Beefy Boxes and Bandwidth Generously Provided by pair Networks
Clear questions and runnable code
get the best and fastest answer
 
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 avoiding work at the Monastery: (3)
As of 2019-08-25 07:55 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found

    Notices?