bug-coreutils
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: du --files-from feature request


From: Jim Meyering
Subject: Re: du --files-from feature request
Date: Sat, 13 Dec 2008 08:34:01 +0100

Andreas Schwab <address@hidden> wrote:
> Jim Meyering <address@hidden> writes:
>> @@ -2424,11 +2424,11 @@ pr invocation
>>  Optional argument @var{number-separator} is the character appended to
>>  the line number to separate it from the text followed.  The default
>>  separator is the TAB character.  In a strict sense a TAB is always
>> -printed with single column output only.  The @var{TAB}-width varies
>> -with the @var{TAB}-position, e.g., with the left @var{margin} specified
>> +printed with single column output only.  The @var{tab}-width varies
>> +with the @var{tab}-position, e.g., with the left @var{margin} specified
>>  by @option{-o} option.  With multicolumn output priority is given to
>>  @samp{equal width of output columns} (a @acronym{POSIX} specification).
>> -The @var{TAB}-width is fixed to the value of the first column and does
>> +The @var{tab}-width is fixed to the value of the first column and does
>>  not change with different values of left @var{margin}.  That means a
>>  fixed number of spaces is always printed in the place of the
>>  @var{number-separator tab}.  The tabification depends upon the output
>
> IMHO, the @var annotation should be dropped (or changed to @sc), since
> TAB is not a variable in this context.  Also, @var{number-separator tab}
> is not a proper use of @var.

Good points.  Thank you.
I've done this:

>From 82f108f567265ef4181e94fdd33d0e86dd6d239f Mon Sep 17 00:00:00 2001
From: Jim Meyering <address@hidden>
Date: Sat, 13 Dec 2008 08:32:55 +0100
Subject: [PATCH] doc: pr: formatting corrections

* doc/coreutils.texi (pr invocation): Fix some overzealous uses of @var.
Reported by Andreas Schwab.
---
 doc/coreutils.texi |    8 ++++----
 1 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 983a694..49aa16d 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -2424,14 +2424,14 @@ pr invocation
 Optional argument @var{number-separator} is the character appended to
 the line number to separate it from the text followed.  The default
 separator is the TAB character.  In a strict sense a TAB is always
-printed with single column output only.  The @var{tab}-width varies
-with the @var{tab}-position, e.g., with the left @var{margin} specified
+printed with single column output only.  The TAB width varies
+with the TAB position, e.g., with the left @var{margin} specified
 by @option{-o} option.  With multicolumn output priority is given to
 @samp{equal width of output columns} (a @acronym{POSIX} specification).
-The @var{tab}-width is fixed to the value of the first column and does
+The TAB width is fixed to the value of the first column and does
 not change with different values of left @var{margin}.  That means a
 fixed number of spaces is always printed in the place of the
address@hidden tab}.  The tabification depends upon the output
address@hidden TAB.  The tabification depends upon the output
 position.

 @item -N @var{line_number}
--
1.6.1.rc2.306.ge5d5e




reply via email to

[Prev in Thread] Current Thread [Next in Thread]