CGI/Perl Guide | Learning Center | Forums | Advertise | Login
Site Search: in

  Main Index MAIN
INDEX 		Search Posts SEARCH
POSTS 		Who's Online WHO'S
ONLINE 		Log in LOG
IN

Home: General Discussions: General Questions:
Perl documentation Generator

 


doe
New User

Mar 31, 2009, 10:27 AM

Post #1 of 3 (3504 views)
Perl documentation Generator Can't Post
Hello all,

Can anyone recommend a perl documentation generator?

1. Select a perl script.
2. parses the script
3. documents all code...

I searched the net and found this:
http://www.naturaldocs.org/

Any help would be appreciated.


FishMonger
Veteran / Moderator

Mar 31, 2009, 11:24 AM

Post #2 of 3 (3502 views)
Re: [doe] Perl documentation Generator [In reply to] Can't Post
What do you mean by:
Quote
3. documents all code...
If your code isn't already documented, then you're out of luck.

If you used POD documentation in the script, then you could use the pod2html module to create a html page of the documentation. Or you could use pod2pdf to create a pdf file.

http://search.cpan.org/~nwclark/perl-5.8.9/pod/pod2html.PL
http://search.cpan.org/~jonallen/pod2pdf-0.42/bin/pod2pdf

If you used regular comment lines, then you could write a simple 1 liner that filters and outputs all comment lines.


KevinR
Veteran


Mar 31, 2009, 6:28 PM

Post #3 of 3 (3493 views)
Re: [FishMonger] Perl documentation Generator [In reply to] Can't Post
Smells like a shill post to me Fish, maybe not.
-------------------------------------------------

 
 


Search for (options) Powered by Gossamer Forum v.1.2.0

Web Applications & Managed Hosting Powered by Gossamer Threads
Visit our Mailing List Archives