in reply to pod-latex-pdf

Why I ask here is simply because I can imagine quite a few number of knowledgable people did something similar to create a nice PDF from POD.
While I haven't actually tried these myself (yet), I found these two on CPAN for someone a while back, and seem to recall getting some positive reviews on one or the other: Pod::HtmlPsPdf and Pod::Pdf.

Yeah, I know, i should try them to see if they are any good before recommending them, and to know which to recommend if any. :)

You may have reasons for wanting to go via LaTeX though, which eludes me since I don't know LaTeX. Apologies if those are of no interest. :)


You have moved into a dark place.
It is pitch black. You are likely to be eaten by a grue.

Replies are listed 'Best First'.
Re: Re: pod-latex-pdf
by perrin (Chancellor) on Jun 20, 2002 at 22:56 UTC
Re: Re: pod-latex-pdf
by axelrose (Scribe) on Jun 21, 2002 at 10:41 UTC

    The reasoning behind using LaTeX is to have full control over the layout, fonts, etc.

    pdflatex can produce very professional output, see e.g. http://www.pragma-ade.nl for samples.

    Another important point is using POD for diffent type of documentation. I think the whole Perl Cookbook was written with enriched POD.

      Ah, I rather thought it might be something like that, but decided to provide what I could anyways. :) And perrin provided an excellent example on how good the result good be above (I downloaded those PDF's and it was very nice IMO).

      As for using POD for documentation, I wholeheartedly agree. I am trying to write more and more stuff in POD for this reason, including company docs that can be transfered to other formats. I'm not there yet, but I am trying.

      As for books, I don't know about the Cookbook, as I don't own it, but the Camel book says it was written entirely in POD. It is mentioned in the POD chapter among other places. So it is definetely good enough. :) As the authors say themselves:

      We don't claim that pod is sufficient for writing a book, although it was sufficient for writing this one.

      Personally, I think one of the absolute best things with POD is that it is also easy to read unprocessed. There are no other formats I know about, that is as easy. Note that I said "that I know about", though. And plain text doesn't really count either, because it doesn't contain any processing instructions. :)


      You have moved into a dark place.
      It is pitch black. You are likely to be eaten by a grue.