Beefy Boxes and Bandwidth Generously Provided by pair Networks
laziness, impatience, and hubris
 
PerlMonks  

Re: Perl Documentation, again. :(

by duct_tape (Hermit)
on Mar 23, 2005 at 16:50 UTC ( [id://441827]=note: print w/replies, xml ) Need Help??


in reply to Perl Documentation, again. :(

I know that this doesn't answer your question, but maybe you could give a look at http://www.naturaldocs.org/. It has support for perl, and is somewhat similar in concept to doxygen. Put some extra comments in your code, run the tool against it and it generates your documentation. I successfully got it to work on one of my recent projects without much work. The documentation for it is pretty good.

Replies are listed 'Best First'.
Re^2: Perl Documentation, again. :(
by MidLifeXis (Monsignor) on Mar 24, 2005 at 00:02 UTC

    One thing I don't like about NaturalDocs is that if you want to use POD and ND, you need to write your documentation twice -- or at least I have not found a way to have both available with a single set of source. That is not to say that ND is not a very good system. I am quite happy with most of what it does.

    I would be more than happy to see this response proven wrong :)

    --MidLifeXis

[reply]

      Yah, I agree with that. For the last project that I used ND on I decided to only use ND and not both it and POD. It would definately be cool to have a POD output format for ND. If you ever find anything out, let me know :)

[reply]

In Section Seekers of Perl Wisdom

Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?

www.com | www.net | www.org
Node Status?
node history
Node Type: note [id://441827]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? • Last hour • Other CB clients
Other Users?
Others wandering the Monastery: (7)
As of 2024-04-19 11:02 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found