From afcef976ee8a63d95d57ab45a41fbcec454a3813 Mon Sep 17 00:00:00 2001 From: jay Date: Sun, 8 Aug 2004 11:23:43 +0000 Subject: [PATCH] Applied documentation improvements suggested by Dan Jacobson . --- xargs/xargs.1 | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/xargs/xargs.1 b/xargs/xargs.1 index e6d3338..6ce74a5 100644 --- a/xargs/xargs.1 +++ b/xargs/xargs.1 @@ -14,13 +14,13 @@ This manual page documents the GNU version of .BR xargs . .B xargs -reads arguments from the standard input, delimited by blanks (which can be +reads items from the standard input, delimited by blanks (which can be protected with double or single quotes or a backslash) or newlines, and executes the .I command (default is /bin/echo) one or more times with any .I initial-arguments -followed by arguments read from standard input. Blank lines on the +followed by items read from standard input. Blank lines on the standard input are ignored. .P Because Unix filenames can contain blanks and newlines, this default @@ -43,10 +43,10 @@ message is issued on stderr when this happens. .SS OPTIONS .TP .I "\-\-null, \-0" -Input filenames are terminated by a null character instead of by +Input items are terminated by a null character instead of by whitespace, and the quotes and backslash are not special (every character is taken literally). Disables the end of file string, which -is treated like any other argument. Useful when arguments might +is treated like any other argument. Useful when input items might contain white space, quote marks, or backslashes. The GNU find \-print0 option produces input suitable for this mode. .TP @@ -62,9 +62,9 @@ Print a summary of the options to and exit. .TP .I "\-\-replace[=replace-str], \-i[replace-str]" -Replace occurences of \fIreplace-str\fR in the initial arguments with +Replace occurences of \fIreplace-str\fR in the initial-arguments with names read from standard input. -Also, unquoted blanks do not terminate arguments. +Also, unquoted blanks do not terminate input items. If \fIreplace-str\fR is omitted, it defaults to "{}" (like for `find \-exec'). Implies \fI\-x\fP and \fI\-l 1\fP. @@ -92,7 +92,7 @@ command. Normally, the command is run once even if there is no input. .TP .I "\-\-max-chars=max-chars, \-s max-chars" Use at most \fImax-chars\fR characters per command line, including the -command and initial arguments and the terminating nulls at the ends of +command and initial-arguments and the terminating nulls at the ends of the argument strings. The default is 20480 characters, not including the size of the environment variables (which are provided for separately so that it doesn't matter if your environment variables -- 2.11.4.GIT