From unknown Sat Jun 14 19:24:59 2025 X-Loop: help-debbugs@gnu.org Subject: bug#45353: Errors in man pages Resent-From: Helge Kreutzmann Original-Sender: "Debbugs-submit" Resent-CC: bug-grep@gnu.org Resent-Date: Mon, 21 Dec 2020 16:12:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 45353 X-GNU-PR-Package: grep X-GNU-PR-Keywords: To: 45353@debbugs.gnu.org X-Debbugs-Original-To: bug-grep@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.160856710122175 (code B ref -1); Mon, 21 Dec 2020 16:12:01 +0000 Received: (at submit) by debbugs.gnu.org; 21 Dec 2020 16:11:41 +0000 Received: from localhost ([127.0.0.1]:48091 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1krNme-0005lb-Rq for submit@debbugs.gnu.org; Mon, 21 Dec 2020 11:11:41 -0500 Received: from lists.gnu.org ([209.51.188.17]:33044) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1krNmd-0005lT-44 for submit@debbugs.gnu.org; Mon, 21 Dec 2020 11:11:39 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:35064) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1krNma-00047A-5R for bug-grep@gnu.org; Mon, 21 Dec 2020 11:11:38 -0500 Received: from luckmann.name ([213.239.213.133]:54929 helo=static.213-239-213-133.clients.your-server.de) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1krNmX-0003Wg-L2 for bug-grep@gnu.org; Mon, 21 Dec 2020 11:11:35 -0500 Received: from localhost (localhost [127.0.0.1]) (uid 502) by static.213-239-213-133.clients.your-server.de with local id 0000000000E5600C.000000005FE0C931.0000434F; Mon, 21 Dec 2020 17:11:29 +0100 Date: Mon, 21 Dec 2020 17:11:29 +0100 From: Helge Kreutzmann Message-ID: <20201221161129.GA17189@Debian-50-lenny-64-minimal> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="=_luckmann.name-17231-1608567089-0001-2" Content-Disposition: inline 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) Received-SPF: none client-ip=213.239.213.133; envelope-from=debian@helgefjell.de; helo=static.213-239-213-133.clients.your-server.de X-Spam_score_int: 4 X-Spam_score: 0.4 X-Spam_bar: / X-Spam_report: (0.4 / 5.0 requ) BAYES_00=-1.9, CK_HELO_GENERIC=0.249, HELO_DYNAMIC_IPADDR=1.951, SPF_HELO_NONE=0.001, SPF_NONE=0.001, URIBL_SBL_A=0.1 autolearn=no autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.6 (-) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.6 (--) 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-17231-1608567089-0001-2 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Dear grep maintainer, the manpage-l10n project maintains a large number of translations of man pages both from a large variety of sources (including grep) 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: grep.1 Issue: The option was mentioned above! "Suppress normal output; instead print a count of matching lines for each " "input file. With the B<-v>, B<-\\^-invert-match> option (see below), coun= t " "non-matching lines." -- Man page: grep.1 Issue: Reorder text? "Report Unix-style byte offsets. This switch causes B to report byte= " "offsets as if the file were a Unix-style text file, i.e., with CR characte= rs " "stripped off. This will produce results identical to running B on a= " "Unix machine. This option has no effect unless B<-b> option is also used;= " "it has no effect on platforms other than MS-DOS and MS-Windows." -- Man page: grep.1 Issue 1: pcresyntax(3) =E2=86=92 B(3) Issue 2: pcrepattern(3) =E2=86=92 B(3) "B understands three different versions of regular expression syntax:= " "``basic'' (BRE), ``extended'' (ERE) and ``perl'' (PCRE). In GNU B " "there is no difference in available functionality between basic and extend= ed " "syntaxes. In other implementations, basic regular expressions are less " "powerful. The following description applies to extended regular " "expressions; differences for basic regular expressions are summarized " "afterwards. Perl-compatible regular expressions give additional " "functionality, and are documented in pcresyntax(3) and pcrepattern(3), but= " "work only if PCRE is available in the system." -- Man page: grep.1 Issue: Order of entrie not according to man-pages(7) "B(1), B(1), B(1), B(1), B(1), B(1), " "B(1), B(1), B(2), B(3), B(3), " "B(3), B(5), B(7), B(7)." -- Man page: grep.1 Issue: PATTERNS =E2=86=92 I "Interpret PATTERNS as Perl-compatible regular expressions (PCREs). This " "option is experimental when combined with the B<-z> (B<-\\^-null-data>) " "option, and B may warn of unimplemented features." -- Man page: grep.1 Issue: Not in "grep --help"; remove? "B<-y>" -- Man page: grep.1 Issue: Not in --help; is it a valid option? "B<-u>, B<-\\^-unix-byte-offsets>" -- Man page: grep.1 Issue: grep should be in B<> "Read all files under each directory, recursively, following symbolic links= " "only if they are on the command line. Note that if no file operand is " "given, grep searches the working directory. This is equivalent to the B<-= d " "recurse> option." --=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-17231-1608567089-0001-2 Content-Type: application/pgp-signature; name="signature.asc" Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- iQIzBAABCAAdFiEEbZZfteMW0gNUynuwQbqlJmgq5nAFAl/gySwACgkQQbqlJmgq 5nCZqg/9EymeTwZ78PnYSfUglJN2jrx/Ha9zneBD+wNMu/19ts+s0c00brcnaAWK sjDUbfQeTZehjHSQOhBy3KW/zsttkViTr+gHtoNJ3ByNkycnYSyfwJD0mRu1Rn7h Ee1npT4C/cYJ5CthqHIkwfLbNENE0grfdP/k+L0/zUGa4JoB2Y/ZkYb6ezPaOuru soz508FgHJm8dKXWe57HUdjAWBgIQH+eGZ0/7fi7XPMUyy5P4iNF0STOi+fFiIqS rqylN0UO1XG4+hFx3hsOPW8cr27NS+BWxhDGnPF+55YGyjqf+QhXcQlG3ZMj8WSH qaUb1EHxpUWy5SjJBpggkynPMQzkVcgz5SVJvx6Kltyg07KmQDejewwGOG6ptZpR OVb6nHY+D9lNTf6Ac2ke21Ig024Glt66Thj2Fq5moGVHUbfO5ItiGHXl2NVBhqZD R7AJkmuTc6d+RhwFhHzptVh0Z2MVFqsXfAH+ck0Hhxgb77xypC+nX/gjb5zr0feO 1nuvy9ss0yU3Qxs/BwoJwlvgS88d39OXJZV+cLNy/40PDMTTUJE1fOJRuT+P+HF8 b3AEmiF44c2Ynw4ZWeoucdOQO/g7gzOpWNhgjRey2QEryBPO1iovsALCyO/eUpEL bQIHJo/xseqTg9gvtjsArkcu7GLdC36oFIZuA+EiDCilZrxjAtE= =vPE8 -----END PGP SIGNATURE----- --=_luckmann.name-17231-1608567089-0001-2-- From unknown Sat Jun 14 19:24:59 2025 X-Loop: help-debbugs@gnu.org Subject: bug#45353: Errors in man pages Resent-From: Jim Meyering Original-Sender: "Debbugs-submit" Resent-CC: bug-grep@gnu.org Resent-Date: Wed, 23 Dec 2020 16:47:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 45353 X-GNU-PR-Package: grep X-GNU-PR-Keywords: To: Helge Kreutzmann Cc: 45353@debbugs.gnu.org Received: via spool by 45353-submit@debbugs.gnu.org id=B45353.16087419864700 (code B ref 45353); Wed, 23 Dec 2020 16:47:01 +0000 Received: (at 45353) by debbugs.gnu.org; 23 Dec 2020 16:46:26 +0000 Received: from localhost ([127.0.0.1]:53966 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ks7HN-0001Dj-W7 for submit@debbugs.gnu.org; Wed, 23 Dec 2020 11:46:26 -0500 Received: from mail-wr1-f43.google.com ([209.85.221.43]:40143) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ks7HK-0001DU-UZ for 45353@debbugs.gnu.org; Wed, 23 Dec 2020 11:46:24 -0500 Received: by mail-wr1-f43.google.com with SMTP id 91so19229698wrj.7 for <45353@debbugs.gnu.org>; Wed, 23 Dec 2020 08:46:22 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=2CjwsBfbAroEMhBCAPjd1jFIPKmBwdKK9H/DVoCYwRw=; b=GWGCXEjRVwBNyf6MPF6QyJoXGTCO9OoNpx4uGRzy00rnFixuPSwBaEDEa0rqZOTEFi TN3q48Rd9As8xD3g+uUndpHNZYy4kn4Zi0KoYTmykYvZHGqWQLI9HVfm+D/WXcYvf3HA P9Z5vz2XJh5ukznWdH99ZumCJ4czTT1XQHIKr7SwTHEdyHRNvLiuT2eZ7piMgz+w4VOR hmAnwEybjUU6WdFmcUmWHVFmqpndv8cQl2m2ZkWwI5LeRUYeNu029mKaIp1dWzX9MLiI 5LIJQLwXGXbrgjRRSE0RKv5lTfO1iyrZ/vUf77lYMhTmcNjzv1xwl9QUlxfCmONPthrt Fa7w== X-Gm-Message-State: AOAM5309WLYx/esg4uhhHV22UcXzfVEeRKIS66aJI0DCB2L+7H+clKTB ZOXgCre2QZHJfUsUeSakJLK9zpdjCnN0akpQMgE= X-Google-Smtp-Source: ABdhPJwXIE+6uJXW9DbkE/osBHi/jIFa3Fy/+uC/Mgd8qPw6ECX0LEZ/H2usogPlfqcdAA4C2KbByZQhUnx4nEP9y1s= X-Received: by 2002:adf:aa83:: with SMTP id h3mr30782793wrc.108.1608741977109; Wed, 23 Dec 2020 08:46:17 -0800 (PST) MIME-Version: 1.0 References: <20201221161129.GA17189@Debian-50-lenny-64-minimal> In-Reply-To: <20201221161129.GA17189@Debian-50-lenny-64-minimal> From: Jim Meyering Date: Wed, 23 Dec 2020 08:46:05 -0800 Message-ID: Content-Type: multipart/mixed; boundary="00000000000014ced305b7246ead" X-Spam-Score: 0.5 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.5 (/) --00000000000014ced305b7246ead Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Mon, Dec 21, 2020 at 8:12 AM Helge Kreutzmann wro= te: ... Thank you for the suggestions. > Man page: grep.1 > Issue: The option was mentioned above! > > "Suppress normal output; instead print a count of matching lines for each= " > "input file. With the B<-v>, B<-\\^-invert-match> option (see below), co= unt " > "non-matching lines." That is expected. Its primary description is above. This part tells how it works when combined with the -c option. > -- > Man page: grep.1 > Issue: Reorder text? > > "Report Unix-style byte offsets. This switch causes B to report by= te " > "offsets as if the file were a Unix-style text file, i.e., with CR charac= ters " > "stripped off. This will produce results identical to running B on= a " > "Unix machine. This option has no effect unless B<-b> option is also use= d; " > "it has no effect on platforms other than MS-DOS and MS-Windows." As mentioned below, this entire option (-u) is about to disappear. > -- > Man page: grep.1 > Issue 1: pcresyntax(3) =E2=86=92 B(3) > Issue 2: pcrepattern(3) =E2=86=92 B(3) > > "B understands three different versions of regular expression synta= x: " > "``basic'' (BRE), ``extended'' (ERE) and ``perl'' (PCRE). In GNU B= " > "there is no difference in available functionality between basic and exte= nded " > "syntaxes. In other implementations, basic regular expressions are less = " > "powerful. The following description applies to extended regular " > "expressions; differences for basic regular expressions are summarized " > "afterwards. Perl-compatible regular expressions give additional " > "functionality, and are documented in pcresyntax(3) and pcrepattern(3), b= ut " > "work only if PCRE is available in the system." Done. > -- > Man page: grep.1 > Issue: Order of entrie not according to man-pages(7) > > "B(1), B(1), B(1), B(1), B(1), B(1), " > "B(1), B(1), B(2), B(3), B(3), " > "B(3), B(5), B(7), B(7)." I read man-pages(7)'s section on SEE ALSO and found only one nit here. It terminated the list with a period, while man-pages(7) says to provide no period. > The list should be ordered by section number and then alphabetically by n= ame. Do not terminate this list with a period. If there's something else, please be more precise. Actually, for each suggestion in the future, please provide an actual diff. That would be far better. > -- > Man page: grep.1 > Issue: PATTERNS =E2=86=92 I > > "Interpret PATTERNS as Perl-compatible regular expressions (PCREs). This= " > "option is experimental when combined with the B<-z> (B<-\\^-null-data>) = " > "option, and B may warn of unimplemented features." > -- > Man page: grep.1 > Issue: Not in "grep --help"; remove? > > "B<-y>" This is deliberate. Undocumenting is a necessary step prior to removal of legacy options like this: $ git grep -e -y doc|tail -1 doc/grep.texi:@option{-y} is an obsolete synonym that is provided for compatibility. > -- > Man page: grep.1 > Issue: Not in --help; is it a valid option? > > "B<-u>, B<-\\^-unix-byte-offsets>" Similarly, case 'u': /* Obsolete option; it has no effect. FIXME: Diagnose use of this option starting in (say) the year 2020. */ break; I'm doing as that suggests in a separate commit. > -- > Man page: grep.1 > Issue: grep should be in B<> > > "Read all files under each directory, recursively, following symbolic lin= ks " > "only if they are on the command line. Note that if no file operand is " > "given, grep searches the working directory. This is equivalent to the B= <-d " > "recurse> option." Done. I wrote the attached patch in your name. Let me know if there's anything else to be done here. --00000000000014ced305b7246ead Content-Type: application/octet-stream; name="0001-doc-adjust-man-page-syntax.patch" Content-Disposition: attachment; filename="0001-doc-adjust-man-page-syntax.patch" Content-Transfer-Encoding: base64 Content-ID: X-Attachment-Id: f_kj1ncjfd0 RnJvbSAwNzA1YjkxMzlhZWMwMjY3YTc5OWExODU5YmQyMzFiYjgzMTcwMzc0IE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBIZWxnZSBLcmV1dHptYW5uIDxkZWJpYW5AaGVsZ2VmamVsbC5k ZT4KRGF0ZTogV2VkLCAyMyBEZWMgMjAyMCAwODo0MToyMiAtMDgwMApTdWJqZWN0OiBbUEFUQ0hd IGRvYzogYWRqdXN0IG1hbiBwYWdlIHN5bnRheAoKKiBkb2MvZ3JlcC5pbi4xOiBNYXJrIHNvbWUg bWFudWFsIG5hbWVzIHdpdGggQjwuLi4+LgpEcm9wIGZpbmFsIHBlcmlvZCBpbiBTRUUgQUxTTy4K VGhpcyByZXNvbHZlcyBodHRwczovL2J1Z3MuZ251Lm9yZy80NTM1MwotLS0KIGRvYy9ncmVwLmlu LjEgfCA4ICsrKystLS0tCiAxIGZpbGUgY2hhbmdlZCwgNCBpbnNlcnRpb25zKCspLCA0IGRlbGV0 aW9ucygtKQoKZGlmZiAtLWdpdCBhL2RvYy9ncmVwLmluLjEgYi9kb2MvZ3JlcC5pbi4xCmluZGV4 IGM1NmM0MDQuLmQ1ZTM1MzQgMTAwNjQ0Ci0tLSBhL2RvYy9ncmVwLmluLjEKKysrIGIvZG9jL2dy ZXAuaW4uMQpAQCAtNjk1LDcgKzY5NSw3IEBAIG9wdGlvbnMgbWF0Y2gsIGEgZmlsZSBpcyBpbmNs dWRlZCB1bmxlc3MgdGhlIGZpcnN0IHN1Y2ggb3B0aW9uIGlzCiAuQlIgXC1yICIsICIgXC1cXlwt cmVjdXJzaXZlCiBSZWFkIGFsbCBmaWxlcyB1bmRlciBlYWNoIGRpcmVjdG9yeSwgcmVjdXJzaXZl bHksCiBmb2xsb3dpbmcgc3ltYm9saWMgbGlua3Mgb25seSBpZiB0aGV5IGFyZSBvbiB0aGUgY29t bWFuZCBsaW5lLgotTm90ZSB0aGF0IGlmIG5vIGZpbGUgb3BlcmFuZCBpcyBnaXZlbiwgZ3JlcCBz ZWFyY2hlcyB0aGUgd29ya2luZyBkaXJlY3RvcnkuCitOb3RlIHRoYXQgaWYgbm8gZmlsZSBvcGVy YW5kIGlzIGdpdmVuLCBCPGdyZXA+IHNlYXJjaGVzIHRoZSB3b3JraW5nIGRpcmVjdG9yeS4KIFRo aXMgaXMgZXF1aXZhbGVudCB0byB0aGUKIC5CICJcLWQgcmVjdXJzZSIKIG9wdGlvbi4KQEAgLTc2 MSw4ICs3NjEsOCBAQCBJbiBvdGhlciBpbXBsZW1lbnRhdGlvbnMsIGJhc2ljIHJlZ3VsYXIgZXhw cmVzc2lvbnMgYXJlIGxlc3MgcG93ZXJmdWwuCiBUaGUgZm9sbG93aW5nIGRlc2NyaXB0aW9uIGFw cGxpZXMgdG8gZXh0ZW5kZWQgcmVndWxhciBleHByZXNzaW9uczsKIGRpZmZlcmVuY2VzIGZvciBi YXNpYyByZWd1bGFyIGV4cHJlc3Npb25zIGFyZSBzdW1tYXJpemVkIGFmdGVyd2FyZHMuCiBQZXJs LWNvbXBhdGlibGUgcmVndWxhciBleHByZXNzaW9ucyBnaXZlIGFkZGl0aW9uYWwgZnVuY3Rpb25h bGl0eSwgYW5kIGFyZQotZG9jdW1lbnRlZCBpbiBwY3Jlc3ludGF4KDMpIGFuZCBwY3JlcGF0dGVy bigzKSwgYnV0IHdvcmsgb25seSBpZgotUENSRSBpcyBhdmFpbGFibGUgaW4gdGhlIHN5c3RlbS4K K2RvY3VtZW50ZWQgaW4gQjxwY3Jlc3ludGF4PigzKSBhbmQgQjxwY3JlcGF0dGVybj4oMyksIGJ1 dCB3b3JrIG9ubHkgaWYKK1BDUkUgc3VwcG9ydCBpcyBlbmFibGVkLgogLlBQCiBUaGUgZnVuZGFt ZW50YWwgYnVpbGRpbmcgYmxvY2tzIGFyZSB0aGUgcmVndWxhciBleHByZXNzaW9ucwogdGhhdCBt YXRjaCBhIHNpbmdsZSBjaGFyYWN0ZXIuCkBAIC0xMzcwLDcgKzEzNzAsNyBAQCBmcm9tIHRoZSBn bG9iYmluZyBzeW50YXggdGhhdCB0aGUgc2hlbGwgdXNlcyB0byBtYXRjaCBmaWxlIG5hbWVzLgog LkJSIHBjcmVwYXR0ZXJuICgzKSwKIC5CUiB0ZXJtaW5mbyAoNSksCiAuQlIgZ2xvYiAoNyksCi0u QlIgcmVnZXggKDcpLgorLkJSIHJlZ2V4ICg3KQogLlNTICJGdWxsIERvY3VtZW50YXRpb24iCiBB CiAuVVIgaHR0cHM6Ly93d3cuZ251Lm9yZy9zb2Z0d2FyZS9ncmVwL21hbnVhbC8KLS0gCjIuMzAu MC5yYzEKCg== --00000000000014ced305b7246ead-- From unknown Sat Jun 14 19:24:59 2025 X-Loop: help-debbugs@gnu.org Subject: bug#45353: Errors in man pages Resent-From: Jim Meyering Original-Sender: "Debbugs-submit" Resent-CC: bug-grep@gnu.org Resent-Date: Wed, 23 Dec 2020 17:15:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 45353 X-GNU-PR-Package: grep X-GNU-PR-Keywords: To: Helge Kreutzmann Cc: 45353@debbugs.gnu.org Received: via spool by 45353-submit@debbugs.gnu.org id=B45353.16087436827445 (code B ref 45353); Wed, 23 Dec 2020 17:15:02 +0000 Received: (at 45353) by debbugs.gnu.org; 23 Dec 2020 17:14:42 +0000 Received: from localhost ([127.0.0.1]:54004 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ks7ik-0001w1-A8 for submit@debbugs.gnu.org; Wed, 23 Dec 2020 12:14:42 -0500 Received: from mail-wm1-f49.google.com ([209.85.128.49]:51039) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ks7ih-0001vn-Fj for 45353@debbugs.gnu.org; Wed, 23 Dec 2020 12:14:40 -0500 Received: by mail-wm1-f49.google.com with SMTP id 190so71515wmz.0 for <45353@debbugs.gnu.org>; Wed, 23 Dec 2020 09:14:39 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=DVdTNiy9b+dqsygmVt6mgAtoCOzIs4tjFr0Xk7iDpXk=; b=rJRBhHxdwnkfJjXhceMAr7Ob/GxhSAxhXktt9sXVIypnMyKtJpTZTV4gac45hMQkFq f3IzQf0PVXVx/0gZAPB8y9egt4x37q67DG7PKDIrpofgWBT0Nl/7UME+m+BWVglqHdzL oV+7lAbHuCwxXXBm6p1b1oLOWXt7MoAjzfiOZT5sVCvOFjelNLu2wi8fmhBIK2V90eju iy+1RiZYLIynmjaDpcyUjTDSLFWLxFMn4YP0LHnv5O2kWOnMB0hS7Bxqsb5Bo4Rb2O+K c00aI3cy/G/55DjZEwRDRMYcWsOJ4mAegvHWI3AlCQfku1uhTWjl67v440YSMVcNQQGA shfQ== X-Gm-Message-State: AOAM530p+g3l0QtUiTSlJ0mLhi0PciftlqTaPMs8rteP3qJtuAV9iHMV nLUHpWtARvF4xt153pKklpGjoEGMj2uXKc2I8YM= X-Google-Smtp-Source: ABdhPJy9lTQhpAGgrgyF4H/OInrkZqx2DNIyNS0WbUIcsglmqjEpsJp72di/uGYXbQtBe7FpTEEvZAx06Mw2BiyZvMM= X-Received: by 2002:a1c:23d5:: with SMTP id j204mr671541wmj.130.1608743673431; Wed, 23 Dec 2020 09:14:33 -0800 (PST) MIME-Version: 1.0 References: <20201221161129.GA17189@Debian-50-lenny-64-minimal> In-Reply-To: From: Jim Meyering Date: Wed, 23 Dec 2020 09:14:20 -0800 Message-ID: Content-Type: multipart/mixed; boundary="00000000000030b3e205b724d3c6" X-Spam-Score: 0.5 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.5 (/) --00000000000030b3e205b724d3c6 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Wed, Dec 23, 2020 at 8:46 AM Jim Meyering wrote: > > On Mon, Dec 21, 2020 at 8:12 AM Helge Kreutzmann w= rote: > ... > > Thank you for the suggestions. > > > Man page: grep.1 > > Issue: The option was mentioned above! > > > > "Suppress normal output; instead print a count of matching lines for ea= ch " > > "input file. With the B<-v>, B<-\\^-invert-match> option (see below), = count " > > "non-matching lines." > > That is expected. Its primary description is above. > This part tells how it works when combined with the -c option. > > > -- > > Man page: grep.1 > > Issue: Reorder text? > > > > "Report Unix-style byte offsets. This switch causes B to report = byte " > > "offsets as if the file were a Unix-style text file, i.e., with CR char= acters " > > "stripped off. This will produce results identical to running B = on a " > > "Unix machine. This option has no effect unless B<-b> option is also u= sed; " > > "it has no effect on platforms other than MS-DOS and MS-Windows." > > As mentioned below, this entire option (-u) is about to disappear. > > > -- > > Man page: grep.1 > > Issue 1: pcresyntax(3) =E2=86=92 B(3) > > Issue 2: pcrepattern(3) =E2=86=92 B(3) > > > > "B understands three different versions of regular expression syn= tax: " > > "``basic'' (BRE), ``extended'' (ERE) and ``perl'' (PCRE). In GNU B " > > "there is no difference in available functionality between basic and ex= tended " > > "syntaxes. In other implementations, basic regular expressions are les= s " > > "powerful. The following description applies to extended regular " > > "expressions; differences for basic regular expressions are summarized = " > > "afterwards. Perl-compatible regular expressions give additional " > > "functionality, and are documented in pcresyntax(3) and pcrepattern(3),= but " > > "work only if PCRE is available in the system." > > Done. > > > -- > > Man page: grep.1 > > Issue: Order of entrie not according to man-pages(7) > > > > "B(1), B(1), B(1), B(1), B(1), B(1), " > > "B(1), B(1), B(2), B(3), B(3), " > > "B(3), B(5), B(7), B(7)." > > I read man-pages(7)'s section on SEE ALSO and found only one nit here. > It terminated the list with a period, while man-pages(7) says to > provide no period. > > > The list should be ordered by section number and then alphabetically by= name. Do not terminate this list with a period. > > If there's something else, please be more precise. > > Actually, for each suggestion in the future, please provide an actual > diff. That would be far better. > > > -- > > Man page: grep.1 > > Issue: PATTERNS =E2=86=92 I > > > > "Interpret PATTERNS as Perl-compatible regular expressions (PCREs). Th= is " > > "option is experimental when combined with the B<-z> (B<-\\^-null-data>= ) " > > "option, and B may warn of unimplemented features." Oops. Nearly missed this. I've done this, too. New patch attached. ... > > I wrote the attached patch in your name. > Let me know if there's anything else to be done here. --00000000000030b3e205b724d3c6 Content-Type: application/octet-stream; name="0001-doc-adjust-man-page-syntax.patch" Content-Disposition: attachment; filename="0001-doc-adjust-man-page-syntax.patch" Content-Transfer-Encoding: base64 Content-ID: X-Attachment-Id: f_kj1offaj0 RnJvbSBlNmJjMDczOTc0NGZhMTIwMjZjNTliYzViYTkwNDcxOTVmN2I2MDNkIE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBIZWxnZSBLcmV1dHptYW5uIDxkZWJpYW5AaGVsZ2VmamVsbC5k ZT4KRGF0ZTogV2VkLCAyMyBEZWMgMjAyMCAwODo0MToyMiAtMDgwMApTdWJqZWN0OiBbUEFUQ0hd IGRvYzogYWRqdXN0IG1hbiBwYWdlIHN5bnRheAoKKiBkb2MvZ3JlcC5pbi4xOiBNYXJrIHNvbWUg bWFudWFsIG5hbWVzIHdpdGggQjwuLi4+LgpNYXJrIFBBVFRFUk5TIHdpdGggSTwuLi4+LgpEcm9w IGZpbmFsIHBlcmlvZCBpbiBTRUUgQUxTTy4KVGhpcyByZXNvbHZlcyBodHRwczovL2J1Z3MuZ251 Lm9yZy80NTM1MwotLS0KIGRvYy9ncmVwLmluLjEgfCAxMCArKysrKy0tLS0tCiAxIGZpbGUgY2hh bmdlZCwgNSBpbnNlcnRpb25zKCspLCA1IGRlbGV0aW9ucygtKQoKZGlmZiAtLWdpdCBhL2RvYy9n cmVwLmluLjEgYi9kb2MvZ3JlcC5pbi4xCmluZGV4IGE5NmRjYzkuLjE5MWE3NTEgMTAwNjQ0Ci0t LSBhL2RvYy9ncmVwLmluLjEKKysrIGIvZG9jL2dyZXAuaW4uMQpAQCAtMjI1LDcgKzIyNSw3IEBA IGFzIGJhc2ljIHJlZ3VsYXIgZXhwcmVzc2lvbnMgKEJSRXMsIHNlZSBiZWxvdykuCiBUaGlzIGlz IHRoZSBkZWZhdWx0LgogLlRQCiAuQlIgXC1QICIsICIgXC1cXlwtcGVybFwtcmVnZXhwCi1JbnRl cnByZXQgUEFUVEVSTlMgYXMgUGVybC1jb21wYXRpYmxlIHJlZ3VsYXIgZXhwcmVzc2lvbnMgKFBD UkVzKS4KK0ludGVycHJldCBJPFBBVFRFUk5TPiBhcyBQZXJsLWNvbXBhdGlibGUgcmVndWxhciBl eHByZXNzaW9ucyAoUENSRXMpLgogVGhpcyBvcHRpb24gaXMgZXhwZXJpbWVudGFsIHdoZW4gY29t YmluZWQgd2l0aCB0aGUKIC5CIFwtegogLlJCICggXC1cXlwtbnVsbFwtZGF0YSApCkBAIC02ODUs NyArNjg1LDcgQEAgb3B0aW9ucyBtYXRjaCwgYSBmaWxlIGlzIGluY2x1ZGVkIHVubGVzcyB0aGUg Zmlyc3Qgc3VjaCBvcHRpb24gaXMKIC5CUiBcLXIgIiwgIiBcLVxeXC1yZWN1cnNpdmUKIFJlYWQg YWxsIGZpbGVzIHVuZGVyIGVhY2ggZGlyZWN0b3J5LCByZWN1cnNpdmVseSwKIGZvbGxvd2luZyBz eW1ib2xpYyBsaW5rcyBvbmx5IGlmIHRoZXkgYXJlIG9uIHRoZSBjb21tYW5kIGxpbmUuCi1Ob3Rl IHRoYXQgaWYgbm8gZmlsZSBvcGVyYW5kIGlzIGdpdmVuLCBncmVwIHNlYXJjaGVzIHRoZSB3b3Jr aW5nIGRpcmVjdG9yeS4KK05vdGUgdGhhdCBpZiBubyBmaWxlIG9wZXJhbmQgaXMgZ2l2ZW4sIEI8 Z3JlcD4gc2VhcmNoZXMgdGhlIHdvcmtpbmcgZGlyZWN0b3J5LgogVGhpcyBpcyBlcXVpdmFsZW50 IHRvIHRoZQogLkIgIlwtZCByZWN1cnNlIgogb3B0aW9uLgpAQCAtNzUxLDggKzc1MSw4IEBAIElu IG90aGVyIGltcGxlbWVudGF0aW9ucywgYmFzaWMgcmVndWxhciBleHByZXNzaW9ucyBhcmUgbGVz cyBwb3dlcmZ1bC4KIFRoZSBmb2xsb3dpbmcgZGVzY3JpcHRpb24gYXBwbGllcyB0byBleHRlbmRl ZCByZWd1bGFyIGV4cHJlc3Npb25zOwogZGlmZmVyZW5jZXMgZm9yIGJhc2ljIHJlZ3VsYXIgZXhw cmVzc2lvbnMgYXJlIHN1bW1hcml6ZWQgYWZ0ZXJ3YXJkcy4KIFBlcmwtY29tcGF0aWJsZSByZWd1 bGFyIGV4cHJlc3Npb25zIGdpdmUgYWRkaXRpb25hbCBmdW5jdGlvbmFsaXR5LCBhbmQgYXJlCi1k b2N1bWVudGVkIGluIHBjcmVzeW50YXgoMykgYW5kIHBjcmVwYXR0ZXJuKDMpLCBidXQgd29yayBv bmx5IGlmCi1QQ1JFIGlzIGF2YWlsYWJsZSBpbiB0aGUgc3lzdGVtLgorZG9jdW1lbnRlZCBpbiBC PHBjcmVzeW50YXg+KDMpIGFuZCBCPHBjcmVwYXR0ZXJuPigzKSwgYnV0IHdvcmsgb25seSBpZgor UENSRSBzdXBwb3J0IGlzIGVuYWJsZWQuCiAuUFAKIFRoZSBmdW5kYW1lbnRhbCBidWlsZGluZyBi bG9ja3MgYXJlIHRoZSByZWd1bGFyIGV4cHJlc3Npb25zCiB0aGF0IG1hdGNoIGEgc2luZ2xlIGNo YXJhY3Rlci4KQEAgLTEzNjAsNyArMTM2MCw3IEBAIGZyb20gdGhlIGdsb2JiaW5nIHN5bnRheCB0 aGF0IHRoZSBzaGVsbCB1c2VzIHRvIG1hdGNoIGZpbGUgbmFtZXMuCiAuQlIgcGNyZXBhdHRlcm4g KDMpLAogLkJSIHRlcm1pbmZvICg1KSwKIC5CUiBnbG9iICg3KSwKLS5CUiByZWdleCAoNykuCisu QlIgcmVnZXggKDcpCiAuU1MgIkZ1bGwgRG9jdW1lbnRhdGlvbiIKIEEKIC5VUiBodHRwczovL3d3 dy5nbnUub3JnL3NvZnR3YXJlL2dyZXAvbWFudWFsLwotLSAKMi4zMC4wLnJjMQoK --00000000000030b3e205b724d3c6-- From unknown Sat Jun 14 19:24:59 2025 X-Loop: help-debbugs@gnu.org Subject: bug#45353: Errors in man pages Resent-From: Helge Kreutzmann Original-Sender: "Debbugs-submit" Resent-CC: bug-grep@gnu.org Resent-Date: Wed, 23 Dec 2020 18:04:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 45353 X-GNU-PR-Package: grep X-GNU-PR-Keywords: To: Jim Meyering Cc: 45353@debbugs.gnu.org Received: via spool by 45353-submit@debbugs.gnu.org id=B45353.160874659212096 (code B ref 45353); Wed, 23 Dec 2020 18:04:02 +0000 Received: (at 45353) by debbugs.gnu.org; 23 Dec 2020 18:03:12 +0000 Received: from localhost ([127.0.0.1]:54054 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ks8Tf-000390-Jt for submit@debbugs.gnu.org; Wed, 23 Dec 2020 13:03:11 -0500 Received: from luckmann.name ([213.239.213.133]:41381 helo=static.213-239-213-133.clients.your-server.de) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ks8Td-00038n-Tf for 45353@debbugs.gnu.org; Wed, 23 Dec 2020 13:03:10 -0500 Received: from localhost (localhost [127.0.0.1]) (uid 502) by static.213-239-213-133.clients.your-server.de with local id 0000000000E54040.000000005FE38656.00006B72; Wed, 23 Dec 2020 19:03:02 +0100 Date: Wed, 23 Dec 2020 19:03:02 +0100 From: Helge Kreutzmann Message-ID: <20201223180302.GA24821@Debian-50-lenny-64-minimal> References: <20201221161129.GA17189@Debian-50-lenny-64-minimal> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="=_luckmann.name-27506-1608746582-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-Score: 4.2 (++++) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: Hello Jim, On Wed, Dec 23, 2020 at 09:14:20AM -0800, Jim Meyering wrote: > On Wed, Dec 23, 2020 at 8:46 AM Jim Meyering wrote: > > On Mon, Dec 21, 2020 at 8:12 AM Helge Kreutzmann < [...] Content analysis details: (4.2 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- 0.2 CK_HELO_GENERIC Relay used name indicative of a Dynamic Pool or Generic rPTR 0.1 URIBL_SBL_A Contains URL's A record listed in the Spamhaus SBL blocklist [URIs: www.ffii.de] 0.6 URIBL_SBL Contains an URL's NS IP listed in the Spamhaus SBL blocklist [URIs: www.ffii.de] 0.0 SPF_NONE SPF: sender does not publish an SPF Record 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record 3.2 HELO_DYNAMIC_IPADDR Relay HELO'd using suspicious hostname (IP addr 1) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 3.2 (+++) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: Hello Jim, On Wed, Dec 23, 2020 at 09:14:20AM -0800, Jim Meyering wrote: > On Wed, Dec 23, 2020 at 8:46 AM Jim Meyering wrote: > > On Mon, Dec 21, 2020 at 8:12 AM Helge Kreutzmann < [...] Content analysis details: (3.2 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- 0.1 URIBL_SBL_A Contains URL's A record listed in the Spamhaus SBL blocklist [URIs: www.ffii.de] 0.6 URIBL_SBL Contains an URL's NS IP listed in the Spamhaus SBL blocklist [URIs: www.ffii.de] 0.2 CK_HELO_GENERIC Relay used name indicative of a Dynamic Pool or Generic rPTR 0.0 SPF_NONE SPF: sender does not publish an SPF Record 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record -1.0 MAILING_LIST_MULTI Multiple indicators imply a widely-seen list manager 3.2 HELO_DYNAMIC_IPADDR Relay HELO'd using suspicious hostname (IP addr 1) 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-27506-1608746582-0001-2 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hello Jim, On Wed, Dec 23, 2020 at 09:14:20AM -0800, Jim Meyering wrote: > On Wed, Dec 23, 2020 at 8:46 AM Jim Meyering wrote: > > On Mon, Dec 21, 2020 at 8:12 AM Helge Kreutzmann = wrote: > > Thank you for the suggestions. You are welcome. Thanks for handling them this quickly. I'm only citing parts where necessary, not those where no question or disagreement is raised. Where applicable, I denote that in our translated files so the translators in question are aware of your rationales. > > > -- > > > Man page: grep.1 > > > Issue: Order of entrie not according to man-pages(7) > > > > > > "B(1), B(1), B(1), B(1), B(1), B(1),= " > > > "B(1), B(1), B(2), B(3), B(3), " > > > "B(3), B(5), B(7), B(7)." > > > > I read man-pages(7)'s section on SEE ALSO and found only one nit here. > > It terminated the list with a period, while man-pages(7) says to > > provide no period. > > > > > The list should be ordered by section number and then alphabetically = by name. Do not terminate this list with a period. > > > > If there's something else, please be more precise. This is a nit pick by some translators. I suggest to ignore this particular issue (I personally don't share their views anymore), I will mark it WONTFIX in our files. > > Actually, for each suggestion in the future, please provide an actual > > diff. That would be far better. As stated in the introductory text that's unfortunatly not possible. manpages-l10n has over 100 upstreams an we do not have the man power to provide full diffs, sorry. (And sometimes we only see that's something is strange, but do not know how it should be). However, do not hesitate to ask in any unclear case (when I have not=20 been precise enough, despite best efforts). If in doubt I'll double check with the original translator as well. > > I wrote the attached patch in your name. > > Let me know if there's anything else to be done here. I'm fine if you put my name in there. If possible it would be fair if you could denote (in a comment of commit message) that the input came =66rom several members of the manpage-l10n translation community. 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-27506-1608746582-0001-2 Content-Type: application/pgp-signature; name="signature.asc" Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- iQIzBAABCAAdFiEEbZZfteMW0gNUynuwQbqlJmgq5nAFAl/jhlQACgkQQbqlJmgq 5nDuMw/+IpeBN0tJXR5RwnAH7lYT12R1AT49pp/nAmShFjaaFNr9AWtwePlRQvkX IIyQNFYaeOpXIePXj7Qpa1XLDlfXoidk5lNnPgDnNypCUMJzc/4Xbi50MZGV6frX WrJjgYLSCUPkYFmbNenzg5KsM+6FlV2pOKwIgWubNCL4xv6TQ62664Q5OT6SN8vr q8jqFtnfAp58NEX+ctMQ19b2yiosRhMnOwwbnStvy9NhnYCfAx2RFmrYtQBQy1iO V9JxJfDihso/1VptDKMe++oKBG0aVlPyGL5QUm1UmksG7DzyW8TumB5tMw4rnG1s 9uD1w7vAmxx9v75EMBWPL7cbNbSKuibBTrdUyJYNemwYHM0A/N+BFPdJ4gi7viiq NVPb4neEpda4LppJ5r6ru5YSw1s22czgnAzPe9mhPVVkSlnoYTtE/54eclmZoHRH zMgM9B6V+sn0ZZXvYNKE9mB3K0nV+gTbwS90mZm6Jn7DpPfWbsFn7cjyUrP95pVW JtZ2AacCP9Sf6xVXV15ZLG98cSdPaPgFrH0eCq3K+vxkh3bDSPmTBeoaXw0z68+S 1QPcONHoL2bfT/VldrUGXp55MCCPkxmbxD29b9sCKHLZGWCSpIWBtJVZUnhTtiNk V2868HMdEqdzbWeG8NCMi5pKJ+nbfUN7ugIR17yBhjoc80nsVsc= =LweU -----END PGP SIGNATURE----- --=_luckmann.name-27506-1608746582-0001-2-- From unknown Sat Jun 14 19:24:59 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Helge Kreutzmann Subject: bug#45353: closed (Re: bug#45353: Errors in man pages) Message-ID: References: <20201221161129.GA17189@Debian-50-lenny-64-minimal> X-Gnu-PR-Message: they-closed 45353 X-Gnu-PR-Package: grep Reply-To: 45353@debbugs.gnu.org Date: Wed, 23 Dec 2020 18:48:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1608749282-24723-1" This is a multi-part message in MIME format... ------------=_1608749282-24723-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #45353: Errors in man pages which was filed against the grep package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 45353@debbugs.gnu.org. --=20 45353: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D45353 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1608749282-24723-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 45353-done) by debbugs.gnu.org; 23 Dec 2020 18:48:01 +0000 Received: from localhost ([127.0.0.1]:54167 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ks9B2-0006QW-P4 for submit@debbugs.gnu.org; Wed, 23 Dec 2020 13:48:01 -0500 Received: from mail-wr1-f49.google.com ([209.85.221.49]:36008) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ks9B1-0006QH-2s for 45353-done@debbugs.gnu.org; Wed, 23 Dec 2020 13:47:59 -0500 Received: by mail-wr1-f49.google.com with SMTP id t16so172888wra.3 for <45353-done@debbugs.gnu.org>; Wed, 23 Dec 2020 10:47:58 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=wb80a/iUCn+CPB7LnEyLY/HSUB5R+/C/REUxsDEfWNI=; b=kxQrgv/5EwkLJ0OfZEC5kOZwXA8MsNvMd6w8YIYNw/KRfdJgZ1g3PU4F/tIdTfhIJ1 WpPGJr4gCbhyqNGTKjI6u8bz21eTl0gLm4U1PbddWEJKVPzg8n0G57BQ7qnOdYZvn71v MazvPC3RNmm+hcISi5YjfwSzZ/e1gPZXWpckPDCI/fMknR0IGTiBM+gx5DUF4Nx/Y1wX WMShJbTq5qY8IiPmTiv7s9KgK/O6NuDBfEF9nSWOYpR5qYYHeQdOMu0QvgydQ0G+NJ+L oqncDsjypGscazRJVFN0sdf8zyBDHU29vYOVGQjTKiBCiunqsRfUHufR9Pdp8GwUCE+d hqTA== X-Gm-Message-State: AOAM5303dN9SXFSR1pmgQMRHf7ypHLYBE6VasYdvY85So3UK9/TvTJBq J9YclYfZMo9keymDis3tXtrlJOkGvf22D6KY1is= X-Google-Smtp-Source: ABdhPJxH93+sGaHUO0FoEyVEAtdByC1l2bc1awhTE6EQQgLvRWmA3Muhx4/F8HWYAwiBSB7o2ge5vt6udzOvUOaocBA= X-Received: by 2002:a5d:44c6:: with SMTP id z6mr30868378wrr.306.1608749273437; Wed, 23 Dec 2020 10:47:53 -0800 (PST) MIME-Version: 1.0 References: <20201221161129.GA17189@Debian-50-lenny-64-minimal> <20201223180302.GA24821@Debian-50-lenny-64-minimal> In-Reply-To: <20201223180302.GA24821@Debian-50-lenny-64-minimal> From: Jim Meyering Date: Wed, 23 Dec 2020 10:47:41 -0800 Message-ID: Subject: Re: bug#45353: Errors in man pages To: Helge Kreutzmann Content-Type: text/plain; charset="UTF-8" X-Spam-Score: 0.5 (/) X-Debbugs-Envelope-To: 45353-done Cc: 45353-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.5 (/) On Wed, Dec 23, 2020 at 10:03 AM Helge Kreutzmann wrote: > > Hello Jim, > On Wed, Dec 23, 2020 at 09:14:20AM -0800, Jim Meyering wrote: > > On Wed, Dec 23, 2020 at 8:46 AM Jim Meyering wrote: > > > On Mon, Dec 21, 2020 at 8:12 AM Helge Kreutzmann wrote: > > > Thank you for the suggestions. > > You are welcome. Thanks for handling them this quickly. > > I'm only citing parts where necessary, not those where no question or > disagreement is raised. Where applicable, I denote that in our > translated files so the translators in question are aware of your > rationales. +1 ... > > I'm fine if you put my name in there. If possible it would be fair if > you could denote (in a comment of commit message) that the input came > from several members of the manpage-l10n translation community. Done and pushed. See this: https://git.savannah.gnu.org/cgit/grep.git/commit/?id=91ce9cdad384cb6d774e9884707c7f00946d909d ------------=_1608749282-24723-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 21 Dec 2020 16:11:41 +0000 Received: from localhost ([127.0.0.1]:48091 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1krNme-0005lb-Rq for submit@debbugs.gnu.org; Mon, 21 Dec 2020 11:11:41 -0500 Received: from lists.gnu.org ([209.51.188.17]:33044) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1krNmd-0005lT-44 for submit@debbugs.gnu.org; Mon, 21 Dec 2020 11:11:39 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:35064) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1krNma-00047A-5R for bug-grep@gnu.org; Mon, 21 Dec 2020 11:11:38 -0500 Received: from luckmann.name ([213.239.213.133]:54929 helo=static.213-239-213-133.clients.your-server.de) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1krNmX-0003Wg-L2 for bug-grep@gnu.org; Mon, 21 Dec 2020 11:11:35 -0500 Received: from localhost (localhost [127.0.0.1]) (uid 502) by static.213-239-213-133.clients.your-server.de with local id 0000000000E5600C.000000005FE0C931.0000434F; Mon, 21 Dec 2020 17:11:29 +0100 Date: Mon, 21 Dec 2020 17:11:29 +0100 From: Helge Kreutzmann To: bug-grep@gnu.org Subject: Errors in man pages Message-ID: <20201221161129.GA17189@Debian-50-lenny-64-minimal> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="=_luckmann.name-17231-1608567089-0001-2" Content-Disposition: inline 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) Received-SPF: none client-ip=213.239.213.133; envelope-from=debian@helgefjell.de; helo=static.213-239-213-133.clients.your-server.de X-Spam_score_int: 4 X-Spam_score: 0.4 X-Spam_bar: / X-Spam_report: (0.4 / 5.0 requ) BAYES_00=-1.9, CK_HELO_GENERIC=0.249, HELO_DYNAMIC_IPADDR=1.951, SPF_HELO_NONE=0.001, SPF_NONE=0.001, URIBL_SBL_A=0.1 autolearn=no autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.6 (-) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.6 (--) 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-17231-1608567089-0001-2 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Dear grep maintainer, the manpage-l10n project maintains a large number of translations of man pages both from a large variety of sources (including grep) 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: grep.1 Issue: The option was mentioned above! "Suppress normal output; instead print a count of matching lines for each " "input file. With the B<-v>, B<-\\^-invert-match> option (see below), coun= t " "non-matching lines." -- Man page: grep.1 Issue: Reorder text? "Report Unix-style byte offsets. This switch causes B to report byte= " "offsets as if the file were a Unix-style text file, i.e., with CR characte= rs " "stripped off. This will produce results identical to running B on a= " "Unix machine. This option has no effect unless B<-b> option is also used;= " "it has no effect on platforms other than MS-DOS and MS-Windows." -- Man page: grep.1 Issue 1: pcresyntax(3) =E2=86=92 B(3) Issue 2: pcrepattern(3) =E2=86=92 B(3) "B understands three different versions of regular expression syntax:= " "``basic'' (BRE), ``extended'' (ERE) and ``perl'' (PCRE). In GNU B " "there is no difference in available functionality between basic and extend= ed " "syntaxes. In other implementations, basic regular expressions are less " "powerful. The following description applies to extended regular " "expressions; differences for basic regular expressions are summarized " "afterwards. Perl-compatible regular expressions give additional " "functionality, and are documented in pcresyntax(3) and pcrepattern(3), but= " "work only if PCRE is available in the system." -- Man page: grep.1 Issue: Order of entrie not according to man-pages(7) "B(1), B(1), B(1), B(1), B(1), B(1), " "B(1), B(1), B(2), B(3), B(3), " "B(3), B(5), B(7), B(7)." -- Man page: grep.1 Issue: PATTERNS =E2=86=92 I "Interpret PATTERNS as Perl-compatible regular expressions (PCREs). This " "option is experimental when combined with the B<-z> (B<-\\^-null-data>) " "option, and B may warn of unimplemented features." -- Man page: grep.1 Issue: Not in "grep --help"; remove? "B<-y>" -- Man page: grep.1 Issue: Not in --help; is it a valid option? "B<-u>, B<-\\^-unix-byte-offsets>" -- Man page: grep.1 Issue: grep should be in B<> "Read all files under each directory, recursively, following symbolic links= " "only if they are on the command line. Note that if no file operand is " "given, grep searches the working directory. This is equivalent to the B<-= d " "recurse> option." --=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-17231-1608567089-0001-2 Content-Type: application/pgp-signature; name="signature.asc" Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- iQIzBAABCAAdFiEEbZZfteMW0gNUynuwQbqlJmgq5nAFAl/gySwACgkQQbqlJmgq 5nCZqg/9EymeTwZ78PnYSfUglJN2jrx/Ha9zneBD+wNMu/19ts+s0c00brcnaAWK sjDUbfQeTZehjHSQOhBy3KW/zsttkViTr+gHtoNJ3ByNkycnYSyfwJD0mRu1Rn7h Ee1npT4C/cYJ5CthqHIkwfLbNENE0grfdP/k+L0/zUGa4JoB2Y/ZkYb6ezPaOuru soz508FgHJm8dKXWe57HUdjAWBgIQH+eGZ0/7fi7XPMUyy5P4iNF0STOi+fFiIqS rqylN0UO1XG4+hFx3hsOPW8cr27NS+BWxhDGnPF+55YGyjqf+QhXcQlG3ZMj8WSH qaUb1EHxpUWy5SjJBpggkynPMQzkVcgz5SVJvx6Kltyg07KmQDejewwGOG6ptZpR OVb6nHY+D9lNTf6Ac2ke21Ig024Glt66Thj2Fq5moGVHUbfO5ItiGHXl2NVBhqZD R7AJkmuTc6d+RhwFhHzptVh0Z2MVFqsXfAH+ck0Hhxgb77xypC+nX/gjb5zr0feO 1nuvy9ss0yU3Qxs/BwoJwlvgS88d39OXJZV+cLNy/40PDMTTUJE1fOJRuT+P+HF8 b3AEmiF44c2Ynw4ZWeoucdOQO/g7gzOpWNhgjRey2QEryBPO1iovsALCyO/eUpEL bQIHJo/xseqTg9gvtjsArkcu7GLdC36oFIZuA+EiDCilZrxjAtE= =vPE8 -----END PGP SIGNATURE----- --=_luckmann.name-17231-1608567089-0001-2-- ------------=_1608749282-24723-1--