http://www.perlmonks.org?node_id=429211

Seventh has asked for the wisdom of the Perl Monks concerning the following question:

Hi all,

I've recently been using Doxygen, and it's Perl support is abysmal. Can anyone recommend a similar tool that can pull out perl comments and headers and generate HTML in the same format?

Thanks!

Replies are listed 'Best First'.
Re: Doxygen-type tool for Perl?
by jimbojones (Friar) on Feb 08, 2005 at 20:32 UTC
    There's discussion in this thread 397662 about doxyfilt (?) which seems to be a perl->doxygen parser.

    - jim
      Yeah, I tried getting Doxyfilt to work for about a week, but to no avail. :(
Re: Doxygen-type tool for Perl?
by mpeters (Chaplain) on Feb 09, 2005 at 15:07 UTC
    I've used Natural Docs before and found it really easy to use/customize since it's written in perl.
Re: Doxygen-type tool for Perl?
by ambrus (Abbot) on Feb 08, 2005 at 20:24 UTC

    pod2html?

      pod2html is very, very far from the abilities of Doxygen.

      Doxygen's main virtue isn't only to understand special comments and to generate HTML for them. The thing people like the most in it is its ability to parse the code and generate call graphs, class hierarchies, and other extremely useful information like a list of callers/callees for functions.

      I wish there was such a tool for Perl !

        I would be curious to know how you imagine that such a tool would work in a dynamically typed language like Perl.
        I wish there was such a tool for Perl !

        Seconded. I do not like Java at all, but the javadoc documentation is streets ahead of perldoc and is mostly self maintaining.


        Examine what is said, not who speaks.
        Silence betokens consent.
        Love the truth but pardon error.
Re: Doxygen-type tool for Perl?
by Arrowhead (Monk) on Feb 10, 2005 at 19:59 UTC

    Time to point once again to my unmaintained but working attempt:

    http://smop.org/computing/perl/doxygen.html

    It doesn't infer more than the method and class names from the source itself, so it's still up to the user to add doxygen comments.