GNU bug report logs - #53976
Improve markup in man pages

Previous Next

Package: diffutils;

Reported by: Mario Blättermann <mario.blaettermann <at> gmail.com>

Date: Sun, 13 Feb 2022 19:19:02 UTC

Severity: normal

Done: Paul Eggert <eggert <at> cs.ucla.edu>

Bug is archived. No further changes may be made.

Full log

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Mario Blättermann <mario.blaettermann <at> gmail.com>
To: bug-diffutils <at> gnu.org
Subject: Improve markup in man pages
Date: Sun, 13 Feb 2022 13:55:41 +0100

[Message part 1 (text/plain, inline)]
Hello,

the SEE ALSO sections in the man pages contain links which will be
pulled in from *.x files by help2man. While help2man evaluates the
Groff markup from --help and --version output, it doesn't bother with
the markup in the *.x files. See the attached patch. The bold
formatting of the links is especially useful in HTML output (but also
in terminal output); the links become clickable and point to the
respective man page in online collections [1]. You can test the
behavior in the German version, where the links are already properly
formatted [2].

[1] https://man.archlinux.org/man/cmp.1
[2] https://man.archlinux.org/man/cmp.1.de

Best Regards,
Mario

[seealso-markup.diff (text/x-patch, attachment)]
This bug report was last modified 3 years and 96 days ago.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.