diff options
author | Bo Borgerson <gigabo@gmail.com> | 2008-04-03 18:42:57 -0400 |
---|---|---|
committer | Jim Meyering <meyering@redhat.com> | 2008-06-17 08:50:41 +0200 |
commit | 322c6f2e5cd3d09ed31d9d8dea2310d70f47842a (patch) | |
tree | d3c17172c9c56923607451c1e37d7a331b8bfbea /doc/coreutils.texi | |
parent | 3435bb7f4021e7f05fbe317ebec34851effce27c (diff) | |
download | coreutils-322c6f2e5cd3d09ed31d9d8dea2310d70f47842a.tar.xz |
sort: add new option --files0-from=F
* src/sort.c: Support new option.
* tests/misc/sort-files0-from: Test new option.
* tests/misc/Makefile.am: Indicate new test.
* docs/coreutils.texi: Explain new option.
* NEWS: Advertise new option.
Signed-off-by: Bo Borgerson <gigabo@gmail.com>
Diffstat (limited to 'doc/coreutils.texi')
-rw-r--r-- | doc/coreutils.texi | 10 |
1 files changed, 6 insertions, 4 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi index 6be37d805..e4a979e61 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -3172,7 +3172,7 @@ Print only the newline counts. @opindex --max-line-length Print only the maximum line lengths. -@macro filesZeroFromOption{cmd,withTotalOption} +@macro filesZeroFromOption{cmd,withTotalOption,subListOutput} @itemx --files0-from=@var{FILE} @opindex --files0-from=@var{FILE} @c This is commented out to avoid a texi2dvi failure. @@ -3184,13 +3184,13 @@ This is useful \withTotalOption\ when the list of file names is so long that it may exceed a command line length limitation. In such cases, running @command{\cmd\} via @command{xargs} is undesirable -because it splits the list into pieces and makes @command{\cmd\} print a -total for each sublist rather than for the entire list. +because it splits the list into pieces and makes @command{\cmd\} print +\subListOutput\ for each sublist rather than for the entire list. One way to produce a list of null-byte-terminated file names is with @sc{gnu} @command{find}, using its @option{-print0} predicate. Do not specify any @var{FILE} on the command line when using this option. @end macro -@filesZeroFromOption{wc,} +@filesZeroFromOption{wc,,a total} For example, to find the length of the longest line in any @file{.c} or @file{.h} file in the current hierarchy, do this: @@ -3779,6 +3779,8 @@ Terminate with an error if @var{prog} exits with nonzero status. White space and the backslash character should not appear in @var{prog}; they are reserved for future use. +@filesZeroFromOption{sort,,sorted output} + @item -k @var{pos1}[,@var{pos2}] @itemx --key=@var{pos1}[,@var{pos2}] @opindex -k |