Stories
Slash Boxes
Comments
NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.

All the Perl that's Practical to Extract and Report

use Perl Log In

Log In

[ Create a new account ]

Yanick (3196)

Yanick
  (email not shown publicly)
http://babyl.dyndns.org/techblog

Journal of Yanick (3196)

Wednesday April 18, 2007
09:41 PM

Catalyst's manual

[ #33028 ]

Don't get me wrong, I love perldoc. But for documentation that span several manpages, I often catch myself dreaming of tables of content, indexes, real dead-tree margins on which to annotate stuff. I'm funny that way.

So I went back to the script that I wrote to create the XPathScript manual and tinkered a bit with it. I then used that newly-concocted black magick (which basically convert and agglomerate pods into a docbook, which is then LaTeXified and subsequently pdfed) to turn the Catalyst manual into a cute little pdf. Me likes. I think I'll tidy up the aforementioned script and publish it as Pod::Manual or something of the kin as soon as time (ah!) allows.

(and yeah, I'm in the process of getting my feet wet with Catalyst. Last week I was hopelessly Not Getting It, but sometime during last week-end, an angel came to me and bapped me over the head with its trumpet. Epiphany! I grok it, now! Even better: I think I'm digging it too!)

The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
 Full
 Abbreviated
 Hidden
More | Login | Reply
Loading... please wait.
  • Pod::Manual::PDF :-)

    Way cool. Can't wait to get my hands on that script. I hate reading in perldoc. I usually just push it up to CPAN and read it when the indexer renders it all.

    pod2html locally is a pitas sometimes as well.
  • That looks totally great! Seriously!

    That's one more barrier to doing some Catalyst learning gone...
    --
    rjbs
    • Assuming this get's refined, maybe syntac colouring, or at least ditch some of the pod parsing errors, I would love to see this on CPAN, or one of the related sites...where on could just go and get the latest Pdf version of the pod for a dist.
    • *blush* Thank you. :-)

      And as I go through the document, I'm noting how the pods could be rearranged so that the flow is more logical, and take note of other pods that should be added to the collection. So expect a second version of the compendium in the near future.