--- xargs.1.orig 2004-12-02 16:46:20.000000000 +0100 +++ xargs.1 2004-12-02 16:49:51.000000000 +0100 @@ -5,9 +5,9 @@ .B xargs [\-0prtx] [\-e[eof-str]] [\-i[replace-str]] [\-l[max-lines]] [\-n max-args] [\-s max-chars] [\-P max-procs] [\-\-null] [\-\-eof[=eof-str]] -[\-\-replace[=replace-str]] [\-\-max-lines[=max-lines]] [\-\-interactive] -[\-\-max-chars=max-chars] [\-\-verbose] [\-\-exit] [\-\-max-procs=max-procs] -[\-\-max-args=max-args] [\-\-no-run-if-empty] [\-\-arg-file=file] +[\-\-replace[=replace-str]] [\-\-max\-lines[=max-lines]] [\-\-interactive] +[\-\-max\-chars=max-chars] [\-\-verbose] [\-\-exit] [\-\-max\-procs=max-procs] +[\-\-max\-args=max-args] [\-\-no\-run\-if\-empty] [\-\-arg\-file=file] [\-\-version] [\-\-help] [command [initial-arguments]] .SH DESCRIPTION @@ -28,14 +28,14 @@ behaviour is often problematic; filenames containing blanks and/or newlines are incorrectly processed by .BR xargs . -In these situations it is better to use the `-0' option, which +In these situations it is better to use the `\-0' option, which prevents such problems. When using this option you will need to ensure that the program which produces the input for .B xargs also uses a null character as a separator. If that program is GNU .B find -for example, the `-print0' option does this for you. +for example, the `\-print0' option does this for you. .P If any invocation of the command exits with a status of 255, .B xargs @@ -43,7 +43,7 @@ message is issued on stderr when this happens. .SS OPTIONS .TP -.I "\-\-arg-file=file, \-a file" +.I "\-\-arg\-file=file, \-a file" Read items from .I file instead of standard input. If you use this option, stdin remains @@ -80,13 +80,13 @@ defaults to "{}" (like for `find \-exec'). Implies \fI\-x\fP and \fI\-l 1\fP. .TP -.I "\-\-max-lines[=max-lines], -l[max-lines]" +.I "\-\-max\-lines[=max-lines], -l[max-lines]" Use at most \fImax-lines\fR nonblank input lines per command line; \fImax-lines\fR defaults to 1 if omitted. Trailing blanks cause an input line to be logically continued on the next input line. Implies \fI\-x\fR. .TP -.I "\-\-max-args=max-args, \-n max-args" +.I "\-\-max\-args=max-args, \-n max-args" Use at most \fImax-args\fR arguments per command line. Fewer than \fImax-args\fR arguments will be used if the size (see the \-s option) is exceeded, unless the \-x option is given, in which case \fBxargs\fR @@ -97,11 +97,11 @@ from the terminal. Only run the command line if the response starts with `y' or `Y'. Implies \fI\-t\fR. .TP -.I "\-\-no-run-if-empty, \-r" +.I "\-\-no\-run\-if\-empty, \-r" If the standard input does not contain any nonblanks, do not run the command. Normally, the command is run once even if there is no input. .TP -.I "\-\-max-chars=max-chars, \-s max-chars" +.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 the argument strings. The default is 131072 characters, not including @@ -124,14 +124,14 @@ .I "\-\-exit, \-x" Exit if the size (see the \fI\-s\fR option) is exceeded. .TP -.I "\-\-max-procs=max-procs, \-P max-procs" +.I "\-\-max\-procs=max-procs, \-P max-procs" Run up to \fImax-procs\fR processes at a time; the default is 1. If \fImax-procs\fR is 0, \fBxargs\fR will run as many processes as possible at a time. Use the \fI\-n\fR option with \fI\-P\fR; otherwise chances are that only one exec will be done. .SH "EXAMPLES" .nf -.B find /tmp -name core -type f -print | xargs /bin/rm -f +.B find /tmp \-name core \-type f \-print | xargs /bin/rm \-f .fi Find files named @@ -141,7 +141,7 @@ and delete them. Note that this will work incorrectly if there are any filenames containing newlines or spaces. .P -.B find /tmp -name core -type f -print0 | xargs -0 /bin/rm -f +.B find /tmp \-name core \-type f \-print0 | xargs \-0 /bin/rm \-f .fi Find files named @@ -152,7 +152,7 @@ directory names containing spaces or newlines are correctly handled. .P .nf -.B cut -d: -f1 < /etc/passwd | sort | xargs echo +.B cut \-d: \-f1 < /etc/passwd | sort | xargs echo .fi Generates a compact listing of all the users on the system. @@ -191,7 +191,7 @@ to ensure that very long lines do not occur. For example: .P -.B echo * | xargs -s 50000 echo | xargs -i -s 100000 rm '{}' +.B echo * | xargs \-s 50000 echo | xargs \-i \-s 100000 rm '{}' .P Here, the first invocation of .B xargs @@ -211,6 +211,6 @@ The reason for this is that you will then be able to track progress in fixing the problem. Other comments about \fBxargs\fP(1) and about the findutils package in general can be sent to the -.I bug-findutils +.I bug\-findutils mailing list. To join the list, send email to -.IR bug-findutils-request@gnu.org . +.IR bug\-findutils\-request@gnu.org .