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

[Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>]

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.
>