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