mirror/findutils
1
0
Fork 0
mirror of https://https.git.savannah.gnu.org/git/findutils.git synced 2026-01-27 01:44:23 +00:00
Code Issues Packages Projects Releases Wiki Activity

doc: improve description about when xargs stops processing

Browse Source 
* doc/find.texi (Multiple Files): Clarify better that xargs will stop when
reading the EOF marker string specified with the --eof option, or when a
launched command exists with status 255.  Switch the two termination
conditions to reflect the behavior.

Fixes RT #1912852.
This commit is contained in:
Bernhard Voelker 2023-02-13 20:22:58 +01:00
parent 4a72809272
commit da65ab1e69
1 changed files with 7 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
doc/find.texi
View File

@ -2478,11 +2478,13 @@ However, if the command needs to have its standard input be a terminal
substitution method or use either the @samp{--arg-file} option or the
@samp{--open-tty} option of @code{xargs}.
The @code{xargs} command will process all its input, building command
lines and executing them, unless one of the commands exits with a
status of 255 (this will cause xargs to issue an error message and
stop) or it reads a line contains the end of file string specified
with the @samp{--eof} option.
The @code{xargs} command will usually process all of its input,
building command lines and executing them.
The processing stops earlier and immediately if the tool reads a line containing
the end-of-file marker string specified with the @samp{--eof} option,
or if one of the launched commands exits with a status of 255.
The latter will cause @code{xargs} to issue an error message and exit with
status 124.
@menu
* Unsafe File Name Handling::