Bring Pod::Simple up to 3.09 as on CPAN.
[p5sagit/p5-mst-13.2.git] / cpan / Pod-Simple / ChangeLog
CommitLineData
4f90f8a5 1# ChangeLog for Pod::Simple dist
351625bd 2#---------------------------------------------------------------------------
3
9d65762f 42009-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
ac185ebf 602009-07-16 Allison Randal <allison@perl.org>
61 * Release 3.08
62
63 Fix installdirs for Perl versions where Pod::Simple was core;
9d65762f 64 RT#36446 & RT#39709, thanks to Jerry Hedden.
ac185ebf 65
66 Fix encoding handling for code in paragraphs; RT#45829, thanks
9d65762f 67 to David Wheeler.
ac185ebf 68
bf5dc521 692008-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
752008-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
4f90f8a5 982007-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
1162006-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
351625bd 1282005-11-21 Allison Randal <allison@perl.org>
129 * Release 3.03
130
131 Applied whitespace patches for Pod::Man and Pod::Text from
4f90f8a5 132 Russ Allbery.
351625bd 133
134 Applied validation patches to Pod::Simple::HTML from Graham Barr.
135
1362004-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
1422004-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
1642004-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
1832003-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
1952003-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
2062003-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
2142003-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
2212003-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
2382003-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
2452003-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
2732002-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
2872002-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
3032002-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
3182002-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
3292002-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
3362002-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
3542002-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.