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 gr...@gnu.org 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

Attachment: signature.asc
Description: PGP signature

Reply via email to