On 2005-08-28 Andreas Metzler <[EMAIL PROTECTED]> wrote:
> On 2005-08-28 Eric Blake <[EMAIL PROTECTED]> wrote:
> > The documentation for xargs could use several improvements. The Invoking
> > `xargs' section of the info pages do not mention -E or -L, and implies
> > that -I's argument is optional when it is not.
> Hello,
> Oh joy. I should have read POSIX more diligently before submitting the
> patch for the documentation. I'll try to provide an update.
[...]
There you go.
cu andreas
--
"See, I told you they'd listen to Reason," [SPOILER] Svfurlr fnlf,
fuhggvat qbja gur juveyvat tha.
Neal Stephenson in "Snow Crash"
Index: doc/find.texi
===================================================================
RCS file: /cvsroot/findutils/findutils/doc/find.texi,v
retrieving revision 1.106
diff -u -r1.106 find.texi
--- doc/find.texi 29 Jul 2005 22:04:07 -0000 1.106
+++ doc/find.texi 28 Aug 2005 08:06:42 -0000
@@ -2055,19 +2055,20 @@
@table @code
@item [EMAIL PROTECTED]@[EMAIL PROTECTED]
[EMAIL PROTECTED] [EMAIL PROTECTED]@[EMAIL PROTECTED]
[EMAIL PROTECTED] -I @var{replace-str}
@itemx [EMAIL PROTECTED]@[EMAIL PROTECTED]
Replace occurrences of @var{replace-str} in the initial arguments with
names read from the input. Also, unquoted blanks do not
terminate arguments; instead, the input is split at newlines only. If
[EMAIL PROTECTED] is omitted, it defaults to @[EMAIL PROTECTED]@}} (like for
[EMAIL PROTECTED] is omitted for @samp{--replace} or @samp{-i}, it defaults
+to @[EMAIL PROTECTED]@}} (like for
@samp{find -exec}). Implies @samp{-x} and @samp{-l 1}. @samp{-i} is
depreceated in favour of @samp{-I}. As an
example, to sort each file in the @file{bills} directory, leaving the
output in that file name with @file{.sorted} appended, you could do:
@example
-find bills -type f | xargs -IXX sort -o XX.sorted XX
+find bills -type f | xargs -I XX sort -o XX.sorted XX
@end example
@noindent
@@ -2827,12 +2828,13 @@
Print a summary of the options to @code{xargs} and exit.
@item [EMAIL PROTECTED]@[EMAIL PROTECTED]
[EMAIL PROTECTED] [EMAIL PROTECTED]@[EMAIL PROTECTED]
[EMAIL PROTECTED] -I @var{replace-str}
@itemx [EMAIL PROTECTED]@[EMAIL PROTECTED]
Replace occurrences of @var{replace-str} in the initial arguments with
names read from standard input. Also, unquoted blanks do not
terminate arguments; instead, the input is split at newlines only.
-If @var{replace-str} is omitted, it defaults to @[EMAIL PROTECTED]@}}
+If @var{replace-str} is omitted for @samp{--replace} or @samp{-i}, it
+defaults to @[EMAIL PROTECTED]@}}
(like for @samp{find -exec}). Implies @samp{-x} and @samp{-l 1}. @samp{-i} is
depreceated in favour of @samp{-I}.
Index: xargs/xargs.1
===================================================================
RCS file: /cvsroot/findutils/findutils/xargs/xargs.1,v
retrieving revision 1.19
diff -u -r1.19 xargs.1
--- xargs/xargs.1 10 Jul 2005 01:51:21 -0000 1.19
+++ xargs/xargs.1 28 Aug 2005 08:06:45 -0000
@@ -4,7 +4,7 @@
.SH SYNOPSIS
.B xargs
[\-0prtx] [\-E[eof-str]] [\-e[eof-str]] [\-\-eof[=eof-str]] [\-\-null]
-[\-I[replace-str]] [\-i[replace-str]] [\-\-replace[=replace-str]]
+[\-I replace-str] [\-i[replace-str]] [\-\-replace[=replace-str]]
[\-l[max-lines]] [\-L[max-lines]] [\-\-max\-lines[=max-lines]] [\-n max-args]
[\-\-max\-args=max-args]
[\-s max-chars] [\-\-max\-chars=max-chars] [\-P max-procs]
[\-\-max\-procs=max-procs]
[\-\-interactive] [\-\-verbose] [\-\-exit]
@@ -75,12 +75,12 @@
.B xargs
and exit.
.TP
-.I "\-\-replace[=replace-str], \-I[replace-str], \-i[replace-str]"
+.I "\-\-replace[=replace-str], \-I replace-str, \-i[replace-str]"
Replace occurrences of \fIreplace-str\fR in the initial-arguments with
names read from standard input.
Also, unquoted blanks do not terminate input items; instead the
separator is the newline character.
-If \fIreplace-str\fR is omitted, it
+If \fIreplace-str\fR is omitted for \-\-replace or \-i , it
defaults to "{}" (like for `find \-exec'). Implies \fI\-x\fP and
\fI\-l 1\fP.
\-i is depreceated in favour of \-I.
_______________________________________________
Bug-findutils mailing list
[email protected]
http://lists.gnu.org/mailman/listinfo/bug-findutils
