From unknown Sun Jun 22 11:36:42 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#31803 <31803@debbugs.gnu.org> To: bug#31803 <31803@debbugs.gnu.org> Subject: Status: Problems in chroot.2, ln.1, test.1, [.1 Reply-To: bug#31803 <31803@debbugs.gnu.org> Date: Sun, 22 Jun 2025 18:36:42 +0000 retitle 31803 Problems in chroot.2, ln.1, test.1, [.1 reassign 31803 coreutils submitter 31803 esr@thyrsus.com severity 31803 normal tag 31803 fixed thanks From debbugs-submit-bounces@debbugs.gnu.org Tue Jun 12 15:16:30 2018 Received: (at submit) by debbugs.gnu.org; 12 Jun 2018 19:16:30 +0000 Received: from localhost ([127.0.0.1]:45350 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fSomL-0008Or-Ja for submit@debbugs.gnu.org; Tue, 12 Jun 2018 15:16:29 -0400 Received: from eggs.gnu.org ([208.118.235.92]:45488) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fSomK-0008Oe-54 for submit@debbugs.gnu.org; Tue, 12 Jun 2018 15:16:28 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fSomD-00063j-Ok for submit@debbugs.gnu.org; Tue, 12 Jun 2018 15:16:23 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:40579) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fSomD-00063f-Ke for submit@debbugs.gnu.org; Tue, 12 Jun 2018 15:16:21 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:36413) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fSomB-0000z5-PH for bug-coreutils@gnu.org; Tue, 12 Jun 2018 15:16:21 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fSom7-00060S-E0 for bug-coreutils@gnu.org; Tue, 12 Jun 2018 15:16:19 -0400 Received: from thyrsus.com ([71.162.243.5]:33846 helo=snark.thyrsus.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fSom7-0005zd-8P for bug-coreutils@gnu.org; Tue, 12 Jun 2018 15:16:15 -0400 Received: from [127.0.1.1] (localhost [127.0.0.1]) by snark.thyrsus.com (Postfix) with ESMTP id 88EF63A4F87 for ; Tue, 12 Jun 2018 15:16:14 -0400 (EDT) X-Mailbox-Line: From nobody Tue Jun 12 15:16:14 2018 Content-Type: multipart/mixed; boundary="===============2975098401658857498==" MIME-Version: 1.0 To: bug-coreutils@gnu.org Subject: Problems in chroot.2, ln.1, test.1, [.1 Message-Id: <20180612191614.88EF63A4F87@snark.thyrsus.com> Date: Tue, 12 Jun 2018 15:16:14 -0400 (EDT) From: esr@thyrsus.com X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -5.0 (-----) 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: -6.0 (------) --===============2975098401658857498== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit This is automatically generated email about markup problems in a man page for which you appear to be responsible. If you are not the right person or list, please tell me so I can correct my database. See http://catb.org/~esr/doclifter/bugs.html for details on how and why these patches were generated. Feel free to email me with any questions. Note: These patches do not change the modification date of any manual page. You may wish to do that by hand. I apologize if this message seems spammy or impersonal. The volume of markup bugs I am tracking is over five hundred - there is no real alternative to generating bugmail from a database and template. -- Eric S. Raymond --===============2975098401658857498== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Problems with test.1: (Identical patches should apply to: [.1) Broken command synopsis syntax. This may mean you're using a construction in the command synopsis other than the standard [ ] | { }, or it may mean you have running text in the command synopsis section (the latter is not technically an error, but most cases of it are impossible to translate into DocBook markup), or it may mean the command syntax fails to match the description. Command-line options described are not actually implemented. --- test.1-unpatched 2018-04-17 21:54:23.971441556 -0400 +++ test.1 2018-04-17 21:58:02.075011621 -0400 @@ -7,20 +7,15 @@ \fI\,EXPRESSION\/\fR .br .B test - -.br -.B [ -\fI\,EXPRESSION \/\fR] -.br -.B [ -] -.br -.B [ -\fI\,OPTION\/\fR .SH DESCRIPTION .\" Add any additional description here .PP Exit with the status determined by EXPRESSION. +.PP +The command "[" is linked to test, and a trailing "]" im the arguments +is ignored. Thus, acomposition of the operations described below may +be surrounded by [ ] and will be interpreted as a test command. This +syntax is frequently used in shell conditionals. .TP \fB\-\-help\fR display this help and exit --===============2975098401658857498== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Problems with chroot.2: My translator trips over a useless command in list markup. List syntax error. This means .IP, .TP or .RS/.RE markup is garbled. Common causes include .TP just before a section header, .TP entries with tags but no bodies, and mandoc lists with no trailing .El. These confuse doclifter, and may also mess up stricter man-page browsers like Xman and Rosetta. --- chroot.2-unpatched 2018-05-17 13:06:30.287251247 -0400 +++ chroot.2 2018-05-17 13:08:13.406550442 -0400 @@ -46,17 +46,13 @@ .BR chroot (): .ad l .RS 4 -.PD 0 -.TP 4 Since glibc 2.2.2: .nf _XOPEN_SOURCE && ! (_POSIX_C_SOURCE\ >=\ 200112L) || /* Since glibc 2.20: */ _DEFAULT_SOURCE || /* Glibc versions <= 2.19: */ _BSD_SOURCE -.TP 4 .fi Before glibc 2.2.2: none -.PD .RE .ad b .SH DESCRIPTION --===============2975098401658857498== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Problems with ln.1: Parenthesized comments in command synopsis. This is impossible to translate to DocBook. --- ln.1-unpatched 2018-04-17 21:19:33.699561983 -0400 +++ ln.1 2018-04-17 21:20:35.227440696 -0400 @@ -4,16 +4,16 @@ ln \- make links between files .SH SYNOPSIS .B ln -[\fI\,OPTION\/\fR]... [\fI\,-T\/\fR] \fI\,TARGET LINK_NAME (1st form)\/\fR +[\fI\,OPTION\/\fR]... [\fI\,-T\/\fR] \fI\,TARGET LINK_NAME\/\fR .br .B ln -[\fI\,OPTION\/\fR]... \fI\,TARGET (2nd form)\/\fR +[\fI\,OPTION\/\fR]... \fI\,TARGET\/\fR .br .B ln -[\fI\,OPTION\/\fR]... \fI\,TARGET\/\fR... \fI\,DIRECTORY (3rd form)\/\fR +[\fI\,OPTION\/\fR]... \fI\,TARGET\/\fR... \fI\,DIRECTORY\/\fR .br .B ln -[\fI\,OPTION\/\fR]... \fI\,-t DIRECTORY TARGET\/\fR... \fI\,(4th form)\/\fR +[\fI\,OPTION\/\fR]... \fI\,-t DIRECTORY TARGET\/\fR... .SH DESCRIPTION .\" Add any additional description here .PP --===============2975098401658857498==-- From debbugs-submit-bounces@debbugs.gnu.org Tue Jun 12 16:18:36 2018 Received: (at 31803) by debbugs.gnu.org; 12 Jun 2018 20:18:36 +0000 Received: from localhost ([127.0.0.1]:45402 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fSpkR-0007JD-ML for submit@debbugs.gnu.org; Tue, 12 Jun 2018 16:18:36 -0400 Received: from mx3-rdu2.redhat.com ([66.187.233.73]:44876 helo=mx1.redhat.com) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fSpkP-0007Iy-FQ for 31803@debbugs.gnu.org; Tue, 12 Jun 2018 16:18:34 -0400 Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.rdu2.redhat.com [10.11.54.6]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 13FCA818F6FB; Tue, 12 Jun 2018 20:18:28 +0000 (UTC) Received: from [10.10.120.103] (ovpn-120-103.rdu2.redhat.com [10.10.120.103]) by smtp.corp.redhat.com (Postfix) with ESMTP id B8A2D2166BB2; Tue, 12 Jun 2018 20:18:27 +0000 (UTC) Subject: Re: bug#31803: Problems in chroot.2, ln.1, test.1, [.1 To: esr@thyrsus.com, 31803@debbugs.gnu.org References: <20180612191614.88EF63A4F87@snark.thyrsus.com> From: Eric Blake Organization: Red Hat, Inc. Message-ID: Date: Tue, 12 Jun 2018 15:18:27 -0500 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.8.0 MIME-Version: 1.0 In-Reply-To: <20180612191614.88EF63A4F87@snark.thyrsus.com> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit X-Scanned-By: MIMEDefang 2.78 on 10.11.54.6 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.11.55.8]); Tue, 12 Jun 2018 20:18:28 +0000 (UTC) X-Greylist: inspected by milter-greylist-4.5.16 (mx1.redhat.com [10.11.55.8]); Tue, 12 Jun 2018 20:18:28 +0000 (UTC) for IP:'10.11.54.6' DOMAIN:'int-mx06.intmail.prod.int.rdu2.redhat.com' HELO:'smtp.corp.redhat.com' FROM:'eblake@redhat.com' RCPT:'' X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 31803 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.3 (---) On 06/12/2018 02:16 PM, esr@thyrsus.com wrote: > > Problems with test.1: > > (Identical patches should apply to: [.1) Well, it's the same page, so there's only one file to patch, if at all. > > Broken command synopsis syntax. This may mean you're using a > construction in the command synopsis other than the standard > [ ] | { }, or it may mean you have running text in the command synopsis > section (the latter is not technically an error, but most cases of it > are impossible to translate into DocBook markup), or it may mean the > command syntax fails to match the description. > > Command-line options described are not actually implemented. > > --- test.1-unpatched 2018-04-17 21:54:23.971441556 -0400 > +++ test.1 2018-04-17 21:58:02.075011621 -0400 > @@ -7,20 +7,15 @@ > \fI\,EXPRESSION\/\fR > .br > .B test > - > -.br > -.B [ > -\fI\,EXPRESSION \/\fR] > -.br > -.B [ > -] > -.br > -.B [ > -\fI\,OPTION\/\fR Is your complaint that these are not rendering correctly? They match the output of '[ --help' (since that is the canonical source that generates the coreutils man pages); it may be that the bug is in help2man in not knowing how to render the [ utility properly. > .SH DESCRIPTION > .\" Add any additional description here > .PP > Exit with the status determined by EXPRESSION. > +.PP > +The command "[" is linked to test, and a trailing "]" im the arguments s/im/in/ > +is ignored. Thus, acomposition of the operations described below may s/acomposition/a composition/ > +be surrounded by [ ] and will be interpreted as a test command. This > +syntax is frequently used in shell conditionals. I'm not a fan of this rewording (even if it were done without typos). While the man pages test.1 and [.1 are identical (can and should be hard linked), the utilities test(1) and [(1) are intentionally NOT hard links. Per GNU Coding Standards, we compile two separate binaries, with two different behaviors chosen at compile time, rather than one utility that pays attention to argv[0]. In fact, if I do 'ln -s /bin/[ $HOME/test', I'd get the [ behavior rather than the test behavior when invoking $HOME/test (rather confusing, but fits with the fact that POSIX says that invoking test and/or [ via a symlink with an inappropriate basename is non-portable - caveat emptor). At any rate, the behavior of --help and whether a trailing ] is significant differs between the two utilities, and a wall of prose does not do justice to the fact that the two invocations are intentionally different (in particular, you've gotten rid of the '[ OPTION' synopsis, which does not exist for the test utility, but is essential for the '[ --help' trick that generates the man page in the first place). > .TP > \fB\-\-help\fR > display this help and exit > > > > Problems with chroot.2: > > My translator trips over a useless command in list markup. > > List syntax error. This means .IP, .TP or .RS/.RE markup is garbled. > Common causes include .TP just before a section header, .TP entries > with tags but no bodies, and mandoc lists with no trailing .El. > These confuse doclifter, and may also mess up stricter man-page > browsers like Xman and Rosetta. > > --- chroot.2-unpatched 2018-05-17 13:06:30.287251247 -0400 > +++ chroot.2 2018-05-17 13:08:13.406550442 -0400 > @@ -46,17 +46,13 @@ > .BR chroot (): > .ad l > .RS 4 > -.PD 0 > -.TP 4 > Since glibc 2.2.2: > .nf > _XOPEN_SOURCE && ! (_POSIX_C_SOURCE\ >=\ 200112L) > || /* Since glibc 2.20: */ _DEFAULT_SOURCE > || /* Glibc versions <= 2.19: */ _BSD_SOURCE > -.TP 4 > .fi > Before glibc 2.2.2: none > -.PD > .RE > .ad b > .SH DESCRIPTION > Thanks. Again, that's probably a bug in help2man rendering 'chroot --help' output incorrectly, so we should fix that tool (coreutils has man/chroot.x as a template to guide things that help2man can't do by itself, but the templates are very minimal, and there is no usage of the empty list construct in the template file, so it is being generated by help2man). > > > Problems with ln.1: > > Parenthesized comments in command synopsis. This is impossible > to translate to DocBook. > > --- ln.1-unpatched 2018-04-17 21:19:33.699561983 -0400 > +++ ln.1 2018-04-17 21:20:35.227440696 -0400 > @@ -4,16 +4,16 @@ > ln \- make links between files > .SH SYNOPSIS > .B ln > -[\fI\,OPTION\/\fR]... [\fI\,-T\/\fR] \fI\,TARGET LINK_NAME (1st form)\/\fR > +[\fI\,OPTION\/\fR]... [\fI\,-T\/\fR] \fI\,TARGET LINK_NAME\/\fR > .br > .B ln > -[\fI\,OPTION\/\fR]... \fI\,TARGET (2nd form)\/\fR > +[\fI\,OPTION\/\fR]... \fI\,TARGET\/\fR > .br > .B ln > -[\fI\,OPTION\/\fR]... \fI\,TARGET\/\fR... \fI\,DIRECTORY (3rd form)\/\fR > +[\fI\,OPTION\/\fR]... \fI\,TARGET\/\fR... \fI\,DIRECTORY\/\fR > .br > .B ln > -[\fI\,OPTION\/\fR]... \fI\,-t DIRECTORY TARGET\/\fR... \fI\,(4th form)\/\fR > +[\fI\,OPTION\/\fR]... \fI\,-t DIRECTORY TARGET\/\fR... Here, the problem lies in 'ln --help' output, which is easy to patch via src/ln.c, rather than trying to patch man/ln.x or help2man. -- Eric Blake, Principal Software Engineer Red Hat, Inc. +1-919-301-3266 Virtualization: qemu.org | libvirt.org From debbugs-submit-bounces@debbugs.gnu.org Tue Jun 12 17:34:05 2018 Received: (at 31803) by debbugs.gnu.org; 12 Jun 2018 21:34:05 +0000 Received: from localhost ([127.0.0.1]:45465 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fSqvU-0000jg-R5 for submit@debbugs.gnu.org; Tue, 12 Jun 2018 17:34:05 -0400 Received: from thyrsus.com ([71.162.243.5]:52186 helo=snark.thyrsus.com) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fSqvS-0000jX-Pq for 31803@debbugs.gnu.org; Tue, 12 Jun 2018 17:34:03 -0400 Received: by snark.thyrsus.com (Postfix, from userid 1000) id 048113A4F0D; Tue, 12 Jun 2018 17:34:02 -0400 (EDT) Date: Tue, 12 Jun 2018 17:34:01 -0400 From: "Eric S. Raymond" To: Eric Blake Subject: Re: bug#31803: Problems in chroot.2, ln.1, test.1, [.1 Message-ID: <20180612213401.GA4849@thyrsus.com> References: <20180612191614.88EF63A4F87@snark.thyrsus.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: Organization: Eric Conspiracy Secret Labs X-Eric-Conspiracy: There is no conspiracy User-Agent: Mutt/1.9.4 (2018-02-28) X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 31803 Cc: 31803@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: , Reply-To: esr@thyrsus.com Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Eric Blake : > Is your complaint that these are not rendering correctly? They match the > output of '[ --help' (since that is the canonical source that generates the > coreutils man pages); it may be that the bug is in help2man in not knowing > how to render the [ utility properly. No, it renders properly in man. The problem is that some of what the page does cannot be lifted to Docbook-XML. What this matters: You find me near the end of the hard part of a project I've been working for 17 years - beating the horrible tag soup that is the Unix manual-page corpus into something uniform enough that high-quality HTML can be generated from it reliably and mechanically. Why DocBook-XML? Because it turns out that trying to move directly from presentation-level man markup to HTML produces crappy HTML. Better to use cliche analysis to get to semantic markup and than to HTML from that; it means (for example) that things like emphasized content and examples render in the output HTML in a uniform way rather than carrying through idiosyncratic presentation choices from the input. Also you get things like working hyperlinks from man page references. I'm down to 13 errors and 397 patches for markup errors out of 13699 pages in an Ubuntu 18.04 with a lot of development stuff loaded. Your pages are in only 3% that don't yet lift clean. That number will drop further because mosr of the patches I ship are plain and simple bug fixes, nit The end goal is that `man foo' should by default no longer produce plain text through a pager, but rather get you high-quality HTML through a text browser with all hypertext features working. Without package authors having to do anything special - with automatic conversion good enough all the magic can be done at the distro-package level. In your specific case, one problem is that the '[' that is test's alias desperately confuses my parser for command synopses, which is trying to lift these into the XML submarkup for these synoposes. This is a harder problem than simply making sure the synopsis looks reasonable. Another issue is that the XML-Docbook command syntax has no way to embed explanatory text win a command synopsis. Thus, in order to achieve the end goal I have to jawbone manpage authors into not doing this. > I'm not a fan of this rewording (even if it were done without typos). While > the man pages test.1 and [.1 are identical (can and should be hard linked), > the utilities test(1) and [(1) are intentionally NOT hard links. Per GNU > Coding Standards, we compile two separate binaries, with two different > behaviors chosen at compile time, rather than one utility that pays > attention to argv[0]. In fact, if I do 'ln -s /bin/[ $HOME/test', I'd get > the [ behavior rather than the test behavior when invoking $HOME/test > (rather confusing, but fits with the fact that POSIX says that invoking test > and/or [ via a symlink with an inappropriate basename is non-portable - > caveat emptor). > > At any rate, the behavior of --help and whether a trailing ] is significant > differs between the two utilities, and a wall of prose does not do justice > to the fact that the two invocations are intentionally different (in > particular, you've gotten rid of the '[ OPTION' synopsis, which does not > exist for the test utility, but is essential for the '[ --help' trick that > generates the man page in the first place). I think these objections are perfectly reasonable. Your page is one of the awkward cases where I had to bend the markup and text somewhat out of its natural shape (more so than I wanted to) to fit the XML-Docbook constraints. We can cooperate to work around this. One obvious way: If the square-bracket aliases on your page were marked up as the groff escapes \*[lB] and \*[rB] instead of '[' and ']' they would render the same, but I think I could teach my parser to no longer be confused and I wouldn't have to try to patch them out in favor of a wall of text. -- Eric S. Raymond My work is funded by the Internet Civil Engineering Institute: https://icei.org Please visit their site and donate: the civilization you save might be your own. From debbugs-submit-bounces@debbugs.gnu.org Wed Jun 13 12:03:14 2018 Received: (at 31803) by debbugs.gnu.org; 13 Jun 2018 16:03:14 +0000 Received: from localhost ([127.0.0.1]:46783 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fT8Es-0000dn-E2 for submit@debbugs.gnu.org; Wed, 13 Jun 2018 12:03:14 -0400 Received: from zimbra.cs.ucla.edu ([131.179.128.68]:58658) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fT8Eq-0000da-5T for 31803@debbugs.gnu.org; Wed, 13 Jun 2018 12:03:13 -0400 Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 368D4160670; Wed, 13 Jun 2018 09:03:06 -0700 (PDT) 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 iK2X8KH11kKd; Wed, 13 Jun 2018 09:03:05 -0700 (PDT) Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 7B66F1606C2; Wed, 13 Jun 2018 09:03:05 -0700 (PDT) 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 FXtFVriwOMrp; Wed, 13 Jun 2018 09:03:05 -0700 (PDT) Received: from [192.168.1.9] (unknown [47.154.30.119]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id 27DF3160670; Wed, 13 Jun 2018 09:03:05 -0700 (PDT) Subject: Re: bug#31803: Problems in chroot.2, ln.1, test.1, [.1 To: esr@thyrsus.com, Eric Blake References: <20180612191614.88EF63A4F87@snark.thyrsus.com> <20180612213401.GA4849@thyrsus.com> From: Paul Eggert Openpgp: preference=signencrypt Autocrypt: addr=eggert@cs.ucla.edu; prefer-encrypt=mutual; keydata= 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 uNcby4U= Organization: UCLA Computer Science Department Message-ID: <069629df-1d6b-f83e-8110-5eb71dca1c35@cs.ucla.edu> Date: Wed, 13 Jun 2018 09:03:04 -0700 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.8.0 MIME-Version: 1.0 In-Reply-To: <20180612213401.GA4849@thyrsus.com> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 31803 Cc: 31803@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.3 (---) Eric S. Raymond wrote: > We can cooperate to work around this. One obvious way: If the > square-bracket aliases on your page were marked up as the groff > escapes \*[lB] and \*[rB] instead of '[' and ']' they would render the > same, but I think I could teach my parser to no longer be confused and > I wouldn't have to try to patch them out in favor of a wall of text. Something like that should be fine. However, wouldn't it cause the man page to fail with traditional troff, as still shipped and supported on Solaris 10? In that case, perhaps we could use [\"[ and ]\"] as special markers instead of using \*[lB] and \*[rB]; this should work with bold old troff and groff, if I understand the proposal correctly. From debbugs-submit-bounces@debbugs.gnu.org Wed Jun 13 16:24:27 2018 Received: (at 31803) by debbugs.gnu.org; 13 Jun 2018 20:24:27 +0000 Received: from localhost ([127.0.0.1]:46937 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fTCJf-0004F9-1O for submit@debbugs.gnu.org; Wed, 13 Jun 2018 16:24:27 -0400 Received: from thyrsus.com ([71.162.243.5]:36494 helo=snark.thyrsus.com) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fTCJc-0004Ez-O6 for 31803@debbugs.gnu.org; Wed, 13 Jun 2018 16:24:25 -0400 Received: by snark.thyrsus.com (Postfix, from userid 1000) id A718B3A4F0C; Wed, 13 Jun 2018 16:24:23 -0400 (EDT) Date: Wed, 13 Jun 2018 16:24:23 -0400 From: "Eric S. Raymond" To: Paul Eggert Subject: Re: bug#31803: Problems in chroot.2, ln.1, test.1, [.1 Message-ID: <20180613202423.GD5102@thyrsus.com> References: <20180612191614.88EF63A4F87@snark.thyrsus.com> <20180612213401.GA4849@thyrsus.com> <069629df-1d6b-f83e-8110-5eb71dca1c35@cs.ucla.edu> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <069629df-1d6b-f83e-8110-5eb71dca1c35@cs.ucla.edu> Organization: Eric Conspiracy Secret Labs X-Eric-Conspiracy: There is no conspiracy User-Agent: Mutt/1.9.4 (2018-02-28) X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 31803 Cc: 31803@debbugs.gnu.org, Eric Blake 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: , Reply-To: esr@thyrsus.com Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Paul Eggert : > Eric S. Raymond wrote: > > We can cooperate to work around this. One obvious way: If the > > square-bracket aliases on your page were marked up as the groff > > escapes \*[lB] and \*[rB] instead of '[' and ']' they would render the > > same, but I think I could teach my parser to no longer be confused and > > I wouldn't have to try to patch them out in favor of a wall of text. > > Something like that should be fine. However, wouldn't it cause the man page > to fail with traditional troff, as still shipped and supported on Solaris > 10? In that case, perhaps we could use [\"[ and ]\"] as special markers > instead of using \*[lB] and \*[rB]; this should work with bold old troff and > groff, if I understand the proposal correctly. I see the problem, but I'm afraid my groff-fu is no strong enough to grok your proposed solution. Why will those sequences work? What are they doing? -- Eric S. Raymond My work is funded by the Internet Civil Engineering Institute: https://icei.org Please visit their site and donate: the civilization you save might be your own. From debbugs-submit-bounces@debbugs.gnu.org Wed Jun 13 18:00:29 2018 Received: (at 31803) by debbugs.gnu.org; 13 Jun 2018 22:00:29 +0000 Received: from localhost ([127.0.0.1]:46991 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fTDob-0006Rr-0h for submit@debbugs.gnu.org; Wed, 13 Jun 2018 18:00:29 -0400 Received: from zimbra.cs.ucla.edu ([131.179.128.68]:38178) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fTDoY-0006Re-P0 for 31803@debbugs.gnu.org; Wed, 13 Jun 2018 18:00:27 -0400 Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id C7D46160825; Wed, 13 Jun 2018 15:00:20 -0700 (PDT) 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 KACcb34CkZ7B; Wed, 13 Jun 2018 15:00:20 -0700 (PDT) Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 196AB160874; Wed, 13 Jun 2018 15:00:20 -0700 (PDT) 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 yGXjsJX-Q4tv; Wed, 13 Jun 2018 15:00:20 -0700 (PDT) Received: from Penguin.CS.UCLA.EDU (Penguin.CS.UCLA.EDU [131.179.64.200]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id F3BE5160825; Wed, 13 Jun 2018 15:00:19 -0700 (PDT) Subject: Re: bug#31803: Problems in chroot.2, ln.1, test.1, [.1 To: esr@thyrsus.com References: <20180612191614.88EF63A4F87@snark.thyrsus.com> <20180612213401.GA4849@thyrsus.com> <069629df-1d6b-f83e-8110-5eb71dca1c35@cs.ucla.edu> <20180613202423.GD5102@thyrsus.com> From: Paul Eggert Openpgp: preference=signencrypt Autocrypt: addr=eggert@cs.ucla.edu; prefer-encrypt=mutual; keydata= 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 uNcby4U= Organization: UCLA Computer Science Department Message-ID: <6456d2d6-abe9-9f3b-373b-884725e573cb@cs.ucla.edu> Date: Wed, 13 Jun 2018 15:00:19 -0700 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.8.0 MIME-Version: 1.0 In-Reply-To: <20180613202423.GD5102@thyrsus.com> Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit Content-Language: en-US X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 31803 Cc: 31803@debbugs.gnu.org, Eric Blake 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.3 (---) On 06/13/2018 01:24 PM, Eric S. Raymond wrote: > I see the problem, but I'm afraid my groff-fu is no strong enough to grok your > proposed solution. Why will those sequences work? What are they doing? They should work for groff and traditional troff, because \" begins a comment. I was hoping that they would also work for whatever preprocessor you're writing, because it can treat [\"[ etc. specially and your preprocessor can key off that. From debbugs-submit-bounces@debbugs.gnu.org Wed Jun 13 18:07:59 2018 Received: (at 31803) by debbugs.gnu.org; 13 Jun 2018 22:07:59 +0000 Received: from localhost ([127.0.0.1]:46995 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fTDvq-0006cp-RS for submit@debbugs.gnu.org; Wed, 13 Jun 2018 18:07:59 -0400 Received: from thyrsus.com ([71.162.243.5]:42764 helo=snark.thyrsus.com) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fTDvo-0006cg-RP for 31803@debbugs.gnu.org; Wed, 13 Jun 2018 18:07:57 -0400 Received: by snark.thyrsus.com (Postfix, from userid 1000) id 8AEED3A4F0C; Wed, 13 Jun 2018 18:07:56 -0400 (EDT) Date: Wed, 13 Jun 2018 18:07:56 -0400 From: "Eric S. Raymond" To: Paul Eggert Subject: Re: bug#31803: Problems in chroot.2, ln.1, test.1, [.1 Message-ID: <20180613220756.GA21993@thyrsus.com> References: <20180612191614.88EF63A4F87@snark.thyrsus.com> <20180612213401.GA4849@thyrsus.com> <069629df-1d6b-f83e-8110-5eb71dca1c35@cs.ucla.edu> <20180613202423.GD5102@thyrsus.com> <6456d2d6-abe9-9f3b-373b-884725e573cb@cs.ucla.edu> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <6456d2d6-abe9-9f3b-373b-884725e573cb@cs.ucla.edu> Organization: Eric Conspiracy Secret Labs X-Eric-Conspiracy: There is no conspiracy User-Agent: Mutt/1.9.4 (2018-02-28) X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 31803 Cc: 31803@debbugs.gnu.org, Eric Blake 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: , Reply-To: esr@thyrsus.com Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Paul Eggert : > On 06/13/2018 01:24 PM, Eric S. Raymond wrote: > > I see the problem, but I'm afraid my groff-fu is no strong enough to grok your > > proposed solution. Why will those sequences work? What are they doing? > > They should work for groff and traditional troff, because \" begins a > comment. I was hoping that they would also work for whatever preprocessor > you're writing, because it can treat [\"[ etc. specially and your > preprocessor can key off that. Ahh, I see. I was confused because I thought you were proposing using those inline and I didn't see how that could work. OK, this should fly. Please mark up the manual sources with those (and put a comment somewhere explaining why we're doing this, to deconfuse future maintainers) and mail me a copy. Then I'll teach doclifter to DTRT. -- Eric S. Raymond My work is funded by the Internet Civil Engineering Institute: https://icei.org Please visit their site and donate: the civilization you save might be your own. From debbugs-submit-bounces@debbugs.gnu.org Wed Jun 13 19:12:25 2018 Received: (at 31803) by debbugs.gnu.org; 13 Jun 2018 23:12:25 +0000 Received: from localhost ([127.0.0.1]:47005 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fTEwC-00082k-R8 for submit@debbugs.gnu.org; Wed, 13 Jun 2018 19:12:25 -0400 Received: from zimbra.cs.ucla.edu ([131.179.128.68]:49156) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fTEwA-00082V-J7 for 31803@debbugs.gnu.org; Wed, 13 Jun 2018 19:12:23 -0400 Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 913AC160972; Wed, 13 Jun 2018 16:12:16 -0700 (PDT) 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 8zS5LSA676Bq; Wed, 13 Jun 2018 16:12:15 -0700 (PDT) Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 97457160CDC; Wed, 13 Jun 2018 16:12:15 -0700 (PDT) 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 uGmuFXvKaZyh; Wed, 13 Jun 2018 16:12:15 -0700 (PDT) Received: from Penguin.CS.UCLA.EDU (Penguin.CS.UCLA.EDU [131.179.64.200]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id 7D566160972; Wed, 13 Jun 2018 16:12:15 -0700 (PDT) Subject: Re: bug#31803: Problems in chroot.2, ln.1, test.1, [.1 To: esr@thyrsus.com References: <20180612191614.88EF63A4F87@snark.thyrsus.com> <20180612213401.GA4849@thyrsus.com> <069629df-1d6b-f83e-8110-5eb71dca1c35@cs.ucla.edu> <20180613202423.GD5102@thyrsus.com> <6456d2d6-abe9-9f3b-373b-884725e573cb@cs.ucla.edu> <20180613220756.GA21993@thyrsus.com> From: Paul Eggert Openpgp: preference=signencrypt Autocrypt: addr=eggert@cs.ucla.edu; prefer-encrypt=mutual; keydata= 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 uNcby4U= Organization: UCLA Computer Science Department Message-ID: <62a29a5a-0de4-7936-d199-12b5b6c29e95@cs.ucla.edu> Date: Wed, 13 Jun 2018 16:12:15 -0700 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.8.0 MIME-Version: 1.0 In-Reply-To: <20180613220756.GA21993@thyrsus.com> Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit Content-Language: en-US X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 31803 Cc: 31803@debbugs.gnu.org, Eric Blake 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.3 (---) On 06/13/2018 03:07 PM, Eric S. Raymond wrote: > OK, this should fly. Please mark up the manual sources with those (and put > a comment somewhere explaining why we're doing this, to deconfuse future > maintainers) and mail me a copy. Then I'll teach doclifter to DTRT. It turns out to be more complicated, since test.1 and ln.1 are automatically generated by help2man. Also, in looking at the troff source I thought it'd be cleaner to quote the square brackets, like this for example: .B "[" If this doesn't work for doclifter please let me know; we could use '.B [\&' instead, as now that I think about it that's a more common way to address similar issues than the comment hack I mentioned in my previous email. Your bug report mentioned chroot.2, but that man page belongs to the kernel; coreutils is in charge of chroot.1 so I guess you should send the chroot.2 section to the kernel man page maintainers. Finally, there is no file '[.1' in coreutils. Perhaps this is some alias maintained downstream? Anyway, it's likely just a copy of test.1 so we should be OK here. I installed the following patches into coreutils and I hope this fixes things for you. https://git.savannah.gnu.org/cgit/coreutils.git/commit/?id=de73c801f34438c1457118f33e26e688554019d3 From debbugs-submit-bounces@debbugs.gnu.org Thu Jun 14 00:09:48 2018 Received: (at 31803) by debbugs.gnu.org; 14 Jun 2018 04:09:48 +0000 Received: from localhost ([127.0.0.1]:47197 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fTJa0-0007pi-J7 for submit@debbugs.gnu.org; Thu, 14 Jun 2018 00:09:48 -0400 Received: from thyrsus.com ([71.162.243.5]:59522 helo=snark.thyrsus.com) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fTJZy-0007pZ-Ln for 31803@debbugs.gnu.org; Thu, 14 Jun 2018 00:09:47 -0400 Received: by snark.thyrsus.com (Postfix, from userid 1000) id CED9F3A4F0D; Thu, 14 Jun 2018 00:09:45 -0400 (EDT) Date: Thu, 14 Jun 2018 00:09:45 -0400 From: "Eric S. Raymond" To: Paul Eggert Subject: Re: bug#31803: Problems in chroot.2, ln.1, test.1, [.1 Message-ID: <20180614040945.GG23233@thyrsus.com> References: <20180612191614.88EF63A4F87@snark.thyrsus.com> <20180612213401.GA4849@thyrsus.com> <069629df-1d6b-f83e-8110-5eb71dca1c35@cs.ucla.edu> <20180613202423.GD5102@thyrsus.com> <6456d2d6-abe9-9f3b-373b-884725e573cb@cs.ucla.edu> <20180613220756.GA21993@thyrsus.com> <62a29a5a-0de4-7936-d199-12b5b6c29e95@cs.ucla.edu> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <62a29a5a-0de4-7936-d199-12b5b6c29e95@cs.ucla.edu> Organization: Eric Conspiracy Secret Labs X-Eric-Conspiracy: There is no conspiracy User-Agent: Mutt/1.9.4 (2018-02-28) X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 31803 Cc: 31803@debbugs.gnu.org, Eric Blake 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: , Reply-To: esr@thyrsus.com Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Paul Eggert : > It turns out to be more complicated, since test.1 and ln.1 are automatically > generated by help2man. Also, in looking at the troff source I thought it'd > be cleaner to quote the square brackets, like this for example: > > .B "[" > > If this doesn't work for doclifter please let me know; we could use '.B [\&' > instead, as now that I think about it that's a more common way to address > similar issues than the comment hack I mentioned in my previous email. I think [\& would be better. I have to quote-strip while parsing synopsis sections, so there's an order-of-operations issue there that's best avoided. -- Eric S. Raymond My work is funded by the Internet Civil Engineering Institute: https://icei.org Please visit their site and donate: the civilization you save might be your own. From debbugs-submit-bounces@debbugs.gnu.org Thu Jun 14 15:09:19 2018 Received: (at 31803) by debbugs.gnu.org; 14 Jun 2018 19:09:19 +0000 Received: from localhost ([127.0.0.1]:48434 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fTXcU-00017T-M6 for submit@debbugs.gnu.org; Thu, 14 Jun 2018 15:09:18 -0400 Received: from zimbra.cs.ucla.edu ([131.179.128.68]:50702) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fTXcR-00017B-Uc for 31803@debbugs.gnu.org; Thu, 14 Jun 2018 15:09:16 -0400 Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id F1CD5160844; Thu, 14 Jun 2018 12:09:09 -0700 (PDT) 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 yV2ixV2SvFWd; Thu, 14 Jun 2018 12:09:09 -0700 (PDT) Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 36FD4160CBC; Thu, 14 Jun 2018 12:09:09 -0700 (PDT) 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 ya1FQD3dFRwG; Thu, 14 Jun 2018 12:09:09 -0700 (PDT) Received: from Penguin.CS.UCLA.EDU (Penguin.CS.UCLA.EDU [131.179.64.200]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id 17A2B160844; Thu, 14 Jun 2018 12:09:09 -0700 (PDT) Subject: Re: bug#31803: Problems in chroot.2, ln.1, test.1, [.1 To: esr@thyrsus.com References: <20180612191614.88EF63A4F87@snark.thyrsus.com> <20180612213401.GA4849@thyrsus.com> <069629df-1d6b-f83e-8110-5eb71dca1c35@cs.ucla.edu> <20180613202423.GD5102@thyrsus.com> <6456d2d6-abe9-9f3b-373b-884725e573cb@cs.ucla.edu> <20180613220756.GA21993@thyrsus.com> <62a29a5a-0de4-7936-d199-12b5b6c29e95@cs.ucla.edu> <20180614040945.GG23233@thyrsus.com> From: Paul Eggert Openpgp: preference=signencrypt Autocrypt: addr=eggert@cs.ucla.edu; prefer-encrypt=mutual; keydata= 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 uNcby4U= Organization: UCLA Computer Science Department Message-ID: <7c64fd07-bf68-378d-2775-a3348ccaec29@cs.ucla.edu> Date: Thu, 14 Jun 2018 12:09:08 -0700 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.8.0 MIME-Version: 1.0 In-Reply-To: <20180614040945.GG23233@thyrsus.com> Content-Type: multipart/mixed; boundary="------------56CF05310AA33BD4C31AC7A9" Content-Language: en-US X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 31803 Cc: 31803@debbugs.gnu.org, Eric Blake 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.3 (---) This is a multi-part message in MIME format. --------------56CF05310AA33BD4C31AC7A9 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit On 06/13/2018 09:09 PM, Eric S. Raymond wrote: > I think [\& would be better. I have to quote-strip while parsing > synopsis sections, so there's an order-of-operations issue there > that's best avoided. OK, I installed the attached. Though in hindsight I wonder, can't doclifter see that the brackets are bolded, and so are literals instead of being metanotation? (Can't hurt to ask...) --------------56CF05310AA33BD4C31AC7A9 Content-Type: text/x-patch; name="0001-doc-port-test.1-to-doclifter.patch" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename="0001-doc-port-test.1-to-doclifter.patch" >From b500b8fedede73394be3f49d14cd3b667d091d1a Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Thu, 14 Jun 2018 12:04:57 -0700 Subject: [PATCH] doc: port test.1 to doclifter * man/test.x: Use \& instead of quoting (Bug#31803). --- man/test.x | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/man/test.x b/man/test.x index a7aaf2c82..0adc35fee 100644 --- a/man/test.x +++ b/man/test.x @@ -6,14 +6,14 @@ test \- check file types and compare values .br .B test .br -.\" Quote the square brackets to help doclifter (Bug#31803). -.B "[" +.\" \& tells doclifter the brackets are literal (Bug#31803). +.B [\& .I EXPRESSION -.B "]" +.B ]\& .br -.B "[ ]" +.B "[\& ]\&" .br -.B "[" +.B [\& .I OPTION [DESCRIPTION] .\" Add any additional description here -- 2.17.1 --------------56CF05310AA33BD4C31AC7A9-- From debbugs-submit-bounces@debbugs.gnu.org Thu Jun 14 16:24:51 2018 Received: (at 31803) by debbugs.gnu.org; 14 Jun 2018 20:24:51 +0000 Received: from localhost ([127.0.0.1]:48511 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fTYnb-00032W-J1 for submit@debbugs.gnu.org; Thu, 14 Jun 2018 16:24:51 -0400 Received: from thyrsus.com ([71.162.243.5]:57676 helo=snark.thyrsus.com) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fTYnY-00032N-T2 for 31803@debbugs.gnu.org; Thu, 14 Jun 2018 16:24:49 -0400 Received: by snark.thyrsus.com (Postfix, from userid 1000) id A89EA3A4F0B; Thu, 14 Jun 2018 16:24:48 -0400 (EDT) Date: Thu, 14 Jun 2018 16:24:48 -0400 From: "Eric S. Raymond" To: Paul Eggert Subject: Re: bug#31803: Problems in chroot.2, ln.1, test.1, [.1 Message-ID: <20180614202448.GA14435@thyrsus.com> References: <20180612191614.88EF63A4F87@snark.thyrsus.com> <20180612213401.GA4849@thyrsus.com> <069629df-1d6b-f83e-8110-5eb71dca1c35@cs.ucla.edu> <20180613202423.GD5102@thyrsus.com> <6456d2d6-abe9-9f3b-373b-884725e573cb@cs.ucla.edu> <20180613220756.GA21993@thyrsus.com> <62a29a5a-0de4-7936-d199-12b5b6c29e95@cs.ucla.edu> <20180614040945.GG23233@thyrsus.com> <7c64fd07-bf68-378d-2775-a3348ccaec29@cs.ucla.edu> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <7c64fd07-bf68-378d-2775-a3348ccaec29@cs.ucla.edu> Organization: Eric Conspiracy Secret Labs X-Eric-Conspiracy: There is no conspiracy User-Agent: Mutt/1.9.4 (2018-02-28) X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 31803 Cc: 31803@debbugs.gnu.org, Eric Blake 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: , Reply-To: esr@thyrsus.com Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Paul Eggert : > OK, I installed the attached. Though in hindsight I wonder, can't doclifter > see that the brackets are bolded, and so are literals instead of being > metanotation? (Can't hurt to ask...) It's a perfectly reasonable question and I would probably be asking it myself in your shoes. Unfortunately, use of highlighting in these synopses is so inconsistent (and in some cases downright perverse) that I had to give up trying to back out syntactic/semantic info from it. Too many false positives from very reasonable-sounding rules like yours. This is one aspect of The Problem With Synopses - which is definitely the biggest single pain in my ass by far about parsing man-page tag soup. What can be in a Synopsis section is not standardized anywhere, and governed only by tradition. DocBook-XML does a pretty good job of capturing a large subset of that tradition in a subset of its DTD, but is necessarily unable to express lots of edge cases other than by treating them as unstrucured text. Doing that, of course, defeats the point of the semantic markup. So I fight a constant uphill battle to improve the parser. Been working on this for 17 years and have my residuals down to a hair less than 2% of the man-page corpus, but it's what I've elsewhere called a Zeno tarpit: http://esr.ibiblio.org/?p=6772 -- Eric S. Raymond My work is funded by the Internet Civil Engineering Institute: https://icei.org Please visit their site and donate: the civilization you save might be your own. From debbugs-submit-bounces@debbugs.gnu.org Fri Oct 19 13:04:02 2018 Received: (at control) by debbugs.gnu.org; 19 Oct 2018 17:04:02 +0000 Received: from localhost ([127.0.0.1]:59735 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gDYBt-0002Mm-Q2 for submit@debbugs.gnu.org; Fri, 19 Oct 2018 13:04:02 -0400 Received: from mail-pg1-f174.google.com ([209.85.215.174]:45955) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gDYBr-0002MK-Oj; Fri, 19 Oct 2018 13:04:00 -0400 Received: by mail-pg1-f174.google.com with SMTP id s3-v6so2801381pga.12; Fri, 19 Oct 2018 10:03:59 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:references:from:message-id:date:user-agent:mime-version :in-reply-to:content-language:content-transfer-encoding; bh=Cn90LilHHNzc7RWKOFNGv+VBgVyGea3MRLJv6HWwGCI=; b=gypdsA3FsqPjEthUZob4M4dh7H0Bq9shp9baBhGSU7TN4ZT4igf3Nha0Kt7FffU2So 9LWF2tsevhgtQucLGpVLnl7vWlOq2ZGMM4Y2oxPnNv1diFndSGX8/0lBUUx2dpeSrZh0 XAxo+swnF+9+MwjvAgEWDbTKyW7KVzUlPkaKDhdwXhJfkkmzApIJieel9r8+/BWLfbWb jObaCCUMjUvOfawPL1uHyoHL+zwbKTqef8OqRDMCxeLebnylB00hLSTXfqTe/c7gPl0J KyCph0UgBMOiB7M216lTYAw498yzYxvEH1HBhP6lSn7+Vvo4mXOiexzP9+R4/cpXo9HK VrNA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=Cn90LilHHNzc7RWKOFNGv+VBgVyGea3MRLJv6HWwGCI=; b=AY6PkJ68f0AnjNbyvIU+tROyHGa1U9KVX8K7TR/VWusOXTNVulTUtqtEi+m3eeu5/O wQY7Q0BQfNMrjq0ohDWEbTBKfG7wNSczlF8V7FsJsYKgSCVJC0KJ4LLTcDkpu/9owGPg w/wyy7sOX8sjSEZA2Q2B5faNLF7m8wlkQBZ7nfJYINnPioSOdh3UexDOdjZnYwNCjxlM FAFnzwt3LC+vpuSjWdLI0RYkQwiz9d/UItYGbCetukhFLRr/OFrcbYq8GsiNy2W3Dw3b XJtrQ8vFXnxqTlN/rg5yInRZ8Q0jS2/r7W5ojG7q7CZNZuAz+NuAApAKELaKVPo4/1zf uHdA== X-Gm-Message-State: ABuFfohYA1O75IETzYTg7Y9+/bBAC0AFomW+r0t+KUFA4lEX3ZlHqrNk HjHMPhmPT4tS/60NuK3kXPTigrAuf5o= X-Google-Smtp-Source: ACcGV62E9FsKmQ+yfgq8IvE1ckskLctKAGZCLyoyBvRD3LHBT0Jb7+nMnLNc2UEBS9hAO7fw8WlxRQ== X-Received: by 2002:a63:b95c:: with SMTP id v28-v6mr33071719pgo.221.1539968633297; Fri, 19 Oct 2018 10:03:53 -0700 (PDT) Received: from tomato.housegordon.com (moose.housegordon.com. [184.68.105.38]) by smtp.googlemail.com with ESMTPSA id z22-v6sm30406373pgk.21.2018.10.19.10.03.51 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 19 Oct 2018 10:03:51 -0700 (PDT) Subject: Re: bug#14649: Problems in chroot.2, ln.1, ptx.1, test.1, [.1 To: 14649@debbugs.gnu.org References: <20130618051403.2DFC6417E1@snark.thyrsus.com> <51C072F1.2020408@draigBrady.com> <20130618162235.GC22597@thyrsus.com> From: Assaf Gordon Message-ID: Date: Fri, 19 Oct 2018 11:03:50 -0600 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.9.1 MIME-Version: 1.0 In-Reply-To: <20130618162235.GC22597@thyrsus.com> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control 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 (-) merge 14649 31803 tags 14649 fixed close 14649 stop (triaging old bugs) ln.1 and test.1 fixed here: https://git.savannah.gnu.org/cgit/coreutils.git/commit/?id=de73c801f34438c1457118f33e26e688554019d3 closing. -assaf From unknown Sun Jun 22 11:36:42 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sat, 17 Nov 2018 12:24:04 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator