cpan/Pod-Simple/ChangeLog

   1 # ChangeLog for Pod::Simple dist
   2 #---------------------------------------------------------------------------
   3
   4 2009-11-12   David E. Wheeler <david@justatheory.org>
   5         * Release 3.10
   6
   7         Converted test files that had DOS enedings to have Unix endings
   8         (RT #50922 from Steve Hay).
   9
  10         Skip tests on VMS where the lack of filename case preservation can
  11         wreak havoc (RT #51184 from Craig A. Berry).
  12
  13         Fix nested definition list format in the XHTML output
  14         (RT #51187 from Lars Dɪᴇᴄᴋᴏᴡ).
  15
  16         Added some files missing from the MANIFEST (and therefore the
  17         distribution) in the last two releases.
  18
  19 2009-10-27   Allison Randal <allison@perl.org>
  20         * Release 3.09
  21
  22         Add support for an index (TOC) in the XHTML output from David E.
  23         Wheeler.
  24
  25         Add strip_verbatim_indent() from David E. Wheeler.
  26
  27         Added the "nocase" option to PullParser's get_title(),
  28         get_version(), get_description(), and get_author() methods. This
  29         allows one to fetch the contents of those sections regardless of
  30         the case of the labels (e.g., "NAME" and "Name" and "name" are all
  31         valid). Graham Barr.
  32
  33         Added the search_class() accessor to Pod::Simple::HTMLBatch.
  34         David E. Wheeler.
  35
  36         XHTML output now properly encodes entities in all places, not just
  37         in verbatim blocks and code spans. David E. Wheeler.
  38
  39         Fixed XHTML to output definition lists when it should, rather than
  40         (broken) unordered lists. David E. Wheeler.
  41
  42         Fixed XHTML so that multiparagraph list items work correctly.
  43         David E. Wheeler.
  44
  45         Fixed XHTML ordered list output so that it does not include the
  46         number specified in the POD in the output. This is on a par with
  47         out the HTML output works. David E. Wheeler.
  48
  49         Applied URL patch from Leon Brocard for The Perl Journal archives.
  50
  51         Fixed test failures with older versions of HTML::Entities (RT #43903
  52         from Salvador Tercia).
  53
  54         Changed CSS files generated by HTMLBatch to be no more than 8.3
  55         characters long. (RT #40450 from Renee Baecker)
  56
  57         Added entity handling for E<sol> and E<verbar> to Pod::Simple::XHTML.
  58         (RT #49615 from Chas Owens.)
  59
  60         Fixed a bug in Pod::Simple::HTML where a definition term item with
  61         no corresponding definition item would be output with no closing
  62         </a></dt>. (RT # 37107 from Kevin Ryde).
  63
  64         Added entity handling for numeric entities to Pod::Simple::XHTML,
  65         following perlpod specification.
  66
  67         A POD tag found inside a complex POD tag (e.g., "C<<< C<foo> >>>")
  68         is now properly parsed as text and entities instead of a tag
  69         embedded in a tag. This is in compliance with `perldoc perlpod`
  70         (RT #12239 from Michael Schwern).
  71
  72         Thanks to David E. Wheeler for applying patches, resolving bugs,
  73         and generally getting ready for the release.
  74
  75 2009-07-16   Allison Randal <allison@perl.org>
  76         * Release 3.08
  77
  78         Fix installdirs for Perl versions where Pod::Simple was core;
  79         RT#36446 & RT#39709, thanks to Jerry Hedden.
  80
  81         Fix encoding handling for code in paragraphs; RT#45829, thanks
  82         to David Wheeler.
  83
  84 2008-06-04   Allison Randal <allison@perl.org>
  85         * Release 3.07
  86
  87         Fix module dependencies, make HTML::Entities optional and require
  88         Test::More.
  89
  90 2008-06-03   Allison Randal <allison@perl.org>
  91         * Release 3.06
  92
  93         Fix bugs related to passing $1 to File::Spec, reported by Andrew Hamlin and
  94         John McNamara.
  95
  96         Applied a suggested fix from Kevin Ryde to return a successful exit
  97         code when Pod::Simple::HTML is run from the command line.
  98
  99         Fix handling of complex L<URL> entries, thanks to tests supplied in RT#4896.
 100
 101         Fix incorrect handling of S<> entries made up of entirely whitespace, thanks
 102         to test case from Andreas Koenig.
 103
 104         Launch Pod::Simple::XHTML, an XHTML compliant, more easily extensible
 105         HTML formatter.
 106
 107         Add feature to parse additional text after =begin target as a block
 108         title, requested by Adam Kennedy.
 109
 110         Thanks to Hans Dieter Pearcey for applying patches, resolving bugs,
 111         and generally getting ready for the release.
 112
 113 2007-03-03   Allison Randal <allison@perl.org>
 114         * Release 3.05
 115
 116         Standardized all test files on 8.3 naming scheme for Perl core.
 117
 118         Applied test patches from Jerry Hedden for Perl core when
 119         Encode not installed.
 120
 121         Applied test patch from Ken Williams for 5.005_04 compatibility.
 122
 123         Applied a patch from Christopher Madsen to fix architecture
 124         directory searches on Gentoo.
 125
 126         Fixed a failing search test on Debian-based distributions caused
 127         by Debian stripping Pod documentation out of core modules.
 128         (Three cheers to the CPAN testers and James Ponza for sending
 129         enough reports that I could work out the pattern.)
 130
 131 2006-01-18   Allison Randal <allison@perl.org>
 132         * Release 3.04
 133
 134         Applied test patches for Perl core integration from Steve Peters.
 135
 136         Added a 'reinit' method to Pod::Simple::BlackBox for Russ Allbery
 137         so Pod::Man can provide backward compatibility to existing users
 138         (such as Module::Build and ExtUtils::MakeMaker).
 139
 140         Applied patch for extracting case-preserved package names on VMS
 141         from Craig Berry.
 142
 143 2005-11-21   Allison Randal <allison@perl.org>
 144         * Release 3.03
 145
 146         Applied whitespace patches for Pod::Man and Pod::Text from
 147         Russ Allbery.
 148
 149         Applied validation patches to Pod::Simple::HTML from Graham Barr.
 150
 151 2004-05-24   Sean M. Burke <sburke@cpan.org>
 152         * Release 3.02
 153
 154         Just fixing some typos in the CSS generated by Pod::Simple:HTMLBatch.
 155
 156
 157 2004-05-24   Sean M. Burke <sburke@cpan.org>
 158         * Release 3.01
 159
 160         No big changes to the main modules, but there's many changes to
 161         the important Pod::Simple::HTML module.
 162
 163         Also, new modules:
 164           Pod::Simple::HTMLBatch
 165           Pod::Simple::HTMLLegacy
 166           Pod::Simple::Progress
 167           Pod::Simple::Search
 168         and tests for these (well, most).
 169
 170         Some prettying up of the Makefile.PL.
 171
 172         The test 00about.t is a bit more careful and verbose now.
 173
 174         The docs are still incomplete, esp. for Pod::Simple::HTML and
 175         Pod::Simple::HTMLBatch, which I hope to improve quite soon.
 176
 177
 178
 179 2004-05-07   Sean M. Burke <sburke@cpan.org>
 180         * Release 2.06
 181
 182         Allison Randal brilliantly refactors a huge monolithic sub in
 183         Blackbox.pm.  Code is now actually sanely readable!
 184
 185         I add the new option-attributes fullstop_space_harden and
 186         codes_in_verbatim, and the two methods abandon_output_string and
 187         abandon_output_fh.  Not yet documented.
 188
 189         New test fullstop_spaces.t and new corpus document
 190         greek_iso_8859_7.pod.
 191
 192         Another version should be forthcoming in a few days that has the
 193         new Pod::Simple::HTML stuff in it.
 194
 195         Note to self: document =extend and =encoding in perlpodspec ASAP!
 196
 197
 198 2003-11-04  Sean M. Burke <sburke@cpan.org>
 199         * Release 2.05 -- bugfix version
 200
 201         In an attempt to stop Perl 5.6 versions from going completely
 202         crazy, I've tried to basically turn off all Unicode/utf8 support
 203         under 5.6. Under 5.8 and above, Unicode should work fine, and
 204         under 5.6, all Unicode characters should be replaced with a little
 205         "can't render" symbol, either a "¤" or a "?".
 206         Many many thanks to Jarkko Hietaniemi for helping out.
 207
 208         (Works under 5.005 now too?)
 209
 210 2003-10-10  Sean M. Burke <sburke@cpan.org>
 211         * Release 2.04 -- minor bugfix version
 212
 213         * Added some code to insulate Pod::Simple to runtime changes in
 214         the value of $/.  Thanks to Iain Truskett for catching this.
 215         * Added FILENO method to TiedOutFH.pm, to work quietly under some
 216         perls.  Thanks to Jochen Stenzel for catching this.
 217         * Fixed some tests that erroneously failed under some 5.6's
 218         because of chdir()s in *.t files messing up @INC  Thanks to many
 219         who caught this, including Rocco Caputo.
 220
 221 2003-09-07  Sean M. Burke <sburke@cpan.org>
 222         * Release 2.03 -- minor upgrade
 223         * A =head[1234] command now closes any currently open =over, and
 224         warns.
 225         * Fixing a few obscure bugs, including one to do with the
 226         Makefile.
 227         * Added some tests for those bugs.
 228
 229 2003-09-02  Sean M. Burke <sburke@cpan.org>
 230         * Release 2.02 -- fixing a testing bug
 231         * Autrijus Tang found a silly bug of mine in corpustest.t's
 232         testing of corpus/t/nonesuch.txt.  Fixed,
 233         * I add encoding_nonesuch.t to test corpus/t/nonesuch.txt better.
 234
 235
 236 2003-09-01  Sean M. Burke <sburke@cpan.org>
 237         * Release 2.01
 238         * Moved all version numbers up to 2.01 for reasons of Tibetan
 239         numerology.
 240
 241         * Implemented =encoding.  Thanks a million to Jarkko, Autrijus,
 242         Dan Kogai, and many others for their help, patience, and
 243         encouragement.
 244
 245         It's not yet documented, but see ./t/corpus/*.txt for examples at
 246         least.
 247
 248         * Added 'use utf8' to all the modules.  Byebye perl-5.005
 249         compatibility, hello decent perl-5.6 compatibility.
 250
 251 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 252
 253 2003-09-01  Sean M. Burke <sburke@cpan.org>
 254         * Release 0.98
 255         * At Michael Schwern's suggestion, a list that begins with a
 256         "=item [number]" line where number isn't a 1, is no longer
 257         treated as an error, but instead is silently coerced into being a
 258         text-item list, just as if it were "=item wubble" or whatever.
 259
 260 2003-08-12  Sean M. Burke <sburke@cpan.org>
 261         * Release 0.97
 262         * Loooking goooooood.  Not smelling so much like beta anymore!
 263         * I think this might be the last version before I go
 264         putting "use utf8" all over the place.
 265
 266         * Added placefolders for "=encoding" support.  If you use
 267         "=encoding", you'll get an error about "not yet implemented"
 268         instead of "unknown directive".
 269
 270         * Rewrote Pod::Simple::Pullparser's get_title, and added
 271         get_version, get_author, and get_description.  Documented them.
 272         Thanks to Graham Barr for contributing an initial get_title and
 273         then being patient while I seemed to do nothing with it for months
 274         on end!
 275
 276         * More tests.
 277
 278         Otherwise just minor changes since last version:
 279         * Fixed error in Pod::Simple::RTF.
 280         * Added new but undocumented methods to Pod::Simple:
 281            unaccept_directive(s) unaccept_target(s) unaccept_code(s)
 282         * Corrected '=back without =open' error to '=back without =over'
 283         * A little tweaking to the _verbatim_format code.
 284         * Dump routines may use \x{NN} instead of \xNN format.
 285         * Pod::Simple::HTML now uses VerbatimFormatted
 286         * A few changes ot DEBUG messages -- nothing you'd normally see.
 287
 288 2002-11-19  Sean M. Burke <sburke@cpan.org>
 289         * Release 0.96
 290         * Still kinda sorta beta.
 291
 292         * Much much more docs in this version.  Only a few feature
 293         changes:
 294
 295         * Added any_errata_seen to Pod::Simple.  Should've been in there
 296         ages ago.  Oops!
 297         * Fixed some errors in the experimental VerbatimFormatted code.
 298         * Added is_tagname / is_tag to Pod::Simple::PullParserStartToken
 299         and Pod::Simple::PullParserEndToken
 300         * Added RTFDEFLANG stuff to Pod::Simple::RTF.
 301
 302 2002-11-10  Sean M. Burke <sburke@cpan.org>
 303         * Release 0.95
 304         * Beta release.  Much documentation still to write, many features
 305         still to add.  The APIs might change in future versions.
 306
 307         * Now including perlpod and perlpodspec in the dist.
 308
 309         * Pod::Simple -- added parse_from_file
 310         * Pod::Simple::RTF -- minor style changes, and minor change to the
 311         RTF-wrapping logic.
 312         * Pod::Simple::BlackBox -- a =cut opening a block is no longer a
 313         fatal(ish) error.
 314         * Pod::Simple::BlackBox -- added experimental new
 315         VerbatimFormatted stuff.
 316
 317
 318 2002-10-16  Sean M. Burke <sburke@cpan.org>
 319         * Release 0.94
 320         * Beta release.  Much documentation still to write, many features
 321         still to add.  The APIs might change in future versions.
 322
 323         * Pod::Simple::RTF -- minor style tweaks
 324         * Pod::Simple::PullParserEndToken and ::PullParserStartToken --
 325         added ->tag as an alias for ->tagname.
 326         * Pod::Simple and Pod::Simple::BlackBox -- added tolerance for
 327         "=item * Foo" as a variant syntax for "=item *\n\nFoo".  Tests
 328         added/changed accordingly.
 329         * Pod::Simple::HTML -- added <a name="..."> stuff, and a hack at
 330         doing something with X<...>'s.
 331
 332
 333 2002-09-29  Sean M. Burke <sburke@cpan.org>
 334         * Release 0.93
 335         * Beta release.  Much documentation still to write, many features
 336         still to add.  The APIs might change in future versions.
 337
 338         * Pod::Simple -- added errors_seen attribute
 339         * Pod::Simple::HTML -- added support for =for HTML ... directives,
 340         and =extend directives.
 341         * Oh, and I added Pod::Simple::RTF in 0.92 but forgot to note it
 342         until now.
 343
 344 2002-09-29  Sean M. Burke <sburke@cpan.org>
 345         * Release 0.92
 346         * Beta release.  Much documentation still to write, many features
 347         still to add.  The APIs might change in future versions.
 348
 349         * Fixing bungled distribution.
 350
 351 2002-09-29  Sean M. Burke <sburke@cpan.org>
 352         * Release 0.91
 353         * Beta release.  Much documentation still to write, many features
 354         still to add.  The APIs might change in future versions.
 355
 356         * Pod::Simple::PullParserTextToken -- added 'text_r'
 357
 358         * Pod::Simple::PullParser -- added 'get_title' and
 359         'get_title_short' to
 360
 361         * Pod::Simple -- corrected wording of "Format for second =extend
 362         parameter" error message.
 363
 364         * Pod::PullParser -- made its filter() run as intended, like
 365         Pod::Simple's filter.
 366
 367         * Pod::Subclassing -- more docs
 368
 369 2002-09-11  Sean M. Burke <sburke@cpan.org>
 370         * Release 0.90
 371         * Beta release.  Much documentation still to write, many features
 372         still to add.  The APIs might change in future versions.