From: Jim Meyering <jim@meyering.net>
Date: Wed, 24 Mar 2004 17:38:17 +0000 (+0000)
Subject: (Block size): Document new envvar BLOCKSIZE.
X-Git-Tag: v5.3.0~1942
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=98e876d78349f2a18c5a6420dc3215483b3ed42f;p=thirdparty%2Fcoreutils.git

(Block size): Document new envvar BLOCKSIZE.
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 83815275c3..d4cb3ad73e 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -751,6 +751,7 @@ used for display is independent of any filesystem block size.
 Fractional block counts are rounded up to the nearest integer.
 
 @opindex --block-size=@var{size}
+@vindex BLOCKSIZE
 @vindex BLOCK_SIZE
 @vindex DF_BLOCK_SIZE
 @vindex DU_BLOCK_SIZE
@@ -771,9 +772,18 @@ Similarly, @env{DU_BLOCK_SIZE} specifies the default for @command{du} and
 This specifies the default block size for all three commands, if the
 above command-specific environment variables are not set.
 
+@item BLOCKSIZE
+This specifies the default block size for all values that are normally
+printed as blocks, if neither @env{BLOCK_SIZE} nor the above
+command-specific environment variables are set.  Unlike the other
+environment variables, @env{BLOCKSIZE} does not affect values that are
+normally printed as byte counts, e.g., the file sizes contained in
+@code{ls -l} output.
+
 @item POSIXLY_CORRECT
-If neither the @env{@var{command}_BLOCK_SIZE} nor the @env{BLOCK_SIZE}
-variables are set, but this variable is set, the block size defaults to 512.
+If neither @env{@var{command}_BLOCK_SIZE}, nor @env{BLOCK_SIZE}, nor
+@env{BLOCKSIZE} is set, but this variable is set, the block size
+defaults to 512.
 
 @end table