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