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