fix various descriptions of "ctime"
(closes SF patch #870287)
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 @@
\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 @@
\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 @@
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?