From 322c6f2e5cd3d09ed31d9d8dea2310d70f47842a Mon Sep 17 00:00:00 2001 From: Bo Borgerson Date: Thu, 3 Apr 2008 18:42:57 -0400 Subject: 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 --- doc/coreutils.texi | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) (limited to 'doc') 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 -- cgit v1.2.3-70-g09d2