From debbugs-submit-bounces@debbugs.gnu.org Sat Jun 30 18:15:04 2012 Received: (at submit) by debbugs.gnu.org; 30 Jun 2012 22:15:04 +0000 Received: from localhost ([127.0.0.1]:39575 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Sl5wV-0004M5-V8 for submit@debbugs.gnu.org; Sat, 30 Jun 2012 18:15:04 -0400 Received: from eggs.gnu.org ([208.118.235.92]:56972) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Sl5wU-0004Lk-3E for submit@debbugs.gnu.org; Sat, 30 Jun 2012 18:15:03 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Sl5sA-0003Ab-UC for submit@debbugs.gnu.org; Sat, 30 Jun 2012 18:10:36 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_HI,T_DKIM_INVALID autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:45710) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Sl5sA-0003AX-Of for submit@debbugs.gnu.org; Sat, 30 Jun 2012 18:10:34 -0400 Received: from eggs.gnu.org ([208.118.235.92]:58750) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Sl5s7-0007wf-PA for bug-coreutils@gnu.org; Sat, 30 Jun 2012 18:10:34 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Sl5s5-00039C-NA for bug-coreutils@gnu.org; Sat, 30 Jun 2012 18:10:31 -0400 Received: from mail-wg0-f49.google.com ([74.125.82.49]:35898) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Sl5s5-00035W-Dj; Sat, 30 Jun 2012 18:10:29 -0400 Received: by wgbds1 with SMTP id ds1so2944682wgb.30 for ; Sat, 30 Jun 2012 15:10:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=message-id:date:from:mime-version:to:subject:content-type :content-transfer-encoding; bh=d5eipEKlVjJrooYmqJ/x86Ras2V7H3EusI3z4snyI3k=; b=I75YEUEgxSBhbF1fPMyWdU1SxfDDJ0agFwO6J4KQ3rfaJjr4T6nlieRzj0nZ+IlfKj F5Mxm0iYJG5UMizEjCG5poghQhEqPI4aRbGmUSLr+yfXCCDOg3vxnEDpAklKwgVqzDeh fZUcdF64AOJ/hkILV2R+AVT9mvcc+pYIuxn2snQE2w6qvrCl//yuTRMBHUmzrvkR543l WHJnwL2JwgWZttK6qu/sdJV3YwQ2w+uhA2+D9V7VayuAHnSWB1sK5sRE/Vb0y3NlNYGU +W/S6svqmMe1zgsu2bsrxzFcAnm1+W+tDP8FgrG2DSEAHnvu/8DHNGyGus4D7vAWcFQ2 9yXQ== Received: by 10.180.81.10 with SMTP id v10mr13577206wix.17.1341094226060; Sat, 30 Jun 2012 15:10:26 -0700 (PDT) Received: from [87.2.92.179] (host179-92-dynamic.2-87-r.retail.telecomitalia.it. [87.2.92.179]) by mx.google.com with ESMTPS id l5sm22726727wix.5.2012.06.30.15.10.24 (version=SSLv3 cipher=OTHER); Sat, 30 Jun 2012 15:10:24 -0700 (PDT) Message-ID: <4FEF7943.2000901@gmail.com> Date: Sun, 01 Jul 2012 00:10:11 +0200 From: Stefano Lattarini MIME-Version: 1.0 To: bug-coreutils@gnu.org, texinfo-devel@gnu.org Subject: Problems building the coreutils info documentation with the development version of makeinfo Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 208.118.235.17 X-Spam-Score: -6.1 (------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.1 (------) Below is the produced diagnostic. Regards, Stefano -*-*-*- coreutils.texi:2207: @itemx must follow @item coreutils.texi:2705: @itemx must follow @item coreutils.texi:2855: @itemx must follow @item coreutils.texi:2863: @itemx must follow @item coreutils.texi:2876: @itemx must follow @item coreutils.texi:2899: @itemx must follow @item coreutils.texi:2912: @itemx must follow @item coreutils.texi:3037: @itemx must follow @item coreutils.texi:3111: @itemx must follow @item coreutils.texi:3133: @itemx must follow @item coreutils.texi:3506: @itemx must follow @item (possibly involving @filesZeroFromOption) coreutils.texi:3687: @itemx must follow @item coreutils.texi:3696: @itemx must follow @item coreutils.texi:3729: @itemx must follow @item coreutils.texi:4132: @itemx must follow @item (possibly involving @filesZeroFromOption) coreutils.texi:6502: @itemx must follow @item coreutils.texi:6871: @itemx must follow @item (possibly involving @optSi) coreutils.texi:7655: @itemx must follow @item coreutils.texi:7785: warning: @itemx should not begin @table coreutils.texi:7787: @itemx must follow @item coreutils.texi:7793: @itemx must follow @item coreutils.texi:7799: @itemx must follow @item coreutils.texi:7823: @itemx must follow @item coreutils.texi:7825: @itemx must follow @item coreutils.texi:7830: @itemx must follow @item coreutils.texi:7846: @itemx must follow @item coreutils.texi:7851: @itemx must follow @item coreutils.texi:7966: @itemx must follow @item (possibly involving @optStripTrailingSlashes) coreutils.texi:8609: @itemx must follow @item coreutils.texi:8759: @itemx must follow @item (possibly involving @optStripTrailingSlashes) coreutils.texi:8830: @itemx must follow @item coreutils.texi:8849: @itemx must follow @item coreutils.texi:8868: @itemx must follow @item coreutils.texi:8876: @itemx must follow @item coreutils.texi:9988: @itemx must follow @item coreutils.texi:10042: @itemx must follow @item coreutils.texi:10049: @itemx must follow @item coreutils.texi:10169: @itemx must follow @item coreutils.texi:10176: @itemx must follow @item coreutils.texi:10291: @itemx must follow @item coreutils.texi:10298: @itemx must follow @item coreutils.texi:10597: @itemx must follow @item coreutils.texi:10671: @itemx must follow @item (possibly involving @optSi) coreutils.texi:10789: @itemx must follow @item coreutils.texi:10841: @itemx must follow @item (possibly involving @filesZeroFromOption) coreutils.texi:10899: @itemx must follow @item (possibly involving @optSi) coreutils.texi:10918: @itemx must follow @item coreutils.texi:10924: @itemx must follow @item coreutils.texi:10934: @itemx must follow @item coreutils.texi:11077: @itemx must follow @item coreutils.texi:12921: @itemx must follow @item coreutils.texi:12928: @itemx must follow @item coreutils.texi:14062: @itemx must follow @item coreutils.texi:14101: @itemx must follow @item coreutils.texi:15307: warning: @itemx should not begin @table coreutils.texi:15314: @itemx must follow @item coreutils.texi:15817: warning: @itemx should not begin @table coreutils.texi:9888: warning: Node next `chown invocation' in menu `touch invocation' and in sectioning `chgrp invocation' differ coreutils.texi:9888: warning: Node `chmod invocation' is prev for `chown invocation' in menu but not in sectioning coreutils.texi:10106: warning: Node `chown invocation' is prev for `chgrp invocation' in sectioning but not in menu coreutils.texi:10229: warning: Node next `chmod invocation' in menu `chown invocation' and in sectioning `touch invocation' differ coreutils.texi:10329: warning: Node prev `touch invocation' in menu `chown invocation' and in sectioning `chmod invocation' differ Makefile:1705: recipe for target 'coreutils.info' failed make[1]: *** [coreutils.info] Error 1 make[1]: Leaving directory '/devel/bleeding/src/coreutils/doc' Makefile:1752: recipe for target 'info-recursive' failed make: *** [info-recursive] Error 1 From debbugs-submit-bounces@debbugs.gnu.org Sat Jun 30 18:43:09 2012 Received: (at 11828) by debbugs.gnu.org; 30 Jun 2012 22:43:09 +0000 Received: from localhost ([127.0.0.1]:39590 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Sl6Nh-00050G-CL for submit@debbugs.gnu.org; Sat, 30 Jun 2012 18:43:09 -0400 Received: from mail-wi0-f174.google.com ([209.85.212.174]:53528) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Sl6Nf-000508-2h for 11828@debbugs.gnu.org; Sat, 30 Jun 2012 18:43:07 -0400 Received: by wibhr14 with SMTP id hr14so1820532wib.15 for <11828@debbugs.gnu.org>; Sat, 30 Jun 2012 15:38:40 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=message-id:date:from:mime-version:to:cc:subject:references :in-reply-to:content-type:content-transfer-encoding; bh=Fc6kJ+/KydT/8LRkXvF4jQ0LN8sMx2MIYrp4pHcTER0=; b=erENo569+/MRBFBeqXfuUbobsmHJvRoI983HIM62gajrUqpgQKne4WMQFsSuHfRlU7 cbYhNk7llMbCShKe+p4pgIlDYltVETTHEUTFPh+sdK/gt3ZqBBZoGwIl+H2fvoYNvatr zT81FLu9KmqCqW+IgbigweH91Taz+qNT1c2Q9YkmrGnvEqf7jH+0pQq5zeyehsbZAEHy rMf+KuVjT/pVLb4jM1jwVPnMG8KU+7LylXvRTanXGBnkKzrVZrE54VqrjQAAsZMB1ona mErSaPPdbZexeU3yxh58BAmY5hcOsTpH+/5clDQxa+5B04SMv2IPH4ki8PasanQtI0mk gOdA== Received: by 10.180.76.135 with SMTP id k7mr7100847wiw.7.1341095920209; Sat, 30 Jun 2012 15:38:40 -0700 (PDT) Received: from [87.2.92.179] (host179-92-dynamic.2-87-r.retail.telecomitalia.it. [87.2.92.179]) by mx.google.com with ESMTPS id db7sm14926125wib.6.2012.06.30.15.38.38 (version=SSLv3 cipher=OTHER); Sat, 30 Jun 2012 15:38:39 -0700 (PDT) Message-ID: <4FEF7FEB.3010304@gmail.com> Date: Sun, 01 Jul 2012 00:38:35 +0200 From: Stefano Lattarini MIME-Version: 1.0 To: Karl Berry Subject: Re: Problems building the coreutils info documentation with the development version of makeinfo References: <201206302229.q5UMTpBx019247@freefriends.org> In-Reply-To: <201206302229.q5UMTpBx019247@freefriends.org> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Spam-Score: -2.6 (--) X-Debbugs-Envelope-To: 11828 Cc: 11828@debbugs.gnu.org, texinfo-devel@gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) On 07/01/2012 12:29 AM, Karl Berry wrote: > Hi Stefano, > > coreutils.texi:2207: @itemx must follow @item > > I imagine the diagnostic is correct. > Sorry if I hasn't been clear, but I meant the CC: to 'texinfo-devel' just as an "FYI" to you, not a bug report (otherwise I'd have written to bug-texinfo ;-). I thought you might be interested in seeing how your improved diagnostic behaves "in the wild". > @itemx must follow @item. > Otherwise the TeX output is wrong. Previous makeinfo unfortunately did > not warn about this. The solution is to fix the manual :). > > coreutils.texi:9888: warning: Node next `chown invocation' in menu `touch invocation' and in sectioning `chgrp invocation' differ > > Would have to see the source. Looks like the menus list the nodes in a > different order than they actually appear, and/or the master menu (can't > remember if coreutils.texi has one) differs from the real menu. > > k > > P.S. I took bug-coreutils out of cc simply because I didn't want to deal > with "opening" a bug report (doesn't it require the bug number somewhere > to append)? > I don't think so; the debbugs software should be smart enough to realize that you're answering to a massage that has already opened a bug report, and it should thus avoid to open a new bug report. I might be wrong on this, though, and I don't feel inclined to experiment right now. > Please forward so it does the right thing, if you like. > Done. Regards, Stefano From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 12 09:10:09 2012 Received: (at 11828) by debbugs.gnu.org; 12 Jul 2012 13:10:10 +0000 Received: from localhost ([127.0.0.1]:35578 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SpJ9k-0002el-HV for submit@debbugs.gnu.org; Thu, 12 Jul 2012 09:10:09 -0400 Received: from mail-wg0-f46.google.com ([74.125.82.46]:62563) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SpJ9g-0002ea-5Q for 11828@debbugs.gnu.org; Thu, 12 Jul 2012 09:10:07 -0400 Received: by wgbdq10 with SMTP id dq10so2060467wgb.15 for <11828@debbugs.gnu.org>; Thu, 12 Jul 2012 06:04:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:date:message-id:x-mailer:in-reply-to:references; bh=Om1K7CSK7SiSmkC7kpCBWV5k0N9VWpF2ilVNoMOChvk=; b=geeM/3YBXFm1f4PmKpddqhd0innE/o75QdkshY3psoH47DlYCMoXQ8fmD5vbyP+0cy qmLzZw/JhlBaFSQP2fPjvcee0kAexciLWyFPQaOvsQrHGIt4uqs8PlfaJk7L0YgmzsM/ L3iolfHqR/DoAL50LV/eQf3QLVEXOrhTU0z85ECz0ymT1IDP6XS6PNwhDUkYobv23EG8 crMy9ptAE5qenABpy9Galbirs9nVSNfMxSQDix/UK8Sz6QlNvsRqWDnqm+ob2CR/KAq8 ZdqQVMGa2iCeg4Da3vJbL/URiKiwvNbaV2jYVV6VAUxE8tBuJII4B/91YZDn9VQ+07el mjYw== Received: by 10.216.199.167 with SMTP id x39mr16883491wen.148.1342098271450; Thu, 12 Jul 2012 06:04:31 -0700 (PDT) Received: from localhost.localdomain (host156-101-dynamic.54-82-r.retail.telecomitalia.it. [82.54.101.156]) by mx.google.com with ESMTPS id y2sm39936945wix.7.2012.07.12.06.04.28 (version=TLSv1/SSLv3 cipher=OTHER); Thu, 12 Jul 2012 06:04:29 -0700 (PDT) From: Stefano Lattarini To: 11828@debbugs.gnu.org Subject: [PATCH] doc: fix errors and warnings with Texinfo 5 Date: Thu, 12 Jul 2012 15:04:19 +0200 Message-Id: <4606283bb60bc65646c2871b2ace967aea4a3ce1.1342098248.git.stefano.lattarini@gmail.com> X-Mailer: git-send-email 1.7.10.2.766.gd284367 In-Reply-To: <4FEF7943.2000901@gmail.com> References: <4FEF7943.2000901@gmail.com> X-Spam-Score: -2.6 (--) X-Debbugs-Envelope-To: 11828 Cc: Stefano Lattarini X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) Or rather, with the development version 4.13.90, which will eventually become Texinfo 5.0. Fixes coreutils bug#11828. * doc/coreutils.texi: Use '@item' instead of '@itemx' in several places, as Texinfo 5 refuses to process an '@itemx' that is not preceded by an '@item'. Ensure that node extended names in menus and sectioning are consistent, and that ordering and presence of nodes in menus and in the actual text are consistent as well. Signed-off-by: Stefano Lattarini --- doc/coreutils.texi | 110 ++++++++++++++++++++++++++--------------------------- 1 file changed, 55 insertions(+), 55 deletions(-) diff --git a/doc/coreutils.texi b/doc/coreutils.texi index 751a920..516ec73 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -40,8 +40,8 @@ * cat: (coreutils)cat invocation. Concatenate and write files. * chcon: (coreutils)chcon invocation. Change SELinux CTX of files. * chgrp: (coreutils)chgrp invocation. Change file groups. -* chmod: (coreutils)chmod invocation. Change file permissions. -* chown: (coreutils)chown invocation. Change file owners/groups. +* chmod: (coreutils)chmod invocation. Change access permissions. +* chown: (coreutils)chown invocation. Change file owners and groups. * chroot: (coreutils)chroot invocation. Specify the root directory. * cksum: (coreutils)cksum invocation. Print POSIX CRC checksum. * comm: (coreutils)comm invocation. Compare sorted files by line. @@ -591,7 +591,7 @@ with embedded newlines. @end macro @macro optSi -@itemx --si +@item --si @opindex --si @cindex SI output Append an SI-style abbreviation to each size, such as @samp{M} for @@ -615,7 +615,7 @@ Use the @option{--si} option if you prefer powers of 1000. @end macro @macro optStripTrailingSlashes -@itemx @w{@kbd{--strip-trailing-slashes}} +@item @w{@kbd{--strip-trailing-slashes}} @opindex --strip-trailing-slashes @cindex stripping trailing slashes Remove any trailing slashes from each @var{source} argument. @@ -2204,7 +2204,7 @@ between sentences to two spaces. Fill output lines up to @var{width} characters (default 75 or @var{goal} plus 10, if @var{goal} is provided). -@itemx -g @var{goal} +@item -g @var{goal} @itemx --goal=@var{goal} @opindex -g @opindex --goal @@ -2702,7 +2702,7 @@ However, if @var{k} starts with a @samp{-}, print all but the last @var{k} bytes of each file. @multiplierSuffixes{k} -@itemx -n @var{k} +@item -n @var{k} @itemx --lines=@var{k} @opindex -n @opindex --lines @@ -2852,7 +2852,7 @@ This option is the same as @option{--follow=name --retry}. That is, tail will attempt to reopen a file when it is removed. Should this fail, tail will keep trying until it becomes accessible again. -@itemx --retry +@item --retry @opindex --retry This option is useful mainly when following by name (i.e., with @option{--follow=name}). @@ -2860,7 +2860,7 @@ Without this option, when tail encounters a file that doesn't exist or is otherwise inaccessible, it reports that fact and never checks it again. -@itemx --sleep-interval=@var{number} +@item --sleep-interval=@var{number} @opindex --sleep-interval Change the number of seconds to wait between iterations (the default is 1.0). During one iteration, every specified file is checked to see if it has @@ -2873,7 +2873,7 @@ is usually ignored. However, if you also specify @option{--pid=@var{p}}, @command{tail} checks whether process @var{p} is alive at least every @var{number} seconds. -@itemx --pid=@var{pid} +@item --pid=@var{pid} @opindex --pid When following by name or by descriptor, you may specify the process ID, @var{pid}, of the sole writer of all @var{file} arguments. Then, shortly @@ -2896,7 +2896,7 @@ terminate until long after the real writer has terminated. Note that @option{--pid} cannot be supported on some systems; @command{tail} will print a warning if this is the case. -@itemx --max-unchanged-stats=@var{n} +@item --max-unchanged-stats=@var{n} @opindex --max-unchanged-stats When tailing a file by name, if there have been @var{n} (default n=@value{DEFAULT_MAX_N_UNCHANGED_STATS_BETWEEN_OPENS}) consecutive @@ -2909,7 +2909,7 @@ and when it prints the lines that have accumulated in the new log file. This option is meaningful only when polling (i.e., without inotify) and when following by name. -@itemx -n @var{k} +@item -n @var{k} @itemx --lines=@var{k} @opindex -n @opindex --lines @@ -3034,7 +3034,7 @@ possible without exceeding @var{size} bytes. Individual lines longer than @var{size} bytes are broken into multiple files. @var{size} has the same format as for the @option{--bytes} option. -@itemx --filter=@var{command} +@item --filter=@var{command} @opindex --filter With this option, rather than simply writing to each output file, write through a pipe to the specified shell @var{command} for each output file. @@ -3108,7 +3108,7 @@ Note specifying a @var{from} value also disables the default auto suffix length expansion described above, and so you may also want to specify @option{-a} to allow suffixes beyond @samp{99}. -@itemx --additional-suffix=@var{suffix} +@item --additional-suffix=@var{suffix} @opindex --additional-suffix Append an additional @var{suffix} to output file names. @var{suffix} must not contain slash. @@ -3130,7 +3130,7 @@ even when this option is specified. Immediately copy input to output in @option{--number r/...} mode, which is a much slower mode of operation. -@itemx --verbose +@item --verbose @opindex --verbose Write a diagnostic just before each output file is opened. @@ -3483,7 +3483,7 @@ Print only the newline counts. Print only the maximum line lengths. @macro filesZeroFromOption{cmd,withTotalOption,subListOutput} -@itemx --files0-from=@var{file} +@item --files0-from=@var{file} @opindex --files0-from=@var{file} @c This is commented out to avoid a texi2dvi failure. @c texi2dvi (GNU Texinfo 4.11) 1.104 @@ -3684,7 +3684,7 @@ an MD5 checksum inconsistent with the associated file, or if no valid line is found, @command{md5sum} exits with nonzero status. Otherwise, it exits successfully. -@itemx --quiet +@item --quiet @opindex --quiet @cindex verifying MD5 checksums This option is useful only when verifying checksums. @@ -3693,7 +3693,7 @@ checked file. Files that fail the verification are reported in the default one-line-per-file format. If there is any checksum mismatch, print a warning summarizing the failures to standard error. -@itemx --status +@item --status @opindex --status @cindex verifying MD5 checksums This option is useful only when verifying checksums. @@ -3726,7 +3726,7 @@ When verifying checksums, warn about improperly formatted MD5 checksum lines. This option is useful only if all but a few lines in the checked input are valid. -@itemx --strict +@item --strict @opindex --strict @cindex verifying MD5 checksums When verifying checksums, @@ -6500,7 +6500,7 @@ command line unless the @option{--dereference-command-line} (@option{-H}), If a command line argument specifies a symbolic link, show information for the file the link references rather than for the link itself. -@itemx --dereference-command-line-symlink-to-dir +@item --dereference-command-line-symlink-to-dir @opindex --dereference-command-line-symlink-to-dir @cindex symbolic links, dereferencing Do not dereference symbolic links, with one exception: @@ -7653,7 +7653,7 @@ Try to preserve SELinux security context and extended attributes (xattr), but ignore any failure to do that and print no corresponding diagnostic. Equivalent to @option{-dR --preserve=all} with the reduced diagnostics. -@itemx --attributes-only +@item --attributes-only @opindex --attributes-only Copy only the specified attributes of the source file to the destination. If the destination already exists, do not alter its contents. @@ -7783,21 +7783,21 @@ If specified, the @var{attribute_list} must be a comma-separated list of one or more of the following strings: @table @samp -@itemx mode +@item mode Preserve the file mode bits and access control lists. -@itemx ownership +@item ownership Preserve the owner and group. On most modern systems, only users with appropriate privileges may change the owner of a file, and ordinary users may preserve the group ownership of a file only if they happen to be a member of the desired group. -@itemx timestamps +@item timestamps Preserve the times of last access and last modification, when possible. On older systems, it is not possible to preserve these attributes when the affected file is a symbolic link. However, many systems now provide the @code{utimensat} function, which makes it possible even for symbolic links. -@itemx links +@item links Preserve in the destination files any links between corresponding source files. Note that with @option{-L} or @option{-H}, this option can convert @@ -7821,14 +7821,14 @@ $ mkdir b c; (cd b; : > a; ln -s a b); cp -aL b c; ls -i1 c/b 74163295 b @end smallexample -@itemx context +@item context Preserve SELinux security context of the file, or fail with full diagnostics. -@itemx xattr +@item xattr Preserve extended attributes of the file, or fail with full diagnostics. If @command{cp} is built without xattr support, ignore this option. If SELinux context, ACLs or Capabilities are implemented using xattrs, they are preserved by this option as well. -@itemx all +@item all Preserve all file attributes. Equivalent to specifying all of the above, but with the difference that failure to preserve SELinux security context or extended attributes @@ -7844,12 +7844,12 @@ mode bits of the corresponding source file, minus the bits set in the umask and minus the set-user-ID and set-group-ID bits. @xref{File permissions}. -@itemx @w{@kbd{--no-preserve}=@var{attribute_list}} +@item @w{@kbd{--no-preserve}=@var{attribute_list}} @cindex file information, preserving Do not preserve the specified attributes. The @var{attribute_list} has the same form as for @option{--preserve}. -@itemx --parents +@item --parents @opindex --parents @cindex parent directories and @command{cp} Form the name of each destination file by appending to the target @@ -8607,7 +8607,7 @@ to when they were last installed. @cindex stripping symbol table information Strip the symbol tables from installed binary executables. -@itemx --strip-program=@var{program} +@item --strip-program=@var{program} @opindex --strip-program @cindex symbol table information, stripping, program Program used to strip binaries. @@ -8828,7 +8828,7 @@ files are named or if a recursive removal is requested. Ignore any previous @option{--force} (@option{-f}) option. Equivalent to @option{--interactive=once}. -@itemx --interactive [=@var{when}] +@item --interactive [=@var{when}] @opindex --interactive Specify when to issue an interactive prompt. @var{when} may be omitted, or one of: @@ -8847,7 +8847,7 @@ removal is requested. Equivalent to @option{-I}. @option{--interactive} with no @var{when} is equivalent to @option{--interactive=always}. -@itemx --one-file-system +@item --one-file-system @opindex --one-file-system @cindex one file system, restricting @command{rm} to When removing a hierarchy recursively, skip any directory that is on a @@ -8866,7 +8866,7 @@ warn about and skip directories on other file systems. Of course, this will not save your @file{/home} if it and your chroot happen to be on the same file system. -@itemx --preserve-root +@item --preserve-root @opindex --preserve-root @cindex root directory, disallow recursive destruction Fail upon any attempt to remove the root directory, @file{/}, @@ -8874,7 +8874,7 @@ when used with the @option{--recursive} option. This is the default behavior. @xref{Treating / specially}. -@itemx --no-preserve-root +@item --no-preserve-root @opindex --no-preserve-root @cindex root directory, allow recursive destruction Do not treat @file{/} specially when removing recursively. @@ -9879,9 +9879,9 @@ timestamps, and other information. Collectively, we call these a file's These commands change file attributes. @menu +* chown invocation:: Change file owners and groups. * chgrp invocation:: Change file groups. * chmod invocation:: Change access permissions. -* chown invocation:: Change file owners and groups. * touch invocation:: Change file timestamps. @end menu @@ -9986,7 +9986,7 @@ actually changes. Do not print error messages about files whose ownership cannot be changed. -@itemx @w{@kbd{--from}=@var{old-owner}} +@item @w{@kbd{--from}=@var{old-owner}} @opindex --from @cindex symbolic links, changing owner Change a @var{file}'s ownership only if it has current attributes specified @@ -10040,14 +10040,14 @@ is a symbolic link. By default, no diagnostic is issued for symbolic links encountered during a recursive traversal, but see @option{--verbose}. -@itemx --preserve-root +@item --preserve-root @opindex --preserve-root @cindex root directory, disallow recursive modification Fail upon any attempt to recursively change the root directory, @file{/}. Without @option{--recursive}, this option has no effect. @xref{Treating / specially}. -@itemx --no-preserve-root +@item --no-preserve-root @opindex --no-preserve-root @cindex root directory, allow recursive modification Cancel the effect of any preceding @option{--preserve-root} option. @@ -10167,14 +10167,14 @@ is a symbolic link. By default, no diagnostic is issued for symbolic links encountered during a recursive traversal, but see @option{--verbose}. -@itemx --preserve-root +@item --preserve-root @opindex --preserve-root @cindex root directory, disallow recursive modification Fail upon any attempt to recursively change the root directory, @file{/}. Without @option{--recursive}, this option has no effect. @xref{Treating / specially}. -@itemx --no-preserve-root +@item --no-preserve-root @opindex --no-preserve-root @cindex root directory, allow recursive modification Cancel the effect of any preceding @option{--preserve-root} option. @@ -10289,14 +10289,14 @@ actually changes. Do not print error messages about files whose permissions cannot be changed. -@itemx --preserve-root +@item --preserve-root @opindex --preserve-root @cindex root directory, disallow recursive modification Fail upon any attempt to recursively change the root directory, @file{/}. Without @option{--recursive}, this option has no effect. @xref{Treating / specially}. -@itemx --no-preserve-root +@item --no-preserve-root @opindex --no-preserve-root @cindex root directory, allow recursive modification Cancel the effect of any preceding @option{--preserve-root} option. @@ -10597,7 +10597,7 @@ pseudo-file-systems, such as automounter entries. Scale sizes by @var{size} before printing them (@pxref{Block size}). For example, @option{-BG} prints sizes in units of 1,073,741,824 bytes. -@itemx --total +@item --total @opindex --total @cindex grand total of disk size, usage and available space Print a grand total of all arguments after all arguments have @@ -10789,7 +10789,7 @@ The program accepts the following options. Also see @ref{Common options}. @opindex --all Show counts for all files, not just directories. -@itemx --apparent-size +@item --apparent-size @opindex --apparent-size Print apparent sizes, rather than disk usage. The apparent size of a file is the number of bytes reported by @code{wc -c} on regular files, @@ -10918,13 +10918,13 @@ With @option{--separate-dirs}, the size reported for a directory name, @var{d}, is merely the @code{stat.st_size}-derived size of the directory entry, @var{d}. -@itemx --time +@item --time @opindex --time @cindex last modified dates, displaying in @command{du} Show time of the most recent modification of any file in the directory, or any of its subdirectories. -@itemx --time=ctime +@item --time=ctime @itemx --time=status @itemx --time=use @opindex --time @@ -10934,7 +10934,7 @@ or any of its subdirectories. Show the most recent status change time (the @samp{ctime} in the inode) of any file in the directory, instead of the modification time. -@itemx --time=atime +@item --time=atime @itemx --time=access @opindex --time @opindex atime@r{, show the most recent} @@ -11077,7 +11077,7 @@ $ stat --format=%d:%i / /usr 2057:2 @end example -@itemx --printf=@var{format} +@item --printf=@var{format} @opindex --printf=@var{format} @cindex output format Use @var{format} rather than the default format. @@ -12921,14 +12921,14 @@ only on the file name, and does not touch any actual file. @opindex --zero Separate output items with @sc{nul} characters. -@itemx --relative-to=@var{file} +@item --relative-to=@var{file} @opindex --relative-to @cindex relpath Print the resolved file names relative to the specified file. Note this option honors the @option{-m} and @option{-e} options pertaining to file existence. -@itemx --relative-base=@var{base} +@item --relative-base=@var{base} @opindex --relative-base This option is valid when used with @option{--relative-to}, and will restrict the output of @option{--relative-to} so that relative names are output, @@ -14062,7 +14062,7 @@ Print a line of column headings. List only the entries that correspond to processes via which the system is waiting for a user to login. The user name is always @samp{LOGIN}. -@itemx --lookup +@item --lookup @opindex --lookup Attempt to canonicalize hostnames found in utmp through a DNS lookup. This is not the default because it can cause significant delays on systems with @@ -14101,7 +14101,7 @@ Ignored; for compatibility with other versions of @command{who}. @opindex --time Print last system clock change. -@itemx -u +@item -u @opindex -u @cindex idle time After the login time, print the number of hours and minutes that the @@ -15342,14 +15342,14 @@ Options must precede operands. @table @samp -@itemx --userspec=@var{user}[:@var{group}] +@item --userspec=@var{user}[:@var{group}] @opindex --userspec By default, @var{command} is run with the same credentials as the invoking process. Use this option to run it as a different @var{user} and/or with a different primary @var{group}. -@itemx --groups=@var{groups} +@item --groups=@var{groups} @opindex --groups Use this option to specify the supplementary @var{groups} to be used by the new process. @@ -15852,7 +15852,7 @@ The program accepts the following options. Also see @ref{Common options}. Options must precede operands. @table @samp -@itemx --foreground +@item --foreground @opindex --foreground Don't create a separate background program group, so that the managed @var{command} can use the foreground TTY normally. -- 1.7.10.2.766.gd284367 From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 12 10:33:54 2012 Received: (at 11828-done) by debbugs.gnu.org; 12 Jul 2012 14:33:54 +0000 Received: from localhost ([127.0.0.1]:36053 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SpKSo-0004aX-KC for submit@debbugs.gnu.org; Thu, 12 Jul 2012 10:33:54 -0400 Received: from mx1.redhat.com ([209.132.183.28]:10393) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SpKSn-0004aP-8T for 11828-done@debbugs.gnu.org; Thu, 12 Jul 2012 10:33:54 -0400 Received: from int-mx12.intmail.prod.int.phx2.redhat.com (int-mx12.intmail.prod.int.phx2.redhat.com [10.5.11.25]) by mx1.redhat.com (8.14.4/8.14.4) with ESMTP id q6CESJEG020260 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 12 Jul 2012 10:28:20 -0400 Received: from [10.36.116.67] (ovpn-116-67.ams2.redhat.com [10.36.116.67]) by int-mx12.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id q6CESH9D003989 (version=TLSv1/SSLv3 cipher=DHE-RSA-CAMELLIA256-SHA bits=256 verify=NO); Thu, 12 Jul 2012 10:28:19 -0400 Message-ID: <4FFEDF01.5070704@draigBrady.com> Date: Thu, 12 Jul 2012 15:28:17 +0100 From: =?ISO-8859-1?Q?P=E1draig_Brady?= User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:6.0) Gecko/20110816 Thunderbird/6.0 MIME-Version: 1.0 To: Stefano Lattarini Subject: Re: bug#11828: [PATCH] doc: fix errors and warnings with Texinfo 5 References: <4FEF7943.2000901@gmail.com> <4606283bb60bc65646c2871b2ace967aea4a3ce1.1342098248.git.stefano.lattarini@gmail.com> In-Reply-To: <4606283bb60bc65646c2871b2ace967aea4a3ce1.1342098248.git.stefano.lattarini@gmail.com> X-Enigmail-Version: 1.3.2 Content-Type: text/plain; charset=ISO-8859-1 X-Scanned-By: MIMEDefang 2.68 on 10.5.11.25 Content-Transfer-Encoding: quoted-printable X-MIME-Autoconverted: from 8bit to quoted-printable by mx1.redhat.com id q6CESJEG020260 X-Spam-Score: -6.9 (------) X-Debbugs-Envelope-To: 11828-done Cc: 11828-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) On 07/12/2012 02:04 PM, Stefano Lattarini wrote: > Or rather, with the development version 4.13.90, which will eventually > become Texinfo 5.0. >=20 > Fixes coreutils bug#11828. >=20 > * doc/coreutils.texi: Use '@item' instead of '@itemx' in several places= , > as Texinfo 5 refuses to process an '@itemx' that is not preceded by an > '@item'. Ensure that node extended names in menus and sectioning are > consistent, and that ordering and presence of nodes in menus and in the > actual text are consistent as well. >=20 > Signed-off-by: Stefano Lattarini Pushed. thanks, P=E1draig. From unknown Mon Aug 18 18:00:19 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Fri, 10 Aug 2012 11:24:03 +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