Subject: Improve markup in man pages
From: Mario Blättermann <[email-masked]>
To: [email-masked]
Date: Sun, 13 Feb 2022 13:55:41 +0100
List-Id: <debbugs-submit.debbugs.gnu.org>

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
diff --git a/man/cmp.x b/man/cmp.x
index 5c9ef82..a50d33c 100644
--- a/man/cmp.x
+++ b/man/cmp.x
@@ -1,2 +1,4 @@
 [SEE ALSO]
-diff(1), diff3(1), sdiff(1)
+.BR diff (1),
+.BR diff3 (1),
+.BR sdiff (1)
diff --git a/man/diff.x b/man/diff.x
index fdb69d2..6efb3ab 100644
--- a/man/diff.x
+++ b/man/diff.x
@@ -1,2 +1,6 @@
 [SEE ALSO]
-wdiff(1), cmp(1), diff3(1), sdiff(1), patch(1)
+.BR wdiff (1),
+.BR cmp (1),
+.BR diff3 (1),
+.BR sdiff (1),
+.BR patch (1)
diff --git a/man/diff3.x b/man/diff3.x
index 0751208..e748e64 100644
--- a/man/diff3.x
+++ b/man/diff3.x
@@ -1,2 +1,4 @@
 [SEE ALSO]
-cmp(1), diff(1), sdiff(1)
+.BR cmp (1),
+.BR diff (1),
+.BR sdiff (1)
diff --git a/man/sdiff.x b/man/sdiff.x
index fdc9c3e..e2b5482 100644
--- a/man/sdiff.x
+++ b/man/sdiff.x
@@ -1,2 +1,4 @@
 [SEE ALSO]
-cmp(1), diff(1), diff3(1)
+.BR cmp (1),
+.BR diff (1),
+.BR diff3 (1)