Update (20061211)
re consideration: I am strongly against changing the title. This title was chosen because it most concisely states the point: the perl pod tutorial as a perldoc, under the name perlpodtut. This title was very carefully chosen, years ago. Vote as you wish, and change the title if you must, but you should at least know my opinion.

Fellow Monks, I'm looking for your opinions. Recently, my Perl Cheat Sheet (rep: 212) has been included with perl as perlcheat. Would you like me to submit POD in 5 minutes (rep: 137) to p5p as perlpodtut?

I think it's good enough for submission to p5p. If you think it's not, let me know why :)

Juerd # { site => 'juerd.nl', plp_site => 'plp.juerd.nl', do_not_use => 'spamtrap' }

Replies are listed 'Best First'.
Re: perlpodtut
by duff (Parson) on Dec 20, 2003 at 20:10 UTC

    Sure, perlpodtut looks useful. Though you might want to mention h2xs and any other standard tools that build POD templates for you.

    duff

[reply]
[d/l]
[select]
Re: perlpodtut
by tachyon (Chancellor) on Dec 21, 2003 at 10:06 UTC

    It is a good summary and there is nothing on pod so sounds like a good idea to me. As well as agreeing with the h2xs suggestion Pod::HTML and Pod::Usage are handy to know about and core.

    cheers

    tachyon

[reply]
[reply]
Re: perlpodtut
by rdfield (Priest) on Dec 21, 2003 at 10:41 UTC
    Since other people have suggested other items that are more for an appendix than the main body of the document, how about adding a note on how to rebuild the ActiveState POD after installing new modules: 
    perl -MActivePerl::DocTools -e "ActivePerl::DocTools::WriteTOC()"

    [download]

    rdfield

[reply]
[d/l]

      how about adding a note on how to rebuild the ActiveState POD

      IMO, it's up to ActiveState to inform their users or better yet: automate it somehow.

      Juerd # { site => 'juerd.nl', plp_site => 'plp.juerd.nl', do_not_use => 'spamtrap' }

[reply]
Re: perlpodtut
by Juerd (Abbot) on Dec 24, 2004 at 10:13 UTC

    Update: A bit late, but I sent it to p5p today. Sorry it took so long.

[reply]

Back to Meditations