Re: Documentation trait / Docstring equiverlent

2005-07-02 Thread John Williams
On Thu, 30 Jun 2005, chromatic wrote: On Thu, 2005-06-30 at 04:33 +, David Formosa (aka ? the Platypus) wrote: I'm just wondering if a documentation trait on subs would be usefull. If we are going to have something like p6explain the doc trait could be used as the source for the

Re: Documentation trait / Docstring equiverlent

2005-07-02 Thread Larry Wall
On Sat, Jul 02, 2005 at 10:17:01AM -0600, John Williams wrote: : There is something to be said for actually _organizing_ the documentation : too, which is why POD docs for a function are not always next to the : function itself. I always cringe when I hear the documentation, as if it's only one

Documentation trait / Docstring equiverlent

2005-06-30 Thread David Formosa \(aka ? the Platypus\)
I'm just wondering if a documentation trait on subs would be usefull. If we are going to have something like p6explain the doc trait could be used as the source for the infomation for it. p6explain would simply have to walk the AST reading the doc traits and pasting the text together. --