nofernandes has asked for the wisdom of the Perl Monks concerning the following question:
Hello felow Monks,
Iīm trying to find a documentation generator for various languages as PL/SQL, C++, Pro*C etc..
There are lots of tools to generate this kind of documentation separately. What i was hoping to find was a tool that can generate good documentation of several languages!
This migth be not a perl question, but i have been wondering in another solution, that is to use the perlpod!! If i include the perlīs pod tags in a source code i could easily create good documentation with some style.
For example in a PL/SQL code:
/* =pod =head1 Title Documentation for program YXZ.sql =cut */
The only inconvenience in this approach is the fact that i have to tell the programmers to use this tags.. and give them the list to explain it. And i donīt know if they will accept this "protocol".
So, i think that the best option is to find a tool that generates html code.
Does someone knows such a tool or has any advices?
Thank you all!
Nuno
|
---|
Replies are listed 'Best First'. | |
---|---|
Re: Doc Generator
by Cine (Friar) on Aug 05, 2003 at 17:52 UTC | |
Re: Doc Generator
by Aristotle (Chancellor) on Aug 05, 2003 at 17:11 UTC | |
by nofernandes (Beadle) on Aug 05, 2003 at 17:19 UTC | |
by Aristotle (Chancellor) on Aug 05, 2003 at 17:21 UTC | |
by nofernandes (Beadle) on Aug 06, 2003 at 15:15 UTC | |
by nofernandes (Beadle) on Aug 05, 2003 at 17:28 UTC | |
by nofernandes (Beadle) on Aug 06, 2003 at 14:27 UTC | |
by Aristotle (Chancellor) on Aug 06, 2003 at 14:50 UTC |