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

podlators 2.1.0 released

From:
Russ Allbery
Date:
June 2, 2008 14:33
Subject:
podlators 2.1.0 released
Message ID:
87k5h89xid.fsf@windlord.stanford.edu
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@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@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@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@stanford.edu)             <http://www.eyrie.org/~eagle/>



nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About