go ahead... be a heretic | |
PerlMonks |
Documentation system -- Important note on OODocby crenz (Priest) |
on Oct 12, 2004 at 17:09 UTC ( [id://398605]=note: print w/replies, xml ) | Need Help?? |
A quick update in-between: I tried out OODoc, but I'm not sure whether it fits the bill. It's very module-oriented; I couldn't get it to include docs from my .pl files. I want to document the whole project, not just the classes. Still, I'll try to take further looks at it. I have an important warning, though: OODoc can delete your files if you are not careful. The example given in the manpage will filter your source and replace the files with files without documentation. When I used that example, it replaced all my files with empty files :-( . Fortunately, I use Subversion, so that was not much of a problem. However, without a backup, these files would have been lost. If you try out OODoc, make sure you work on a copy and use something like this
instead of the call to processFiles in the manpage until you know and understand what OODoc does. This will keep your source files intact, AFAIK.
In Section
Seekers of Perl Wisdom
|
|