fix various descriptions of "ctime"

(closes SF patch #870287)

3 files changed, 7 insertions, 3 deletions

diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex
index 211d194..a61e97c 100644
--- 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 74ccc37..d5353f1 100644
--- 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 7ee4911..dcd5a63 100644
--- 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?