This is a "clear the decks" release, taking care of various smaller bug
reports and feature requests that had accumulated.
There is one big change here: as of this release, pod2text and pod2man die
by default if the POD document has syntax errors. I'm a bit worried that
this will be too disruptive and I'll have to back it down, but there was
some discussion about this a while back and a general consensus that
hiding things in a POD ERRORS section by default isn't the most helpful
behavior. Please let me know if this causes significant problems and I
can back it down to reporting errors on standard error without dying.
Note that the modules, Pod::Man and Pod::Text, will continue to use the
POD ERRORS section by default, since having a module suddenly start
throwing an exception isn't very friendly.
The URL
http://archives.eyrie.org/software/perl/podlators-2.5.0.tar.gz
has entered CPAN as
file: $CPAN/authors/id/R/RR/RRA/podlators-2.5.0.tar.gz
size: 101497 bytes
md5: 964f19e1ab23420a2f7c8753943b8a03
Changes from the previous release:
2013-01-02 Russ Allbery <r...@stanford.edu>
* VERSION: podlators 2.5.0 released.
* lib/Pod/Man.pm (guesswork): Extend a small-caps section through
the punctuation that commonly appears in license disclaimers so
that small caps isn't turned on and off at the boundaries of every
word, producing unreadable *roff.
* t/man.t: Test the updated small-caps behavior.
* lib/Pod/Man.pm (new): Support a new errors option with values
die, stderr, pod, and none. Convert the stderr option to the
errors option with value stderr. (#39007)
(end_document): Die if errors was set to die and there were POD
syntax errors.
* lib/Pod/Text.pm (new): Likewise.
(end_document): Likewise.
* scripts/pod2man: Support a new --errors option that sets the
underlying errors formatter option and default to dying on POD
syntax errors.
* scripts/pod2text: Likewise.
* t/man-options.t: Add support for catching exceptions during
formatting. Test valid and invalid errors settings.
* t/text-options.t: Likewise.
* lib/Pod/Man.pm (cmd_l): Add nourls option to suppress the URL
from L<> formatting codes that contain anchor text. (#62210)
* lib/Pod/Text.pm (cmd_l): Likewise.
* scripts/pod2man: New --nourls option to set the corresponding
option in Pod::Man.
* scripts/pod2text: Likewise for Pod::Text.
* t/man-options.t: Test new nourls option.
* t/text-options.t: Likewise.
* lib/Pod/Man.pm (outindex): Also collapse consecutive whitespace
in index term text.
* t/man.t: Test for handling of index terms containing whitespace.
2013-01-02 Kevin Ryde
* lib/Pod/Man.pm (outindex): Remove newlines from index term text
since *roff quotes don't span lines. (#82332)
--
Russ Allbery (r...@stanford.edu) <http://www.eyrie.org/~eagle/>
