mirror/coreutils
1
0
Fork 0
mirror of https://https.git.savannah.gnu.org/git/coreutils.git synced 2026-01-27 01:44:21 +00:00
Code Issues Packages Projects Releases Wiki Activity

doc: clarify the pr --page-width descriptions

Browse Source 
* doc/coreutils.texi (pr invocation): Clarify that -w or -W
will be rounded down so that each column has the same width.
Adjust the wording for -W, to avoid the implication that the
width of -S is insignificant to the page width.
* src/pr.c (usage): Add a period to avoid ambiguity in
the man page output.
This commit is contained in:
Pádraig Brady 2014-04-29 16:31:22 +01:00
parent f940fece04
commit 59eacf2764
2 changed files with 11 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
doc/coreutils.texi
View File

@ -2878,8 +2878,10 @@ Print nonprinting characters in octal backslash notation.
@opindex -w
@opindex --width
Set page width to @var{page_width} characters for multiple text-column
output only (default for @var{page_width} is 72). @option{-s[CHAR]} turns
off the default page width and any line truncation and column alignment.
output only (default for @var{page_width} is 72). The specified
@var{page_width} is rounded down so that columns have equal width.
@option{-s[CHAR]} turns off the default page width and any line truncation
and column alignment.
Lines of full length are merged, regardless of the column options
set. No @var{page_width} setting is possible with single column output.
A POSIX-compliant formulation.
@ -2888,12 +2890,13 @@ A POSIX-compliant formulation.
@itemx --page_width=@var{page_width}
@opindex -W
@opindex --page_width
Set the page width to @var{page_width} characters. That's valid with and
without a column option. Text lines are truncated, unless @option{-J}
is used. Together with one of the three column options
Set the page width to @var{page_width} characters, honored with and
without a column option. With a column option, the specified @var{page_width}
is rounded down so that columns have equal width. Text lines are truncated,
unless @option{-J} is used. Together with one of the three column options
(@option{-@var{column}}, @option{-a -@var{column}} or @option{-m}) column
alignment is always used. The separator options @option{-S} or @option{-s}
don't affect the @option{-W} option. Default is 72 characters. Without
don't disable the @option{-W} option. Default is 72 characters. Without
@option{-W @var{page_width}} and without any of the column options NO line
truncation is used (defined to keep downward compatibility and to meet
most frequent tasks). That's equivalent to @option{-W 72 -J}@. The header

3
src/pr.c
View File

@ -2820,7 +2820,8 @@ Paginate or columnate FILE(s) for printing.\n\
fputs (_("\
-s[CHAR], --separator[=CHAR]\n\
separate columns by a single character, default for CHAR\n\
is the <TAB> character without -w and \'no char\' with -w\n\
is the <TAB> character without -w and \'no char\' with -w.\
\n\
-s[CHAR] turns off line truncation of all 3 column\n\
options (-COLUMN|-a -COLUMN|-m) except -w is set\n\
"), stdout);