Andreas Schwab <sch...@suse.de> wrote:
> Jim Meyering <j...@meyering.net> 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 <meyer...@redhat.com>
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
-...@var{number-separator tab}. The tabification depends upon the output
+...@var{number-separator} TAB. The tabification depends upon the output
position.
@item -N @var{line_number}
--
1.6.1.rc2.306.ge5d5e
_______________________________________________
Bug-coreutils mailing list
Bug-coreutils@gnu.org
http://lists.gnu.org/mailman/listinfo/bug-coreutils
