Beefy Boxes and Bandwidth Generously Provided by pair Networks
No such thing as a small change
 
PerlMonks  

Re: Thoughts on pod.

by Stegalex (Chaplain)
on Feb 26, 2002 at 14:31 UTC ( [id://147575]=note: print w/replies, xml ) Need Help??


in reply to Thoughts on pod.

When I was a Java programmer, there was a neat utility called Javadocs which publishes documentation about module interfaces automatically. It's pretty cool and very automagic. Is there such a thing for Perl? I like chicken.

Replies are listed 'Best First'.
Re: Re: Thoughts on pod.
by robot_tourist (Hermit) on Feb 26, 2002 at 15:58 UTC

    Not having used Javadoc or pod 'in anger' yet (I am but a university student and students only doc their code if they get marks for it), I can say that the plain old mark-up system of pod looks very easy to use. Javadoc, on the other hand, makes much prettier documentation, but has a more difficult syntax and you need an html viewer to look at it. The Javadoc convention of putting the documentation above a method and explaining all your params and return values is good.

    I have a wiry brain/each eye a camera. Robot Tourist, by Ten Benson

Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Node Status?
node history
Node Type: note [id://147575]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this?Last hourOther CB clients
Other Users?
Others taking refuge in the Monastery: (3)
As of 2024-03-29 05:00 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found