Pod::Thread 3.00

This Perl module converts POD documents to thread, the macro language I use for my static site builder (about which, more in another software release coming up shortly). This release fixes a whole ton of long-standing problems.

• Remove support for parsing CVS $Id$ strings and emitting \id commands.
• Stop wrapping output text.
• Fix internal section links.
• Fix conversion of nested =over blocks.
• Fix conversion of =over blocks without an =item.
• Fix links to headings containing markup.
• Fix metacharacter escaping in headings, contents, and navbar.
• Fix handling of =for thread and =begin thread.
• Fix non-breaking spaces in navbar section names.
• Fix internal links whose anchors are wrapped.
• Output the document before erroring out if POD errors were seen.
• Suppress \signature if the input document was empty.
• Add bugtracker, homepage, and repository package metadata.

In brief, a lot of the POD implementation was previously done by chasing bugs rather than testing comprehensively, as reflected by the 65% code coverage in the previous release. The test suite now achieves about 95% code coverage (most of the rest is obscure error handling around encoding) and cleans up a bunch of long-standing problems with internal links.

I had previously punted entirely on section links containing markup, and as a result the section links shown in the navigation bar or table of contents were missing the markup and headings containing thread metacharacters were mangled beyond recognition. That was because I was trying to handle resolving links using regexes (after I got rid of the original two-pass approach that required a driver script). This release uses Text::Balanced instead, the same parsing module used by my static site generator, to solve the problem (mostly) correctly. (I think there may still be a few very obscure edge cases, but I probably won't encounter them.)

The net result should hopefully be better conversion of my software documentation, including INN documentation, when I regenerate my site (which will be coming soon).

You can get the latest release from CPAN or from the Pod::Thread distribution page.