From: Pádraig Brady <P@draigBrady.com>
Date: Wed, 12 Jun 2013 10:40:25 +0000 (+0100)
Subject: doc: clarify the description of du --separate-dirs
X-Git-Tag: v8.22~128
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=63eea601d80ceb4d58afe7ef09690e40571e6d70;p=thirdparty%2Fcoreutils.git

doc: clarify the description of du --separate-dirs

* src/du.c (usage): Clarify that --separate-dirs doesn't exclude
all directories.
* doc/coreutils.texi (du invocation): Avoid implying that -S
excludes the size of any non directory entries for a directory.
Also don't mention st_size as it's dependent on --apparent-size.
Reported by C de-Avillez in <https://launchpad.net/bugs/1187044>
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index d607eaf3d6..a325bd058e 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -11436,8 +11436,7 @@ Normally, in the output of @command{du} (when not using @option{--summarize}),
 the size listed next to a directory name, @var{d}, represents the sum
 of sizes of all entries beneath @var{d} as well as the size of @var{d} itself.
 With @option{--separate-dirs}, the size reported for a directory name,
-@var{d}, is merely the @code{stat.st_size}-derived size of the directory
-entry, @var{d}.
+@var{d}, will exclude the size of any subdirectories.
 
 @optSi
 
diff --git a/src/du.c b/src/du.c
index a80a17701a..1aa5a16756 100644
--- a/src/du.c
+++ b/src/du.c
@@ -315,7 +315,7 @@ Summarize disk usage of each FILE, recursively for directories.\n\
 "), stdout);
       fputs (_("\
   -P, --no-dereference  don't follow any symbolic links (this is the default)\n\
-  -S, --separate-dirs   do not include size of subdirectories\n\
+  -S, --separate-dirs   for directories do not include size of subdirectories\n\
       --si              like -h, but use powers of 1000 not 1024\n\
   -s, --summarize       display only a total for each argument\n\
 "), stdout);