Some POD questions.

davidov0009 has asked for the wisdom of the Perl Monks concerning the following question:

I have looked through perlpod and some other tutorials on documentation for perl but to me there always seems to be a missing step. The part where you make the documentation into an actual readable document. I have looked at pod2html but don't quite understand its purpose. How does one go about taking the POD in their module/script and making it into those pages that one sees for each module on CPAN?

use strict;
use CGI;
[download]

Comment on Some POD questions. Download Code

Replies are listed 'Best First'.
Re: Some POD questions. by FunkyMonk (Bishop) on Dec 20, 2007 at 18:43 UTC
`pod2html < /path/to/module.pm > module.html` [download]	[reply] [d/l] [select]
Re: Some POD questions. by webfiend (Vicar) on Dec 20, 2007 at 20:47 UTC
Try POD::HTML. It's just a frontend to the command line tool, but it will do what you need. Oh, and I suggest you do some form of caching or your Web host / admin may come smack you after a few thousand hits. The tool itself handles some caching, so read those docs.	[reply]
Re: Some POD questions. by dj_goku (Novice) on Dec 20, 2007 at 23:00 UTC
As someone already stated with less typing (you don't need to '<' in the script): `$ pod2html file.pl > file.html`	[reply] [d/l]