package man-db groff-base severity 1052675 serious reassign 1052675 groff-base merge 1041731 1052675 thanks
Hi FC,
The fundamental issue here is that groff 1.23.0 is exposing, rather than
concealing, glyph usage errors in man pages. The plan is to permit such
exposure while the next release of Debian is in development, so that
developers are made aware of the issue and can address it (if they
choose), and then conceal such errors again as a Debian patch to groff
around the time of the trixie freeze.
From groff's NEWS file:
o The an (man) and doc (mdoc) macro packages no longer remap the -, ',
and ` input characters to Basic Latin code points on UTF-8 devices,
but treat them as groff normally does (and AT&T troff before it did)
for typesetting devices, where they become the hyphen, apostrophe or
right single quotation mark, and left single quotation mark,
respectively. This change is expected to expose glyph usage errors
in man pages. See the "PROBLEMS" file for a recipe that will
conceal these errors. A better long-term approach is for man pages
to adopt correct input practices; the man pages groff_man_style(7),
groff_char(7), and man-pages(7) (subsection "Generating optimal
glyphs"; from the Linux man-pages project) contain such
instructions. Doing so also improves man page typography when
formatting for PDF.
If you maintain a generator of man(7) or mdoc(7) documents (such as
a tool that converts other formats to them), and need assistance,
please contact the [email protected] mailing list and describe your
situation.
At 2023-09-26T00:58:27+0200, FC Stegerman wrote:
> $ LC_ALL=C man apksigner
Since many people like the expanded glyph repertoire of UTF-8, you might
apply the patch documented in groff's PROBLEMS file to your
/etc/groff/man.local.
--- start ---
.if '\*[.T]'utf8' \{\
. char ' \[aq]
. char - \-
. char ^ \[ha]
. char ` \[ga]
. char ~ \[ti]
.\}
--- end ---
As that file notes, you may also wish to do the same for "mdoc.local".
Regards,
Branden
signature.asc
Description: PGP signature
