Hi,
What are the chances of the old pod2latex being retired for the next
perl release (5.6.1 ??) and replacing it with Pod::LaTeX (yes, I wrote
that)?
The current pod2latex is broken in many ways that have been discussed
occasionally on this list. Amongst these are that it does not handle
nested lists and requires quite a bit of manual labor after translation.
The code is also quite difficult to support (but that's a personal comment
rather than a bug).
Pod::LaTeX currently does everything the existing pod2latex does and
more:
- Does handle nested lists
- Based on Pod::Parser
- Much more flexible
pod2latex -full -modify -out perlbook /local/lib/perl5/
will translate all the perl documentation into a single latex file.
The things it doesn't yet do are not handled by the current system either:
- no regression test
- Does not handle unescaped < or >
- Does not automatically podify func() or $var
As far as the last two points go, I have a feeling that this should be
done in some generic way before Pod::LaTeX even sees the text (essentially
translating $var to C<$var> [or whateve] on the fly) since the code must
be the same regardless of whether you are translating to html, latex or
plain text (but then maybe I'm naive).
Thanks
--
Tim Jenness
JCMT software engineer/Support scientist
http://www.jach.hawaii.edu/~timj
