Hello all,
I made this for myself : a PDF printable version of the Moose::Manual. I will do it for the Moose::Cookbook too.

I thought others might want to use it. Help yourself :
PDF file
and if you want to change it, here is the original :
ODT file
All critics are more than welcome, and you can make changes yourselves now.

I think (it's just my very humble opinion) that ALL Perl documentation should be provided in such a printable format, so that people like me who are hurt by screens can easily print it all. It's also easier for me to learn when i can highlight things and take notes.

I didn't know where to share it, so i just put it here for now. If anybody has a better idea, please move it or tell me where to post / send it.

Replies are listed 'Best First'.
Re: Moose::Manual in a PDF printable file
by MidLifeXis (Monsignor) on Apr 02, 2012 at 18:16 UTC

    See also pod pdf. It looks like there are a couple of options out there.

    --MidLifeXis

[reply]

      Very nice, thank you !

      For a documentation as long as Moose's, though, it would be nice to have a full PDF version somewhere for printing purpose. The whole Moose::Manual took approx 125 pages before i shrinked it to 73 pages.

      But Pod::Pdf might make it so much faster (for me) that i might just use this for the Cookbook, and i will use it for smaller PODs.
      Yep, thank a lot, you just saved me lots of time and effort :-)
      Especially because i do this with most PODs that i have to read, unless they are very small.

      I still like the idea that i can make it more lightweight in terms of pages, though. It took me 1 hour 30 to do this, which is too long for gaining 50 pages of weight and paper sheets. But when i think that other people will also benefit from it...

      Time will tell if i will ever take the time to do it again (^c^)

[reply]

        I just tried Pod::Pdf on the Recipe 1 of the Cookbook.
        It created a 10 pages document out of this simple example, 5 of which are useless.

        In comparison, a re-factoring with OOffice gives me a document of approximately 2 pages and a half : it's twice as short.

        Conclusion : i will do this re-factoring and print it here, probably tomorrow.

[reply]
Re: Moose::Manual in a PDF printable file
by mascip (Pilgrim) on Apr 02, 2012 at 19:33 UTC
[reply]
Re: Moose::Manual in a PDF printable file
by perlStuck (Sexton) on Apr 02, 2012 at 15:50 UTC
[reply]

      Hmmmmm... at first i thought "it's not really a Meditation"; but it's definitely a tutorial draft, for review, and there is a "meditation" inside : "ALL Perl documentation should be provided in such a printable format".

      Thank you perlStuck :-)

      Errrr.... i don't find how to post a new message in Meditations. Help ?

[reply]

        Go to 'Meditations' page.
        Go to 'Add your Meditation' section at bottom of page.
        Add your meditation by pasting text into 'Meditation' text box. (Add a title, too, in the 'Title' box.)

[reply]

Back to Perl News