From unknown Sun Jun 22 04:11:37 2025 X-Loop: help-debbugs@gnu.org Subject: bug#71087: grep.in.1: some remarks and editorial changes for this man page Resent-From: Bjarni Ingi Gislason Original-Sender: "Debbugs-submit" Resent-CC: bug-grep@gnu.org Resent-Date: Tue, 21 May 2024 02:35:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 71087 X-GNU-PR-Package: grep X-GNU-PR-Keywords: To: 71087@debbugs.gnu.org X-Debbugs-Original-To: bug-grep@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.171625885223633 (code B ref -1); Tue, 21 May 2024 02:35:01 +0000 Received: (at submit) by debbugs.gnu.org; 21 May 2024 02:34:12 +0000 Received: from localhost ([127.0.0.1]:46344 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1s9FKO-000697-7Q for submit@debbugs.gnu.org; Mon, 20 May 2024 22:34:12 -0400 Received: from lists.gnu.org ([209.51.188.17]:51364) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1s9FKK-000691-Bx for submit@debbugs.gnu.org; Mon, 20 May 2024 22:34:11 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1s9FKE-0000iY-OV for bug-grep@gnu.org; Mon, 20 May 2024 22:34:03 -0400 Received: from smtp-out1-06.simnet.is ([194.105.231.13]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1s9FK8-0007ss-Al for bug-grep@gnu.org; Mon, 20 May 2024 22:34:02 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=simnet.is; i=@simnet.is; q=dns/txt; s=sel1; t=1716258836; x=1747794836; h=date:from:to:subject:message-id:mime-version; bh=6C6fXjCTuR9kM7DZjgzh7DxQBaCHDw67MTGOUer3PMU=; b=BUmWskTLZyTI8jEvAzo0At2LjwSjuxrWL2vFcjPdrj7lYBi3KmSsQ+sV 8fgi3rWKmaWOHyIuums8mwJGKgeopTRX1tn2Q209lfSlTNTfAFsxtoHh0 FkaQYHV1TmFrx5V7B4HnEN7p8Eo+3JqqSTObgYZxdHJIYuQSxJBHrAy6E vLuH/rXyljjxw/gc/4c1jWTQ3sic8sWADPLyoLGKlaFJkGxXBRTwZlubN pvxFD6s0x6n09EZ0DcyRt1FFnUYL/KfPuYi2VUo9hlC+lZ0BLxpPCCtQD fIFl6/P9kmvae2hql0+hDLQBeixNUCgYWdtCgtpRQAHjIi1BGX3X1o+6T w==; X-CSE-ConnectionGUID: tJ4w9iIAS2qZrDrNXDwlXg== X-CSE-MsgGUID: US+JEwARRZ+FUxpgOKTnrA== Authentication-Results: smtp-out-06.simnet.is; dkim=none (message not signed) header.i=none X-SBRS: 4.4 X-IPAS-Result: A2ElAgCtBUxmkFjoacJaHAEBAQEBAQcBARIBAQQEAQFAgT4EAQELAYJDfIFkiCWNfh2BFoISnGsHAQEBDzETBAEBAwEDjUUoNwYOAQIEAQEBAQMCAwEBAQEBAQEBBgEBBgEBAQEBAQYHAhABAQEBAQEgHhAOJ4UvRQ2DG4IQLAKCViGDXwGCZK50gTSBAYMc2xWBXBCBSAGILQGKPDwGgg2BFTWCPXaFEIV3BIUIhVCCcUmIKhWCTBpLgiEIhWGJboFtA1khAhEBVRMXCz4dAhYDGxQEMA8JCyYqBjkCEgwGBgZZNAkEIwMIBAMQMgMgcREDBBoECwd1gyUEE0QDgTeJcIM7giCEHkuEdYF2DmGKDoFHRh02CgMLbT01FBsopFiCfUMBATBdAS93UpNakAKBQ6FFhB2GVYMugguVODOEBYFWiyiGNQw5kjeYYqNvhRiBe4IALAcaCDA7gmcJSRkPji0WLogIyCp4AjkCBwsBAQMJimoBAQ IronPort-PHdr: A9a23:FTP1RBGM9OL/fOGTKqvamJ1Gfg0Y04WdBeZ0woEil6oLdbm/usy8e lfe4PNgkBnIRtaT5/FFjr/QtKbtESwF7I2auX8POJpLS1ceiMoQkgBhSM6IAEH2NrjrOio9G skqaQ== IronPort-Data: A9a23:1lGnPawbiiPJz5YcYt56t+fTxirEfRIJ4+MujC+fZmQN5Y9G5oE1v jVdDCmYY6GUY3yhIo8gWDmFhRgPvJ/Un9RjTAs+qH8xQXkX9MTLX4WQcUqqYnnNfpKcE0845 Z1BZoicIpA5ECGE/E2mPOC79yEg3vvTF+WnVbas1kydPeNBYH5JZUVLwrZi3eaE+OSEPj5hm e8eguXTYQOo0mckazpF5v7S8R1l5aipsW5E7wZlPP1C41OPzFAYXckVTU2TByKjG9ELRIZWZ ApiIJWRpD6xE8IFU4v9+lrDWhRXBOaUZU7X0iY+t5GK2nBqvjY13rswKM0SYEJWjyTht91qw b2hj7TpIesSFvOKwLR1vyVwSXkkYfUbouefehBTjOTKp6H4Wyq9qxlRJBle0b0woo5fHWxI/ PoEHzEBBjjrazWeme/TpkFE36zPHeGzVG8tkigIIQLxUZ7Kdav+r5Divre06tufavdmRp4yb +JBAdZmgY+pjxdnYj/7A7pm9Auka+WWn5S1Zzt5qIJui1U/wjCd35DxEobKK92rbP4Ph3SCi njgz0jmBiEVYYn3JTqtqhpAh8fRnDjnHZATEaWi8e57xQXJgHISEwFQVEDTTfuR0x/iHYsHd gpOoXBo/fhaGE+DF7ERWzWyr1afvxsaVsYWEvZSBASll/SOuVbGWwDoSBZ8U58EmdAffwYYl XG0j8vmIh9Ttqe8HCf1GrC89m/iaHdEcQfufxQsRxYKptb5rZkbgRTSCNF5H8aIYsbdBzDr3 3WYrS0mnbIDnItTjeOl/EvbxTO3znTUcuIrzhn1An307yJQX9S8VZaE837rwelEHInMGzFto 0M4s8SZ6ekPC7SEmyqMXPgBEdmVCxCtbWS0bblHQ8hJyti9x0NPa7y89xlfHy9U3issZz7yf ArBuAZJ/phDLT7yN+lpYpmtTcUxpUQBKTgHfq6NBjatSsEgHONiwM2ITRTOt4wKuBJ9+ZzTw b/BLa6R4Y8yUMyLNgaeSeYHyqMMzSsj327VTp2T5034iOTEPyTLGO5VbwHmggUFAEWs/Vy9H zF3apPi9vmjeLGmCsUq2ddPdg5TcxDX+7io85A/mhG/zvpOQz1xWqCAndvNiqRgnqBc3ufGl kxRqWcFoGcTcUbvcF3QAlg6MeOHdcgk9xoTY3dzVWtELlB/Pe5DGo9ELcBmFVTmncQ/pcNJo w4tJJjcXaofFWmdk9nfBLGkxLFfmN2QrVrmF0KYjPIXJvaMmyShFgfYQzbS IronPort-HdrOrdr: A9a23:uSSQOa+3+tV2oG2qDIluk+DHI+orL9Y04lQ7vn2ZbSYlFPBw9v re+8jzuiWUtN98YhEdcLO7Sc29qBHnhPtICOAqVN/INmSL1wWVxepZnOnfKlPbak7DytI= X-Talos-CUID: 9a23:J4TkEmDmsckT5Aj6EzVFqFFFG+EMSSfE/m38OWmIJXlteLLAHA== X-Talos-MUID: 9a23:4/bfLwkxtkUgwEafkJdldnpfD4RKzruHMno/0rs7q9GLEg9MPS202WE= X-IronPort-Anti-Spam-Filtered: true X-IronPort-AV: E=Sophos;i="6.08,176,1712620800"; d="diff'?scan'208";a="5622875" Received: from vist-zimproxy-02.vist.is ([194.105.232.88]) by smtp-out-06.simnet.is with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 21 May 2024 02:26:35 +0000 Received: from localhost (localhost [127.0.0.1]) by vist-zimproxy-02.vist.is (Postfix) with ESMTP id D2E294406D14 for ; Tue, 21 May 2024 02:26:34 +0000 (GMT) Received: from vist-zimproxy-02.vist.is ([127.0.0.1]) by localhost (vist-zimproxy-02.vist.is [127.0.0.1]) (amavis, port 10032) with ESMTP id cewIc_CUz5g2 for ; Tue, 21 May 2024 02:26:34 +0000 (GMT) Received: from localhost (localhost [127.0.0.1]) by vist-zimproxy-02.vist.is (Postfix) with ESMTP id 0840E4406CF3 for ; Tue, 21 May 2024 02:26:34 +0000 (GMT) Received: from vist-zimproxy-02.vist.is ([127.0.0.1]) by localhost (vist-zimproxy-02.vist.is [127.0.0.1]) (amavis, port 10026) with ESMTP id 7IKGtBaYvgi8 for ; Tue, 21 May 2024 02:26:33 +0000 (GMT) Received: from kassi.invalid.is (85-220-3-206.dsl.dynamic.simnet.is [85.220.3.206]) by vist-zimproxy-02.vist.is (Postfix) with ESMTPS id E5E834405BAC for ; Tue, 21 May 2024 02:26:33 +0000 (GMT) Received: from bg by kassi.invalid.is with local (Exim 4.97) (envelope-from ) id 1s9FCy-0000000017T-3DDo for bug-grep@gnu.org; Tue, 21 May 2024 02:26:32 +0000 Date: Tue, 21 May 2024 02:26:32 +0000 From: Bjarni Ingi Gislason Message-ID: MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="cO8ituUvyeOCU1RP" Content-Disposition: inline Received-SPF: pass client-ip=194.105.231.13; envelope-from=bg@simnet.is; helo=smtp-out1-06.simnet.is X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.4 (-) 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.4 (--) --cO8ituUvyeOCU1RP Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Here are some notes and editorial fixes for the manual. The patch is in the attachment. -.- The difference between the formatted outputs can be seen with: nroff -man > nroff -man > diff -u and for groff, using "printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -man -Z - " instead of "nroff -man" Add the option "-t", if the file contains a table. Read the output of "diff -u" with "less -R" or similar. -.-. If "man" (man-db) is used to check the manual for warnings, the following must be set: The option "-warnings=w" The environmental variable: export MAN_KEEP_STDERR=yes (or any non-empty value) or (produce only warnings): export MANROFFOPT="-ww -z" export MAN_KEEP_STDERR=yes (or any non-empty value) -.-. Output from "mandoc -T lint grep.in.1": (possibly shortened list) mandoc: grep.in.1:27:9: WARNING: undefined string, using "": la The fix to eliminate this warning is to add explicitly an empty string to its value: .as la "" A similar method can be used for undefined registers: .nr a +0 The groff's 'an-ext.tmac' does not define the string 'la', just the character. -.-. Use the correct macro for the font change of a single argument or split the argument into two. 248:.IR FILE 677:.BR \-I -.-. Change a HYPHEN-MINUS (code 0x2D) to a minus(-dash) (\-), if it is in front of a name for an option, is a symbol for standard input, is a single character used to indicate an option, or is in the NAME section (man-pages(7)). N.B. - (0x2D), processed as a UTF-8 file, is changed to a hyphen (0x2010, groff \[u2010] or \[hy]) in the output. 752:.B sort -z -.-. Output from "groff -b -mandoc -dAD=l -rF0 -rHY=0 -t -w w -z -rCHECKSTYLE=0": troff: backtrace: file '':26 troff::26: warning: macro 'la' not defined --cO8ituUvyeOCU1RP Content-Type: text/x-diff; charset=us-ascii Content-Disposition: attachment; filename="grep.in.1.diff" --- grep.in.1 2024-05-21 01:34:19.228927615 +0000 +++ grep.in.1.new 2024-05-21 01:32:13.506930462 +0000 @@ -23,6 +23,7 @@ . \} .\} . +.as la \" add an empty string to avoid a warning .if !\w|\*(la| \{\ .\" groff an-ext.tmac does not seem to be in use, so define the parts of .\" it that are used below. For a copy of groff an-ext.tmac, please see: @@ -245,7 +246,7 @@ If this option is used multiple times or option, search for all patterns given. The empty file contains zero patterns, and therefore matches nothing. If -.IR FILE +.I FILE is .B \- , read patterns from standard input. @@ -674,7 +675,7 @@ whose base name matches Ignore any redundant trailing slashes in .IR GLOB . .TP -.BR \-I +.B \-I Process a binary file as if it did not contain matching data; this is equivalent to the .B \-\^\-binary\-files=without\-match @@ -749,7 +750,7 @@ Like the or .B \-\^\-null option, this option can be used with commands like -.B sort -z +.B sort \-z to process arbitrary file names. . .SH "REGULAR EXPRESSIONS" --cO8ituUvyeOCU1RP-- From unknown Sun Jun 22 04:11:37 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: Bjarni Ingi Gislason Subject: bug#71087: closed (Re: bug#71087: grep.in.1: some remarks and editorial changes for this man page) Message-ID: References: X-Gnu-PR-Message: they-closed 71087 X-Gnu-PR-Package: grep Reply-To: 71087@debbugs.gnu.org Date: Tue, 21 May 2024 16:53:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1716310382-3389-1" This is a multi-part message in MIME format... ------------=_1716310382-3389-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #71087: grep.in.1: some remarks and editorial changes for this man page 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 71087@debbugs.gnu.org. --=20 71087: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D71087 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1716310382-3389-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 71087-done) by debbugs.gnu.org; 21 May 2024 16:52:37 +0000 Received: from localhost ([127.0.0.1]:50068 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1s9Sj6-0000sT-QK for submit@debbugs.gnu.org; Tue, 21 May 2024 12:52:37 -0400 Received: from mail.cs.ucla.edu ([131.179.128.66]:58158) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1s9Sj1-0000sF-A1 for 71087-done@debbugs.gnu.org; Tue, 21 May 2024 12:52:35 -0400 Received: from localhost (localhost [127.0.0.1]) by mail.cs.ucla.edu (Postfix) with ESMTP id 0A4BC3C011BD8; Tue, 21 May 2024 09:52:20 -0700 (PDT) Received: from mail.cs.ucla.edu ([127.0.0.1]) by localhost (mail.cs.ucla.edu [127.0.0.1]) (amavis, port 10032) with ESMTP id qL6SdPETdguP; Tue, 21 May 2024 09:52:19 -0700 (PDT) Received: from localhost (localhost [127.0.0.1]) by mail.cs.ucla.edu (Postfix) with ESMTP id 92AD43C00E8B0; Tue, 21 May 2024 09:52:19 -0700 (PDT) DKIM-Filter: OpenDKIM Filter v2.10.3 mail.cs.ucla.edu 92AD43C00E8B0 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cs.ucla.edu; s=9D0B346E-2AEB-11ED-9476-E14B719DCE6C; t=1716310339; bh=P3eFMNonIJjPglqJOFdsfDANbPKqGQmDeNBZKXrPkTo=; h=Message-ID:Date:MIME-Version:To:From; b=Byoe1x047KBAsU4Utll30EqleiE+Js6KW/woD4GQpj7a48s+n/tMBmp7Z9A3TJERG gYEXRWAALm3vGdbnpsj+WFX6bUdKe0K1Ss+dphdmf6CgbTOv0+nWS1R0YS8zbnfJh1 IX8yzElsFZqTcp/Ku6vWHNhea66/GbBEqR06skznbxIGc/WlU/+GDakGPfvc7k3sCM MBqduz74Xn18frIsbNKBtfOAGMDzGsdmvrGq21riB6XVg3tD3mjWIkLNJoiGiVZ+2d nM05q2g+oY9Pwvxi2O1RgRti7C4G5P0IXI5/230fzSXlCFmy44JCm0g+EtTgxNQ/5U VFAjEylZYeSog== X-Virus-Scanned: amavis at mail.cs.ucla.edu Received: from mail.cs.ucla.edu ([127.0.0.1]) by localhost (mail.cs.ucla.edu [127.0.0.1]) (amavis, port 10026) with ESMTP id 83h_J_5vxpNY; Tue, 21 May 2024 09:52:19 -0700 (PDT) Received: from [192.168.254.12] (unknown [47.154.17.165]) by mail.cs.ucla.edu (Postfix) with ESMTPSA id 6F3663C011BD8; Tue, 21 May 2024 09:52:19 -0700 (PDT) Content-Type: multipart/mixed; boundary="------------Mcc1TJ3gxMTosHeuE629LWeA" Message-ID: Date: Tue, 21 May 2024 09:52:19 -0700 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: bug#71087: grep.in.1: some remarks and editorial changes for this man page To: Bjarni Ingi Gislason References: Content-Language: en-US From: Paul Eggert Organization: UCLA Computer Science Department In-Reply-To: X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 71087-done Cc: 71087-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: -1.0 (-) This is a multi-part message in MIME format. --------------Mcc1TJ3gxMTosHeuE629LWeA Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Thanks, I installed the attached. --------------Mcc1TJ3gxMTosHeuE629LWeA Content-Type: text/x-patch; charset=UTF-8; name="0001-doc-fix-troff-typos.patch" Content-Disposition: attachment; filename="0001-doc-fix-troff-typos.patch" Content-Transfer-Encoding: base64 RnJvbSA1M2I4ODkxNTVmNWVlNTM0MDRhOTg3M2Y0ODMwMGZlNWI1MDMyMWQ5IE1vbiBTZXAg MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBQYXVsIEVnZ2VydCA8ZWdnZXJ0QGNzLnVjbGEuZWR1 PgpEYXRlOiBUdWUsIDIxIE1heSAyMDI0IDA5OjUwOjQzIC0wNzAwClN1YmplY3Q6IFtQQVRD SF0gZG9jOiBmaXggdHJvZmYgdHlwb3MKCiogZG9jL2dyZXAuaW4uMTogRml4IHRyb2ZmIHR5 cG9zIGZvdW5kIGJ5IG1hbmRvYyBhbmQgZ3JvZmYuClByb2JsZW0gcmVwb3J0ZWQgYnkgQmph cm5pIEluZ2kgR2lzbGFzb24gKGJ1ZyM3MTA4NykuCi0tLQogZG9jL2dyZXAuaW4uMSB8IDcg KysrKy0tLQogMSBmaWxlIGNoYW5nZWQsIDQgaW5zZXJ0aW9ucygrKSwgMyBkZWxldGlvbnMo LSkKCmRpZmYgLS1naXQgYS9kb2MvZ3JlcC5pbi4xIGIvZG9jL2dyZXAuaW4uMQppbmRleCA1 NTExOGE3Li5kOTYwNGFlIDEwMDY0NAotLS0gYS9kb2MvZ3JlcC5pbi4xCisrKyBiL2RvYy9n cmVwLmluLjEKQEAgLTIzLDYgKzIzLDcgQEAKIC4JXH0KIC5cfQogLgorLmFzIGxhCiAuaWYg IVx3fFwqKGxhfCBce1wKIC5cIiBncm9mZiBhbi1leHQudG1hYyBkb2VzIG5vdCBzZWVtIHRv IGJlIGluIHVzZSwgc28gZGVmaW5lIHRoZSBwYXJ0cyBvZgogLlwiIGl0IHRoYXQgYXJlIHVz ZWQgYmVsb3cuICBGb3IgYSBjb3B5IG9mIGdyb2ZmIGFuLWV4dC50bWFjLCBwbGVhc2Ugc2Vl OgpAQCAtMjQ1LDcgKzI0Niw3IEBAIElmIHRoaXMgb3B0aW9uIGlzIHVzZWQgbXVsdGlwbGUg dGltZXMgb3IgaXMgY29tYmluZWQgd2l0aCB0aGUKIG9wdGlvbiwgc2VhcmNoIGZvciBhbGwg cGF0dGVybnMgZ2l2ZW4uCiBUaGUgZW1wdHkgZmlsZSBjb250YWlucyB6ZXJvIHBhdHRlcm5z LCBhbmQgdGhlcmVmb3JlIG1hdGNoZXMgbm90aGluZy4KIElmCi0uSVIgRklMRQorLkkgRklM RQogaXMKIC5CIFwtCiAsIHJlYWQgcGF0dGVybnMgZnJvbSBzdGFuZGFyZCBpbnB1dC4KQEAg LTY3NCw3ICs2NzUsNyBAQCB3aG9zZSBiYXNlIG5hbWUgbWF0Y2hlcwogSWdub3JlIGFueSBy ZWR1bmRhbnQgdHJhaWxpbmcgc2xhc2hlcyBpbgogLklSIEdMT0IgLgogLlRQCi0uQlIgXC1J CisuQiBcLUkKIFByb2Nlc3MgYSBiaW5hcnkgZmlsZSBhcyBpZiBpdCBkaWQgbm90IGNvbnRh aW4gbWF0Y2hpbmcgZGF0YTsgdGhpcyBpcwogZXF1aXZhbGVudCB0byB0aGUKIC5CIFwtXF5c LWJpbmFyeVwtZmlsZXM9d2l0aG91dFwtbWF0Y2gKQEAgLTc0OSw3ICs3NTAsNyBAQCBMaWtl IHRoZQogb3IKIC5CIFwtXF5cLW51bGwKIG9wdGlvbiwgdGhpcyBvcHRpb24gY2FuIGJlIHVz ZWQgd2l0aCBjb21tYW5kcyBsaWtlCi0uQiBzb3J0IC16CisuQiAic29ydCBcLXoiCiB0byBw cm9jZXNzIGFyYml0cmFyeSBmaWxlIG5hbWVzLgogLgogLlNIICJSRUdVTEFSIEVYUFJFU1NJ T05TIgotLSAKMi40MC4xCgo= --------------Mcc1TJ3gxMTosHeuE629LWeA-- ------------=_1716310382-3389-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 21 May 2024 02:34:12 +0000 Received: from localhost ([127.0.0.1]:46344 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1s9FKO-000697-7Q for submit@debbugs.gnu.org; Mon, 20 May 2024 22:34:12 -0400 Received: from lists.gnu.org ([209.51.188.17]:51364) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1s9FKK-000691-Bx for submit@debbugs.gnu.org; Mon, 20 May 2024 22:34:11 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1s9FKE-0000iY-OV for bug-grep@gnu.org; Mon, 20 May 2024 22:34:03 -0400 Received: from smtp-out1-06.simnet.is ([194.105.231.13]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1s9FK8-0007ss-Al for bug-grep@gnu.org; Mon, 20 May 2024 22:34:02 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=simnet.is; i=@simnet.is; q=dns/txt; s=sel1; t=1716258836; x=1747794836; h=date:from:to:subject:message-id:mime-version; bh=6C6fXjCTuR9kM7DZjgzh7DxQBaCHDw67MTGOUer3PMU=; b=BUmWskTLZyTI8jEvAzo0At2LjwSjuxrWL2vFcjPdrj7lYBi3KmSsQ+sV 8fgi3rWKmaWOHyIuums8mwJGKgeopTRX1tn2Q209lfSlTNTfAFsxtoHh0 FkaQYHV1TmFrx5V7B4HnEN7p8Eo+3JqqSTObgYZxdHJIYuQSxJBHrAy6E vLuH/rXyljjxw/gc/4c1jWTQ3sic8sWADPLyoLGKlaFJkGxXBRTwZlubN pvxFD6s0x6n09EZ0DcyRt1FFnUYL/KfPuYi2VUo9hlC+lZ0BLxpPCCtQD fIFl6/P9kmvae2hql0+hDLQBeixNUCgYWdtCgtpRQAHjIi1BGX3X1o+6T w==; X-CSE-ConnectionGUID: tJ4w9iIAS2qZrDrNXDwlXg== X-CSE-MsgGUID: US+JEwARRZ+FUxpgOKTnrA== Authentication-Results: smtp-out-06.simnet.is; dkim=none (message not signed) header.i=none X-SBRS: 4.4 X-IPAS-Result: =?us-ascii?q?A2ElAgCtBUxmkFjoacJaHAEBAQEBAQcBARIBAQQEAQFAg?= =?us-ascii?q?T4EAQELAYJDfIFkiCWNfh2BFoISnGsHAQEBDzETBAEBAwEDjUUoNwYOAQIEA?= =?us-ascii?q?QEBAQMCAwEBAQEBAQEBBgEBBgEBAQEBAQYHAhABAQEBAQEgHhAOJ4UvRQ2DG?= =?us-ascii?q?4IQLAKCViGDXwGCZK50gTSBAYMc2xWBXBCBSAGILQGKPDwGgg2BFTWCPXaFE?= =?us-ascii?q?IV3BIUIhVCCcUmIKhWCTBpLgiEIhWGJboFtA1khAhEBVRMXCz4dAhYDGxQEM?= =?us-ascii?q?A8JCyYqBjkCEgwGBgZZNAkEIwMIBAMQMgMgcREDBBoECwd1gyUEE0QDgTeJc?= =?us-ascii?q?IM7giCEHkuEdYF2DmGKDoFHRh02CgMLbT01FBsopFiCfUMBATBdAS93UpNak?= =?us-ascii?q?AKBQ6FFhB2GVYMugguVODOEBYFWiyiGNQw5kjeYYqNvhRiBe4IALAcaCDA7g?= =?us-ascii?q?mcJSRkPji0WLogIyCp4AjkCBwsBAQMJimoBAQ?= IronPort-PHdr: A9a23:FTP1RBGM9OL/fOGTKqvamJ1Gfg0Y04WdBeZ0woEil6oLdbm/usy8e lfe4PNgkBnIRtaT5/FFjr/QtKbtESwF7I2auX8POJpLS1ceiMoQkgBhSM6IAEH2NrjrOio9G skqaQ== IronPort-Data: A9a23:1lGnPawbiiPJz5YcYt56t+fTxirEfRIJ4+MujC+fZmQN5Y9G5oE1v jVdDCmYY6GUY3yhIo8gWDmFhRgPvJ/Un9RjTAs+qH8xQXkX9MTLX4WQcUqqYnnNfpKcE0845 Z1BZoicIpA5ECGE/E2mPOC79yEg3vvTF+WnVbas1kydPeNBYH5JZUVLwrZi3eaE+OSEPj5hm e8eguXTYQOo0mckazpF5v7S8R1l5aipsW5E7wZlPP1C41OPzFAYXckVTU2TByKjG9ELRIZWZ ApiIJWRpD6xE8IFU4v9+lrDWhRXBOaUZU7X0iY+t5GK2nBqvjY13rswKM0SYEJWjyTht91qw b2hj7TpIesSFvOKwLR1vyVwSXkkYfUbouefehBTjOTKp6H4Wyq9qxlRJBle0b0woo5fHWxI/ PoEHzEBBjjrazWeme/TpkFE36zPHeGzVG8tkigIIQLxUZ7Kdav+r5Divre06tufavdmRp4yb +JBAdZmgY+pjxdnYj/7A7pm9Auka+WWn5S1Zzt5qIJui1U/wjCd35DxEobKK92rbP4Ph3SCi njgz0jmBiEVYYn3JTqtqhpAh8fRnDjnHZATEaWi8e57xQXJgHISEwFQVEDTTfuR0x/iHYsHd gpOoXBo/fhaGE+DF7ERWzWyr1afvxsaVsYWEvZSBASll/SOuVbGWwDoSBZ8U58EmdAffwYYl XG0j8vmIh9Ttqe8HCf1GrC89m/iaHdEcQfufxQsRxYKptb5rZkbgRTSCNF5H8aIYsbdBzDr3 3WYrS0mnbIDnItTjeOl/EvbxTO3znTUcuIrzhn1An307yJQX9S8VZaE837rwelEHInMGzFto 0M4s8SZ6ekPC7SEmyqMXPgBEdmVCxCtbWS0bblHQ8hJyti9x0NPa7y89xlfHy9U3issZz7yf ArBuAZJ/phDLT7yN+lpYpmtTcUxpUQBKTgHfq6NBjatSsEgHONiwM2ITRTOt4wKuBJ9+ZzTw b/BLa6R4Y8yUMyLNgaeSeYHyqMMzSsj327VTp2T5034iOTEPyTLGO5VbwHmggUFAEWs/Vy9H zF3apPi9vmjeLGmCsUq2ddPdg5TcxDX+7io85A/mhG/zvpOQz1xWqCAndvNiqRgnqBc3ufGl kxRqWcFoGcTcUbvcF3QAlg6MeOHdcgk9xoTY3dzVWtELlB/Pe5DGo9ELcBmFVTmncQ/pcNJo w4tJJjcXaofFWmdk9nfBLGkxLFfmN2QrVrmF0KYjPIXJvaMmyShFgfYQzbS IronPort-HdrOrdr: A9a23:uSSQOa+3+tV2oG2qDIluk+DHI+orL9Y04lQ7vn2ZbSYlFPBw9v re+8jzuiWUtN98YhEdcLO7Sc29qBHnhPtICOAqVN/INmSL1wWVxepZnOnfKlPbak7DytI= X-Talos-CUID: 9a23:J4TkEmDmsckT5Aj6EzVFqFFFG+EMSSfE/m38OWmIJXlteLLAHA== X-Talos-MUID: 9a23:4/bfLwkxtkUgwEafkJdldnpfD4RKzruHMno/0rs7q9GLEg9MPS202WE= X-IronPort-Anti-Spam-Filtered: true X-IronPort-AV: E=Sophos;i="6.08,176,1712620800"; d="diff'?scan'208";a="5622875" Received: from vist-zimproxy-02.vist.is ([194.105.232.88]) by smtp-out-06.simnet.is with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 21 May 2024 02:26:35 +0000 Received: from localhost (localhost [127.0.0.1]) by vist-zimproxy-02.vist.is (Postfix) with ESMTP id D2E294406D14 for ; Tue, 21 May 2024 02:26:34 +0000 (GMT) Received: from vist-zimproxy-02.vist.is ([127.0.0.1]) by localhost (vist-zimproxy-02.vist.is [127.0.0.1]) (amavis, port 10032) with ESMTP id cewIc_CUz5g2 for ; Tue, 21 May 2024 02:26:34 +0000 (GMT) Received: from localhost (localhost [127.0.0.1]) by vist-zimproxy-02.vist.is (Postfix) with ESMTP id 0840E4406CF3 for ; Tue, 21 May 2024 02:26:34 +0000 (GMT) Received: from vist-zimproxy-02.vist.is ([127.0.0.1]) by localhost (vist-zimproxy-02.vist.is [127.0.0.1]) (amavis, port 10026) with ESMTP id 7IKGtBaYvgi8 for ; Tue, 21 May 2024 02:26:33 +0000 (GMT) Received: from kassi.invalid.is (85-220-3-206.dsl.dynamic.simnet.is [85.220.3.206]) by vist-zimproxy-02.vist.is (Postfix) with ESMTPS id E5E834405BAC for ; Tue, 21 May 2024 02:26:33 +0000 (GMT) Received: from bg by kassi.invalid.is with local (Exim 4.97) (envelope-from ) id 1s9FCy-0000000017T-3DDo for bug-grep@gnu.org; Tue, 21 May 2024 02:26:32 +0000 Date: Tue, 21 May 2024 02:26:32 +0000 From: Bjarni Ingi Gislason To: bug-grep@gnu.org Subject: grep.in.1: some remarks and editorial changes for this man page Message-ID: MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="cO8ituUvyeOCU1RP" Content-Disposition: inline Received-SPF: pass client-ip=194.105.231.13; envelope-from=bg@simnet.is; helo=smtp-out1-06.simnet.is X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.4 (-) 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.4 (--) --cO8ituUvyeOCU1RP Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Here are some notes and editorial fixes for the manual. The patch is in the attachment. -.- The difference between the formatted outputs can be seen with: nroff -man > nroff -man > diff -u and for groff, using "printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -man -Z - " instead of "nroff -man" Add the option "-t", if the file contains a table. Read the output of "diff -u" with "less -R" or similar. -.-. If "man" (man-db) is used to check the manual for warnings, the following must be set: The option "-warnings=w" The environmental variable: export MAN_KEEP_STDERR=yes (or any non-empty value) or (produce only warnings): export MANROFFOPT="-ww -z" export MAN_KEEP_STDERR=yes (or any non-empty value) -.-. Output from "mandoc -T lint grep.in.1": (possibly shortened list) mandoc: grep.in.1:27:9: WARNING: undefined string, using "": la The fix to eliminate this warning is to add explicitly an empty string to its value: .as la "" A similar method can be used for undefined registers: .nr a +0 The groff's 'an-ext.tmac' does not define the string 'la', just the character. -.-. Use the correct macro for the font change of a single argument or split the argument into two. 248:.IR FILE 677:.BR \-I -.-. Change a HYPHEN-MINUS (code 0x2D) to a minus(-dash) (\-), if it is in front of a name for an option, is a symbol for standard input, is a single character used to indicate an option, or is in the NAME section (man-pages(7)). N.B. - (0x2D), processed as a UTF-8 file, is changed to a hyphen (0x2010, groff \[u2010] or \[hy]) in the output. 752:.B sort -z -.-. Output from "groff -b -mandoc -dAD=l -rF0 -rHY=0 -t -w w -z -rCHECKSTYLE=0": troff: backtrace: file '':26 troff::26: warning: macro 'la' not defined --cO8ituUvyeOCU1RP Content-Type: text/x-diff; charset=us-ascii Content-Disposition: attachment; filename="grep.in.1.diff" --- grep.in.1 2024-05-21 01:34:19.228927615 +0000 +++ grep.in.1.new 2024-05-21 01:32:13.506930462 +0000 @@ -23,6 +23,7 @@ . \} .\} . +.as la \" add an empty string to avoid a warning .if !\w|\*(la| \{\ .\" groff an-ext.tmac does not seem to be in use, so define the parts of .\" it that are used below. For a copy of groff an-ext.tmac, please see: @@ -245,7 +246,7 @@ If this option is used multiple times or option, search for all patterns given. The empty file contains zero patterns, and therefore matches nothing. If -.IR FILE +.I FILE is .B \- , read patterns from standard input. @@ -674,7 +675,7 @@ whose base name matches Ignore any redundant trailing slashes in .IR GLOB . .TP -.BR \-I +.B \-I Process a binary file as if it did not contain matching data; this is equivalent to the .B \-\^\-binary\-files=without\-match @@ -749,7 +750,7 @@ Like the or .B \-\^\-null option, this option can be used with commands like -.B sort -z +.B sort \-z to process arbitrary file names. . .SH "REGULAR EXPRESSIONS" --cO8ituUvyeOCU1RP-- ------------=_1716310382-3389-1--