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 d607eaf3d65e9e6498624dd6a002c76be059c225..a325bd058ee80a5c2794de3e9d07dc7a80a5ab1d 100644 (file)
--- 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 a80a17701ad0429d425df0d932afc8f1d9650a1a..1aa5a1675621ea67c6d585a16ebeded3b8ffc7ea 100644 (file)
--- 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);