cpan/Pod-Simple/ChangeLog

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