From: Steve Dower <steve.dower@microsoft.com>
Date: Tue, 29 May 2018 02:27:11 +0000 (-0700)
Subject: bpo-32878: Adds documentation for st_ino on Windows (GH-5764) (GH-7190)
X-Git-Tag: v3.6.6rc1~85
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=325320d5f5a4480a6f4f92dcf86b9dbb7eb5c791;p=python

bpo-32878: Adds documentation for st_ino on Windows (GH-5764) (GH-7190)
---

diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index b3179acac0..e9ee51416b 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -2263,7 +2263,13 @@ features:
 
    .. attribute:: st_ino
 
-      Inode number.
+      Platform dependent, but if non-zero, uniquely identifies the
+      file for a given value of ``st_dev``. Typically:
+
+      * the inode number on Unix,
+      * the `file index
+        <https://msdn.microsoft.com/en-us/library/aa363788>`_ on
+        Windows
 
    .. attribute:: st_dev
 
@@ -2416,6 +2422,10 @@ features:
    .. versionadded:: 3.5
       Added the :attr:`st_file_attributes` member on Windows.
 
+   .. versionchanged:: 3.5
+      Windows now returns the file index as :attr:`st_ino` when
+      available.
+
 
 .. function:: stat_float_times([newvalue])