Re: Need advise on documentation support tools in Perl

What kind of application is this (where's the POD, inline or what)?

Don't rule out pod just yet -- just because officially only head1..4 is supported, don't mean you can't make it head1..n -- grab one of the following, and work some magic ;D Pod::POM, Pod::Tree (watchout for pod2html), Pod::Parser.

XML + templating system is something to think about.

You might also wanna exploit Exuberant CTags (http://ctags.sf.net) and look into DocBook (http://docbook.org)

MJD says you can't just make shit up and expect the computer to know what you mean, retardo!
** The Third rule of perl club is a statement of fact: pod is sexy.

Comment on Re: Need advise on documentation support tools in Perl

Replies are listed 'Best First'.
Re: Re: Need advise on documentation support tools in Perl by admiraln (Acolyte) on Feb 10, 2003 at 16:17 UTC
The POD is nowhere yet. The system is written in PHP and I am responsible for preparing it for release. This will include logging bugs as I discover them but primarily to document the system as it stands in a way that will let the help files be updatable when the code will evolve. I am using perl to automate some steps in the process so POD came up as a file format to store information that may have to be transformed to other formats. Disclaimer	[reply]

Replies are listed 'Best First'.

Re: Re: Need advise on documentation support tools in Perl
by admiraln (Acolyte) on Feb 10, 2003 at 16:17 UTC

I am using perl to automate some steps in the process so POD came up as a file format to store information that may have to be transformed to other formats.

Disclaimer

[reply]