good chemistry is complicated, and a little bit messy -LW |
|
PerlMonks |
comment on |
( [id://3333]=superdoc: print w/replies, xml ) | Need Help?? |
Check out Pod::Webserver. It scans the
perl installation and runs a web server which
serves pod formatted as HTML.
I also use a simple script to create a syntax-highlighted source code listings and an index page. It uses gvim to make syntax-highlighted listings in HTML. I wrote a little script to create these highlighted listings in a batch mode. The script also makes an index page. It runs so slowly that when the first file being processed was large, I was fooled into thinking it was broken! There are several ongoing projects that are relevant. TheDamian is working on something a bit like JavaDoc. It parses specially formatted comments and turns them into documentation. I don't have the details handy, but I can post a few notes later if there is interest. There is at least one perl refactoring tool in the works, but it is still in the research phase. To work properly it must parse perl itself, which is properly understood as a very hard problem. I have seen this tool handle subs and packages and draw depedency diagrams. This was demonstrated (in part) by MikeZone at a Sonoma.pm Mongers meeting.
It should work perfectly the first time! - toma
In reply to Re: documentation generator? web-enabled perldoc?
by toma
|
|