Subject: bug#53918: closed (Re: bug#53918: Errors in man pages of gzip)

From: [email-masked] (GNU bug Tracking System)
Date: Thu, 10 Feb 2022 18:56:02 +0000

Your bug report

#53918: Errors in man pages of gzip

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

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

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

Subject: Re: bug#53918: Errors in man pages of gzip
From: Paul Eggert <[email-masked]>
To: Helge Kreutzmann <[email-masked]>
Cc: [email-masked]
Date: Thu, 10 Feb 2022 10:55:42 -0800
List-Id: <debbugs-submit.debbugs.gnu.org>

Thanks, I installed the attached.

From 94bd21adcee935a3145435d26b4230b8bbc8bbc0 Mon Sep 17 00:00:00 2001
From: Paul Eggert <[email-masked]>
Date: Thu, 10 Feb 2022 10:54:10 -0800
Subject: [PATCH] doc: embolden SEE ALSO refs

Problem reported by Helge Kreutzmann (Bug#53918).
---
 gzexe.1 | 6 +++++-
 gzip.1  | 9 ++++++++-
 zgrep.1 | 8 +++++++-
 zless.1 | 3 ++-
 zmore.1 | 8 +++++++-
 znew.1  | 8 +++++++-
 6 files changed, 36 insertions(+), 6 deletions(-)

diff --git a/gzexe.1 b/gzexe.1
index 75213d0..04e3a73 100644
--- a/gzexe.1
+++ b/gzexe.1
@@ -26,7 +26,11 @@ This utility is most useful on systems with very small disks.
 .B \-d
 Decompress the given executables instead of compressing them.
 .SH "SEE ALSO"
-gzip(1), znew(1), zmore(1), zcmp(1), zforce(1)
+.BR gzip (1),
+.BR znew (1),
+.BR zmore (1),
+.BR zcmp (1),
+.BR zforce (1)
 .SH CAVEATS
 The compressed executable is a shell script.  This may create some
 security holes.  In particular, the compressed executable relies
diff --git a/gzip.1 b/gzip.1
index 7497a72..05ed6d2 100644
--- a/gzip.1
+++ b/gzip.1
@@ -412,7 +412,14 @@ containing the following:
       export PATH=/usr/bin
       exec gzip \-9 "$@"
 .SH "SEE ALSO"
-znew(1), zcmp(1), zmore(1), zforce(1), gzexe(1), zip(1), unzip(1), compress(1)
+.BR znew (1),
+.BR zcmp (1),
+.BR zmore (1),
+.BR zforce (1),
+.BR gzexe (1),
+.BR zip (1),
+.BR unzip (1),
+.BR compress (1)
 .PP
 The
 .B gzip
diff --git a/zgrep.1 b/zgrep.1
index 6ca2457..4daaab9 100644
--- a/zgrep.1
+++ b/zgrep.1
@@ -49,4 +49,10 @@ and
 .SH AUTHOR
 Charles Levert ([email-masked])
 .SH "SEE ALSO"
-grep(1), gzexe(1), gzip(1), zdiff(1), zforce(1), zmore(1), znew(1)
+.BR grep (1),
+.BR gzexe (1),
+.BR gzip (1),
+.BR zdiff (1),
+.BR zforce (1),
+.BR zmore (1),
+.BR znew (1)
diff --git a/zless.1 b/zless.1
index a36aad1..0d13e4d 100644
--- a/zless.1
+++ b/zless.1
@@ -20,7 +20,8 @@ command
 .B zless
 available is important to be worth providing it.
 .SH "SEE ALSO"
-zmore(1), less(1)
+.BR zmore (1),
+.BR less (1)
 .SH "BUGS"
 The
 .B zless
diff --git a/zmore.1 b/zmore.1
index a5559e0..c387dd1 100644
--- a/zmore.1
+++ b/zmore.1
@@ -139,4 +139,10 @@ if there is more than one file.
 /etc/termcap
 Terminal data base
 .SH "SEE ALSO"
-more(1), gzip(1), zdiff(1), zgrep(1), znew(1), zforce(1), gzexe(1)
+.BR more (1),
+.BR gzip (1),
+.BR zdiff (1),
+.BR zgrep (1),
+.BR znew (1),
+.BR zforce (1),
+.BR gzexe (1)
diff --git a/znew.1 b/znew.1
index 6451ff3..72419c9 100644
--- a/znew.1
+++ b/znew.1
@@ -32,7 +32,13 @@ Use pipes for the conversion to reduce disk space usage.
 Keep a .Z file when it is smaller than the .gz file; implies
 .BR -t .
 .SH "SEE ALSO"
-gzip(1), zmore(1), zdiff(1), zgrep(1), zforce(1), gzexe(1), compress(1)
+.BR gzip (1),
+.BR zmore (1),
+.BR zdiff (1),
+.BR zgrep (1),
+.BR zforce (1),
+.BR gzexe (1),
+.BR compress(1)
 .SH BUGS
 If the
 .B \-P
-- 
2.32.0

Subject: Errors in man pages of gzip
From: Helge Kreutzmann <[email-masked]>
To: [email-masked]
Date: Thu, 10 Feb 2022 17:01:19 +0100
List-Id: <debbugs-submit.debbugs.gnu.org>

Dear gzip maintainer,
the manpage-l10n project maintains a large number of translations of
man pages both from a large variety of sources (including gzip) as
well for a large variety of target languages.

During their work translators notice different possible issues in the
original (english) man pages. Sometimes this is a straightforward
typo, sometimes a hard to read sentence, sometimes this is a
convention not held up and sometimes we simply do not understand the
original.

We use several distributions as sources and update regularly (at
least every 2 month). This means we are fairly recent (some
distributions like archlinux also update frequently) but might miss
the latest upstream version once in a while, so the error might be
already fixed. We apologize and ask you to close the issue immediately
if this should be the case, but given the huge volume of projects and
the very limited number of volunteers we are not able to double check
each and every issue.

Secondly we translators see the manpages in the neutral po format,
i.e. converted and harmonized, but not the original source (be it man,
groff, xml or other). So we cannot provide a true patch (where
possible), but only an approximation which you need to convert into
your source format.

Finally the issues I'm reporting have accumulated over time and are
not always discovered by me, so sometimes my description of the
problem my be a bit limited - do not hesitate to ask so we can clarify
them.

I'm now reporting the errors for your project. If future reports
should use another channel, please let me know.

Man page: gzexe.1
Issue: Missing markup: B<>

"gzip(1), znew(1), zmore(1), zcmp(1), zforce(1)"
--
Man page: gzip.1
Issue: Missing markup: B<>

"znew(1), zcmp(1), zmore(1), zforce(1), gzexe(1), zip(1), unzip(1), "
"compress(1)"
--
Man page: zgrep.1
Issue: Missing markup: B<>

"grep(1), gzexe(1), gzip(1), zdiff(1), zforce(1), zmore(1), znew(1)"
--
Man page: zless.1
Issue: Missing markup: B<>

"zmore(1), less(1)"
--
Man page: zmore.1
Issue: Missing markup: B<>

"more(1), gzip(1), zdiff(1), zgrep(1), znew(1), zforce(1), gzexe(1)"
--
Man page: znew.1
Issue: Missing markup: B<>

"gzip(1), zmore(1), zdiff(1), zgrep(1), zforce(1), gzexe(1), compress(1)"

-- 
      Dr. Helge Kreutzmann                     [email-masked]
           Dipl.-Phys.                   http://www.helgefjell.de/debian.php
        64bit GNU powered                     gpg signed mail preferred
           Help keep free software "libre": http://www.ffii.de/