1 # ChangeLog for Pod::Simple dist 2#--------------------------------------------------------------------------- 33.43 2021-06-28 Karl Williamson <khw@cpan.org> 4 - Remove pod markup from README 5 - Update homepage to metacpan 6 - "use" not "require" Pod::Simple::TiedOutFH, (PR#131, Jim Keenan) 73.42 2020-11-10 Karl Williamson <khw@cpan.org> 8 - Drop EUMM version prereq, Graham Knop++ 93.41 2020-10-09 Karl Williamson <khw@cpan.org> 10 - Factorize tests functions in one helper module, Nicolas Rochelmagne++ 11 - Support =head5, =head6, John M. Gamble++ 12 - Support SOURCE_DATE_EPOCH, Bernhard M. Wiedemann++ 13 - Enforce warnings for tests, Nicolas Rochelmagne++ 14 - Add github CI, atoomic++ 15 - suppress "UTF-16 surrogate 0xd800" warning, Shoichi Kaji++ 163.40 2019-10-23 Karl Williamson <khw@cpan.org> 17 - Fixed iusse #108, Roy Storey++ 18 - Make case sensitivity determination overridable by user, Kenneth 19 Ölwing++ 20 - Add expand_verbatim_tabs() method, which also can turn off 21 expansion, fixing #110 223.39 2019-06-30 Karl Williamson <khw@cpan.org> 23 - Fixed JustPod not opening file with :raw. Spotted by Dave Mitchell. 24 Fixed by James Keenan 25 - Fixed garbage line looking like pod. Spotted by Todd Rinaldo. 26 - Finished fixing Issue 95 by adding note that = in column 1 can be 27 misinterpreted as pod. 28 293.38 2019-05-30 Karl Williamson <khw@cpan.org> 30 - Removed some alien files that somehow got in the tar, including a copy 31 of Pod::Escapes. Spotted by Petr Pisar++ 32 333.37 2019-05-30 Karl Williamson <khw@cpan.org> 34 - Suppressed some expected diagnostics under harness 35 - Pod::Simple now depends on the 'if' module 36 373.36 2019-05-15 Karl Williamson <khw@cpan.org> 38 - Added Pod::Simple::JustPod to extract the pod lines from a file 39 - Improved detection of input encoding CP1252 vs UTF-8 40 - Fixed github issue #79, =cut event out of order 41 - Fixed github issue #85, verbatim_indent doesn't work on HTML 42 - Fixed github issue #89, css files refer to themselves 43 - Fixed github issue #92, broken RTF with Unicode inputs 44 - Extended RTF to handle Unicode code points above 0xFFFF 45 - Nested L<> is now flagged as an error 46 - Turned off negative repeat count does nothing warnings 47 - Fixed/improved some docs about this distribution 48 493.35 2016-11-29 Karl Williamson <khw@cpan.org> 50 - Needed to 'make manifest' before uploading to CPAN. No changes beyond 51 version bump 52 533.34 2016-11-29 Karl Williamson <khw@cpan.org> 54 - Stabilize t/search50.t. Thanks to rurban for the patch! 55 - Turn off utf8 warnings when trying to see if a file is UTF-8 or not. 56 573.32 2015-11-02 Marc Green <marcgreen@cpan.org> 58 - Fixed failing tests on Windows. Thanks to A. Sinan Unur for the 59 patch! 60 61 - Switched debugging output from STDOUT to STDERR. Should rarely be 62 used, but modules that do depend on debugging output might need to 63 change how they handle it. Patch from Karl Williamson (GitHub Pull 64 Request #76). 65 66 - Added errata_seen() to make POD errors easily accessible. Thanks to 67 Sean Zellmer for the pull request! 68 693.31 2015-08-23 Marc Green <marcgreen@cpan.org> 70 - No changes since 3.30_1. 71 723.30_1 2015-07-19 Marc Green <marcgreen@cpan.org> 73 - Simplified the detection of case-insensitivity in Pod::Simple::Search. 74 75 - Fixed "Use of uninitialized value $1 in lc" warning in 76 Pod::Simple::Search. 77 78 - If @INC includes the current directory symbol, '.', the survey() 79 method of Pod::Simple::Search no longer excludes it from its list 80 of directories to search. Instead, The survey() and find() methods 81 now both exclude duplicate directories from @INC (RT #102344). 82 83 - Moved source repository and updated links to new perl-pod GitHub 84 organization: https://github.com/perl-pod/pod-simple. 85 86 - Improved repository links and added GitHub issue tracking link to 87 the distribution metadata. 88 89 - Switched from File::Spec's catdir to catfile for path names, to 90 fix failures on VMS. Also now use Unix path semantics where 91 they're not required to be platform-specific. Thanks to Craig A. 92 Berry for the patch (RT #105511). 93 94 - Improved the example use of the 'html_encode_chars()' method in 95 the Pod::Simple::XHTML documentation. Patch from Randy Stauner. 96 973.30 2015-02-23 David E. Wheeler <david@justatheory.org> 98 - No changes since 3.29_6. 99 1003.29_6 2015-02-19 David E. Wheeler <david@justatheory.org> 101 - The survey() method in Pod::Simple::Search now ignores duplicate 102 files with varying lettercasing on case-insensitive file systems. 103 This allows 104 105 - When pondering files in a given directory, the survey() method in 106 Pod::Simple::Search now prefers files with extensions in the 107 following order: no extension, .pod, .pm, .plx, .pl. 108 109 - The find() method in Pod::Simple::Search now records the './pod' 110 subdirectory of each directory it considers in such a way as to 111 preserve its case on the file system. 112 113 - The find() method in Pod::Simple::Search now tries harder to find 114 the proper file on case-insensitive file systems when searching 115 for modules starting with "Pod". For example, when searching for 116 'Pod::Perldoc' it now returns a file ending in 'Pod/Perldoc.pm' 117 instead of 'Pod/perldoc.pod', as the latter is actually the 118 documention for the 'perldoc' program. 119 1203.29_5 2015-02-17 David E. Wheeler <david@justatheory.org> 121 - No changes except that the release tarball should no longer be empty. 122 1233.29_4 2015-02-16 David E. Wheeler <david@justatheory.org> 124 - Removed "Caveats" from the docs. Pod::Simple has been out of beta 125 for years. 126 127 - The survey() method in Pod::Simple::Search no longer assumes that 128 files ending in '.pod' are actually Pod. Like .pm and .pl files, 129 .pod files must contains at least one valid POD command, as 130 documented. This brings the behavior in line with find(), which 131 already required that .pod files contain Pod. 132 133 - The survey() method in Pod::Simple::Search now prefers files 134 ending in .pod over those ending in .pm, and .pm over those ending 135 in .pl, when it finds duplicate pod files for a given name. 136 1373.29_3 2015-02-11 David E. Wheeler <david@justatheory.org> 138 - Tightened up the first pass at recognizing a Pod command so that 139 fewer invalid Pod lines will be recognized. Suggested by Randy 140 Stauner. 141 142 - Fixed bug where Pod::Simple would attempt to call 143 utf8::unicode_to_native on Perl 5.6, where that function does not 144 exist. 145 146 - Typos and minor wordsmithing changes in Pod::Simple::Subclassing, 147 thanks to Randy Stauner. 148 149 - The Pod::Simple::Search survey() and find() methods now use the same 150 code for determining @INC directories to search. The only difference 151 is that find() also includes $Config::Config{'scriptdir'}. 152 1533.29 2015-01-13 David E. Wheeler <david@justatheory.org> 154 - NOTE: This will be the last release of Pod::Simple to support versions 155 of Perl earlier than 5.6. 156 157 - Fixed test failure for unsupported encoding on Perl 5.6. 158 159 - Removed unnecessary dependency on constant. Reported by Petr Pisar 160 (RT #85578). 161 162 - Many documentation and comment typos fixed by David Steinbrunner. 163 164 - Fixed issue when an encoding is declared via an '=encoding' directive 165 *after* Pod::Simple has already detected an encoding. Thanks to 166 Graham Knop for the patch and Patrice Dumas for the tests. 167 168 - Added '>&STDERR' as an output to better emulate 169 Pod::Parser::parse_from_file(). Florent Angly. 170 171 - Tidied the description of the different Pod::Simple interfaces, 172 with greater emphasis on the four different steps to subclassing. 173 Florent Angly. 174 175 - Added the 'top_anchor' attribue to Pod::Simple::HTML, to allow 176 specification of a custom top anchor format. Gabor Szabo. 177 178 - Fixed the text formatter to properly set the Text::Wrap overflow policy. 179 Thanks to Nigel Metheringham for the fix! 180 181 - Fixed mis-matched quotation marks when adding JavaScript elements 182 to the XHTML output. Patch from jonathancast. 183 184 - Fixed issues on EBCDIC. Patch from Karl Williamson (GitHub Pull 185 Request #58). 186 187 - Fixed bug where the value passed to Pod::Simple::XHTML's 188 html_css() method would be output twice. Thanks to Andrew Johnson 189 for the report (RT #99303). 190 191 - Documented the 'recurse' attribute of Pod::Simple::Search. 192 Thanks to Jim Keenan for the report (RT #91886). 193 194 - An error is no longer thrown when '=encoding' directives are found 195 on subsequent lines. Instead, we now log a an error message, 196 "Cannot have multiple =encoding directives" (RT #91757). 197 198 - The HTML and XHTML formatters now do a better job of preserving 199 lines in 'begin html' blocks. Fixes a bug that dates from 2002 200 (Perl RT#9385, CPAN RT #91851). 201 2023.28 2013-05-04 David E. Wheeler <david@justatheory.org> 203 - Removed use of 'done_testing' in t/white.t, which was added in 204 v3.27. Thanks to Paul Howarth for the catch. 205 206 - Fixed inproperly calculated number of skipped tests in t/xhtml01.t 207 when HTML::Entities is not intalled. 208 2093.27 2013-05-03 David E. Wheeler <david@justatheory.org> 210 - Added new warnings as defined by Pod::Checker, thanks to RJBS: 211 + "=over" without "=back" 212 + "L<>" starts or ends with whitespace 213 + raw "|" or "/" in "L<text|link>" text 214 215 - Added ->keep_encoding_directive, which is false by default, to 216 prevent formatters from emitting a document's '=encoding' 217 directive in most cases. That they emitted the encoding was a bug 218 introduced in v3.26 (RT #84093). Now, only the DumpAsText and 219 DumpAsXML formats set it to true. Patch from Patrice Dumas. 220 2213.26 2013-02-27 David E. Wheeler <david@justatheory.org> 222 - Fixed another test script to skip all tests when Encode is not 223 installed. 224 225 - Added 'encoding()' and 'detected_encoding()' to return the current 226 encoding and the encoding actually to decode the input file. The 227 value from "=encoding" is also now kept in the output tree. Patch 228 from Patrice Dumas (RT #74390). 229 2303.25 2013-02-16 David E. Wheeler <david@justatheory.org> 231 - Improved the warning when "=item" types mismatch within one 232 "=over"/"=back" block. 233 2343.24 2013-02-14 David E. Wheeler <david@justatheory.org> 235 - Fixed corner case bug for unlikely scenario in which non-UTF-8 236 text could be parsed as UTF-8. Grant McLean. 237 238 - XHTML IDs can no longer end with punctuation. Thanks to Smylers 239 for the patch. 240 241 - Fixed test failure on Perl 5.6.2. 242 243 - Changed the default installation location from "perl" to "site" on 244 5.12 and higher, since as of that version of Perl, dual-life 245 modules no longer need to be installed in "perl" to replace 246 in-core versions. Patch from tzccinct. 247 248 - Fixed hash order dependency test failures on Perl 5.17. Thanks to 249 Yves Orton for the patch. 250 251 - Inlined the code that tries to guess a Pod file's encoding. This 252 reduces the time Pod::Simple takes to build the core Perl 253 documentation by 15-20%. Thanks to Dagfinn Ilmari Mannsåker for 254 the patch! 255 256 - Added a warning when "=item" types mismatch within one 257 "=over"/"=back" block. Marc Green/Google Summer of Code, with 258 assist from RJBS. 259 260 - Fixed regression introduced in 3.22 in which "C< >" tags were 261 incorrectly treated as verbatim text in table of contents items 262 emitted by Pod::Simple::XHTML. Thanks to Randy Stauner for the 263 report and to Thomas Sibley for the fix! 264 265 - Loosened up the matching of "L< >" tags for man pages so that they 266 allow names with dots, underscores, and any other chararacters 267 other than "/", just so long as they end in '[(][-a-zA-Z0-9]+[)]'. 268 Thanks to Dave Rolsky and Kevin Ryde for the reports (RT #82975 & 269 RT #82972). 270 271 - Fixed inverted mapping of "keyboard" to "kbd" in 272 Pod::Simple::HTML. Thanks to Robert Boisvert for the bug report 273 (RT #79201). 274 275 - Added two new Tagmap entries to Pod::Simple::HTML: "preformat" 276 maps to "pre", and "teletype" maps to "tt". Suggested by Robert 277 Boisvert (RT #79201). 278 279 - "X< >" tags are now ignored by the pull parser when it searches 280 for titles, as is any trailing whitespace. Thanks to Patrice Dumas 281 for the report (RT #74389). 282 2833.23 2012-08-14 David E. Wheeler <david@justatheory.org> 284 - Eliminated nested elements in table of contents (index) items 285 output of Pod::Simple::XHTML. This was especially problematic for 286 headers that included links, as the TOC then got nested anchor 287 elements, which simply would not work. Thanks to Ben Bullock for 288 the report and test case (RT #77686). 289 290 - Fixed semantically invalid nested XHTML generated by 291 Pod::Simple::XHTML since v3.21. Gisle Aas. 292 293 - Improved support for nested "C< >" tags in Pod::Simple::XHTML. 294 Gisle Aas. 295 296 - No longer tries to decode a string with the "utf8" flag set, as 297 the double-decoding only triggered an error. Grant McLean. 298 299 - Added documentation note that the API expects encoded text 300 (octets). Grant McLean. 301 302 - Added "parse_characters()" option to specify that strings to are 303 already decoded from octets into characters. Grant McLean. 304 3053.22 2012-05-27 David E. Wheeler <david@justatheory.org> 306 - Fix but where Pod::Simple would whine about non-ASCII bytes in 307 code or comments. Now only does so for Pod (in the absence of an 308 "=encoding" tag. Broken in 3.21. Grant McLean. 309 3103.21 2012-05-23 David E. Wheeler <david@justatheory.org> 311 - NOTE: COMPATABILITY CHANGE: The 'codes_in_verbatim' option in 312 Pod::Simple::XHTML is no longer enabled by default. This brings it 313 agreement with the other formatting classes, and eliminates 314 unexpected behavior in XHTML-formatted Pod. Users who depended on 315 this functionality can still get it by enabling 316 'codes_in_verbatim' in their code. 317 318 - Fixed some typos in the documentation. Thanks to Jonathan Yu via 319 the Debian packagers via Florian Ragwitz (RT #75532). 320 321 - Now emit a warning the first time a non-ASCII byte is encountered 322 when no "=encoding" has been seen. Grant McLean. 323 324 - When a non-ASCII byte is encounted before an "=encoding" line has 325 been seen, a heuristic (as described in perlpodspec) is applied to 326 select UTF-8 encoding if the non-ASCII bytes form a valid UTF-8 327 byte sequence, or Latin-1 otherwise. Grant McLean. 328 329 - Added 'handle_code' method to Pod::Simple::XHTML. This allows 330 subclasses to override the handling of verbatim blocks, and makes 331 for a more cohesive interface, to boot. Gisle Aas. 332 333 - Subsequent text segments are now joined together and passed as a 334 single unit to text handling code. This makes it easier for custom 335 handlers to process complete blocks of text in a single call to 336 'handle_text', rather than in dribs and drabs. Gisle Aas. 337 338 - Replaced naive text wrapping code in Pod::Simple::DumpAsXML with 339 Text::Wrap, which was already used for similar purposes elsewhere 340 in Pod::Simple. Gisle Aas. 341 3423.20 2012-03-01 David E. Wheeler <david@justatheory.org> 343 - Removed use of 'done_testing' in t/xhtml15.t, which was added in 344 v3.19. Thanks to Paul Howarth for the catch. 345 346 - Fixed quoting of links in a regular expression Pod::Simple::Text. 347 Reported by Father Chrysostomos. 348 349 - Fix test failure on case-insensitive, non-case-preserving file systems 350 (VMS I'm looking at *you*). Patch from Craig A. Berry. 351 352 - Pod::Simple::HTML no longer emits "href='#___top'" if a TOC 353 (index) is not output. Patch from Rick Myers. 354 355 - Fixed links in the TOC of XHTML output to use IDs derived from encoded 356 text, rather than raw Pod, so that it will link to the ID actually 357 generated for the section. Thanks to Randy Stauner for the report 358 (with test case!) (RT #72544). 359 360 - PullParser now throws an exception on an attempt to set a source 361 more than once. Necessary because data from the previous source 362 will be cached, so the new source would be ignored anyway. Create a 363 new PullParser, instead. Thanks to Paul Boldra for the report (RT 364 #74265). 365 3663.19 2011-08-23 David E. Wheeler <david@justatheory.org> 367 - Fixed occasional test failure when tests are run in parallel 368 (HARNESS_OPTIONS=j6:c). Thanks to Alexei Znamensky for the report and 369 Marc Green for the fix. 370 371 - Added "pod_handler" option. This is a callback that can be used to 372 inspect the content on a "=pod" line. Marc Green/Google Summer of 373 Code. 374 375 - Added tests for proper line-ending parsing from the previous 376 release. The tests were in the repository, but didn't make it into 377 the MANIFEST or, therefore, the release. Reported by Marc Green. 378 379 - Added the "parse_empty_lists" option. When enabled, Pod::Simple 380 will recognize empty lists (that is, a blocks with '=over' and 381 '=back' but nothing in between). Disabled by default. Marc 382 Green/Google Summer of Code. 383 384 - Added the "whiteline_handler" attribute. It's much like 385 "code_handler", "cut_handler", and "pod_handler", except it's 386 triggered on lines that contain only whitespace characters. Marc 387 Green/Google Summer of Code. 388 389 - Added "raw" attribute to L<> treelet that contains the L<>'s raw 390 contents. Marc Green/Google Summer of Code. 391 392 - Pod directives autoclosed by Pod::Simple are now denoted as such 393 by the new "fake_closer" attribue. Marc Green/Google Summer of 394 Code. 395 396 - Fixed incompatibility with Pod::Simple::HTMLBatch in 397 Pod::Simple::XHTML. Patch by Eric Johnson. 398 3993.18 2011-07-16 David E. Wheeler <david@justatheory.org> 400 - Pod::Simple now properly parses Pod files using Mac OS Classic line- 401 endings (\r). Marc Green/Google Summer of Code. 402 403 - Fixed test failure in 't/search50.t when the test finds a .pod but 404 the module is in a .pm. Thanks to the cpan-testers who reported 405 this when the test searched for Capture::Tiny. 406 4073.17 2011-07-09 David E. Wheeler <david@justatheory.org> 408 - Documented tertiary methods. Patch from Shawn H Corey. 409 410 - Added "backlink" option to Pod::Simple::XHTML. Thanks to Marc 411 Green/Google Summer of Code for the pull request. 412 413 - Typos fixed in Pod::Simple::HTMLBatch. Reported by Shawn H Corey. 414 415 - Fixed quoting of value returned by a "strip_verbatim_indent()" 416 code reference so that regex meta characters are properly escaped. 417 418 - Added "anchor_items" option to Pod::Simple::XHMTL. This allows 419 text items (which are output as <dt> elements) to have IDs that 420 can be referenced in the "#" part of a URL. Marc Green/Google 421 Summer of Code. 422 423 - Added "recurse" option to Pod::Simple::Search. It's enabled by 424 default; disable it to turn off recursion into subdirectories. 425 Marc Green/Google Summer of Code. 426 427 - Added documentation to clarify the behavior of the "content_seen" 428 method. Thanks to Olaf Alders for the pull request. 429 4303.16 2011-03-14 David E. Wheeler <david@justatheory.org> 431 - Fixed invalid HTML generated for nested lists by Pod::Simple::XHTML 432 (Fitz Elliott). 433 434 - Replaced the invalid "<nobr>" tag -- created for "S<>" -- with 435 '<span style="white-space: nowrap;">' (Fitz Elliott). 436 437 - Fixed some nerbles in our own Pod (Michael Stevens) 438 439 - Improved the "Minimal code" example in Pod::Simple::HTML. The key 440 is to use pase_file(), not parse_from_file() (which should 441 otherwise be undocumented, and is just there for Pod::Parser 442 compatibility. Thanks to prodding from Ævar Arnfjörð Bjarmason (RT 443 #65428). 444 445 - Added the html_charset() and html_encode_chars() attributes to 446 Pod::Simple::XHTML. Inspired by a bug report from Agent Zhang 447 (章亦春) (RT #29587). 448 449 - Added "Minimal code" example to the Pod::Simple::XHTML documentation. 450 451 - Fixed mispelling of the "=encoding" markup in the parser (it was 452 spelled "=encode"). Thanks to "TTY" for the patch. (RT #24820). 453 4543.15 2010-11-11 David E. Wheeler <david@justatheory.org> 455 - Removed "perlpod.pod" and "perlpodspec.pod". These now just live 456 in the Perl core. 457 458 - Fixed stylesheet names output by HTMLBatch to match the names of 459 the actual stylesheet files (broken in 3.09). Thanks to Kevin Ryde 460 for the report (RT #56725). 461 462 - Added missing closing slash to the CSS links in the XHTML output. 463 Thanks to HarleyPig for the patch! 464 465 - Added parens around bar "qw(...)" in t/xhtml05.t. Thanks to Jerry 466 D. Hedden for the patch. 467 468 - Improved the Pod::Simple::HTML docs. Thanks to Gabor Szabo for the 469 patch. 470 471 - Pod::Simple::XHTML now properly encodes entities in URLs in the 472 anchor tag. Thanks to John McNamara for the report (RT-60249). 473 474 - Pod::Simple::HTML and XHTML now strip whitespace from the end of 475 section names that appear as anchor names for headers (in HTML) 476 and IDs (in XHTML). Such whitespace appeared when "X<>" entities 477 were stripped out but not the space between them (RT-56572). 478 479 - Make test "t/search50.t" always pass on case-insensitive file 480 systems rather than just skip VMS. 481 4823.14 2009-04-27 483 - Removed explicit loading of UNIVERSAL. RJBS. 484 485 - Reversed the change applied in release 3.09 to fix RT #12239. POD 486 tag found inside a complex POD tag (e.g., "C<<< I<foo> >>>") is 487 again parsed as a tag embedded in a tag instead of text and 488 entities. The previous interpretation of `perldoc perlpod` was 489 mistaken. (RT #55602 from Christopher J. Madsen). 490 4913.13 2009-12-17 David E. Wheeler <david@justatheory.org> 492 - Removed deleted test file from MANIFEST. 493 4943.12 2009-12-17 David E. Wheeler <david@justatheory.org> 495 - Removed "All rights reserved" from all files. 496 497 - Added acknowledgements to man.he.net and search.cpan.org for 498 permission to link man pages and Perl module links to their sites 499 in the output of Pod::Simple::HTML and Pod::Simple::XHTML. 500 501 - Add "html_h_level" option to Pod::Simple::XHTML and ::HTML to allow 502 a =head1 to become an <h2> and so on. RJBS. 503 504 - Add batch_mode_page_object_init() method to Pod::Simple::XHTML. 505 This allows it to be used by Pod::Simple::HTMLBatch. 506 507 - Fixed a regression in Pod::Simple::XHTML where '=begin html' blocks 508 were incorrectly escaped rather than simply passed through unmolested. 509 RJBS. 510 511 - Removed the undocumented "fullstop_space_harden" attribute, which 512 apparently was only used by Pod::Text a very long time ago. 513 5143.11 2009-12-09 David E. Wheeler <david@justatheory.org> 515 - Restored code to HTMLBatch that allows the TOC (index) to be created 516 in batch jobs (RT #52324 from Martin J. Evans). 517 518 - Added resources to META.yml, including bug tracker, license, and 519 repository. 520 521 - Turned man page links into links to man.he.net in Pod::Simple::HTML 522 and Pod::Simple::XHTML output. Subclass and override 523 resolve_man_page_link() to use a different URL. 524 525 - Added the resolve_pod_page_link() and resolve_man_page_link() methods 526 to Pod::Simple::XHTML to make it easier for subclasses to change the 527 URLs created for POD and man page links. 528 529 - Fixed the output of entities in L<> tags by Pod::Simple::XHTML. 530 531 - Fixed the output of POD links from Pod::Simple::XHTML so that the 532 section part (/foo) is turned into a proper fragment identifier (#foo) 533 in the resulting search.cpan.org link. 534 535 - Pod::Simple::Text now outputs URLs for links created in the 536 L<text|URL> format. For example, L<Perl|http://perl.org> is now 537 output as "Perl <http://perl.org>" rather than just as "Perl". 538 539 - Updated perlpod.pod and perlpodspec.pod to sync up with Perl core 540 (and to be released in Perl 5.12). Changes include: 541 * Removing the prohibition against L<text|href> 542 * Deprecation of L<section> and L<"section"> 543 * Legalization of "=begin formatname parameter" 544 545 - A couple of bug fixes in Pod::Simple::HTML from Graham Barr. 546 547 - Added the do_section() method to Pod::Simple::HTML. Graham Barr. 548 549 - Word-smithed the "DESCRIPTION" a bit and wrote the README. 550 551 - Synced up all module version numbers to 3.11 except for 552 Pod::Simple::HTMLLegacy, which is at 5.01 and should not have its 553 version number lowered. 554 5553.10 2009-11-12 David E. Wheeler <david@justatheory.org> 556 - Converted test files that had DOS endings to have Unix endings 557 (RT #50922 from Steve Hay). 558 559 - Skip tests on VMS where the lack of filename case preservation can 560 wreak havoc (RT #51184 from Craig A. Berry). 561 562 - Fix nested definition list format in the XHTML output 563 (RT #51187 from Lars Dɪᴇᴄᴋᴏᴡ). 564 565 - Added some files missing from the MANIFEST (and therefore the 566 distribution) in the last two releases. 567 5683.09 2009-10-27 Allison Randal <allison@perl.org> 569 - Add support for an index (TOC) in the XHTML output from David E. 570 Wheeler. 571 572 - Add strip_verbatim_indent() from David E. Wheeler. 573 574 - Added the "nocase" option to PullParser's get_title(), 575 get_version(), get_description(), and get_author() methods. This 576 allows one to fetch the contents of those sections regardless of 577 the case of the labels (e.g., "NAME" and "Name" and "name" are all 578 valid). Graham Barr. 579 580 - Added the search_class() accessor to Pod::Simple::HTMLBatch. 581 David E. Wheeler. 582 583 - XHTML output now properly encodes entities in all places, not just 584 in verbatim blocks and code spans. David E. Wheeler. 585 586 - Fixed XHTML to output definition lists when it should, rather than 587 (broken) unordered lists. David E. Wheeler. 588 589 - Fixed XHTML so that multiparagraph list items work correctly. 590 David E. Wheeler. 591 592 - Fixed XHTML ordered list output so that it does not include the 593 number specified in the POD in the output. This is on a par with 594 out the HTML output works. David E. Wheeler. 595 596 - Applied URL patch from Leon Brocard for The Perl Journal archives. 597 598 - Fixed test failures with older versions of HTML::Entities (RT #43903 599 from Salvador Tercia). 600 601 - Changed CSS files generated by HTMLBatch to be no more than 8.3 602 characters long. (RT #40450 from Renee Baecker) 603 604 - Added entity handling for E<sol> and E<verbar> to Pod::Simple::XHTML. 605 (RT #49615 from Chas Owens.) 606 607 - Fixed a bug in Pod::Simple::HTML where a definition term item with 608 no corresponding definition item would be output with no closing 609 </a></dt>. (RT # 37107 from Kevin Ryde). 610 611 - Added entity handling for numeric entities to Pod::Simple::XHTML, 612 following perlpod specification. 613 614 - A POD tag found inside a complex POD tag (e.g., "C<<< C<foo> >>>") 615 is now properly parsed as text and entities instead of a tag 616 embedded in a tag. This is in compliance with `perldoc perlpod` 617 (RT #12239 from Michael Schwern). 618 619 - Thanks to David E. Wheeler for applying patches, resolving bugs, 620 and generally getting ready for the release. 621 6223.08 2009-07-16 Allison Randal <allison@perl.org> 623 - Fix installdirs for Perl versions where Pod::Simple was core; 624 RT#36446 & RT#39709, thanks to Jerry Hedden. 625 626 - Fix encoding handling for code in paragraphs; RT#45829, thanks 627 to David Wheeler. 628 6293.07 2008-06-04 Allison Randal <allison@perl.org> 630 - Fix module dependencies, make HTML::Entities optional and require 631 Test::More. 632 6333.06 2008-06-03 Allison Randal <allison@perl.org> 634 - Fix bugs related to passing $1 to File::Spec, reported by Andrew Hamlin and 635 John McNamara. 636 637 - Applied a suggested fix from Kevin Ryde to return a successful exit 638 code when Pod::Simple::HTML is run from the command line. 639 640 - Fix handling of complex L<URL> entries, thanks to tests supplied in RT#4896. 641 642 - Fix incorrect handling of S<> entries made up of entirely whitespace, thanks 643 to test case from Andreas Koenig. 644 645 - Launch Pod::Simple::XHTML, an XHTML compliant, more easily extensible 646 HTML formatter. 647 648 - Add feature to parse additional text after =begin target as a block 649 title, requested by Adam Kennedy. 650 651 - Thanks to Hans Dieter Pearcey for applying patches, resolving bugs, 652 and generally getting ready for the release. 653 6543.05 2007-03-03 Allison Randal <allison@perl.org> 655 - Standardized all test files on 8.3 naming scheme for Perl core. 656 657 - Applied test patches from Jerry Hedden for Perl core when 658 Encode not installed. 659 660 - Applied test patch from Ken Williams for 5.005_04 compatibility. 661 662 - Applied a patch from Christopher Madsen to fix architecture 663 directory searches on Gentoo. 664 665 - Fixed a failing search test on Debian-based distributions caused 666 by Debian stripping Pod documentation out of core modules. 667 (Three cheers to the CPAN testers and James Ponza for sending 668 enough reports that I could work out the pattern.) 669 6703.04 2006-01-18 Allison Randal <allison@perl.org> 671 - Applied test patches for Perl core integration from Steve Peters. 672 673 - Added a 'reinit' method to Pod::Simple::BlackBox for Russ Allbery 674 so Pod::Man can provide backward compatibility to existing users 675 (such as Module::Build and ExtUtils::MakeMaker). 676 677 - Applied patch for extracting case-preserved package names on VMS 678 from Craig Berry. 679 6803.03 2005-11-21 Allison Randal <allison@perl.org> 681 - Applied whitespace patches for Pod::Man and Pod::Text from 682 Russ Allbery. 683 684 - Applied validation patches to Pod::Simple::HTML from Graham Barr. 685 6863.02 2004-05-24 Sean M. Burke <sburke@cpan.org> 687 - Just fixing some typos in the CSS generated by Pod::Simple:HTMLBatch. 688 6893.01 2004-05-24 Sean M. Burke <sburke@cpan.org> 690 - No big changes to the main modules, but there's many changes to 691 the important Pod::Simple::HTML module. 692 693 - Also, new modules: 694 - Pod::Simple::HTMLBatch 695 - Pod::Simple::HTMLLegacy 696 - Pod::Simple::Progress 697 - Pod::Simple::Search 698 - and tests for these (well, most). 699 700 - Some prettying up of the Makefile.PL. 701 702 - The test 00about.t is a bit more careful and verbose now. 703 704 - The docs are still incomplete, esp. for Pod::Simple::HTML and 705 Pod::Simple::HTMLBatch, which I hope to improve quite soon. 706 707 708 7092.06 2004-05-07 Sean M. Burke <sburke@cpan.org> 710 - Allison Randal brilliantly refactors a huge monolithic sub in 711 Blackbox.pm. Code is now actually sanely readable! 712 713 - I add the new option-attributes fullstop_space_harden and 714 codes_in_verbatim, and the two methods abandon_output_string and 715 abandon_output_fh. Not yet documented. 716 717 - New test fullstop_spaces.t and new corpus document 718 greek_iso_8859_7.pod. 719 720 - Another version should be forthcoming in a few days that has the 721 new Pod::Simple::HTML stuff in it. 722 723 - Note to self: document =extend and =encoding in perlpodspec ASAP! 724 725 7262.05 2003-11-04 Sean M. Burke <sburke@cpan.org> -- bugfix version 727 - In an attempt to stop Perl 5.6 versions from going completely 728 crazy, I've tried to basically turn off all Unicode/utf8 support 729 under 5.6. Under 5.8 and above, Unicode should work fine, and 730 under 5.6, all Unicode characters should be replaced with a little 731 "can't render" symbol, either a "¤" or a "?". 732 Many many thanks to Jarkko Hietaniemi for helping out. 733 734 - (Works under 5.005 now too?) 735 7362.04 2003-10-10 Sean M. Burke <sburke@cpan.org> -- minor bugfix version 737 * Added some code to insulate Pod::Simple to runtime changes in 738 the value of $/. Thanks to Iain Truskett for catching this. 739 * Added FILENO method to TiedOutFH.pm, to work quietly under some 740 perls. Thanks to Jochen Stenzel for catching this. 741 * Fixed some tests that erroneously failed under some 5.6's 742 because of chdir()s in *.t files messing up @INC Thanks to many 743 who caught this, including Rocco Caputo. 744 7452.03 2003-09-07 Sean M. Burke <sburke@cpan.org> -- minor upgrade 746 * A =head[1234] command now closes any currently open =over, and 747 warns. 748 * Fixing a few obscure bugs, including one to do with the 749 Makefile. 750 * Added some tests for those bugs. 751 7522.02 2003-09-02 Sean M. Burke <sburke@cpan.org> -- fixing a testing bug 753 * Autrijus Tang found a silly bug of mine in corpustest.t's 754 testing of corpus/t/nonesuch.txt. Fixed, 755 * I add encoding_nonesuch.t to test corpus/t/nonesuch.txt better. 756 757 7582.01 2003-09-01 Sean M. Burke <sburke@cpan.org> 759 * Moved all version numbers up to 2.01 for reasons of Tibetan 760 numerology. 761 762 * Implemented =encoding. Thanks a million to Jarkko, Autrijus, 763 Dan Kogai, and many others for their help, patience, and 764 encouragement. 765 766 * It's not yet documented, but see ./t/corpus/*.txt for examples at 767 least. 768 769 * Added 'use utf8' to all the modules. Byebye perl-5.005 770 compatibility, hello decent perl-5.6 compatibility. 771 772- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 773 7740.98 2003-09-01 Sean M. Burke <sburke@cpan.org> 775 * At Michael Schwern's suggestion, a list that begins with a 776 "=item [number]" line where number isn't a 1, is no longer 777 treated as an error, but instead is silently coerced into being a 778 text-item list, just as if it were "=item wubble" or whatever. 779 7800.97 2003-08-12 Sean M. Burke <sburke@cpan.org> 781 * Loooking goooooood. Not smelling so much like beta anymore! 782 * I think this might be the last version before I go 783 putting "use utf8" all over the place. 784 785 * Added placefolders for "=encoding" support. If you use 786 "=encoding", you'll get an error about "not yet implemented" 787 instead of "unknown directive". 788 789 * Rewrote Pod::Simple::Pullparser's get_title, and added 790 get_version, get_author, and get_description. Documented them. 791 Thanks to Graham Barr for contributing an initial get_title and 792 then being patient while I seemed to do nothing with it for months 793 on end! 794 795 * More tests. 796 797 * Otherwise just minor changes since last version: 798 * Fixed error in Pod::Simple::RTF. 799 * Added new but undocumented methods to Pod::Simple: 800 unaccept_directive(s) unaccept_target(s) unaccept_code(s) 801 * Corrected '=back without =open' error to '=back without =over' 802 * A little tweaking to the _verbatim_format code. 803 * Dump routines may use \x{NN} instead of \xNN format. 804 * Pod::Simple::HTML now uses VerbatimFormatted 805 * A few changes ot DEBUG messages -- nothing you'd normally see. 806 8070.96 2002-11-19 Sean M. Burke <sburke@cpan.org> 808 * Still kinda sorta beta. 809 810 * Much much more docs in this version. Only a few feature 811 changes: 812 813 * Added any_errata_seen to Pod::Simple. Should've been in there 814 ages ago. Oops! 815 * Fixed some errors in the experimental VerbatimFormatted code. 816 * Added is_tagname / is_tag to Pod::Simple::PullParserStartToken 817 and Pod::Simple::PullParserEndToken 818 * Added RTFDEFLANG stuff to Pod::Simple::RTF. 819 8200.95 2002-11-10 Sean M. Burke <sburke@cpan.org> 821 * Beta release. Much documentation still to write, many features 822 still to add. The APIs might change in future versions. 823 824 * Now including perlpod and perlpodspec in the dist. 825 826 * Pod::Simple -- added parse_from_file 827 * Pod::Simple::RTF -- minor style changes, and minor change to the 828 RTF-wrapping logic. 829 * Pod::Simple::BlackBox -- a =cut opening a block is no longer a 830 fatal(ish) error. 831 * Pod::Simple::BlackBox -- added experimental new 832 VerbatimFormatted stuff. 833 834 8350.94 2002-10-16 Sean M. Burke <sburke@cpan.org> 836 * Beta release. Much documentation still to write, many features 837 still to add. The APIs might change in future versions. 838 839 * Pod::Simple::RTF -- minor style tweaks 840 * Pod::Simple::PullParserEndToken and ::PullParserStartToken -- 841 added ->tag as an alias for ->tagname. 842 * Pod::Simple and Pod::Simple::BlackBox -- added tolerance for 843 "=item * Foo" as a variant syntax for "=item *\n\nFoo". Tests 844 added/changed accordingly. 845 * Pod::Simple::HTML -- added <a name="..."> stuff, and a hack at 846 doing something with X<...>'s. 847 848 8490.93 2002-09-29 Sean M. Burke <sburke@cpan.org> 850 * Beta release. Much documentation still to write, many features 851 still to add. The APIs might change in future versions. 852 853 * Pod::Simple -- added errors_seen attribute 854 * Pod::Simple::HTML -- added support for =for HTML ... directives, 855 and =extend directives. 856 * Oh, and I added Pod::Simple::RTF in 0.92 but forgot to note it 857 until now. 858 8590.92 2002-09-29 Sean M. Burke <sburke@cpan.org> 860 * Beta release. Much documentation still to write, many features 861 still to add. The APIs might change in future versions. 862 863 * Fixing bungled distribution. 864 8650.91 2002-09-29 Sean M. Burke <sburke@cpan.org> 866 * Beta release. Much documentation still to write, many features 867 still to add. The APIs might change in future versions. 868 869 * Pod::Simple::PullParserTextToken -- added 'text_r' 870 871 * Pod::Simple::PullParser -- added 'get_title' and 872 'get_title_short' to 873 874 * Pod::Simple -- corrected wording of "Format for second =extend 875 parameter" error message. 876 877 * Pod::PullParser -- made its filter() run as intended, like 878 Pod::Simple's filter. 879 880 * Pod::Subclassing -- more docs 881 8820.90 2002-09-11 Sean M. Burke <sburke@cpan.org> 883 * Beta release. Much documentation still to write, many features 884 still to add. The APIs might change in future versions. 885