Beefy Boxes and Bandwidth Generously Provided by pair Networks
Pathologically Eclectic Rubbish Lister
 
PerlMonks  

Some POD questions.

by davidov0009 (Scribe)
on Dec 20, 2007 at 18:38 UTC ( #658204=perlquestion: print w/replies, xml ) Need Help??

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;

Replies are listed 'Best First'.
Re: Some POD questions.
by FunkyMonk (Chancellor) on Dec 20, 2007 at 18:43 UTC
    pod2html < /path/to/module.pm > module.html

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.

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

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: perlquestion [id://658204]
Approved by FunkyMonk
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others scrutinizing the Monastery: (3)
As of 2019-08-21 00:52 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found

    Notices?