podlators 2.5.0 released

[email protected] (Russ Allbery) Wed, 02 Jan 2013 13:55:48 -0800
Newsgroups perl.pod-people,perl.perl5.porters
Organization The Eyrie
Message-ID <[email protected]>
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  <[email protected]>

	* 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 ([email protected])             <http://www.eyrie.org/~eagle/>