README
1Pod::LaTeX - convert Pod to latex using Pod::Parser
2
3This is version 0.60 of Pod::LaTeX. This module can be used to
4convert pod data to latex. It uses the standard Pod::Parser module.
5A pod2latex replacement command is provided. This can be installed over
6the pod2latex command distributed with perl.
7
8Please let me know of any problems.
9
10INSTALLATION
11
12 % perl Build.PL
13 % ./Build
14 % ./Build test
15 % ./Build install
16
17Currently the tests are not very good (only a simple test is provided).
18
19REQUIREMENTS
20
21Requires perl 5.005 or newer.
22
23Written completely in Perl. XS is not required.
24
25Requires the PodParser package from CPAN. This is standard with
26perl 5.6.0. This module is part of the standard perl distribution
27and has been since perl 5.6.1.
28
29AUTHOR
30
31Tim Jenness <tjenness@cpan.org>
32
33Copyright (C) 2011-2012 Tim Jenness.
34Copyright (C) 1999-2004 Tim Jenness and the UK Particle Physics and
35Astronomy Research Council. All Rights Reserved. This program is free
36software; you can redistribute it and/or modify it under the same
37terms as Perl itself.
38
39CHANGES
40
41V0.61
42 - Update site vs perl install for perl v5.12 and above
43 - Issue a deprecation warning if the module is being used in perl 5.17.0 and above.
44 This module will be removed from perl Core for perl 5.20. (Ricardo Signes)
45 It will still be available on CPAN.
46
47V0.60
48 - Patch for "--" from Dima Kogan (RT #72518)
49
50V0.59
51 - Use Module::Build
52 - Fix trivial pod typo (RT #46887)
53
54V0.58
55 - Fix problem with [] in items (R. de Vries)
56
57V0.57
58 - Missing README file for V0.56 now added. No changes to code.
59
60V0.56
61 - Add -prefile/-postfile and -preamble/-postamble options to pod2latex
62 and fix double printing of user postamble.
63 (thanks to Adriano Rodrigues Ferreira)
64 - UserPostamble and UserPreamble were erroneously being written
65 even when AddPostamble and AddPreamble were false.
66
67V0.55
68 - Fix enumerated lists so that they do not double up the number
69 (Aerial Scolnicov and Sudhi Herle)
70 - Strip "." and ")" from numbers when looking for enumerated lists
71 (Sudhi Herle)
72 - Module now returns a true value (add 1; at end) (Dan Kogai)
73 - Many new Pod escapes supported (Peter J Acklam)
74 - The module now installs into the PERL dirs and not the site
75 install if the perl version is greater than 5.6.0 (since this
76 module is part of core perl as of v5.6.1).
77 - The pod2latex script is now configured as a true pod2latex.PL
78 application (imported changes from bleadperl)
79 - Should now pass tests with Pod::ParseUtils v0.30 installed
80 (thanks to Mark Veltzer for pointing out the problem)
81
82V0.54
83 - Fix misunderstanding with =for
84 - Add fixes for < and > (and also |)
85 - Fix tabbing (thanks to Hugh S Myers)
86 - Fix strange indenting with long items (Hugh S Myers)
87 - add a real test
88 - Fix L<> since the fix to escape | had broken it
89 - add -h1level to pod2latex
90
91V0.53
92 - Handle long items (Mark A Hershberge)
93 - Escape ~ (Simon Cozens)
94 - Add verbar and sol support as well as | escape (Marcel Grunauer)
95
96V0.52
97 - minor fix to pod2latex to preserve order of supplied arguments
98
99V0.51
100 - Fix some of the warning messages so that they report the
101 line number in the pod file correctly for errors.
102
103 - Fix escaping of ^, { and }
104
105V0.50
106 - First public release
107
108KNOWN BUGS
109
110 - Does not automatically convert func() to B<func()> and $a to C<$a>
111
112 - Probably does not match the new perlpodspec
113