develooper Front page | perl.perl5.porters | Postings from June 2008

podlators 2.1.0 released

Thread Previous
Russ Allbery
June 2, 2008 14:33
podlators 2.1.0 released
Message ID:
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.


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  <>

        * VERSION: podlators 2.1.0 released.

        * Makefile.PL: Add LICENSE.

        * lib/Pod/ (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/ (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  <>

        * lib/Pod/ (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  <>

        * lib/Pod/ (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 (             <>

Thread Previous Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About