in reply to Perl for Perl's Sake: Yet Another Perl Doc Tool

While I like the format of this and NaturalDocs, I really don't like that I need to maintain two types of documentation - one for command line output (perldoc foobratz.pl), and one for web (or other output format) enabled documentation.

It would be nice to have something that you maintain in one location, and that processes into any output (like POD), in a full featured way (nd or this module).

This sounds like another good tool. Any ideas on one that allows maintenance of one set of documentation comments?

--MidLifeXis

Replies are listed 'Best First'.
Re^2: Perl for Perl's Sake: Yet Another Perl Doc Tool
by renodino (Curate) on Aug 22, 2007 at 18:45 UTC
    Since Pod::Classdoc just uses special POD tags ("=begin/end classdoc") wrapped inside POD sections, presumably its just a matter of writing an appropriate POD filter (plus something - e.g., PPI - to detect the beginning of package/method definitions).

    OTOH, maybe Lynx would work with the HTML version ? I've not tried it (and frankly am not inclined to).

    BTW: thanks for the NaturalDocs link, I'd not heard of it before.

    Perl Contrarian & SQL fanboy
[reply]

In Section Cool Uses for Perl