To create a POD filter for translating POD documentation into some other
format, you create a subclass of Pod::Parser which typically overrides just
the base class implementation for the following methods:
* command()
* verbatim()
* textblock()
* interior_sequence()
The reason of this import is the huge amount of bug fixes, even if it's
declared as deprecated. Pod::Latex-users (and other Pod::Parser dependent)
will benefit from this import:
Before using this for any _new_ software, please consider using Pod::Simple,
it is a modern replacement for this module.
09-Feb-2008 Marek Rouchal <marekr@cpan.org>
-----------------------------------------------------------------------------
Version 1.38
+ missed one (important) line from one of the patches below in pod2usage2.t
No change in the *.pm files
04-Feb-2008 Marek Rouchal <marekr@cpan.org>
-----------------------------------------------------------------------------
Version 1.37
+ fixed resource links in META.yml
+ address CPAN#42695 with a minor change in PlainText, although not solving
it completely; the 'loose' option now applies to all =headN headings
+ address failures of find.t on Win32 (cpantesters) - root cause was a
mismatch of directory names like "Progra~1" (short/long file names)
+ include the following bleadperl changes:
* Blank lines "between" verbatim sections are now acceptible:
http://perl5.git.perl.org/perl.git/commitdiff/caa547d
* Be less picky about what constitutes "numeric lists" in Pod:
http://perl5.git.perl.org/perl.git/commitdiff/4df4f5d
* Changes made to contains_pod.t when upgrading to 1.34:
http://perl5.git.perl.org/perl.git/commitdiff/fb59f97
* Fix paths on new pod2usage2 tests to work in the core.
http://perl5.git.perl.org/perl.git/commitdiff/222046efb22c183703fea2b30db76296ab782e89
* Make t/pod/pod2usage2.t work on case insensitive file systems.
http://perl5.git.perl.org/perl.git/commitdiff/767c16ab361d1225fb153423fb22b590c1e0c7ea
Thanks to Nicholas Clark, Steve Hay, Jerry D. Hedden for the patches
+ removed \r from t/pod/usage2.pod
19-Jan-2008 Marek Rouchal <marekr@cpan.org>
-----------------------------------------------------------------------------
Version 1.36
- Did I say this package is dead, and there won't be any updates?
This release is fixing all open CPAN RT issues, hopefully this is the
last version forever...
+ Ironed out the most severe issues reported by perlcritic, updated
META.yml
+ Adapted Makefile.PL such that CPAN should recognize dependencies better
+ CPAN#30672: Merged the minor change (recognize =encoding) from 5.10.0,
along with a few test improvements - thanks Adriano Ferreira for the patch
+ Assimilated changes from 5.8.9 on podchecker.PL
+ CPAN#23618: replace $Config{privlib} with privlibexp to avoid problems
with installation paths like ~user. Thanks clonezone for the patch
+ CPAN#24983: document that parse_from_file() accepts also file handle
references and objects that support the regular IO interfaces
+ added a little tweaking of Test::Builder to pod2usage2.t, which
should solve the problem with older Perls (5.005)
+ CPAN#29749: applied patch to squelch noise from older blib
versions. Thanks SREZIC
+ CPAN#29978: fixed insecure argument for running perldoc from
pod2usage() in -T scripts
+ CPAN#30043: add =cut as an indentifier for POD in Pod::Find.
Thanks NATERAJJ for the patch
+ CPAN#33020: Pod::Usage will by default look for both SYNOPSIS and
USAGE - since SYNOPSIS is the traditional section name, while USAGE
is suggested by perlcritic
+ CPAN#33150: made sure that pod2usage(-message=>'...') always
appears, even when using perldoc
+ CPAN#35514: add some documentation and a test to demonstrate how
pod2usage works together with Pod::Find::pod_where to show module PODs
+ CPAN#38648: pod2usage(-verbose => 1) now accepts whitespace after
SYNOPSIS. Thanks dwierenga AT valueclick DOT com for the patch
+ CPAN#38747: two important bug fixes and one improvement, all around
pod2usage(-sections). Many thanks David DOT Purdie AT erggroup DOT com
for the patches and suggestions. This fixes also CPAN#41136
+ CPAN#41135: allow subheadings in OPTIONS/ARGUMENTS and
pod2usage(-verbose => 1) - they are now printed as well
+ CPAN#42141: find.t fix for VMS in UNIX compatible mode. Thanks a lot
malmberg AT Encompasserve org for the patch
+ Fixed inconsistencies between Pod::PlainText and Pod::Text regarding
selection of sections; now both should work according to the docs of
Pod::Usage
+ verified on perl 5.8.8, 5.8.7, 5.6.1, 5.005.03 on Solaris 8 (Sparc),
perl 5.6.1, 5.8.7 on RedHat Linux 7.2,
perl 5.10.0 on Windows 2000,
perl 5.8.0, 5.6.1, 5.8.7, 5.8.8 on RedHat Enterprise Linux 3.0,
perl 5.8.5, 5.6.1, 5.8.7, 5.8.8 on RedHat Enterprise Linux 4.0
with various combinations of Pod::Text, Test::More etc.
Oked by joerg@ and rhaen@
c605437127