in reply to POD, come let me see thee, I have thee not, but still I clutch thee

> .oO(Hmmm, maybe emulate perldoc itself - getting the wanted behaviour by overloading one/some of the Pod::Perldoc::* methods as appropriate i.e. iff called with -f & 2 args and then handing off to perldoc itself...)

If your thinking about emulating perldoc, I'm wondering what you really need to realize...

Just a suggestion: The book Perl Hacks Hack #45 describes how to implement docstrings using Attribute::Handlers. (with a package "Attribute::Docstring" which unfortunately is not on CPAN* ) This allone should work with just compiling the code, and you can introspect all subs and package-vars directly!

Alternatively you may add a simple static parser which reads the docstrings like sub name :Doc( 'documentation text ...' ) { } without even compiling.

For me, this looks much easier than emulating perldoc.

Cheers Rolf

UPDATE:
(*) But here perl_hacks_examples.tar.gz /object_hacks/add_information_with_attributes/lib/Attribute/Docstring.pm

  • Comment on Re: POD, come let me see thee, I have thee not, but still I clutch thee
  • Download Code