fix various descriptions of "ctime"

(closes SF patch #870287)

diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex
index 211d194f8530243ebdd92430b43df3201ebc0d4a..a61e97c92856061598d8f305f61fbad92ec0ff8b 100644 (file)
--- a/Doc/lib/libos.tex
+++ b/Doc/lib/libos.tex
@@ -909,7 +909,8 @@ the \ctype{stat} structure, namely:
 \member{st_atime} (time of most recent access),
 \member{st_mtime} (time of most recent content modification),
 \member{st_ctime}
-(time of most recent content modification or metadata change).
+(platform dependent; time of most recent metadata change on \UNIX, or
+the time of creation on Windows).
 
 \versionchanged [If \function{stat_float_times} returns true, the time
 values are floats, measuring seconds. Fractions of a second may be

diff --git a/Doc/lib/libstat.tex b/Doc/lib/libstat.tex
index 74ccc3777be15b41c7bed9f5fa85f5cb09c11f54..d5353f1d1052abd3e51598f3eae79157861d14f4 100644 (file)
--- a/Doc/lib/libstat.tex
+++ b/Doc/lib/libstat.tex
@@ -110,7 +110,10 @@ Time of last modification.
 \end{datadesc}
 
 \begin{datadesc}{ST_CTIME}
-Time of last status change (see manual pages for details).
+The ``ctime'' as reported by the operating system.  On some systems
+(like \UNIX) is the time of the last metadata change, and, on others
+(like Windows), is the creation time (see platform documentation for
+details).
 \end{datadesc}
 
 The interpretation of ``file size'' changes according to the file

diff --git a/Lib/posixpath.py b/Lib/posixpath.py
index 7ee4911d3146bd069f80b7de19dc21f9032442ff..dcd5a638c045bc4e5c5e7b8633ebc2946c6902b6 100644 (file)
--- a/Lib/posixpath.py
+++ b/Lib/posixpath.py
@@ -146,7 +146,7 @@ def getatime(filename):
     return os.stat(filename).st_atime
 
 def getctime(filename):
-    """Return the creation time of a file, reported by os.stat()."""
+    """Return the metadata change time of a file, reported by os.stat()."""
     return os.stat(filename).st_ctime
 
 # Is a path a symbolic link?