stat: clarify the description of the %o stat format

* src/stat.c (usage):  Indicate this is a transfer size
suggestion, rather than some persistent block size.
* doc/coreutils.texi (stat invocation): Likewise.

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 685de20..2ada962 100644 (file)
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -11031,7 +11031,7 @@ The valid @var{format} directives for files with @option{--format} and
 @item %m - Mount point (See note below)
 @item %n - File name
 @item %N - Quoted file name with dereference if symbolic link
-@item %o - I/O block size
+@item %o - Optimal I/O transfer size hint
 @item %s - Total size, in bytes
 @item %t - Major device type in hex
 @item %T - Minor device type in hex

diff --git a/src/stat.c b/src/stat.c
index 9ae2d5a..b2e1030 100644 (file)
--- a/src/stat.c
+++ b/src/stat.c
@@ -1362,7 +1362,7 @@ The valid format sequences for files (without --file-system):\n\
   %m   mount point\n\
   %n   file name\n\
   %N   quoted file name with dereference if symbolic link\n\
-  %o   I/O block size\n\
+  %o   optimal I/O transfer size hint\n\
   %s   total size, in bytes\n\
   %t   major device type in hex\n\
   %T   minor device type in hex\n\