Beefy Boxes and Bandwidth Generously Provided by pair Networks
go ahead... be a heretic
 
PerlMonks  

Doxygen-type tool for Perl?

by Seventh (Beadle)
on Feb 08, 2005 at 20:09 UTC ( #429211=perlquestion: print w/ replies, xml ) Need Help??
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!

Comment on Doxygen-type tool for 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 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.
        I would be curious to know how you imagine that such a tool would work in a dynamically typed language like Perl.
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 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.

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: perlquestion [id://429211]
Approved by Limbic~Region
Front-paged by grinder
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others examining the Monastery: (6)
As of 2014-09-19 03:14 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    How do you remember the number of days in each month?











    Results (129 votes), past polls