doc: improve description about when xargs stops processing

* 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.

1 files changed, 7 insertions, 5 deletions

diff --git a/doc/find.texi b/doc/find.texi
index e2e746a6..c634fa72 100644
--- a/doc/find.texi
+++ b/doc/find.texi
@@ -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::