1ATTENTION! 2 3Before using this for any _new_ software, please consider using Pod::Simple, 4it is a modern replacement for this module. 5 6 10-Feb-2015 Marek Rouchal <marekr@cpan.org> 7 ----------------------------------------------------------------------------- 8 Version 1.63 9 + CPAN#101847: [PATCH] Bump $VERSION in module changed since Pod-Parser-1.60 10 increased VERSION in all *.pm files 11 + CPAN#98610: Pod::Find should skip also object directories of modern vc 12 systems (.git, .hg) 13 implemented in Pod::Find 14 Thanks for the reports and patches! 15 16 02-Feb-2014 Marek Rouchal <marekr@cpan.org> 17 ----------------------------------------------------------------------------- 18 Version 1.62 19 + CPAN#87891: More sanity checks in podselect() 20 documentation patches by florent.angly@gmail.com, and a bit of stricter 21 checking what clients pass to podselect() 22 23 01-Jun-2013 Marek Rouchal <marekr@cpan.org> 24 ----------------------------------------------------------------------------- 25 Version 1.61 26 + CPAN#85656 fix typos in comments 27 28 29 31-Jan-2013 Marek Rouchal <marekr@cpan.org> 30 ----------------------------------------------------------------------------- 31 Version 1.60 32 + removed Pod::Checker and Pod::Usage from this distribution - they are now 33 separate distros and are subjects to be refactored, to be based upon 34 Pod::Simple. Thanks to rjbs for reminding me of this. 35 36 37 25-Jan-2012 Marek Rouchal <marekr@cpan.org> 38 ----------------------------------------------------------------------------- 39 Version 1.51 40 + CPAN#74271: Pod::Parser should not flag L<text|hyperlink> 41 undo change CPAN#47473: L<alt text|URL> _is_ allowed (see discussion on 42 pod-people and p5p); confirmed by blead change; references: 43 http://code.activestate.com/lists/perl-pod-people/1690/ 44 http://code.activestate.com/lists/perl-pod-people/1393/ 45 http://perl5.git.perl.org/perl.git/commit/f6e963e4dd62b8e3c01b31f4a4dd57e47e104997 46 + bump all module versions (except Pod::PlainText) to 1.51 47 + update META.yml (thanks rjbs for the hint) 48 49 50 16-Jan-2012 Marek Rouchal <marekr@cpan.org> 51 ----------------------------------------------------------------------------- 52 Version 1.50 53 + fix whitespace (esp. CR [\r] related) issues with different Perl versions 54 on Windows (with Perl 5.8.8 [Activestate], and 5.6.1 [SUA]) 55 + merge latest core (5.14.x) changes to this distro 56 + CPAN#73446: fix minor POD error in InputObjects.pm 57 + CPAN#43955: podchecker fails to detect superfluous =cut directive: 58 implemented (and extended by a check for superfluous =pod commands) and 59 documented in Pod::Checker; also added a note in the POD of all modules 60 that they are part of the Pod::Parser distribution 61 + CPAN#46695: use consistent version (1.50) for distribution and all Pod:: 62 modules in this distro (except for Pod::PlainText, which stays at 2.05) 63 + CPAN#52086: mismatch between distro and module version: 64 same as above 65 + CPAN#55121: correction for Pod::Find and t/pod/find.t on VMS 66 + CPAN#47473: podchecker on L<> url with alt text 67 ... causes an error in Pod::Checker now 68 + CPAN#57954: Pod::Usage does not find perldoc when perl is relocatable 69 ... use $Config{scriptdirexp} instead of scriptdir 70 + CPAN#61223: podchecker notice missing blank line before command 71 implemented with more tests in poderrs.t and self test of all *.pms 72 + CPAN#66614: parse of no final newline vs perl -w 73 ... a rare case, but fixed nevertheless 74 + CPAN#68157: Pod-Parser-1.38/lib/Pod/Usage.pm question/bug 75 ... pass through formatting options to Pod::Text 76 + CPAN#70771: mishandles symbolic links in @INC 77 ... fixed by making the paths in @INC absolute, using Cwd::abs_path() 78 + CPAN#71139: 3 possible optimisations 79 ... applied 80 + several other rt.cpan.org tickets processed and closed 81 82 83 09-Feb-2008 Marek Rouchal <marekr@cpan.org> 84 ----------------------------------------------------------------------------- 85 Version 1.38 86 + missed one (important) line from one of the patches below in pod2usage2.t 87 No change in the *.pm files 88 89 90 04-Feb-2008 Marek Rouchal <marekr@cpan.org> 91 ----------------------------------------------------------------------------- 92 Version 1.37 93 + fixed resource links in META.yml 94 + address CPAN#42695 with a minor change in PlainText, although not solving 95 it completely; the 'loose' option now applies to all =headN headings 96 + address failures of find.t on Win32 (cpantesters) - root cause was a 97 mismatch of directory names like "Progra~1" (short/long file names) 98 + include the following bleadperl changes: 99 * Blank lines "between" verbatim sections are now acceptible: 100 http://perl5.git.perl.org/perl.git/commitdiff/caa547d 101 * Be less picky about what constitutes "numeric lists" in Pod: 102 http://perl5.git.perl.org/perl.git/commitdiff/4df4f5d 103 * Changes made to contains_pod.t when upgrading to 1.34: 104 http://perl5.git.perl.org/perl.git/commitdiff/fb59f97 105 * Fix paths on new pod2usage2 tests to work in the core. 106 http://perl5.git.perl.org/perl.git/commitdiff/222046efb22c183703fea2b30db76296ab782e89 107 * Make t/pod/pod2usage2.t work on case insensitive file systems. 108 http://perl5.git.perl.org/perl.git/commitdiff/767c16ab361d1225fb153423fb22b590c1e0c7ea 109 Thanks to Nicholas Clark, Steve Hay, Jerry D. Hedden for the patches 110 + removed \r from t/pod/usage2.pod 111 112 113 19-Jan-2008 Marek Rouchal <marekr@cpan.org> 114 ----------------------------------------------------------------------------- 115 Version 1.36 116 - Did I say this package is dead, and there won't be any updates? 117 This release is fixing all open CPAN RT issues, hopefully this is the 118 last version forever... 119 + Ironed out the most severe issues reported by perlcritic, updated 120 META.yml 121 + Adapted Makefile.PL such that CPAN should recognize dependencies better 122 + CPAN#30672: Merged the minor change (recognize =encoding) from 5.10.0, 123 along with a few test improvements - thanks Adriano Ferreira for the patch 124 + Assimilated changes from 5.8.9 on podchecker.PL 125 + CPAN#23618: replace $Config{privlib} with privlibexp to avoid problems 126 with installation paths like ~user. Thanks clonezone for the patch 127 + CPAN#24983: document that parse_from_file() accepts also file handle 128 references and objects that support the regular IO interfaces 129 + added a little tweaking of Test::Builder to pod2usage2.t, which 130 should solve the problem with older Perls (5.005) 131 + CPAN#29749: applied patch to squelch noise from older blib 132 versions. Thanks SREZIC 133 + CPAN#29978: fixed insecure argument for running perldoc from 134 pod2usage() in -T scripts 135 + CPAN#30043: add =cut as an indentifier for POD in Pod::Find. 136 Thanks NATERAJJ for the patch 137 + CPAN#33020: Pod::Usage will by default look for both SYNOPSIS and 138 USAGE - since SYNOPSIS is the traditional section name, while USAGE 139 is suggested by perlcritic 140 + CPAN#33150: made sure that pod2usage(-message=>'...') always 141 appears, even when using perldoc 142 + CPAN#35514: add some documentation and a test to demonstrate how 143 pod2usage works together with Pod::Find::pod_where to show module PODs 144 + CPAN#38648: pod2usage(-verbose => 1) now accepts whitespace after 145 SYNOPSIS. Thanks dwierenga AT valueclick DOT com for the patch 146 + CPAN#38747: two important bug fixes and one improvement, all around 147 pod2usage(-sections). Many thanks David DOT Purdie AT erggroup DOT com 148 for the patches and suggestions. This fixes also CPAN#41136 149 + CPAN#41135: allow subheadings in OPTIONS/ARGUMENTS and 150 pod2usage(-verbose => 1) - they are now printed as well 151 + CPAN#42141: find.t fix for VMS in UNIX compatible mode. Thanks a lot 152 malmberg AT Encompasserve org for the patch 153 + Fixed inconsistencies between Pod::PlainText and Pod::Text regarding 154 selection of sections; now both should work according to the docs of 155 Pod::Usage 156 + verified on perl 5.8.8, 5.8.7, 5.6.1, 5.005.03 on Solaris 8 (Sparc), 157 perl 5.6.1, 5.8.7 on RedHat Linux 7.2, 158 perl 5.10.0 on Windows 2000, 159 perl 5.8.0, 5.6.1, 5.8.7, 5.8.8 on RedHat Enterprise Linux 3.0, 160 perl 5.8.5, 5.6.1, 5.8.7, 5.8.8 on RedHat Enterprise Linux 4.0 161 with various combinations of Pod::Text, Test::More etc. 162 163 164 27-Oct-2005 Marek Rouchal <marekr@cpan.org> 165 ----------------------------------------------------------------------------- 166 Version 1.35 167 + Did I say this package is dead? 168 + Make version of distro equal Pod::Parser::VERSION on popular 169 request - although this is IMHO not a prerequisite (CPAN#17069) 170 + Check for core changes to this module dist - there are none 171 + Added support for =head3 in Pod::PlainText - who on earth is 172 using that one? Thanks David Wheeler dwheelerATcpanDOTorg (CPAN#17515) 173 + Added support even for =head4 in Pod::PlainText (CPAN#15989) 174 + Allow Pod::Usage to work with new and old versions of Pod::Text 175 Thanks steveiATfisharerojoDOTorg for the patch (CPAN#16368) 176 + fall back to $PAGER|more if perldoc fails in Pod::Usage (CPAN#16901) 177 + CPAN#17202 is somehow solved in this release 178 + try to address CPAN#16959 by removing all extra line end characters 179 in line comparisons in test 180 + added test to catch CPAN#17997, should it ever be a problem 181 + address CPAN#19137 by a CAVEAT in Pod::Parser 182 + CPAN#19933: PATCH to support L<Weblink|http://www.whatver.site> 183 thanks LGODDARD 184 + CPAN#21010: Calling parse_from_file twice causes errors 185 my (...) = ... if(...); # is no good - had to split that 186 + CPAN#15718: Documentation: -section argument should be -sections 187 + minor change in Select.pm to solve an issue on Cygwin with ^M 188 + CPAN#17997: Regression: -input no longer works with __DATA__ with -verbose => 2 189 thanks CLOTHO for the patch 190 + ran a rough POD spell check 191 + fixed test failure on Windows in pod2usage.t (CPAN#14928) 192 193 194 04-Oct-2005 Marek Rouchal <marekr@cpan.org> 195 ----------------------------------------------------------------------------- 196 Version 1.34 197 + yi luo luoyi.ly at gmail.com noticed that -x _ does not do the right 198 thing on Windoze with *.bat files, where -x $file does 199 + JHOBLITT at cpan.org sent a patch to make contains_pod accept files that 200 start with =head on the first line. Test integrated with slight modifications 201 (to avoid dependency on File::Temp and others) (CPAN#14871) 202 + applied http://public.activestate.com/cgi-bin/perlbrowse?patch=25588 203 (thanks H.Merijn Brand and Rafael Garcia-Suarez) 204 Neverending story... 205 206 05-Sep-2005 Marek Rouchal <marekr@cpan.org> 207 ----------------------------------------------------------------------------- 208 Version 1.33 209 + CPAN#14194: I<> in Pod::Usage overridden to just show the text, no ** around 210 + CPAN#14195: wrong exit value for pod2usage(0) 211 + CPAN#14315: allow for arbitrary URLs 212 I hope this will do now - Pod-Parser is DEAD! 213 214 215 15-Jun-2005 Marek Rouchal <marekr@cpan.org> 216 ----------------------------------------------------------------------------- 217 Version 1.32 218 + applied patch by radek at pld-linux dot org that fixes a regression of 219 broken support of Pod::Parser input from objects (CPAN#13203) 220 221 222 01-Jun-2005 Marek Rouchal <marekr@cpan.org> 223 ----------------------------------------------------------------------------- 224 Version 1.31 225 + applied patch suggested by ITUB AT cpan.org (remove spurious setting of 226 $_), which significantly reduces runtime (CPAN#12327) 227 + fixed regression in podselect.PL and pod2usage.PL reported by Steve Peters 228 steve AT fisharerojo.org; no change in the actual code, just the build 229 script; the fix in Pod::Usage was already in 230 + downgraded error about nested styles (e.g. C<...C<...>...>) to a warning 231 (CPAN#12240) 232 + added the brackets to gensym() to make use strict happy in Perls < 5.006 233 (CPAN#5613) 234 + pod2usage() is more tolerant wrt. =head1 SYNOPSIS\s* (CPAN#6329) 235 + require at least File::Spec 0.82 as suggested in CPAN#8709 236 + include the -noperldoc option in Pod::Usage as suggested in CPAN#11525 237 This is the last time an enhancement was implemented! >:-> 238 + fixed the test t/pod/find.t to not depend on perlfunc (CPAN#6679); 239 now the test also uses t/pod/testpods/lib/Pod/Stuff.pm; 240 this implicitely fixes also CPAN#8742 241 + slightly updated META.yml 242 + made sure that CPAN#7486 is _really_ integrated 243 + make -quiet DWIM in Pod::Checker (CPAN#11884) 244 245 246 12-Mar-2005 Marek Rouchal <marekr@cpan.org> 247 ----------------------------------------------------------------------------- 248 Version 1.30 249 + changed dist name to Pod-Parser 250 + pushed versions of .pm files to 1.30 as far as CPAN permits, i.e. don't 251 decrease existing versions > 1.30 252 + added end of support announcement 253 + cross-checked this version with the Perl5 core version and merged a 254 couple of changes 255 256 257 08-Feb-2005 Marek Rouchal <marekr@cpan.org> 258 ----------------------------------------------------------------------------- 259 Version 1.29 - not released 260 + integrated patch by tony at irational dot org to support printing of 261 custom sections in Pod::Usage 262 + integrate change 22886 on Pod::Find (Rafael Garcia-Suarez and 263 Alan Burlison): Pod::Find should ignore SCM files and dirs 264 + integrate a patch by Russ Allbery rra at stanford dot edu to support 265 Pod::Usage together with Pod::Text based on Pod::Simple or Pod::Parser 266 + integrated #23327 (CPAN#7486) (fix warnings with NOEXIT) 267 + integrated patch by Radoslaw Zielinski radek at karnet dot pl that 268 allows to specify IO::String objects as output file handles 269 270 271 08-May-2004 Marek Rouchal <marekr@cpan.org> 272 ----------------------------------------------------------------------------- 273 Version 1.28 274 + bumped version of ParseUtils to make CPAN indexer happy 275 276 277 08-May-2004 Marek Rouchal <marekr@cpan.org> 278 ----------------------------------------------------------------------------- 279 Version 1.27 280 + reviewed a bunch of rather old emails and verified that all that is in 281 + added patch by Michael G Schwern schwernATpobox.com to suppress spurious 282 warning about / and | in L<> hyperlinks 283 284 285 286 24-Nov-2003 Marek Rouchal <marekr@cpan.org> 287 ----------------------------------------------------------------------------- 288 Version 1.26 289 + bumped version of Pod::Parser on request by Jarkko Hietaniemi 290 + included a patch by Peter Prymmer PPrymmerATfactset.com to fix 291 the expansion of the scripts on VMS 292 + included fix to support PodParser as core module from 5.6.0 on 293 (Autrijus Tang autrijusATautrijus.org) 294 + updated README and other files to reflect change in maintenance, 295 in consequence updated Pod::PlainText and some t/...xr 296 297 298 27-Aug-2003 Marek Rouchal <marekr@cpan.org> 299 ----------------------------------------------------------------------------- 300 Version 1.25 - not released 301 + Merged bleadperl-5.8.1 into this distribution. Added a couple of 302 if($ENV{PERL_CORE}) statements to ease the maintenance of core/module. 303 304 305 26-Aug-2003 Marek Rouchal <marekr@cpan.org> 306 ----------------------------------------------------------------------------- 307 Version 1.24 308 + removed the "BETA STAGE" from Pod::Checker - it is now stable 309 + added patch by Micheal Schwern schwernATpobox.com to silence Pod::Checker 310 (the module) and let podchecker (the script) print the diagnostics. Added 311 note in the Pod::Checker documentation. 312 + Tom Wyant twyant4ATcomcast.net reported that Cygwin also has the 313 core pods in pods/ - fixed in Pod::Find 314 + changed the logic in Pod::InputObjects a bit to speed up the parser, 315 based on a suggestion by Mark Jason Dominus mjdATplover.com. The 316 original proposal was however too much of a revolution to the existing 317 behaviour. 318 + Some minor performance improvements in Pod::Parser (profile analysis) 319 320 321 12-Jun-2003 Marek Rouchal <marekr@cpan.org> 322 ----------------------------------------------------------------------------- 323 Version 1.23 324 + fixed a bug in Usage.pm, spotted by Kees Cook keesATosdl.org: 325 the special value 'NOEXIT' has not been treated appropriately 326 + added INSTALLDIRS=perl as suggested by M. Schwern 327 328 329 23-Apr-2003 Marek Rouchal <marekr@cpan.org> 330 ----------------------------------------------------------------------------- 331 Version 1.22 332 + fixed a bug in Usage.pm, spotted by Harry Felder harryATrentec.com: 333 the path to perldoc is $Config{scriptdir}, not (always) $Config{bin} 334 335 336 07-Nov-2002 Marek Rouchal <marekr@cpan.org> 337 ----------------------------------------------------------------------------- 338 Version 1.21 339 + fixed a bug in the find.t test 340 + make test work ok on MacOS/darwin, which strangely enough has its 341 perlfunc.pod in a "pods" directory, rather than "pod" 342 343 344 31-Oct-2002 Marek Rouchal <marekr@cpan.org> 345 ----------------------------------------------------------------------------- 346 Version 1.20 347 + Merged changes of perl-5.8.0 core back into this distribution: 348 - MacOS specific changes 349 - english orthography corrections 350 - adaptations to perlpodspec (e.g. =over does not require argument) 351 + Adapt the link text to perlpodspec (drop extra text like 352 `elsewhere in this document', `the ... manpage' etc.) 353 + Allow dashes in Pod hyperlinks, e.g. L<Inline::C-Cookbook> 354 (on request by Slaven Rezic and Mark Overmeer) 355 356 357 29-Aug-2002 Marek Rouchal <marekr@cpan.org> 358 ----------------------------------------------------------------------------- 359 Version 1.19 360 + Changed t/pod/testp2pt.pl to always choose Pod::PlainText for the tests, 361 do not rely on Pod::Text, which is not included in this package 362 (as suggested by Richard Clamp <richardc@unixbeard.net>) 363 + Fixed spurious warning in Pod::ParseUtils reported by Rafael Garcia-Suarez 364 <rgarciasuarez@free.fr>: Inside "" the characters | and / are ok 365 + Added a num_warnings method to Pod::Checker - requested by 366 brian d foy <comdog@panix.com> 367 + Added a warning if =head2 comes before a =head1 - one TODO item less! 368 369 01-Sep-2000 Brad Appleton <bradapp@enteract.com> 370 ----------------------------------------------------------------------------- 371 Version 1.18 372 + Fixed error in failing recognize empty C<< >> sequences 373 + Modified pod2usage to use perldoc if ultra-verbose mode is set 374 and input is a filename and output is STDOUT (so now it doesnt just 375 print the manpage, it pretty prints it and paginates it) 376 + Allowed -exitval => NOEXIT to be given to pod2usage to instruct it 377 NOT to exit the running script. 378 + Applied VMS patches from Tim Jennes to t/pod/find.t and lib/Pod/Find.pm 379 380 25-Jul-2000 Marek Rouchal <marek@saftsack.fs.uni-bayreuth.de> 381 ----------------------------------------------------------------------------- 382 Version 1.17 383 + included small fixes by Tim Jenness <t.jenness@jach.hawaii.edu> to 384 Pod::Find and t/pod/find.t 385 + extended logic in Pod::Find to search for pod/ subdirectories in all 386 given subdirectories (in pod_where function) to find e.g. "perlfunc". 387 Thus pod_where could be used by perldoc. 388 + added check for recent File::Spec version in Makefile.PL 389 + updated Makefile.PL, CHANGES, README 390 391 07-Jul-2000 Marek Rouchal <marek@saftsack.fs.uni-bayreuth.de> 392 ----------------------------------------------------------------------------- 393 Version 1.16 394 + included two subs suggested by Tim Jenness <t.jenness@jach.hawaii.edu> 395 in Pod::Find (pod_where and contains_pod) and included a test in 396 t/pod/find.t 397 + updated Makefile.PL, CHANGES and TODO 398 399 400 03-Jul-2000 Marek Rouchal <marek@saftsack.fs.uni-bayreuth.de> 401 ----------------------------------------------------------------------------- 402 Version 1.15 403 + introduced -quiet option for Pod::Checker to suppress diagnostic 404 output when Pod::Checker is used to eat POD and output text. 405 + improved documentation in Pod::Checker 406 + improved code coverage of t/pod/poderrs.t 407 + updated TODO 408 409 410 04-Jun-2000 Marek Rouchal <marek@saftsack.fs.uni-bayreuth.de> 411 ----------------------------------------------------------------------------- 412 Version 1.14 413 + fixed wrong value in Pod::Parser concerning whitespace lines 414 + added check in podchecker whether argument is a directory 415 + introduce additional warning level: this suppresses the complaints 416 about unescaped <>, but the check is enabled when the wrning level is 417 increased: podchecker -warn -warn 418 adapted documentation appropriately 419 + Pod::Hyperlink now parses L<open(2)> again, but gives a warning. The 420 calling programs have to check themselves for what to do with pages 421 like open(2). 422 + Changed POD of several modules so that they conform to podchecker :-) 423 424 425 14-Mar-2000 Marek Rouchal <marek@saftsack.fs.uni-bayreuth.de> 426 16-Mar-2000 Brad Appleton <bradapp@enteract.com> 427 ----------------------------------------------------------------------------- 428 Version 1.13 429 + Improved support of Win32 and OS/2 platforms by using File::Spec in 430 Pod::Find 431 + strip .bat and .cmd on Win32 and OS/2, respectively 432 + removed all tabs from Pod::Find and reviewed POD documentation 433 + finally fixed t/pod/ptestpchk.pl to ignore any and all non-word-chars 434 in pathnames. No more special casing filenames for MacOS, NT, VMS, etc 435 just for the sake of passing the t/pod/poderrs.t test! 436 437 438 11-Mar-2000 Brad Appleton <bradapp@enteract.com> 439 ----------------------------------------------------------------------------- 440 Version 1.12 441 + Sync-up with patches from the 5.6 core distribution 442 + Require perl5.005 instead of 5.004 now that 5.6 is almost out 443 + Removed the t/pod/xtra tests from the distribution 444 + Ignore [\n\r] when looking for non-empty blank lines in Pod::Parser 445 + Added VMS file-unixification to test scripts 446 447 448 23-Feb-2000 Brad Appleton <bradapp@enteract.com> 449 Marek Rouchal <marek@saftsack.fs.uni-bayreuth.de> 450 ----------------------------------------------------------------------------- 451 Version 1.11 452 + Fixed Pod::Parser warnings about non-empty blank lines in code 453 + added note about extraction capabilities of Pod::Checker to README 454 + added collection of index entries X<...> (Pod::Checker) 455 + extended internal hyperlink node uniqueness check (Pod::Checker) 456 + added documentation in Pod::Checker for built-in methods 457 (nodes, hyperlinks, X<...> entries) 458 + minor cleanups (find_node in Pod::Cache::Item) and changed priority 459 in parsing L<...> (Pod::ParseUtils) 460 461 22-Feb-2000 Brad Appleton <bradapp@enteract.com> 462 ----------------------------------------------------------------------------- 463 Version 1.10 464 + bump up the version number to avoid confusion with a short-lived 465 version of 1.093-beta 466 467 21-Feb-2000 Brad Appleton <bradapp@enteract.com> 468 Marek Rouchal <marek@saftsack.fs.uni-bayreuth.de> 469 ----------------------------------------------------------------------------- 470 Version 1.093 471 + Pod::Parser now warns about non-empty blank lines matching /^\s+$/ 472 + got rid of special handling of '=>' and '=>' inside C<..> and instead 473 implemented the more general rules posted by Larry Wall on P5P allowing 474 /[A-Z]<...>/ and /[A-Z]<[<:]\s+...\s+[:>]>/ to deal with things like 475 embedded '->' and '=>' using whitespace, as in: C<< <=> >> and I<< <> >>. 476 + added proposals by Wolfgang Laun to Pod::Checker (more errors and 477 warnings): 478 - removed qr// so that code runs with Perl 5.004 479 - POD files can include '.' in the name. 480 - L<DBI(3)> now causes an error, correct is: L<DBI> 481 482 483 03-Jan-2000 Marek Rouchal <marek@saftsack.fs.uni-bayreuth.de> 484 ----------------------------------------------------------------------------- 485 Version 1.092 486 + added the Pod::Cache and Pod::Cache::Item code to Pod::ParseUtils. 487 + modified the README file. 488 489 15-Dec-1999 Marek Rouchal <marek@saftsack.fs.uni-bayreuth.de> 490 ----------------------------------------------------------------------------- 491 Version 1.091 492 + cleaned up Pod::Checker, especially documentation, updated test 493 + moved helper code to new module Pod::ParseUtils, added documentation 494 + added Pod::Find, along with a test 495 496 497 22-Oct-1999 Marek Rouchal <marek@saftsack.fs.uni-bayreuth.de> 498 ----------------------------------------------------------------------------- 499 Version 1.090 500 + Added several additional checks to Pod::Checker 501 + Pod::Checker detects files with no POD 502 + Pod::Checker prints warnings about inproper style 503 + Modified podchecker to use the -warnings option and the "empty POD" 504 status 505 + Added Pod::Hyperlink (internal in Pod::Checker for now) that parses 506 the L<> sequence into alttext, page and section 507 + Updated documentation 508 + Started adding callbacks so that Pod::Checker can be used also for 509 single-pass POD translators in the future 510 511 25-Sep-1999 Brad Appleton <bradapp@enteract.com> 512 ----------------------------------------------------------------------------- 513 Version 1.085 514 + Added a section on tree-based parsing to the PODs for Pod::Parser 515 + Added '-expand_text" callback-option to Pod::Parser::parse_text() 516 + Added ability to specify contents for Pod::InteriorSequence::new 517 + Added the notion of "parse-options" to enable/disable certain 518 parsing behaviors (see the section on "PARSING OPTIONS" 519 in the documentation for Pod::Parser) 520 + Added Pod::Parser::parseopts() 521 + Added the '-want_nonPODs' parse-option 522 + Added the '-process_cut_cmd' parse-option 523 + Fixed the '*child2parent*' functions in InputObjects so that they 524 dont invoke "can" or "isa" for unblessed scalar-refs. 525 526 03-Sep-1999 Brad Appleton <bradapp@enteract.com> 527 ----------------------------------------------------------------------------- 528 Version 1.084 529 + Added Russ Allbery's Pod::PlainText re-write 530 + Added some tests contributed by Russ Allbery 531 + Fixed Makefile.PL to install the supplied scripts 532 + Updated copyright messages 533 + Added an error/warning callback function to Pod::Parser. When specified, 534 it will call the user-provided function instead of "warn" when printing 535 error messages (This makes it easier for things like Pod::Checker to 536 capture and/or redirect error output). See Pod::Parser::errorsub(). 537 538 28-Jun-1999 Brad Appleton <bradapp@enteract.com> 539 ----------------------------------------------------------------------------- 540 Version 1.083 541 + Fixed problem with not defaulting to STDIN in parse_from_filehandle 542 (thanks to Russ Allbery for the patch) 543 + Fixed problem with != and -= (and <op>= in general) processing 544 inside of C<...> (thanks to Russ Allbery for this patch too) 545 546 28-Apr-1999 Brad Appleton <bradapp@enteract.com> 547 ----------------------------------------------------------------------------- 548 Version 1.082 549 + Fixed portability problems with Makefile.PL on MSWin32 systems 550 (thanks to Jan Dubois for showing how to do this!) 551 552 08-Apr-1999 Brad Appleton <bradapp@enteract.com> 553 ----------------------------------------------------------------------------- 554 Version 1.081 555 + Fixed warning message in Pod::Parser::parse_text when $expand_seq is undef. 556 + Fixed another problem with ignoring the contents of an interior sequence 557 if it was nothing but ')' inside the angle brackets (e.g. C<0>). 558 + Moved test files under t/ to t/pod, and added a subdirectory t/pod/xtra 559 for the extra tests that involve "included" files and processing its 560 own source (the "xtra" files are *not* part of what comes with the CORE 561 in Perl 5.006) 562 + Munged the Makefile.PL to be able to set TEST_FILES to t/pod/*.t and 563 t/pod/xtra/*.t (if it exists). This requires File::Spec so now you 564 need either File::Spec or Perl 5.005 or later to install this. 565 566 567 01-Mar-1999 Brad Appleton <bradapp@enteract.com> 568 ----------------------------------------------------------------------------- 569 Version 1.08 570 + Fixed a bug in obtaining options-hash in pod2usage() 571 + Modified test suite & tools to run as expected on more platforms 572 (the .t scripts now do a zero-exit if $ENV{ACTIVE_HARNESS} is set) 573 + Some more portability fixes for searching file-paths in Pod::Usage 574 (thanks to Chris Nandor) 575 + Changed the distribution directory structure a little bit. Instead 576 of all the scripts and modules at the top level directory, the scripts 577 are now in the 'scripts/' subdirectory and the modules are now in the 578 'lib/Pod/' subdirectory. 579 580 581 16-Jan-1999 Brad Appleton <bradapp@enteract.com> 582 ----------------------------------------------------------------------------- 583 Version 1.07 584 + Added Pod::Checker and podchecker.PL 585 + Fixed line-counting errors in Pod::Parser::parse_from_filehandle() 586 + Added raw_text method for Pod::ParseTree 587 + Documented optional hash-ref arg to Pod::Parser::parse_text and replaced 588 '-expand' with '-expand_seq' and '-expand_ptree' 589 + parse_text now has sequences point to the parents they are nested inside 590 of as soon as they are created (instead of after they are appended to 591 the parent, which may occur *after* expansion) 592 + Added the regression test-suite to the distribution in the t/ subdirectory. 593 Its not very exhaustive, but its a start. 594 + Now uses File::Spec, which is bundled with perl 5.005 and later, but if 595 you have perl 5.004 you may need to download File::Spec from CPAN 596 597 598 09-Nov-1998 Brad Appleton <bradapp@enteract.com> 599 ----------------------------------------------------------------------------- 600 Version 1.061 601 + Minor additions to v1.06 602 * Pod::InteriorSequence::nested was buried inside POD directives. 603 I had to add the `=cut' between the subroutine docs and its code. 604 605 * Removed some of the documentation for things in Pod::Parser and 606 Pod::Input object that the user probably doesnt need to know. 607 608 * Split out "CHANGES" and "TODO" into separate files from the README 609 610 611 22-Oct-1998 Brad Appleton <bradapp@enteract.com> 612 ----------------------------------------------------------------------------- 613 Version 1.06 614 + SIGNIFICANT CHANGES (POSSIBLE BACKWARD INCOMPATIBILITIES) 615 * Pod::InputObjects::ParseTree object ADDED. This object corresponds 616 to a parse-tree of parsed pod paragraph text. Every node in the 617 parse-tree is either a text-string, or a Pod::InteriorSequence 618 that has yet to be expanded. 619 620 * Pod::Parser::parse_text ADDED!!! This routine parses some pod input 621 text and returns a parse-tree as the result. This is VERY useful for 622 people who cant rely on strict bottom-up expansion of interior 623 sequences. Now they can get the parse-tree and expand sequences 624 themselves in whatever order they require. 625 626 * Pod::Parser::interpolate PARAMETER CHANGE, it *no* *longer* takes a 627 regexp as its second parameter!!! It used to accept a regular 628 expression signifying the end of parsing conditions and pass it to 629 _interpolate_bottom_up. It now takes a line-number as the second 630 arg. 631 632 * Pod::Parser::_interpolate_bottom_up has been *REMOVED*!! Pod::Parser 633 no longer uses a recursive routine to parse interior sequences. 634 635 * The following Pod::Parser subroutines now take the current line-number 636 as an ADDITIONAL PARAMETER: command, textblock, verbatim, interpolate, 637 preprocess_line, preprocess_paragraph, parse_paragraph. 638 639 * REMOVED the Pod::Parser::total_lines method 640 641 * ADDED the nested() method to Pod::InteriorSequence 642 643 * REMOVED the following methods from Pod::InputSource: num_lines, 644 file_line, and ADDED the method filename instead. 645 646 * REMOVED the _CMD_SEQUENCES data-field and sequences() method from 647 Pod::Parser. If you need to know the parent of a nested interior 648 sequence, then invoke the nested() method of that sequence. 649 650 + OTHER CHANGES 651 - Added the "-pathlist" options to Pod::Usage and pod2usage 652 - Made Pod::Usage a tad more portable for DOS and MSWin32 653 - Got rid of a rogue '#' in podselect that was in front of a needed 654 "use" statement. 655 - Fixed a bug in Pod::Parser::_interpolate_bottom_up that made it stop 656 interpolating interior sequences after the first line of a paragraph. 657 658 12-Feb-1998 Brad Appleton <bradapp@enteract.com> 659 ----------------------------------------------------------------------------- 660 Version 1.05 661 - Fixed a bug in Pod::Usage (it was using an obsolete name to access an 662 attribute instead of using the new access method). 663 - Removed the use of $`, $&, and $' throughout all modules in this package. 664 665 Version 1.04 666 22-Dec-1997 Brad Appleton <bradapp@enteract.com> 667 ----------------------------------------------------------------------------- 668 Version 1.04 669 + SIGNIFICANT CHANGES 670 * Created a Pod/InputObjects.pm and moved the details of input streams 671 and interior sequences into appropriately named objects defined 672 in this file. 673 * Pod::PlainText now handles =for and =begin/=end 674 * Added the curr_headings() method to Pod::Select 675 * Fixed a few very simple but very stupid errors with improper version 676 numbers in the .pm files. 677 * Pod::PlainText now inherits from Pod::Select (instead of Pod::Parser) 678 because it needs to use the curr_headings() method. 679 680 681 24-Sep-1997 Brad Appleton <bradapp@enteract.com> 682 ----------------------------------------------------------------------------- 683 Version 1.03 (major revision) 684 + SIGNIFICANT CHANGES 685 * If a POD directive begins with '==' instead of '=', then that line 686 is considered a paragraph by itself (you dont need a blank line 687 before you begin the next paragraph). NOTE that this only works 688 for the *beginning* of a paragraph!! If the '==' begins a line 689 in the *middle* of a paragraph, then it receives no special treatment 690 and is not considered to be the beginning of a new POD directive. 691 If this added convenience seems confusing at first, just remember the 692 following phrases: 693 "LESS IS MORE" -- LESS equals signs need MORE newlines! 694 "MORE IS LESS" -- MORE equals signs need LESS newlines! 695 As long as you dont forget that the '=' on a POD directive always 696 comes *before* the newline that ends the paragraph (so the '=' is 697 associated with the first word of each phrase) you should be fine. 698 699 * The '=pod' command *IS* *NOW* *PASSED* TO Pod::Parser::command()! 700 701 * ALL INSTANCE DATA FIELDS HAVE BEEN RENAMED! Rather than using the new 702 field names, you should use the newly provided field access methods to 703 get/set private instance data. These are as follows: 704 705 Accessor Method Old Field Name 706 ------------------- ------------------- 707 cutting() CUTTING 708 output_file() OUTFILE 709 output_handle() OUTPUT 710 input_file() INFILE 711 input_handle() INPUT 712 total_lines() LINE 713 total_paragraphs() PARAGRAPH 714 input_streams() INPUT_STACK 715 top_stream() INPUT_TOP 716 sequence_commands() SEQUENCES 717 718 * The last parameter passed to the command() and interior_sequence() 719 methods has changed. Please see the documentation! 720 721 * The stack of interior sequences being processed is NO LONGER an 722 array of text-strings. It is now an array of hash-refs! 723 724 * Renamed my version of Pod::Text to Pod::PlainText to avoid some nasty 725 problems it caused for CPAN. 726 727 * The method Pod::Parser::interpolate() NO LONGER MODIFIES its first 728 argument (which means the argument doesnt have to be an l-value)! 729 This method is now a wrapper which invokes the new method named 730 _interpolate_bottom_up(). This new method *is* recursive and *does* 731 modify its first argument. 732 733 * _interpolate_bottom_up() contains a small but ugly *hack* to allow 734 '->' and '=>' to remain untouched inside of C<...> (without having 735 to use the E<gt> escape sequence) PROVIDED THAT there is something 736 to the left of it OTHER THAN another '-' or '='. 737 738 * The 'select()' and 'want_section()' methods have moved from Pod::Parser 739 into Pod::Select. 740 741 * All callback and callback-related methods have moved into the new 742 module Pod:::Callbacks (which is NOT YET FINISHED for this release). 743 744 22-May-1997 Brad Appleton <bradapp@enteract.com> 745 ----------------------------------------------------------------------------- 746 Version 1.02 747 - Added the ability to register callbacks for =xxxx paragraphs and other 748 paragraphs. This means that one could (for example) register a temporary 749 callback after =item is seen to handle the very next paragraph and then 750 unregister itself. The methods added were add_callbacks and rm_callbacks. 751 Also, a private method invoke_callbacks was added to go about the business 752 of invoking callbacks. The callback mechanism Ive implemented is extremely 753 flexible and also way more complex than Id like (and hence requires lots 754 more documentation than I would like). Also, the interfaces to add_callbacks 755 and rm_callbacks tries to be very flexible in the number and type of 756 arguments you can give it. This is probably too flexible to the point 757 of being too difficult to figure out how to use. My callback mechanism 758 is very powerful but I think the interface to it is lousy and far too 759 complex. I am desperately in search of a way to make it smaller and 760 simpler without removing too much functionality. If you have any ideas 761 about how to do this PLEASE SHARE THEM WITH ME! 762 763 - Got rid of =pod pragmas. P5P has decided to use =for, and =begin/=end 764 instead and Ill just handle those like regular commands. NOTE THAT THIS 765 MEANS THE command() METHOD SHOULD NOW EXPECT TO BE PASSED =pod COMMANDS. 766 767 - Expanded the documentation for Pod::Usage to be (hopefully) a little less 768 confusing regarding the various different invocation styles. Many thanks 769 to Steven McDougall <swmcd@world.std.com> for spending many hours of 770 assistance toward this goal. 771 772 - Fixed Pod::Text to use the proper indentation for nested '=item' lists 773 and to handle consecutive =item paragraphs. (Thank you to Diab Jerious 774 <djerius@cfa.harvard.edu> for helping me with this one.) 775 776 - Fixed a bug in Pod::Parser that was causing the argument to =over to be 777 a newline instead of the empty string when no "over count" was given. 778 779 05-Sep-1996 Brad Appleton <bradapp@enteract.com> 780 ----------------------------------------------------------------------------- 781 Version 1.01 782 - Commented out "use diagnostics" in all modules 783 - Made use of "use vars" 784 - Added the instance variables $self->{INPUT_STACK} and $self->{INPUT_TOP} 785 to Pod::Parser and made it possible to use the parse_from_file() and 786 parse_from_filehandle methods() to process "included" files (in addition 787 to normal pods that dont "include" other files). 788 - Added MSG option/key to pod2usage(). 789 790 19-Aug-1996 Brad Appleton <bradapp@enteract.com> 791 ----------------------------------------------------------------------------- 792 Version 1.00 (first "official" release): 793 - Renamed Pod::Filter to Pod::Parser at Kenneth Albanowski's recommendation. 794 - Moved podselect() into its own separate module Pod::Select to avoid 795 unnecessary namespace pollution in Pod::Parser. 796 - Renamed several methods and added another preprocessing method in 797 Parser.pm. 798 - Pod::Parser now keeps track of the current line and paragraph number 799 and the current input and output file names. 800 - Fixed parse_from_filehandle() to recognize a line matching /^\s+$/ as a 801 paragraph terminator. 802 - Included Pod::Usage and Pod::Text as part of the PodParser distribution 803 rather then packing and releasing each module separately. 804 - Removed pod2text.PL and added pod2usage.PL 805 806 807 07-Aug-1996 Brad Appleton <bradapp@enteract.com> 808 ----------------------------------------------------------------------------- 809 Initial release of version 0.01 to garner some feedback. This release was 810 actually three separate "initial" releases of Pod::Parser, Pod::Text, and 811 Pod::Usage which were originally named Pod::Filter, Pod::PlainText, and 812 Pod::Usage (respectively). 813 814 815