[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Bug#679900: package description copied from manual page

Justin B Rye wrote:

Please consider this shortened version:

    Description: Perl module providing stack trace facilities
     The Devel::StackTrace module provides two classes, Devel::StackTrace
     and Devel::StackTraceFrame.
     The Devel::StackTrace object encapsulates the information that can be
     obtained by using the caller() function, as well as providing a simple
     interface to this data.
     The Devel::StackTrace object contains a set of Devel::StackTraceFrame
     objects, one for each level of the stack.  The frames contain all the
     data available from caller().
The problem here is that after it says there are two of them, D::ST
and D::STF, it's confusing that both of the following paragraphs
appear to be describing D::ST - it's not clear that the second
paragraph is effectively defining D::STF.
It's my fault. I think the second paragraph should have started with the
       The Devel::StackTrace module provides two classes.
       Devel::StackTrace objects provide a simple interface to the data
       available from caller(), encapsulating the information from a set of
       Devel::StackTraceFrame objects.
       Devel::StackTraceFrame objects each contain the caller data for one
       level of the stack.

Reply to: