summaryrefslogtreecommitdiff
path: root/doc/find.texi
diff options
context:
space:
mode:
authorBernhard Voelker <mail@bernhard-voelker.de>2021-11-24 01:57:35 +0100
committerBernhard Voelker <mail@bernhard-voelker.de>2021-11-27 23:21:06 +0100
commit4ddb092de66a4186a097de5ab8390b2e7d167efb (patch)
treeac6d9db247cfbd63386d9f7b6f0209a042e5e0fa /doc/find.texi
parentf16272db43c9d811c1b946ec8262651d43619573 (diff)
downloadfindutils-4ddb092de66a4186a097de5ab8390b2e7d167efb.tar.gz
find: allow -files0-from input file to be empty
Do no longer output an error diagnostic when the input file of the -files0-from option is empty. * find/ftsfind.c (process_all_startpoints): Remove error diagnostic. * doc/find.texi (node Starting points): Adjust documentation. * find/find.1: Likewise. * tests/find/files0-from.sh: Adjust test. Suggested by Stephane Chazelas in https://savannah.gnu.org/bugs/?60383#comment11
Diffstat (limited to 'doc/find.texi')
-rw-r--r--doc/find.texi8
1 files changed, 6 insertions, 2 deletions
diff --git a/doc/find.texi b/doc/find.texi
index 69572b78..8a12898e 100644
--- a/doc/find.texi
+++ b/doc/find.texi
@@ -410,8 +410,12 @@ The starting points in @file{file} have to be separated by ASCII NUL characters.
Two consecutive NUL characters, i.e., a starting point with a Zero-length
file name is not allowed and will lead to an error diagnostic followed by
a non-Zero exit code later.
-The given @file{file} has to contain at least one starting point,
-i.e., an empty input file will be diagnosed as well.
+
+In the case the given @file{file} is empty, @code{find} does not process any
+starting point and therefore will exit immediately after parsing the program
+arguments.
+This is unlike the standard invocation where @code{find} assumes the current
+directory as starting point if no path argument is passed.
The processing of the starting points is otherwise as usual, e.g. @code{find}
will recurse into subdirectories unless otherwise prevented.