ATTENTION!
Before using this for any new software, please consider using Pod::Simple, it is a modern replacement for this module.
Version 1.38
+ missed one (important) line from one of the patches below in pod2usage2.t
No change in the *.pm files
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:
Version 1.36
Version 1.35
+ Did I say this package is dead?
+ Make version of distro equal Pod::Parser::VERSION on popular
request - although this is IMHO not a prerequisite (CPAN#17069)
+ Check for core changes to this module dist - there are none
+ Added support for =head3 in Pod::PlainText - who on earth is
using that one? Thanks David Wheeler dwheelerATcpanDOTorg (CPAN#17515)
+ Added support even for =head4 in Pod::PlainText (CPAN#15989)
+ Allow Pod::Usage to work with new and old versions of Pod::Text
Thanks steveiATfisharerojoDOTorg for the patch (CPAN#16368)
+ fall back to $PAGER|more if perldoc fails in Pod::Usage (CPAN#16901)
+ CPAN#17202 is somehow solved in this release
+ try to address CPAN#16959 by removing all extra line end characters
in line comparisons in test
+ added test to catch CPAN#17997, should it ever be a problem
+ address CPAN#19137 by a CAVEAT in Pod::Parser
+ CPAN#19933: PATCH to support L<Weblink|http://www.whatver.site>;
thanks LGODDARD
+ CPAN#21010: Calling parse_from_file twice causes errors
my (...) = ... if(...); is no good - had to split that
+ CPAN15718: Documentation: -section argument should be -sections
+ minor change in Select.pm to solve an issue on Cygwin with ^M
+ CPAN#17997: Regression: -input no longer works with __DATA__ with -verbose => 2
thanks CLOTHO for the patch
+ ran a rough POD spell check
+ fixed test failure on Windows in pod2usage.t (CPAN#14928)
Version 1.34
+ yi luo luoyi.ly at gmail.com noticed that -x does not do the right
thing on Windoze with *.bat files, where -x $file does
+ JHOBLITT at cpan.org sent a patch to make containspod accept files that
start with =head on the first line. Test integrated with slight modifications
(to avoid dependency on File::Temp and others) (CPAN#14871)
+ applied http://public.activestate.com/cgi-bin/perlbrowse?patch=25588
(thanks H.Merijn Brand and Rafael Garcia-Suarez)
Neverending story...
Version 1.33
+ CPAN#14194: I<> in Pod::Usage overridden to just show the text, no ** around
+ CPAN#14195: wrong exit value for pod2usage(0)
+ CPAN#14315: allow for arbitrary URLs
I hope this will do now - Pod-Parser is DEAD!
Version 1.32
+ applied patch by radek at pld-linux dot org that fixes a regression of
broken support of Pod::Parser input from objects (CPAN#13203)
Version 1.31
+ applied patch suggested by ITUB AT cpan.org (remove spurious setting of
$_), which significantly reduces runtime (CPAN#12327)
+ fixed regression in podselect.PL and pod2usage.PL reported by Steve Peters
steve AT fisharerojo.org; no change in the actual code, just the build
script; the fix in Pod::Usage was already in
+ downgraded error about nested styles (e.g. C<...C<...>...>) to a warning
(CPAN#12240)
+ added the brackets to gensym() to make use strict happy in Perls < 5.006
(CPAN#5613)
+ pod2usage() is more tolerant wrt. =head1 SYNOPSIS\s* (CPAN#6329)
+ require at least File::Spec 0.82 as suggested in CPAN#8709
+ include the -noperldoc option in Pod::Usage as suggested in CPAN#11525
This is the last time an enhancement was implemented! >:->
+ fixed the test t/pod/find.t to not depend on perlfunc (CPAN#6679);
now the test also uses t/pod/testpods/lib/Pod/Stuff.pm;
this implicitely fixes also CPAN#8742
+ slightly updated META.yml
+ made sure that CPAN#7486 is really integrated
+ make -quiet DWIM in Pod::Checker (CPAN#11884)
Version 1.30
+ changed dist name to Pod-Parser
+ pushed versions of .pm files to 1.30 as far as CPAN permits, i.e. don't
decrease existing versions > 1.30
+ added end of support announcement
+ cross-checked this version with the Perl5 core version and merged a
couple of changes
Version 1.29 - not released
+ integrated patch by tony at irational dot org to support printing of
custom sections in Pod::Usage
+ integrate change 22886 on Pod::Find (Rafael Garcia-Suarez and
Alan Burlison): Pod::Find should ignore SCM files and dirs
+ integrate a patch by Russ Allbery rra at stanford dot edu to support
Pod::Usage together with Pod::Text based on Pod::Simple or Pod::Parser
+ integrated #23327 (CPAN#7486) (fix warnings with NOEXIT)
+ integrated patch by Radoslaw Zielinski radek at karnet dot pl that
allows to specify IO::String objects as output file handles
Version 1.28
+ bumped version of ParseUtils to make CPAN indexer happy
Version 1.27
+ reviewed a bunch of rather old emails and verified that all that is in
+ added patch by Michael G Schwern schwernATpobox.com to suppress spurious
warning about / and | in L<> hyperlinks
24-Nov-2003 Marek Rouchal <marekr@cpan.org>
Version 1.25 - not released
+ Merged bleadperl-5.8.1 into this distribution. Added a couple of
if($ENV{PERL_CORE}) statements to ease the maintenance of core/module.
Version 1.24
+ removed the "BETA STAGE" from Pod::Checker - it is now stable
+ added patch by Micheal Schwern schwernATpobox.com to silence Pod::Checker
(the module) and let podchecker (the script) print the diagnostics. Added
note in the Pod::Checker documentation.
+ Tom Wyant twyant4ATcomcast.net reported that Cygwin also has the
core pods in pods/ - fixed in Pod::Find
+ changed the logic in Pod::InputObjects a bit to speed up the parser,
based on a suggestion by Mark Jason Dominus mjdATplover.com. The
original proposal was however too much of a revolution to the existing
behaviour.
+ Some minor performance improvements in Pod::Parser (profile analysis)
Version 1.23
+ fixed a bug in Usage.pm, spotted by Kees Cook keesATosdl.org:the
special value 'NOEXIT' has not been treated appropriately
+ added INSTALLDIRS=perl as suggested by M. Schwern
Version 1.22
+ fixed a bug in Usage.pm, spotted by Harry Felder harryATrentec.com:the
path to perldoc is $Config{scriptdir}, not (always) $Config{bin}
Version 1.21
+ fixed a bug in the find.t test
+ make test work ok on MacOS/darwin, which strangely enough has its
perlfunc.pod in a "pods" directory, rather than "pod"
Version 1.20
+ Merged changes of perl-5.8.0 core back into this distribution:
Version 1.19
+ Changed t/pod/testp2pt.pl to always choose Pod::PlainText for the tests,
do not rely on Pod::Text, which is not included in this package
(as suggested by Richard Clamp <richardc@unixbeard.net>)
+ Fixed spurious warning in Pod::ParseUtils reported by Rafael Garcia-Suarez
<rgarciasuarez@free.fr>: Inside "" the characters | and / are ok
+ Added a num_warnings method to Pod::Checker - requested by
brian d foy <comdog@panix.com>
+ Added a warning if =head2 comes before a =head1 - one TODO item less!
Version 1.18
+ Fixed error in failing recognize empty C<< >> sequences
+ Modified pod2usage to use perldoc if ultra-verbose mode is set
and input is a filename and output is STDOUT (so now it doesnt just
print the manpage, it pretty prints it and paginates it)
+ Allowed -exitval => NOEXIT to be given to pod2usage to instruct it
NOT to exit the running script.
+ Applied VMS patches from Tim Jennes to t/pod/find.t and lib/Pod/Find.pm
Version 1.17
+ included small fixes by Tim Jenness <t.jenness@jach.hawaii.edu> to
Pod::Find and t/pod/find.t
+ extended logic in Pod::Find to search for pod/ subdirectories in all
given subdirectories (in pod_where function) to find e.g. "perlfunc".
Thus pod_where could be used by perldoc.
+ added check for recent File::Spec version in Makefile.PL
+ updated Makefile.PL, CHANGES, README
Version 1.16
+ included two subs suggested by Tim Jenness <t.jenness@jach.hawaii.edu>
in Pod::Find (pod_where and contains_pod) and included a test in
t/pod/find.t
+ updated Makefile.PL, CHANGES and TODO
Version 1.15
+ introduced -quiet option for Pod::Checker to suppress diagnostic
output when Pod::Checker is used to eat POD and output text.
+ improved documentation in Pod::Checker
+ improved code coverage of t/pod/poderrs.t
+ updated TODO
Version 1.14
+ fixed wrong value in Pod::Parser concerning whitespace lines
+ added check in podchecker whether argument is a directory
+ introduce additional warning level: this suppresses the complaints
about unescaped <>, but the check is enabled when the wrning level is
increased: podchecker -warn -warn
adapted documentation appropriately
+ Pod::Hyperlink now parses L<open(2)> again, but gives a warning. The
calling programs have to check themselves for what to do with pages
like open(2).
+ Changed POD of several modules so that they conform to podchecker :-)
14-Mar-2000 Marek Rouchal <marek@saftsack.fs.uni-bayreuth.de> 16-Mar-2000 Brad Appleton <bradapp@enteract.com>
Version 1.12
+ Sync-up with patches from the 5.6 core distribution
+ Require perl5.005 instead of 5.004 now that 5.6 is almost out
+ Removed the t/pod/xtra tests from the distribution
+ Ignore [\n\r] when looking for non-empty blank lines in Pod::Parser
+ Added VMS file-unixification to test scripts
23-Feb-2000 Brad Appleton <bradapp@enteract.com>
Marek Rouchal <marek@saftsack.fs.uni-bayreuth.de>
Version 1.10
+ bump up the version number to avoid confusion with a short-lived
version of 1.093-beta
21-Feb-2000 Brad Appleton <bradapp@enteract.com>
Marek Rouchal <marek@saftsack.fs.uni-bayreuth.de>
Version 1.092
+ added the Pod::Cache and Pod::Cache::Item code to Pod::ParseUtils.
+ modified the README file.
Version 1.091
+ cleaned up Pod::Checker, especially documentation, updated test
+ moved helper code to new module Pod::ParseUtils, added documentation
+ added Pod::Find, along with a test
Version 1.090
+ Added several additional checks to Pod::Checker
+ Pod::Checker detects files with no POD
+ Pod::Checker prints warnings about inproper style
+ Modified podchecker to use the -warnings option and the "empty POD"
status
+ Added Pod::Hyperlink (internal in Pod::Checker for now) that parses
the L<> sequence into alttext, page and section
+ Updated documentation
+ Started adding callbacks so that Pod::Checker can be used also for
single-pass POD translators in the future
Version 1.085
+ Added a section on tree-based parsing to the PODs for Pod::Parser
+ Added '-expand_text" callback-option to Pod::Parser::parse_text()
+ Added ability to specify contents for Pod::InteriorSequence::new
+ Added the notion of "parse-options" to enable/disable certain
parsing behaviors (see the section on "PARSING OPTIONS"
in the documentation for Pod::Parser)
+ Added Pod::Parser::parseopts()
+ Added the '-want_nonPODs' parse-option
+ Added the '-process_cut_cmd' parse-option
+ Fixed the 'child2parent' functions in InputObjects so that they
dont invoke "can" or "isa" for unblessed scalar-refs.
Version 1.084
+ Added Russ Allbery's Pod::PlainText re-write
+ Added some tests contributed by Russ Allbery
+ Fixed Makefile.PL to install the supplied scripts
+ Updated copyright messages
+ Added an error/warning callback function to Pod::Parser. When specified,
it will call the user-provided function instead of "warn" when printing
error messages (This makes it easier for things like Pod::Checker to
capture and/or redirect error output). See Pod::Parser::errorsub().
Version 1.083
+ Fixed problem with not defaulting to STDIN in parse_from_filehandle
(thanks to Russ Allbery for the patch)
+ Fixed problem with != and -= (and <op>= in general) processing
inside of C<...> (thanks to Russ Allbery for this patch too)
Version 1.082
+ Fixed portability problems with Makefile.PL on MSWin32 systems
(thanks to Jan Dubois for showing how to do this!)
Version 1.081
+ Fixed warning message in Pod::Parser::parse_text when $expand_seq is undef.
+ Fixed another problem with ignoring the contents of an interior sequence
if it was nothing but ')' inside the angle brackets (e.g. C<0>).
+ Moved test files under t/ to t/pod, and added a subdirectory t/pod/xtra
for the extra tests that involve "included" files and processing its
own source (the "xtra" files are not part of what comes with the CORE
in Perl 5.006)
+ Munged the Makefile.PL to be able to set TEST_FILES to t/pod/.t and
t/pod/xtra/.t (if it exists). This requires File::Spec so now you
need either File::Spec or Perl 5.005 or later to install this.
Version 1.08
+ Fixed a bug in obtaining options-hash in pod2usage()
+ Modified test suite & tools to run as expected on more platforms
(the .t scripts now do a zero-exit if $ENV{ACTIVE_HARNESS} is set)
+ Some more portability fixes for searching file-paths in Pod::Usage
(thanks to Chris Nandor)
+ Changed the distribution directory structure a little bit. Instead
of all the scripts and modules at the top level directory, the scripts
are now in the 'scripts/' subdirectory and the modules are now in the
'lib/Pod/' subdirectory.
Version 1.07
+ Added Pod::Checker and podchecker.PL
+ Fixed line-counting errors in Pod::Parser::parse_from_filehandle()
+ Added raw_text method for Pod::ParseTree
+ Documented optional hash-ref arg to Pod::Parser::parse_text and replaced
'-expand' with '-expand_seq' and '-expand_ptree'
+ parse_text now has sequences point to the parents they are nested inside
of as soon as they are created (instead of after they are appended to
the parent, which may occur after expansion)
+ Added the regression test-suite to the distribution in the t/ subdirectory.
Its not very exhaustive, but its a start.
+ Now uses File::Spec, which is bundled with perl 5.005 and later, but if
you have perl 5.004 you may need to download File::Spec from CPAN
Version 1.061
+ Minor additions to v1.06
Version 1.06
+ SIGNIFICANT CHANGES (POSSIBLE BACKWARD INCOMPATIBILITIES)
+ OTHER CHANGES
Version 1.05
Version 1.04
22-Dec-1997 Brad Appleton <bradapp@enteract.com>
Version 1.03 (major revision)
+ SIGNIFICANT CHANGES
"LESS IS MORE" -- LESS equals signs need MORE newlines! "MORE IS LESS" -- MORE equals signs need LESS newlines! As long as you dont forget that the '=' on a POD directive always comes before the newline that ends the paragraph (so the '=' is associated with the first word of each phrase) you should be fine.
Accessor Method Old Field Name
------------------- -------------------
cutting() CUTTING
output_file() OUTFILE
output_handle() OUTPUT
input_file() INFILE
input_handle() INPUT
total_lines() LINE
total_paragraphs() PARAGRAPH
input_streams() INPUT_STACK
top_stream() INPUT_TOP
sequence_commands() SEQUENCES
Version 1.02
Version 1.01
Version 1.00 (first "official" release):
Initial release of version 0.01 to garner some feedback. This release was actually three separate "initial" releases of Pod::Parser, Pod::Text, and Pod::Usage which were originally named Pod::Filter, Pod::PlainText, and Pod::Usage (respectively).