From unknown Mon Aug 18 18:04:12 2025 X-Loop: help-debbugs@gnu.org Subject: bug#52958: [PATCH] doc: fix man page syntax errors Resent-From: =?UTF-8?Q?Ond=C5=99ej?= Fiala Original-Sender: "Debbugs-submit" Resent-CC: bug-grep@gnu.org Resent-Date: Sun, 02 Jan 2022 17:01:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 52958 X-GNU-PR-Package: grep X-GNU-PR-Keywords: patch To: 52958@debbugs.gnu.org Cc: =?UTF-8?Q?Ond=C5=99ej?= Fiala X-Debbugs-Original-To: bug-grep@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.164114282410980 (code B ref -1); Sun, 02 Jan 2022 17:01:02 +0000 Received: (at submit) by debbugs.gnu.org; 2 Jan 2022 17:00:24 +0000 Received: from localhost ([127.0.0.1]:33539 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n44DX-0002r0-IN for submit@debbugs.gnu.org; Sun, 02 Jan 2022 12:00:24 -0500 Received: from lists.gnu.org ([209.51.188.17]:37216) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n3urh-0002ON-AP for submit@debbugs.gnu.org; Sun, 02 Jan 2022 02:01:13 -0500 Received: from eggs.gnu.org ([209.51.188.92]:33332) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n3urf-0007z4-Ua for bug-grep@gnu.org; Sun, 02 Jan 2022 02:01:12 -0500 Received: from gmmr4.centrum.cz ([46.255.227.253]:48391) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.90_1) (envelope-from ) id 1n3urd-0006ZA-KK for bug-grep@gnu.org; Sun, 02 Jan 2022 02:01:11 -0500 Received: from gmmr-3.centrum.cz (unknown [10.255.254.11]) by gmmr4.centrum.cz (Postfix) with ESMTP id C2E8CDA0; Sun, 2 Jan 2022 08:00:59 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=volny.cz; s=mail; t=1641106859; bh=Zs2SD2MEUCorGpzzfKK6qJYtRwGH/8UI0ONee2BvTQg=; h=From:To:Cc:Subject:Date:From; b=cBfIGYONR6jbeecYRAGe3Rz0ocYvXrAKZkaqtMqeb/GQJo7v3cI+pahF/WNI50CIN pcL9DgRPcVIoyUSB6YGFbx99/PxVimePI7V4b94lre37wyrd7auH5tzTYNDQs4vONV YsD14dFLS+y278TjFam/EDnO4G1z2C5Za+puZbfk= Received: from vm2.excello.cz (vm2.excello.cz [212.24.139.173]) by gmmr-3.centrum.cz (Postfix) with QMQP id C066720078EA; Sun, 2 Jan 2022 08:00:59 +0100 (CET) Received: from vm2.excello.cz by vm2.excello.cz (VF-Scanner: Clear:RC:0(2a00:da80:0:502::8):SC:0(1.8/5.0):CC:0:; processed in 0.4 s); 02 Jan 2022 07:00:59 +0000 X-VF-Scanner-ID: 20220102070059.410672.9800.vm2.excello.cz.0 X-Spam-Status: No, hits=1.8, required=5.0 Received: from gmmr-3.centrum.cz (2a00:da80:0:502::8) by out1.virusfree.cz with ESMTPS (TLSv1.3, TLS_AES_256_GCM_SHA384); 2 Jan 2022 08:00:59 +0100 Received: from gm-smtp10.centrum.cz (unknown [10.255.254.33]) by gmmr-3.centrum.cz (Postfix) with ESMTP id 5FDC420078EC; Sun, 2 Jan 2022 08:00:59 +0100 (CET) Received: from localhost.localdomain (unknown [94.199.96.206]) by gm-smtp10.centrum.cz (Postfix) with ESMTPA id 4D869C068880; Sun, 2 Jan 2022 08:00:59 +0100 (CET) From: =?UTF-8?Q?Ond=C5=99ej?= Fiala Date: Sun, 2 Jan 2022 07:58:49 +0100 Message-Id: <20220102065845.18707-1-temp.xanomes@volny.cz> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=46.255.227.253; envelope-from=temp.xanomes@volny.cz; helo=gmmr4.centrum.cz X-Spam_score_int: -1 X-Spam_score: -0.2 X-Spam_bar: / X-Spam_report: (-0.2 / 5.0 requ) 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=unavailable autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.7 (-) X-Mailman-Approved-At: Sun, 02 Jan 2022 12:00:22 -0500 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.7 (--) * doc/grep.in.1: Fix syntax errors. Introduced by commit v3.6-5-g91ce9cd. --- Commit 91ce9cdad introduced invalid roff into the manpage. This should have been caught during code review as far as I can tell. doc/grep.in.1 | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/doc/grep.in.1 b/doc/grep.in.1 index ed53a8f..372b892 100644 --- a/doc/grep.in.1 +++ b/doc/grep.in.1 @@ -214,7 +214,9 @@ as basic regular expressions (BREs, see below). This is the default. .TP .BR \-P ", " \-\^\-perl\-regexp -Interpret I as Perl-compatible regular expressions (PCREs). +Interpret +.I PATTERNS +as Perl-compatible regular expressions (PCREs). This option is experimental when combined with the .B \-z .RB ( \-\^\-null\-data ) @@ -690,7 +692,9 @@ options match, a file is included unless the first such option is .BR \-r ", " \-\^\-recursive 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, B searches the working directory. +Note that if no file operand is given, +.B grep +searches the working directory. This is equivalent to the .B "\-d recurse" option. @@ -756,8 +760,11 @@ 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 B(3) and B(3), but work only if -PCRE support is enabled. +documented in +.BR pcre2syntax (3) +and +.BR pcre2pattern (3), +but work only if PCRE support is enabled. .PP The fundamental building blocks are the regular expressions that match a single character. -- 2.34.1 From unknown Mon Aug 18 18:04:12 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: =?UTF-8?Q?Ond=C5=99ej?= Fiala Subject: bug#52958: closed (Re: bug#52958: [PATCH] doc: fix man page syntax errors) Message-ID: References: <7599c5b7-a865-d0ba-bb51-4539f8a99d6d@cs.ucla.edu> <20220102065845.18707-1-temp.xanomes@volny.cz> X-Gnu-PR-Message: they-closed 52958 X-Gnu-PR-Package: grep X-Gnu-PR-Keywords: patch Reply-To: 52958@debbugs.gnu.org Date: Sun, 02 Jan 2022 19:18:01 +0000 Content-Type: multipart/mixed; boundary="----------=_1641151081-1869-1" This is a multi-part message in MIME format... ------------=_1641151081-1869-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #52958: [PATCH] doc: fix man page syntax errors 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 52958@debbugs.gnu.org. --=20 52958: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D52958 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1641151081-1869-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 52958-done) by debbugs.gnu.org; 2 Jan 2022 19:17:57 +0000 Received: from localhost ([127.0.0.1]:33738 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n46Mf-0000Tt-7C for submit@debbugs.gnu.org; Sun, 02 Jan 2022 14:17:57 -0500 Received: from zimbra.cs.ucla.edu ([131.179.128.68]:47612) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n46Mc-0000Tb-Q6 for 52958-done@debbugs.gnu.org; Sun, 02 Jan 2022 14:17:55 -0500 Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id A26B91600D3; Sun, 2 Jan 2022 11:17:48 -0800 (PST) Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10032) with ESMTP id RgaP2zXEhOEZ; Sun, 2 Jan 2022 11:17:48 -0800 (PST) Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 07B3B1600FD; Sun, 2 Jan 2022 11:17:48 -0800 (PST) X-Virus-Scanned: amavisd-new at zimbra.cs.ucla.edu Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id BCxx8DKdavGT; Sun, 2 Jan 2022 11:17:47 -0800 (PST) Received: from [192.168.1.9] (cpe-172-91-119-151.socal.res.rr.com [172.91.119.151]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id D8B871600D3; Sun, 2 Jan 2022 11:17:47 -0800 (PST) Message-ID: <7599c5b7-a865-d0ba-bb51-4539f8a99d6d@cs.ucla.edu> Date: Sun, 2 Jan 2022 11:17:47 -0800 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.3.1 Subject: Re: bug#52958: [PATCH] doc: fix man page syntax errors Content-Language: en-US To: =?UTF-8?Q?Ond=c5=99ej_Fiala?= References: <20220102065845.18707-1-temp.xanomes@volny.cz> From: Paul Eggert Organization: UCLA Computer Science Department In-Reply-To: <20220102065845.18707-1-temp.xanomes@volny.cz> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Score: -2.4 (--) X-Debbugs-Envelope-To: 52958-done Cc: 52958-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: -3.4 (---) Thanks, I installed that and am closing the bug report. ------------=_1641151081-1869-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 2 Jan 2022 17:00:24 +0000 Received: from localhost ([127.0.0.1]:33539 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n44DX-0002r0-IN for submit@debbugs.gnu.org; Sun, 02 Jan 2022 12:00:24 -0500 Received: from lists.gnu.org ([209.51.188.17]:37216) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n3urh-0002ON-AP for submit@debbugs.gnu.org; Sun, 02 Jan 2022 02:01:13 -0500 Received: from eggs.gnu.org ([209.51.188.92]:33332) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n3urf-0007z4-Ua for bug-grep@gnu.org; Sun, 02 Jan 2022 02:01:12 -0500 Received: from gmmr4.centrum.cz ([46.255.227.253]:48391) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.90_1) (envelope-from ) id 1n3urd-0006ZA-KK for bug-grep@gnu.org; Sun, 02 Jan 2022 02:01:11 -0500 Received: from gmmr-3.centrum.cz (unknown [10.255.254.11]) by gmmr4.centrum.cz (Postfix) with ESMTP id C2E8CDA0; Sun, 2 Jan 2022 08:00:59 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=volny.cz; s=mail; t=1641106859; bh=Zs2SD2MEUCorGpzzfKK6qJYtRwGH/8UI0ONee2BvTQg=; h=From:To:Cc:Subject:Date:From; b=cBfIGYONR6jbeecYRAGe3Rz0ocYvXrAKZkaqtMqeb/GQJo7v3cI+pahF/WNI50CIN pcL9DgRPcVIoyUSB6YGFbx99/PxVimePI7V4b94lre37wyrd7auH5tzTYNDQs4vONV YsD14dFLS+y278TjFam/EDnO4G1z2C5Za+puZbfk= Received: from vm2.excello.cz (vm2.excello.cz [212.24.139.173]) by gmmr-3.centrum.cz (Postfix) with QMQP id C066720078EA; Sun, 2 Jan 2022 08:00:59 +0100 (CET) Received: from vm2.excello.cz by vm2.excello.cz (VF-Scanner: Clear:RC:0(2a00:da80:0:502::8):SC:0(1.8/5.0):CC:0:; processed in 0.4 s); 02 Jan 2022 07:00:59 +0000 X-VF-Scanner-ID: 20220102070059.410672.9800.vm2.excello.cz.0 X-Spam-Status: No, hits=1.8, required=5.0 Received: from gmmr-3.centrum.cz (2a00:da80:0:502::8) by out1.virusfree.cz with ESMTPS (TLSv1.3, TLS_AES_256_GCM_SHA384); 2 Jan 2022 08:00:59 +0100 Received: from gm-smtp10.centrum.cz (unknown [10.255.254.33]) by gmmr-3.centrum.cz (Postfix) with ESMTP id 5FDC420078EC; Sun, 2 Jan 2022 08:00:59 +0100 (CET) Received: from localhost.localdomain (unknown [94.199.96.206]) by gm-smtp10.centrum.cz (Postfix) with ESMTPA id 4D869C068880; Sun, 2 Jan 2022 08:00:59 +0100 (CET) From: =?UTF-8?q?Ond=C5=99ej=20Fiala?= To: bug-grep@gnu.org Subject: [PATCH] doc: fix man page syntax errors Date: Sun, 2 Jan 2022 07:58:49 +0100 Message-Id: <20220102065845.18707-1-temp.xanomes@volny.cz> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=46.255.227.253; envelope-from=temp.xanomes@volny.cz; helo=gmmr4.centrum.cz X-Spam_score_int: -1 X-Spam_score: -0.2 X-Spam_bar: / X-Spam_report: (-0.2 / 5.0 requ) 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=unavailable autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.7 (-) X-Debbugs-Envelope-To: submit X-Mailman-Approved-At: Sun, 02 Jan 2022 12:00:22 -0500 Cc: =?UTF-8?q?Ond=C5=99ej=20Fiala?= 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.7 (--) * doc/grep.in.1: Fix syntax errors. Introduced by commit v3.6-5-g91ce9cd. --- Commit 91ce9cdad introduced invalid roff into the manpage. This should have been caught during code review as far as I can tell. doc/grep.in.1 | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/doc/grep.in.1 b/doc/grep.in.1 index ed53a8f..372b892 100644 --- a/doc/grep.in.1 +++ b/doc/grep.in.1 @@ -214,7 +214,9 @@ as basic regular expressions (BREs, see below). This is the default. .TP .BR \-P ", " \-\^\-perl\-regexp -Interpret I as Perl-compatible regular expressions (PCREs). +Interpret +.I PATTERNS +as Perl-compatible regular expressions (PCREs). This option is experimental when combined with the .B \-z .RB ( \-\^\-null\-data ) @@ -690,7 +692,9 @@ options match, a file is included unless the first such option is .BR \-r ", " \-\^\-recursive 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, B searches the working directory. +Note that if no file operand is given, +.B grep +searches the working directory. This is equivalent to the .B "\-d recurse" option. @@ -756,8 +760,11 @@ 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 B(3) and B(3), but work only if -PCRE support is enabled. +documented in +.BR pcre2syntax (3) +and +.BR pcre2pattern (3), +but work only if PCRE support is enabled. .PP The fundamental building blocks are the regular expressions that match a single character. -- 2.34.1 ------------=_1641151081-1869-1--