summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorPedro J. Ruiz Lopez <holzplatten@es.gnu.org>2008-10-23 20:08:44 +0200
committerJim Meyering <meyering@redhat.com>2009-07-04 18:47:49 +0200
commit2da7dc21e77a43d43696abc86700dda9259cf091 (patch)
tree713e78df15ea92839eb48107b02710127c1786be /doc
parentba3da6fe033c38ffdac4fe9b60b617f26a687aaf (diff)
downloadidutils-2da7dc21e77a43d43696abc86700dda9259cf091.tar.gz
idutils-2da7dc21e77a43d43696abc86700dda9259cf091.tar.bz2
idutils-2da7dc21e77a43d43696abc86700dda9259cf091.zip
mkid, xtokid: accept a new option --files0-from=FILE
* bootstrap.conf (gnulib_modules): Add quote and readtokens0. * doc/idutils.texi: Document the option. * src/mkid.c (usage, FILES0_FROM_OPTION, long_options, help_me) (main): Implement. * src/xtokid.c (usage, FILES0_FROM_OPTION, long_options, help_me) (main): Likewise.
Diffstat (limited to 'doc')
-rw-r--r--doc/idutils.texi13
1 files changed, 12 insertions, 1 deletions
diff --git a/doc/idutils.texi b/doc/idutils.texi
index 6ff139f..ab9040e 100644
--- a/doc/idutils.texi
+++ b/doc/idutils.texi
@@ -313,7 +313,18 @@ One or more file or directory names may appear in @var{names}. The file
tree walker will stop short at these files and directories and their
contents will not be scanned.
-@end table
+@itemx --files0-from=@var{FILE}
+@opindex --files0-from=@var{FILE}
+Rather than processing files named on the command line, process those
+named in file @var{FILE}; each name is terminated by a null byte.
+This is useful when the list of file names is so long that it may
+exceed a command line length limitation.
+One way to produce a list of null-byte-terminated file names is with
+@sc{gnu} @command{find}, using its @option{-print0} predicate. Do not
+specify any @var{FILE} on the command line when using this option.
+
+
+ @end table
@c ************* gkm *********************************************************
@node File listing options