From debbugs-submit-bounces@debbugs.gnu.org Tue Jun 18 02:30:01 2013 Received: (at submit) by debbugs.gnu.org; 18 Jun 2013 06:30:01 +0000 Received: from localhost ([127.0.0.1]:52129 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1UopQW-0003DA-1O for submit@debbugs.gnu.org; Tue, 18 Jun 2013 02:30:00 -0400 Received: from eggs.gnu.org ([208.118.235.92]:51552) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1UooFN-0000iT-MJ for submit@debbugs.gnu.org; Tue, 18 Jun 2013 01:14:26 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UooFH-0004XL-1p for submit@debbugs.gnu.org; Tue, 18 Jun 2013 01:14:20 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-99.2 required=5.0 tests=BAYES_50,USER_IN_WHITELIST autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:37688) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UooFG-0004XH-VD for submit@debbugs.gnu.org; Tue, 18 Jun 2013 01:14:18 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:53259) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UooFF-0001nT-Mk for bug-coreutils@gnu.org; Tue, 18 Jun 2013 01:14:18 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UooFE-0004Wp-JA for bug-coreutils@gnu.org; Tue, 18 Jun 2013 01:14:17 -0400 Received: from static-71-162-243-5.phlapa.fios.verizon.net ([71.162.243.5]:39860 helo=snark.thyrsus.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UooFE-0004Wj-E1 for bug-coreutils@gnu.org; Tue, 18 Jun 2013 01:14:16 -0400 Received: from [127.0.1.1] (localhost [127.0.0.1]) by snark.thyrsus.com (Postfix) with ESMTP id 2DFC6417E1 for ; Tue, 18 Jun 2013 01:14:03 -0400 (EDT) X-Mailbox-Line: From nobody Tue Jun 18 01:14:03 2013 Content-Type: multipart/mixed; boundary="===============4023865121044683655==" MIME-Version: 1.0 To: bug-coreutils@gnu.org Subject: Problems in chroot.2, ln.1, ptx.1, test.1, [.1 Message-Id: <20130618051403.2DFC6417E1@snark.thyrsus.com> Date: Tue, 18 Jun 2013 01:14:03 -0400 (EDT) From: esr@thyrsus.com X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.1 (----) X-Debbugs-Envelope-To: submit X-Mailman-Approved-At: Tue, 18 Jun 2013 02:29:58 -0400 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 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: -4.1 (----) --===============4023865121044683655== 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 --===============4023865121044683655== 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 2012-06-28 19:08:11.104797083 -0400 +++ ln.1 2012-06-28 19:08:38.520796573 -0400 @@ -4,16 +4,16 @@ ln \- make links between files .SH SYNOPSIS .B ln -[\fIOPTION\fR]... [\fI-T\fR] \fITARGET LINK_NAME (1st form)\fR +[\fIOPTION\fR]... [\fI-T\fR] \fITARGET LINK_NAME .br .B ln -[\fIOPTION\fR]... \fITARGET (2nd form)\fR +[\fIOPTION\fR]... \fITARGET .br .B ln -[\fIOPTION\fR]... \fITARGET\fR... \fIDIRECTORY (3rd form)\fR +[\fIOPTION\fR]... \fITARGET\fR... \fIDIRECTORY .br .B ln -[\fIOPTION\fR]... \fI-t DIRECTORY TARGET\fR... \fI(4th form)\fR +[\fIOPTION\fR]... \fI-t DIRECTORY TARGET\fR... .SH DESCRIPTION .\" Add any additional description here .PP --===============4023865121044683655== 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 2012-06-30 16:40:34.828017118 -0400 +++ chroot.2 2012-06-30 16:41:39.536015957 -0400 @@ -46,15 +46,12 @@ .BR chroot (): .ad l .RS 4 -.PD 0 -.TP 4 Since glibc 2.2.2: .nf _BSD_SOURCE || (_XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED) && !(_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600) -.TP 4 .fi Before glibc 2.2.2: none .PD --===============4023865121044683655== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Problems with ptx.1: Parenthesized comments in command synopsis. This is impossible to translate to DocBook. --- ptx.1-unpatched 2010-07-22 16:30:37.000000000 -0400 +++ ptx.1 2010-07-22 16:31:32.000000000 -0400 @@ -4,7 +4,7 @@ ptx \- produce a permuted index of file contents .SH SYNOPSIS .B ptx -[\fIOPTION\fR]... [\fIINPUT\fR]... \fI(without -G)\fR +[\fIOPTION\fR]... [\fIINPUT\fR]... .br .B ptx \fI-G \fR[\fIOPTION\fR]... [\fIINPUT \fR[\fIOUTPUT\fR]] --===============4023865121044683655== 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) --- test.1-unpatched 2012-06-30 11:52:03.264340869 -0400 +++ test.1 2012-06-30 11:53:49.460338879 -0400 @@ -7,16 +7,13 @@ \fIEXPRESSION\fR .br .B test - -.br -.B [ -\fIEXPRESSION \fR] -.br -.B [ +[ +--help +] [ +--version +] [ +\fIEXPRESSION ] -.br -.B [ -\fIOPTION\fR .SH DESCRIPTION .\" Add any additional description here .PP --===============4023865121044683655==-- From debbugs-submit-bounces@debbugs.gnu.org Tue Jun 18 10:47:24 2013 Received: (at 14649) by debbugs.gnu.org; 18 Jun 2013 14:47:24 +0000 Received: from localhost ([127.0.0.1]:53222 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1UoxBs-0004Fl-2I for submit@debbugs.gnu.org; Tue, 18 Jun 2013 10:47:24 -0400 Received: from mail2.vodafone.ie ([213.233.128.44]:40744) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1UoxBp-0004FP-OO for 14649@debbugs.gnu.org; Tue, 18 Jun 2013 10:47:22 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AjkDAMFywFFda1ms/2dsb2JhbAANTBaDJL9PAwGBF4MXAQEBAwEyAUYFCwsNCwkWDwkDAgECAUUTAQUCAQGIBBKoM5JBjXljXwcWg0sDmGqFGo4QgXA Received: from unknown (HELO [192.168.1.79]) ([93.107.89.172]) by mail2.vodafone.ie with ESMTP; 18 Jun 2013 15:47:14 +0100 Message-ID: <51C072F1.2020408@draigBrady.com> Date: Tue, 18 Jun 2013 15:47:13 +0100 From: =?ISO-8859-1?Q?P=E1draig_Brady?= User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:17.0) Gecko/20130110 Thunderbird/17.0.2 MIME-Version: 1.0 To: esr@thyrsus.com Subject: Re: bug#14649: Problems in chroot.2, ln.1, ptx.1, test.1, [.1 References: <20130618051403.2DFC6417E1@snark.thyrsus.com> In-Reply-To: <20130618051403.2DFC6417E1@snark.thyrsus.com> X-Enigmail-Version: 1.5.1 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 8bit X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 14649 Cc: 14649@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 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.0 (/) On 06/18/2013 06:14 AM, esr@thyrsus.com wrote: > 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 > > > > Problems with ln.1: > > Parenthesized comments in command synopsis. This is impossible > to translate to DocBook. So is this a limitation of docbook, troff or doclifter? I'm unsure what to do here, but we can't just remove the comments. > Problems with test.1: > > (Identical patches should apply to: [.1) The reason for the non symmetry is documented in the source. thanks, Pádraig. From debbugs-submit-bounces@debbugs.gnu.org Tue Jun 18 12:22:53 2013 Received: (at 14649) by debbugs.gnu.org; 18 Jun 2013 16:22:53 +0000 Received: from localhost ([127.0.0.1]:53415 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1UoygG-0007kn-74 for submit@debbugs.gnu.org; Tue, 18 Jun 2013 12:22:53 -0400 Received: from static-71-162-243-5.phlapa.fios.verizon.net ([71.162.243.5]:39771 helo=snark.thyrsus.com) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1UoygD-0007kc-Sv for 14649@debbugs.gnu.org; Tue, 18 Jun 2013 12:22:50 -0400 Received: by snark.thyrsus.com (Postfix, from userid 1000) id 6BC0D4173B; Tue, 18 Jun 2013 12:22:35 -0400 (EDT) Date: Tue, 18 Jun 2013 12:22:35 -0400 From: "Eric S. Raymond" To: =?iso-8859-1?Q?P=E1draig?= Brady Subject: Re: bug#14649: Problems in chroot.2, ln.1, ptx.1, test.1, [.1 Message-ID: <20130618162235.GC22597@thyrsus.com> References: <20130618051403.2DFC6417E1@snark.thyrsus.com> <51C072F1.2020408@draigBrady.com> MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <51C072F1.2020408@draigBrady.com> Organization: Eric Conspiracy Secret Labs X-Eric-Conspiracy: There is no conspiracy User-Agent: Mutt/1.5.21 (2010-09-15) X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 14649 Cc: 14649@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list Reply-To: esr@thyrsus.com 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.0 (/) Pádraig Brady : > > Parenthesized comments in command synopsis. This is impossible > > to translate to DocBook. > > So is this a limitation of docbook, troff or doclifter? It's a limitation of XML-DocBook. The markup includes a special syntax for synopses with a fixed grammar and terminals. Over 99.7% of manual pages with command synopses fit that grammar; yours is one of the very few exceptions. > I'm unsure what to do here, but we can't just remove the comments. I don't see why not; they're just ordinal numbering and thus convey little or no information. But if you want a rewrite less dependent obn the numbering, here's how I'd do it: With the -T option (1st form above), create a link to TARGET with the name LINK_NAME. With a single file or directory argument (2nd form), create a link to TARGET in the current directory. With the -t option (3rd form) or a final directory argument (4th form), create links to each TARGET in DIRECTORY. Create hard links by default, symbolic links with \fB\-\-symbolic\fR. By default, each destination (name of new link) should not already exist. When creating hard links, each TARGET must exist. Symbolic links can hold arbitrary text; if later resolved, a relative link is interpreted in relation to its parent directory. -- Eric S. Raymond From debbugs-submit-bounces@debbugs.gnu.org Fri Oct 19 13:04:02 2018 Received: (at 14649) by debbugs.gnu.org; 19 Oct 2018 17:04:02 +0000 Received: from localhost ([127.0.0.1]:59737 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gDYBu-0002Ms-3m 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: 14649 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 03:53:10 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