fix various descriptions of "ctime"

(closes SF patch #870287)

diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex
index b93ce77bee56954acf2ae42ed77d0f5b12d38f0c..eed9f98edba80aca0791d697cd840048ff65f648 100644 (file)
--- a/Doc/lib/libos.tex
+++ b/Doc/lib/libos.tex
@@ -892,7 +892,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 58e8eedcec97834807a1ea73dfff8ca496b833ff..1d225ae7d3cdae3c412618ed2c256dd9c082c824 100644 (file)
--- a/Lib/posixpath.py
+++ b/Lib/posixpath.py
@@ -150,7 +150,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?