From 1cd6e4dc38c7f7de3b39d93cb503ee2058662bcd Mon Sep 17 00:00:00 2001 From: Fred Drake Date: Wed, 12 May 2004 03:51:40 +0000 Subject: [PATCH] fix various descriptions of "ctime" (closes SF patch #870287) --- Doc/lib/libos.tex | 3 ++- Doc/lib/libstat.tex | 5 ++++- Lib/posixpath.py | 2 +- 3 files changed, 7 insertions(+), 3 deletions(-) diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex index 211d194f85..a61e97c928 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 74ccc3777b..d5353f1d10 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 7ee4911d31..dcd5a638c0 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? -- 2.50.1