[Patches] [ python-Patches-870287 ] Fix docstring for posixpath.getctime

[SourceForge.net]

Patches item #870287, was opened at 2004-01-04 10:22
Message generated for change (Comment added) made by gerrit
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=305470&aid=870287&group_id=5470

Category: Documentation
Group: Python 2.3
Status: Open
Resolution: None
Priority: 5
Submitted By: Gerrit Holl (gerrit)
Assigned to: Nobody/Anonymous (nobody)
Summary: Fix docstring for posixpath.getctime

Initial Comment:
(not sure whether this is "Library" or "Documentation")

The docstring of posixpath.getctime calls ctime the
"creation time". This is incorrect, because it is the
"change time". The library documentation is correct
here. This patch fixes the docstring.

----------------------------------------------------------------------

>Comment By: Gerrit Holl (gerrit)
Date: 2004-01-17 15:55

Message:
Logged In: YES 
user_id=13298

The docstring is a different issue: The standard library
needs to be accurate for all platforms, whereas each
platform has it's own implementation of os.path.getctime.
Hence, it's possible to give each platform it's own
docstring for os.path.getctime, so that
posixpath.getctime.__doc__ != ntpath.getctime.__doc__. Is
this it a good thing to have different docstrings? If so,
I'd say that each platform documents for it's own getctime
what ctime means. If not, I'd say we copy the standard
library documentation.


----------------------------------------------------------------------

Comment By: George Yoshida (quiver)
Date: 2004-01-12 05:11

Message:
Logged In: YES 
user_id=671362

> IIRC, it is creation time on some platforms and is the
> change time on others.

This was discussed before.

[ 827902 ] ctime is not creation time
http://www.python.org/sf/827902



----------------------------------------------------------------------

Comment By: Raymond Hettinger (rhettinger)
Date: 2004-01-12 00:32

Message:
Logged In: YES 
user_id=80475

IIRC, it is creation time on some platforms and is the
change time on others.

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=305470&aid=870287&group_id=5470