Your skill will accomplish what the force of many cannot |
|
PerlMonks |
Re: documentation generator? web-enabled perldoc?by PodMaster (Abbot) |
on Aug 07, 2004 at 08:47 UTC ( [id://380872]=note: print w/replies, xml ) | Need Help?? |
doxygen parses sourcecode to determine constants, function signatures, etc..
function signature won't work for perl (as i'm sure you realize).
doxygen includes hyperlinked syntaxt hilighted sourcecode in its output, and there is no reason you couldn't do that with perl other than its of little use most of the time (and parsing perl is hard). doxygen links all function references to the function documentation, and there's no reason a pod translator couldn't do that (in fact Pod::Html tries to resolve those when possible). Anyway, here is something other than just pod: Anyway, perl's only issue with pod (besides the fact that L<blah blah|http://some.url/> isn't legal yet), is that there aren't many tools (like doxygen) to generate pod from raw source (as much is possible) for module writers (module users shouldn't need to deal with such tools).BTW - I like pod :)
In Section
Seekers of Perl Wisdom
|
|