Changes for version v6.1.0 - 2026-07-19
- groff 1.24.0 broke use of the .IP macro for tag list formatting by removing the mandatory spacing between the tag and the paragraph. Work around this by using .TP for lists other than bullet or numbered lists. Be aware that groff 1.24 and later defaults to a minimum gap of two spaces between the tag and the paragraph for .TP instead of one space as in previous pod2man and groff releases. POD documents that want an indent just wide enough for tags to format on the same line as the paragraph may need to increase the indent level for the =over command by one to render as desired with those versions of groff.
- Change the default fixed-width font from CW to CR. This avoids warnings with groff 1.24.0 or later at the cost of breaking troff output on Solaris 10. nroff output and troff output on Solaris 11 are unaffected. The pod2man option --fixed=CW will restore the previous behavior. Thanks to G. Branden Robinson for the analysis and assistance. (GitHub #43)
- Move the Pod::Man override of the AD string (needed to request left justification) after .TH, and also clear the HY register to request no hyphenation. This positioning also works with groff 1.23.0 and is required by groff 1.24.0 to disable hyphenation and use left justification by default without overriding user preferences. Many thanks to G. Branden Robinson for the discussion and assistance.
- Pod::Text now supports setting the encoding option to "none" to disable output encoding. This only makes sense when calling output_string() to direct the formatted output to a scalar. It is intended for special cases where the formatted output is held in memory for further processing and will encoded for output at a later step. Thanks to djerius for the suggestion. (GitHub #38)
- Fix Pod::Text quoting heuristics for C<> when the contents contains newlines. Thanks to van-de-bugger for the report. (GitHub #39)
- Suppress adding double quotes around C<> text in Pod::Man and Pod::Text if the contents are quoted with Unicode double quotes or consist of a single character followed by an ASCII double quote.
- Fix the documentation for the date and release options to Pod::Man and the corresponding --date and --release options to pod2man. The positions of the footers controlled by these options were reversed in podlators 1.12 but the documentation was never updated.
- Update the Pod::Man discussion of intersentence spacing to reflect groff changes around double quotes and to recommend against attempting to manage the spacing for *roff output.
Documentation
Perl POD style guide
Convert POD data to formatted *roff input
Convert POD data to formatted ASCII text
Modules
Convert POD data to formatted *roff input
Parse an Lltgt formatting code in POD text
Convert POD data to formatted text
Convert POD data to formatted color ASCII text
Convert POD data to formatted overstrike text
Convert POD data to ASCII text with format escapes