1 # ChangeLog for Pod::Simple dist
2 #---------------------------------------------------------------------------
4 2009-10-27 Allison Randal <allison@perl.org>
7 Add support for an index (TOC) in the XHTML output from David E.
10 Add strip_verbatim_indent() from David E. Wheeler.
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
18 Added the search_class() accessor to Pod::Simple::HTMLBatch.
21 XHTML output now properly encodes entities in all places, not just
22 in verbatim blocks and code spans. David E. Wheeler.
24 Fixed XHTML to output definition lists when it should, rather than
25 (broken) unordered lists. David E. Wheeler.
27 Fixed XHTML so that multiparagraph list items work correctly.
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.
34 Applied URL patch from Leon Brocard for The Perl Journal archives.
36 Fixed test failures with older versions of HTML::Entities (RT #43903
37 from Salvador Tercia).
39 Changed CSS files generated by HTMLBatch to be no more than 8.3
40 characters long. (RT #40450 from Renee Baecker)
42 Added entity handling for E<sol> and E<verbar> to Pod::Simple::XHTML.
43 (RT #49615 from Chas Owens.)
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).
49 Added entity handling for numeric entities to Pod::Simple::XHTML,
50 following perlpod specification.
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).
57 Thanks to David E. Wheeler for applying patches, resolving bugs,
58 and generally getting ready for the release.
60 2009-07-16 Allison Randal <allison@perl.org>
63 Fix installdirs for Perl versions where Pod::Simple was core;
64 RT#36446 & RT#39709, thanks to Jerry Hedden.
66 Fix encoding handling for code in paragraphs; RT#45829, thanks
69 2008-06-04 Allison Randal <allison@perl.org>
72 Fix module dependencies, make HTML::Entities optional and require
75 2008-06-03 Allison Randal <allison@perl.org>
78 Fix bugs related to passing $1 to File::Spec, reported by Andrew Hamlin and
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.
84 Fix handling of complex L<URL> entries, thanks to tests supplied in RT#4896.
86 Fix incorrect handling of S<> entries made up of entirely whitespace, thanks
87 to test case from Andreas Koenig.
89 Launch Pod::Simple::XHTML, an XHTML compliant, more easily extensible
92 Add feature to parse additional text after =begin target as a block
93 title, requested by Adam Kennedy.
95 Thanks to Hans Dieter Pearcey for applying patches, resolving bugs,
96 and generally getting ready for the release.
98 2007-03-03 Allison Randal <allison@perl.org>
101 Standardized all test files on 8.3 naming scheme for Perl core.
103 Applied test patches from Jerry Hedden for Perl core when
104 Encode not installed.
106 Applied test patch from Ken Williams for 5.005_04 compatibility.
108 Applied a patch from Christopher Madsen to fix architecture
109 directory searches on Gentoo.
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.)
116 2006-01-18 Allison Randal <allison@perl.org>
119 Applied test patches for Perl core integration from Steve Peters.
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).
125 Applied patch for extracting case-preserved package names on VMS
128 2005-11-21 Allison Randal <allison@perl.org>
131 Applied whitespace patches for Pod::Man and Pod::Text from
134 Applied validation patches to Pod::Simple::HTML from Graham Barr.
136 2004-05-24 Sean M. Burke <sburke@cpan.org>
139 Just fixing some typos in the CSS generated by Pod::Simple:HTMLBatch.
142 2004-05-24 Sean M. Burke <sburke@cpan.org>
145 No big changes to the main modules, but there's many changes to
146 the important Pod::Simple::HTML module.
149 Pod::Simple::HTMLBatch
150 Pod::Simple::HTMLLegacy
151 Pod::Simple::Progress
153 and tests for these (well, most).
155 Some prettying up of the Makefile.PL.
157 The test 00about.t is a bit more careful and verbose now.
159 The docs are still incomplete, esp. for Pod::Simple::HTML and
160 Pod::Simple::HTMLBatch, which I hope to improve quite soon.
164 2004-05-07 Sean M. Burke <sburke@cpan.org>
167 Allison Randal brilliantly refactors a huge monolithic sub in
168 Blackbox.pm. Code is now actually sanely readable!
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.
174 New test fullstop_spaces.t and new corpus document
175 greek_iso_8859_7.pod.
177 Another version should be forthcoming in a few days that has the
178 new Pod::Simple::HTML stuff in it.
180 Note to self: document =extend and =encoding in perlpodspec ASAP!
183 2003-11-04 Sean M. Burke <sburke@cpan.org>
184 * Release 2.05 -- bugfix version
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.
193 (Works under 5.005 now too?)
195 2003-10-10 Sean M. Burke <sburke@cpan.org>
196 * Release 2.04 -- minor bugfix version
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.
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
210 * Fixing a few obscure bugs, including one to do with the
212 * Added some tests for those bugs.
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.
221 2003-09-01 Sean M. Burke <sburke@cpan.org>
223 * Moved all version numbers up to 2.01 for reasons of Tibetan
226 * Implemented =encoding. Thanks a million to Jarkko, Autrijus,
227 Dan Kogai, and many others for their help, patience, and
230 It's not yet documented, but see ./t/corpus/*.txt for examples at
233 * Added 'use utf8' to all the modules. Byebye perl-5.005
234 compatibility, hello decent perl-5.6 compatibility.
236 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
238 2003-09-01 Sean M. Burke <sburke@cpan.org>
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.
245 2003-08-12 Sean M. Burke <sburke@cpan.org>
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.
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".
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
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.
273 2002-11-19 Sean M. Burke <sburke@cpan.org>
275 * Still kinda sorta beta.
277 * Much much more docs in this version. Only a few feature
280 * Added any_errata_seen to Pod::Simple. Should've been in there
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.
287 2002-11-10 Sean M. Burke <sburke@cpan.org>
289 * Beta release. Much documentation still to write, many features
290 still to add. The APIs might change in future versions.
292 * Now including perlpod and perlpodspec in the dist.
294 * Pod::Simple -- added parse_from_file
295 * Pod::Simple::RTF -- minor style changes, and minor change to the
297 * Pod::Simple::BlackBox -- a =cut opening a block is no longer a
299 * Pod::Simple::BlackBox -- added experimental new
300 VerbatimFormatted stuff.
303 2002-10-16 Sean M. Burke <sburke@cpan.org>
305 * Beta release. Much documentation still to write, many features
306 still to add. The APIs might change in future versions.
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.
318 2002-09-29 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 -- 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
329 2002-09-29 Sean M. Burke <sburke@cpan.org>
331 * Beta release. Much documentation still to write, many features
332 still to add. The APIs might change in future versions.
334 * Fixing bungled distribution.
336 2002-09-29 Sean M. Burke <sburke@cpan.org>
338 * Beta release. Much documentation still to write, many features
339 still to add. The APIs might change in future versions.
341 * Pod::Simple::PullParserTextToken -- added 'text_r'
343 * Pod::Simple::PullParser -- added 'get_title' and
346 * Pod::Simple -- corrected wording of "Format for second =extend
347 parameter" error message.
349 * Pod::PullParser -- made its filter() run as intended, like
350 Pod::Simple's filter.
352 * Pod::Subclassing -- more docs
354 2002-09-11 Sean M. Burke <sburke@cpan.org>
356 * Beta release. Much documentation still to write, many features
357 still to add. The APIs might change in future versions.