This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author eric.araujo
Recipients eric.araujo
Date 2017-11-07.19:05:43
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1510081543.19.0.213398074469.issue31972@psf.upfronthosting.co.za>
In-reply-to
Content
pydoc pathlib.Path shows the docstring of PurePath:

 |  PurePath represents a filesystem path and offers operations which
 |  don't imply any actual filesystem I/O.

But immediately after we see methods like chmod, exists and co which obviously aren’t pure.  Looking at the reST docs or the source code, the reader can deduce that this is the docstring of PurePath inherited by Path, but I find it confusing.

Solution: adding docstrings to all pathlib classes.  PurePath and Path can have all the info, Posix/Windows* subclasses only one line with a reference.
History
Date User Action Args
2017-11-07 19:05:43eric.araujosetrecipients: + eric.araujo
2017-11-07 19:05:43eric.araujosetmessageid: <1510081543.19.0.213398074469.issue31972@psf.upfronthosting.co.za>
2017-11-07 19:05:43eric.araujolinkissue31972 messages
2017-11-07 19:05:43eric.araujocreate