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

diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index bd6b3abdcec0c296ef4878c47662713c107326b9..ee378a6b15774478049c9c147b22b034e58c2e87 100644 (file)
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -1813,8 +1813,8 @@ features:
    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