As I mentioned earlier I use
noweb for mixing Perl code and documentation. There's a onepage Guide to using noweb at
http://www.eecs.harvard.edu/~nr/noweb/onepage.ps.
I am not good at LaTeX but I understand it and was able to start my documentation work after a few minutes of reading. If you know LaTeX well, you'll be even faster.
What I like in using noweb is the fact that I have just one file to edit. I can then extract the documentation (html, ps, pdf) and the several other files (e.g. perl-script, perl-module, sql-script, makefile). UC: I'm a real fan ;^)
weini
