Closes #12350: clarify blocks/block size members of stat result.

diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index d4912ce9c34a0881a864d22956a6e719c6f82803..64d7874ef0a501cc8f5d296a4bae4c43ed706e8a 100644 (file)
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -1386,8 +1386,8 @@ Files and Directories
    On some Unix systems (such as Linux), the following attributes may also be
    available:
 
-   * :attr:`st_blocks` - number of blocks allocated for file
-   * :attr:`st_blksize` - filesystem blocksize
+   * :attr:`st_blocks` - number of 512-byte blocks allocated for file
+   * :attr:`st_blksize` - filesystem blocksize for efficient file system I/O
    * :attr:`st_rdev` - type of device if an inode device
    * :attr:`st_flags` - user defined flags for file