Bug#679900: package description copied from manual page

Martin Eberhard Schauer Martin.E.Schauer at gmx.de
Mon Jul 2 13:28:34 UTC 2012


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
D::STF.
>        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.
>    







More information about the pkg-perl-maintainers mailing list