From: Jim Meyering <jim@meyering.net>
Date: Sat, 20 Dec 2003 11:28:14 +0000 (+0000)
Subject: (du invocation): Describe new option: -0, --null.
X-Git-Tag: v5.1.0~27
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=340b33464a84570e8daff15a7f3816e89e24a296;p=thirdparty%2Fcoreutils.git

(du invocation): Describe new option: -0, --null.
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index d60b62d060..5c14e6cdc3 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -8447,6 +8447,15 @@ Show the total for each directory (and file if --all) that is at
 most MAX_DEPTH levels down from the root of the hierarchy.  The root
 is at level 0, so @code{du --max-depth=0} is equivalent to @code{du -s}.
 
+@item -0
+@opindex -0
+@itemx --null
+@opindex --null
+@cindex output NUL-terminated lines
+Output the zero byte (@kbd{NUL}) at the end of each line, rather than a newline.
+This option enables other programs to parse the output of @command{du}
+even when that output would contain file names with embedded newlines.
+
 @item -s
 @itemx --summarize
 @opindex -s