I've attached a patch to address the only items I think should be addressed.
One class I left untouched are unambiguous command references.
For example it's a bit redundant to use cp(1) in a long description
with many references to cp, in the cp manpage itself.
The other class is not using italics for option parameters within URLs.
The reasoning for that was given in
https://github.com/coreutils/coreutils/commit/e2fdbea10
Basically since the url is matching the whole option, it was
deemed too messy to be mixing different formatting within the URL,
as that can be marked up in various ways.
Note if you want to give precedence to italics over URLs,
then you can disable URLs at runtime with TERM=dumb env var,
or build with the ./configure --disable-manual-url option.
Marking this as done.
thanks,
Padraig
From 31572ed49e1bb29bc2f4c5bd2bc25d523c823279 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?P=C3=A1draig=20Brady?= <[email protected]>
Date: Sat, 25 Apr 2026 19:01:53 +0100
Subject: [PATCH] doc: apply man page formatting suggestions from manpage-l10n
* src/basenc.c: Add (1) to base64 and base32 references.
* src/cksum.c. Likewise for cksum references.
* src/echo.c: Use "bell" in descriptions rather than BEL.
* src/printf.c: Likewise.
* src/id.c: Separate -u,-U,-G so marked up appropriately.
Fixes https://bugs.gnu.org/80904
---
src/basenc.c | 4 ++--
src/cksum.c | 4 ++--
src/echo.c | 2 +-
src/id.c | 4 ++--
src/printf.c | 2 +-
5 files changed, 8 insertions(+), 8 deletions(-)
diff --git a/src/basenc.c b/src/basenc.c
index cd86b106a..4da824e6c 100644
--- a/src/basenc.c
+++ b/src/basenc.c
@@ -119,7 +119,7 @@ Base%d encode or decode FILE, or standard input, to standard output.\n\
#if BASE_TYPE == 42
oputs (_("\
--base64\n\
- same as 'base64' program (RFC4648 section 4)\n\
+ same as base64(1) program (RFC4648 section 4)\n\
"));
oputs (_("\
--base64url\n\
@@ -131,7 +131,7 @@ Base%d encode or decode FILE, or standard input, to standard output.\n\
"));
oputs (_("\
--base32\n\
- same as 'base32' program (RFC4648 section 6)\n\
+ same as base32(1) program (RFC4648 section 6)\n\
"));
oputs (_("\
--base32hex\n\
diff --git a/src/cksum.c b/src/cksum.c
index 3a59e45ca..ffd9a82d5 100644
--- a/src/cksum.c
+++ b/src/cksum.c
@@ -502,7 +502,7 @@ Usage: %s [OPTION]... [FILE]...\n\
Print or check %s checksums.\n\
"), DIGEST_TYPE_STRING);
fputs (_("\
-Legacy interface to the cksum utility.\n\
+Legacy interface to the cksum(1) utility.\n\
"), stdout);
}
else
@@ -517,7 +517,7 @@ Print or check %s (%d-bit) checksums.\n\
DIGEST_TYPE_STRING,
DIGEST_BITS);
fputs (_("\
-Legacy interface to the cksum utility.\n\
+Legacy interface to the cksum(1) utility.\n\
"), stdout);
#endif
diff --git a/src/echo.c b/src/echo.c
index 872f11c74..d64306d7a 100644
--- a/src/echo.c
+++ b/src/echo.c
@@ -74,7 +74,7 @@ If -e is in effect, the following sequences are recognized:\n\
"), stdout);
fputs (_("\
\\\\ backslash\n\
- \\a alert (BEL)\n\
+ \\a alert (bell)\n\
\\b backspace\n\
\\c produce no further output\n\
\\e escape\n\
diff --git a/src/id.c b/src/id.c
index 27b3e8b70..b5a307721 100644
--- a/src/id.c
+++ b/src/id.c
@@ -115,11 +115,11 @@ or (when USER omitted) for the current process.\n\
"));
oputs (_("\
-n, --name\n\
- print a name instead of a number, for -u,-g,-G\n\
+ print a name instead of a number, for -u, -g, -G\n\
"));
oputs (_("\
-r, --real\n\
- print the real ID instead of the effective ID, with -u,-g,-G\n\
+ print the real ID instead of the effective ID, with -u, -g, -G\n\
"));
oputs (_("\
-u, --user\n\
diff --git a/src/printf.c b/src/printf.c
index 674dd7d07..5fb4c7c86 100644
--- a/src/printf.c
+++ b/src/printf.c
@@ -69,7 +69,7 @@ FORMAT controls the output as in C printf. Interpreted sequences are:\n\
"), stdout);
fputs (_("\
\\\\ backslash\n\
- \\a alert (BEL)\n\
+ \\a alert (bell)\n\
\\b backspace\n\
\\c produce no further output\n\
\\e escape\n\
--
2.53.0
