Russ Allbery > Eagle's Path > September 2016 |
A new release of the distribution that provides Pod::Man and Pod::Text for Perl documentation formatting.
The impetus for this release is fixing a rendering bug in Pod::Man that spewed stray bits of half-escaped *roff into the man page for the text "TRUE (1)". This turned out to be due to two interlocking bugs in the dark magic regexes that try to fix up formatting to make man pages look a bit better: incorrect double-markup in both small caps and as a man page reference, and incorrect interpretation of the string "\s0(1)". Both are fixed in this release.
podlators 4.00 changed Pod::Man to make piping POD through pod2man on
standard input without providing the --name
option an error, since
there was no good choice for the man page title. This turned out to be
too disruptive: the old behavior of tolerating this had been around for
too long, and I got several bug reports. Since I think backward
compatibility is extremely important for these tools, I've backed down
from this change, and now Pod::Man and pod2man just silently use the man
page name "STDIN" (which still fixes the original problem of being
reproducible).
It is, of course, still a good idea to provide the name option when dealing with standard input, since "STDIN" isn't a very good man page title.
This release also adds new --lquote
and --rquote
options to
pod2man to set the quote marks independently, and removes a test that
relied on a POD construct that is going to become an error in Pod::Simple.
You can get the latest release from the podlators distribution page.
Posted: 2016-09-24 19:28 — Why no comments?
Russ Allbery > Eagle's Path > September 2016 |