From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from static.213-239-213-133.clients.your-server.de (luckmann.name [213.239.213.133]) by sourceware.org (Postfix) with UTF8SMTPS id 6365D3857C50 for ; Wed, 20 Apr 2022 14:44:29 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 6365D3857C50 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=helgefjell.de Authentication-Results: sourceware.org; spf=none smtp.mailfrom=helgefjell.de Received: from localhost (localhost [127.0.0.1]) (uid 502) by static.213-239-213-133.clients.your-server.de with local id 0000000000E5E02F.0000000062601C4B.00006AF3; Wed, 20 Apr 2022 16:44:27 +0200 Date: Wed, 20 Apr 2022 16:44:27 +0200 From: Helge Kreutzmann To: Mark Wielaard Cc: bzip2-devel@sourceware.org Subject: Re: Errors in man pages of bzip2 Message-ID: <20220420144427.GA26593@Debian-50-lenny-64-minimal> References: <20220205103540.GA5411@Debian-50-lenny-64-minimal> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="=_luckmann.name-27379-1650465867-0001-2" Content-Disposition: inline In-Reply-To: X-Public-Key-URL: http://www.helgefjell.de/data/debian_neu.asc X-homepage: http://www.helgefjell.de/debian User-Agent: Mutt/1.10.1 (2018-07-13) X-Spam-Status: No, score=1.8 required=5.0 tests=BAYES_00, CK_HELO_GENERIC, HELO_DYNAMIC_IPADDR, KAM_DMARC_STATUS, KAM_LAZY_DOMAIN_SECURITY, KAM_NUMSUBJECT, KAM_SHORT, SPF_HELO_NONE, SPF_NONE, TXREP, T_SCC_BODY_TEXT_LINE, URIBL_SBL_A autolearn=no autolearn_force=no version=3.4.4 X-Spam-Level: * X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on server2.sourceware.org X-BeenThere: bzip2-devel@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Bzip2-devel mailing list List-Unsubscribe: , List-Archive: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 20 Apr 2022 14:44:31 -0000 This is a MIME-formatted message. If you see this text it means that your E-mail software does not support MIME-formatted messages. --=_luckmann.name-27379-1650465867-0001-2 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hello Mark, On Tue, Apr 19, 2022 at 11:36:50PM +0200, Mark Wielaard wrote: > Sorry for the late reply. >=20 > On Sat, Feb 05, 2022 at 11:35:40AM +0100, Helge Kreutzmann wrote: > > 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. > >=20 > > I'm now reporting the errors for your project. If future reports > > should use another channel, please let me know. >=20 > If you could file future issues in bugzilla: > https://sourceware.org/bugzilla/enter_bug.cgi?product=3Dbzip2 > Then there is an archive. But sending reports to this list is also > fine. I can do this; however in February I was told by Micah Snyder to use https://gitlab.com/groups/bzip2/-/issues Is the sourcware bugzilla now preferred? > > Man page: bzdiff.1 > > Issue: missing markup (B< >) > >=20 > > "cmp(1), diff(1), bzmore(1), bzless(1), bzgrep(1), bzip2(1)" >=20 > I don't understand what is wrong here. The entries in SEE ALSO are marked in bold, which usually is indicated in our format with B<>, so it should be B(1) instead of cmp(1) and similarly for the others. If you use *roff, it could look like =2EBR \%cmp (1), =2EBR \%diff (1), =2E.. > > -- > > Man page: bzexe.1 > > Issue: markup of the command: B > >=20 > > "The I utility allows you to compress executables in place and h= ave " > > "them automatically uncompress and execute when you run them (at a pena= lty in " > > "performance). For example if you execute ``bzexe /bin/cat'' it will c= reate " > > "the following two files:" >=20 > I believe bzexe is a Debian extension that isn't part of bzip2 as we ship= it. Ok, then I mark this accordingly. > > -- > > Man page: bzgrep.1 > > Issue: missing markup (B< >) > >=20 > > "grep(1), egrep(1), fgrep(1), bzdiff(1), bzmore(1), bzless(1), bzip2(1)" >=20 > Again, I don't understand the issue here. Same as above, missing bold markup. > > -- > > Man page: bzmore.1 > > Issue: missing markup (B< >) > >=20 > > "more(1), less(1), bzip2(1), bzdiff(1), bzgrep(1)" >=20 > This is like above, I don't really understand what is wrong with the > way we use SEE ALSO in the manpages. Same as above, missing bold markup. Thanks for handling the issues! Greetings Helge --=20 Dr. Helge Kreutzmann debian@helgefjell.de Dipl.-Phys. http://www.helgefjell.de/debian.php 64bit GNU powered gpg signed mail preferred Help keep free software "libre": http://www.ffii.de/ --=_luckmann.name-27379-1650465867-0001-2 Content-Type: application/pgp-signature; name="signature.asc" Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- iQIzBAABCAAdFiEEbZZfteMW0gNUynuwQbqlJmgq5nAFAmJgHD4ACgkQQbqlJmgq 5nBRVxAAstIX8F7u35if35RXe99hns9dNOSIgUoDOjbafE+4MQ4sdR8xvziLIlLO 0Cu7h2U/7ZpX93SNWGrnV9EXOvdxNCCUowzt/Cdn2AvRbHbY/Si6s0sYOKKKDYkv ACigCxRRs7AsyjNMUAi1Dfm9+9Nc4Lsyute0oQ4FK+vFKfrC306zpLivX/GEmJPt BprydDPplwSXZA5EtH9C+p5+LLTKCBGtI9v3lvTDmC6CxojH48F5IfjPE3JkmKMa k5OOzN1QquDJSoaokhb1p+mG459lJ13Z/+vyE8z4iVp9P2LaT8SGj48oo+XZ/6KE wtzsjZ4kW1rZIGXm7yzlyMVMwSs/rv8C8XDJ3moc7b4YnMqYNcqj5V2G0BUS0zdS X/lwBGsQcSgpIjBMi+7Gdgj62ibbjEvBL3kVR4QWYkY86r7/C9vClJJrVBypvBmG XIE8wW+f+JhyXuJvL1lQLfi2tCGQ+NZuw5y+BWvrgCR3rsRJw8NuTCWnYrLt1/j7 FvPAja2GD9vAnnbM7lsGeV/TfZCesbKS08Q6S4LhgUb5zTNEbhfJzLQcJiYys/81 mVTesju9bmNQ6MIHlGzyt+CWXnE9CLN/7vsSMvE15C82lZc3tXWHUd+lInlTQr8X v+TbsUV39pr2LA9Eo5Cm1FGnQ6GKFfW/RbzRSko5FYSNRrR+9A8= =JoWj -----END PGP SIGNATURE----- --=_luckmann.name-27379-1650465867-0001-2--