This release adds a new --utf8 option to pod2man and corresponding
Pod::Man configuration option to write UTF-8 characters to the resulting
*roff output rather than trying to convert the characters to troff escapes
or just X for unknown characters. This is a separate option rather than
the default since UTF-8 characters are known to break some vendor *roff
implementations and the resulting *roff output is therefore not portable.
Linux distributions may wish to consider enabling this by default,
although there isn't a good way to do that as yet without patching the
module (and the documentation!).
I also fixed various other bugs turned up by Debian's switch to Perl 5.10.
Debian Perl maintainers, you will probably want to switch to this version
of Pod::Man before lenny.
The URL
http://archives.eyrie.org/software/modules/podlators-2.1.0.tar.gz
has entered CPAN as
file: $CPAN/authors/id/R/RR/RRA/podlators-2.1.0.tar.gz
size: 80707 bytes
md5: 9d4283c0975f8dfdedc47ca15ed63496
Changes since the previous release:
2008-06-01 Russ Allbery <rra(a)stanford.edu>
* VERSION: podlators 2.1.0 released.
* Makefile.PL: Add LICENSE.
* lib/Pod/Man.pm (format_text): If the utf8 option is set, don't
convert non-ASCII characters to *roff escapes or X. Document the
utf8 option.
* scripts/pod2man.PL: New option -u or --utf8 says to output
literal UTF-8 characters rather than pure ASCII.
* t/man-options.t: New file. Test the utf8 option.
* t/man.t: Be more cautious about passing an encoding to binmode
to allow for a Perl without PerlIO.
* lib/Pod/Man.pm (switchquotes): Match text between \f(CW and \fP
or \fR in headings non-greedily to get the fonts right with
multiple C<> formatting codes.
* t/man.t: Test =head1 with multiple C<> codes.
2008-05-14 Russ Allbery <rra(a)stanford.edu>
* lib/Pod/Man.pm (preamble_template): Protect .Sh text against
leading *roff control characters since some *roff implementations
apparently "look through" font escapes at the beginning of lines.
2008-05-12 Russ Allbery <rra(a)stanford.edu>
* lib/Pod/Man.pm (format_text): Escape backslashes separately from
processing non-ASCII characters and do that, dash escaping, and
underscore adjustment before processing non-ASCII characters.
Otherwise, we escape the hyphen in eth characters.
* t/man.t: Test for handling of eth.
--
Russ Allbery (rra(a)stanford.edu) <
http://www.eyrie.org/~eagle/>