doc: clarify the operation of ls -k

* src/ls.c (usage): Mention -k only changes the display
for disk usage (directory total, and ls -s), and imply
that it can be overridden (by --block-size, and -h).
* doc/coreutils.texi (block size): Mention that ls -k
handling is different to other utilities.
Addresses http://bugs.gnu.org/14525

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 64713dc4a8962319b42a8d5816727cfda4efd7e5..67feb125ac3b64741c6d28b7772a084f570ef630 100644 (file)
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -1012,7 +1012,9 @@ option is equivalent to @option{--block-size=1K}, which
 is the default unless the @env{POSIXLY_CORRECT} environment variable is
 set.  The @option{-h} or @option{--human-readable} option is equivalent to
 @option{--block-size=human-readable}.  The @option{--si} option is
-equivalent to @option{--block-size=si}.
+equivalent to @option{--block-size=si}.  Note for @command{ls}
+the @option{-k} option does not control the display of the
+apparent file sizes, whereas the @option{--block-size} option does.
 
 @node Floating point
 @section Floating point numbers

diff --git a/src/ls.c b/src/ls.c
index 512d65e2dd0f998726b6ecb610088f25b5ba112d..e7d1d9315e5f858abe6e44bebe3c138784d346ff 100644 (file)
--- a/src/ls.c
+++ b/src/ls.c
@@ -4816,7 +4816,7 @@ Sort entries alphabetically if none of -cftuvSUX nor --sort is specified.\n\
   -i, --inode                print the index number of each file\n\
   -I, --ignore=PATTERN       do not list implied entries matching shell PATTERN\
 \n\
-  -k, --kibibytes            use 1024-byte blocks\n\
+  -k, --kibibytes            default to 1024-byte blocks for disk usage\n\
 "), stdout);
       fputs (_("\
   -l                         use a long listing format\n\