Man.vim: No ASCII HYPHEN-MINUS (dash) with groff-base (v1.23.0)

[zzzyxwvut]

Debianites, heads up!

(At the moment this only concerns the folks on the testing
(trixie) and the unstable (sid) releases.)

With groff-base version 1.23.0, the output from man(1) is
subject to the following change:

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.

So, command names with dashes (0x002d), e.g. git-commit(1),
are now rendered with hyphens (0x2010), git‐commit(1), in
Man and, with autoload/dist/man.vim, in Vim.

Good luck finding any such command (with Bash):

printf '%s\n' /usr/share/man/man1/git$'\342\200\220'*

To abandon this novelty, introduce a mapping:

* When viewing man pages, some characters on my UTF-8 terminal emulator
look funny or copy-and-paste wrong. Why?

Some Unicode Basic Latin ("ASCII") input characters are mapped to
non-Basic Latin code points in output for consistency with other output
devices, like PDF. . . .

However, many man pages are written in ignorance of the correct special
characters to obtain the desired glyphs. You can conceal these errors
by adding the following to your site-local man(7) configuration. The
file is called "man.local"; its installation directory depends on how
groff was configured when it was built.

--- start ---

.if '\*[.T]'utf8' \
.  char - \-

--- end ---

You may also wish to do the same for "mdoc.local".

(There is also a similar, old, undone fix.)

Try looking for man.local and mdoc.local in /etc/groff/.

TRACK THE ISSUE HERE.