doc: clarify that truncate --size represents bytes by default

* src/truncate.c (usage): Mention that --size is in bytes which
is by far the most common usage.
* doc/coreutils.texi (truncate invocation): Likewise. Also cross
reference the --io-blocks option.
Reported in http://bugs.gnu.org/14686

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index a325bd058ee80a5c2794de3e9d07dc7a80a5ab1d..ae1081b1acefdb5d2cf3ea3d212480e8d1ac0425 100644 (file)
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -11849,6 +11849,7 @@ Base the size of each @var{file} on the size of @var{rfile}.
 @opindex -s
 @opindex --size
 Set or adjust the size of each @var{file} according to @var{size}.
+@var{size} is in bytes unless @option{--io-blocks} is specified.
 @multiplierSuffixesNoBlocks{size}
 
 @var{size} may also be prefixed by one of the following to adjust

diff --git a/src/truncate.c b/src/truncate.c
index 8349cb61ac3188b21bdc03840bc110baf3a70575..d48c346e8ec4d9763654f18b2bae84908eff26b1 100644 (file)
--- a/src/truncate.c
+++ b/src/truncate.c
@@ -114,7 +114,7 @@ reads as zero bytes.\n\
 "), stdout);
       fputs (_("\
   -r, --reference=RFILE  base size on RFILE\n\
-  -s, --size=SIZE        set or adjust the file size by SIZE\n"), stdout);
+  -s, --size=SIZE        set or adjust the file size by SIZE bytes\n"), stdout);
       fputs (HELP_OPTION_DESCRIPTION, stdout);
       fputs (VERSION_OPTION_DESCRIPTION, stdout);
       emit_size_note ();