podlators 5.01

podlators is the Perl distribution providing Pod::Man and Pod::Text, along with related modules and supporting scripts.

The primary change in this release is the addition of configurable guesswork for Pod::Text, paralleling Pod::Man. I had forgotten that Pod::Text also had complex heuristics for whether to quote C<> text that have the same Perl-specific properties as Pod::Man. This is now configurable via a guesswork option, the same as in Pod::Man, although the only type of guesswork supported is quoting. I also updated the default regexes, which include some fixes from Pod::Man.

Thanks to discussion with G. Branden Robinson, I now understand quoting in roff considerably better, which let me fix a few obscure bugs with strange page titles or configured quote characters. Pod::Man now avoids quoting macro arguments when the quoting is unnecessary, which should hopefully produce slightly more readable output.

Finally, I had started using a Pod::Simple feature introduced in 3.26 in Pod::Text but forgot to update the dependency, resulting in test failures on some old versions of Perl. (The same tests didn't fail in GitHub CI, which is probably related to how I install dependencies.) That's been fixed in this release.

You can get the latest version from CPAN or from the podlators distribution page.

Posted: 2022-12-25 09:56 — Why no comments?

Last spun 2023-05-13 from thread modified 2022-12-25