1 # ChangeLog for Pod::Simple dist
2 #---------------------------------------------------------------------------
4 2009-11-12 David E. Wheeler <david@justatheory.org>
7 Converted test files that had DOS enedings to have Unix endings
8 (RT #50922 from Steve Hay).
10 Skip tests on VMS where the lack of filename case preservation can
11 wreak havoc (RT #51184 from Craig A. Berry).
13 Fix nested definition list format in the XHTML output
14 (RT #51187 from Lars Dɪᴇᴄᴋᴏᴡ).
16 Added some files missing from the MANIFEST (and therefore the
17 distribution) in the last two releases.
19 2009-10-27 Allison Randal <allison@perl.org>
22 Add support for an index (TOC) in the XHTML output from David E.
25 Add strip_verbatim_indent() from David E. Wheeler.
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
33 Added the search_class() accessor to Pod::Simple::HTMLBatch.
36 XHTML output now properly encodes entities in all places, not just
37 in verbatim blocks and code spans. David E. Wheeler.
39 Fixed XHTML to output definition lists when it should, rather than
40 (broken) unordered lists. David E. Wheeler.
42 Fixed XHTML so that multiparagraph list items work correctly.
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.
49 Applied URL patch from Leon Brocard for The Perl Journal archives.
51 Fixed test failures with older versions of HTML::Entities (RT #43903
52 from Salvador Tercia).
54 Changed CSS files generated by HTMLBatch to be no more than 8.3
55 characters long. (RT #40450 from Renee Baecker)
57 Added entity handling for E<sol> and E<verbar> to Pod::Simple::XHTML.
58 (RT #49615 from Chas Owens.)
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).
64 Added entity handling for numeric entities to Pod::Simple::XHTML,
65 following perlpod specification.
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).
72 Thanks to David E. Wheeler for applying patches, resolving bugs,
73 and generally getting ready for the release.
75 2009-07-16 Allison Randal <allison@perl.org>
78 Fix installdirs for Perl versions where Pod::Simple was core;
79 RT#36446 & RT#39709, thanks to Jerry Hedden.
81 Fix encoding handling for code in paragraphs; RT#45829, thanks
84 2008-06-04 Allison Randal <allison@perl.org>
87 Fix module dependencies, make HTML::Entities optional and require
90 2008-06-03 Allison Randal <allison@perl.org>
93 Fix bugs related to passing $1 to File::Spec, reported by Andrew Hamlin and
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.
99 Fix handling of complex L<URL> entries, thanks to tests supplied in RT#4896.
101 Fix incorrect handling of S<> entries made up of entirely whitespace, thanks
102 to test case from Andreas Koenig.
104 Launch Pod::Simple::XHTML, an XHTML compliant, more easily extensible
107 Add feature to parse additional text after =begin target as a block
108 title, requested by Adam Kennedy.
110 Thanks to Hans Dieter Pearcey for applying patches, resolving bugs,
111 and generally getting ready for the release.
113 2007-03-03 Allison Randal <allison@perl.org>
116 Standardized all test files on 8.3 naming scheme for Perl core.
118 Applied test patches from Jerry Hedden for Perl core when
119 Encode not installed.
121 Applied test patch from Ken Williams for 5.005_04 compatibility.
123 Applied a patch from Christopher Madsen to fix architecture
124 directory searches on Gentoo.
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.)
131 2006-01-18 Allison Randal <allison@perl.org>
134 Applied test patches for Perl core integration from Steve Peters.
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).
140 Applied patch for extracting case-preserved package names on VMS
143 2005-11-21 Allison Randal <allison@perl.org>
146 Applied whitespace patches for Pod::Man and Pod::Text from
149 Applied validation patches to Pod::Simple::HTML from Graham Barr.
151 2004-05-24 Sean M. Burke <sburke@cpan.org>
154 Just fixing some typos in the CSS generated by Pod::Simple:HTMLBatch.
157 2004-05-24 Sean M. Burke <sburke@cpan.org>
160 No big changes to the main modules, but there's many changes to
161 the important Pod::Simple::HTML module.
164 Pod::Simple::HTMLBatch
165 Pod::Simple::HTMLLegacy
166 Pod::Simple::Progress
168 and tests for these (well, most).
170 Some prettying up of the Makefile.PL.
172 The test 00about.t is a bit more careful and verbose now.
174 The docs are still incomplete, esp. for Pod::Simple::HTML and
175 Pod::Simple::HTMLBatch, which I hope to improve quite soon.
179 2004-05-07 Sean M. Burke <sburke@cpan.org>
182 Allison Randal brilliantly refactors a huge monolithic sub in
183 Blackbox.pm. Code is now actually sanely readable!
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.
189 New test fullstop_spaces.t and new corpus document
190 greek_iso_8859_7.pod.
192 Another version should be forthcoming in a few days that has the
193 new Pod::Simple::HTML stuff in it.
195 Note to self: document =extend and =encoding in perlpodspec ASAP!
198 2003-11-04 Sean M. Burke <sburke@cpan.org>
199 * Release 2.05 -- bugfix version
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.
208 (Works under 5.005 now too?)
210 2003-10-10 Sean M. Burke <sburke@cpan.org>
211 * Release 2.04 -- minor bugfix version
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.
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
225 * Fixing a few obscure bugs, including one to do with the
227 * Added some tests for those bugs.
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.
236 2003-09-01 Sean M. Burke <sburke@cpan.org>
238 * Moved all version numbers up to 2.01 for reasons of Tibetan
241 * Implemented =encoding. Thanks a million to Jarkko, Autrijus,
242 Dan Kogai, and many others for their help, patience, and
245 It's not yet documented, but see ./t/corpus/*.txt for examples at
248 * Added 'use utf8' to all the modules. Byebye perl-5.005
249 compatibility, hello decent perl-5.6 compatibility.
251 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
253 2003-09-01 Sean M. Burke <sburke@cpan.org>
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.
260 2003-08-12 Sean M. Burke <sburke@cpan.org>
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.
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".
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
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.
288 2002-11-19 Sean M. Burke <sburke@cpan.org>
290 * Still kinda sorta beta.
292 * Much much more docs in this version. Only a few feature
295 * Added any_errata_seen to Pod::Simple. Should've been in there
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.
302 2002-11-10 Sean M. Burke <sburke@cpan.org>
304 * Beta release. Much documentation still to write, many features
305 still to add. The APIs might change in future versions.
307 * Now including perlpod and perlpodspec in the dist.
309 * Pod::Simple -- added parse_from_file
310 * Pod::Simple::RTF -- minor style changes, and minor change to the
312 * Pod::Simple::BlackBox -- a =cut opening a block is no longer a
314 * Pod::Simple::BlackBox -- added experimental new
315 VerbatimFormatted stuff.
318 2002-10-16 Sean M. Burke <sburke@cpan.org>
320 * Beta release. Much documentation still to write, many features
321 still to add. The APIs might change in future versions.
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.
333 2002-09-29 Sean M. Burke <sburke@cpan.org>
335 * Beta release. Much documentation still to write, many features
336 still to add. The APIs might change in future versions.
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
344 2002-09-29 Sean M. Burke <sburke@cpan.org>
346 * Beta release. Much documentation still to write, many features
347 still to add. The APIs might change in future versions.
349 * Fixing bungled distribution.
351 2002-09-29 Sean M. Burke <sburke@cpan.org>
353 * Beta release. Much documentation still to write, many features
354 still to add. The APIs might change in future versions.
356 * Pod::Simple::PullParserTextToken -- added 'text_r'
358 * Pod::Simple::PullParser -- added 'get_title' and
361 * Pod::Simple -- corrected wording of "Format for second =extend
362 parameter" error message.
364 * Pod::PullParser -- made its filter() run as intended, like
365 Pod::Simple's filter.
367 * Pod::Subclassing -- more docs
369 2002-09-11 Sean M. Burke <sburke@cpan.org>
371 * Beta release. Much documentation still to write, many features
372 still to add. The APIs might change in future versions.