Subject: bug#53976: closed (Re: [bug-diffutils] bug#53976: Improve markup in man pages)

From: [email-masked] (GNU bug Tracking System)
Date: Tue, 15 Feb 2022 03:10:02 +0000

Your bug report

#53976: Improve markup in man pages

which was filed against the diffutils package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to [email-masked].

-- 
53976: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=53976
GNU Bug Tracking System
Contact [email-masked] with problems

Subject: Re: [bug-diffutils] bug#53976: Improve markup in man pages
From: Paul Eggert <[email-masked]>
To: Mario Blättermann <[email-masked]>
Cc: [email-masked]
Date: Mon, 14 Feb 2022 19:09:19 -0800
List-Id: <debbugs-submit.debbugs.gnu.org>

Thanks, installed here:

https://git.savannah.gnu.org/gitweb/?p=diffutils.git;a=commitdiff;h=dd9deb765548679e821be565229bb2e142d93573

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)