[issue29688] Document Path.absolute

2017-03-11 Thread Brett Cannon
Brett Cannon added the comment: I know it has it's uses (avoiding stat calls is one of them), but it is still undocumented, untested, and has two comments in it saying it needs work. Because of all that it might as well not exist since it doesn't meet our standards of quality. If someone want

[issue29688] Document Path.absolute

2017-03-10 Thread Eryk Sun
Eryk Sun added the comment: resolve() can't replace absolute(). They serve different purposes. Sometimes one wants an absolute path, but without resolving symbolic links. absolute() processes a path as a string, which will continue to be true if it's updated to call nt._getfullpathname (GetFu

[issue29688] Document Path.absolute

2017-03-10 Thread Brett Cannon
Brett Cannon added the comment: I'm still thinking about this but I'm still leaning towards deprecating pathlib.absolute(). -- ___ Python tracker ___ ___

[issue29688] Document Path.absolute

2017-03-03 Thread Serhiy Storchaka
Changes by Serhiy Storchaka : -- nosy: +pitrou ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.pyt

[issue29688] Document Path.absolute

2017-03-03 Thread Brett Cannon
Brett Cannon added the comment: I've closed the PR on GitHub until we decide whether we just want to deprecate Path.absolute() in favour of Path.resolve(). -- ___ Python tracker ___

[issue29688] Document Path.absolute

2017-03-03 Thread Brett Cannon
Brett Cannon added the comment: As brought up on the PR, it turns out Path.absolute() is extremely under-tested. Perhaps we should deprecate Path.absolute() instead of document it and properly test it (and the testing will be necessary to move forward with the documentation)? Path.resolve() ha

[issue29688] Document Path.absolute

2017-03-02 Thread Brett Cannon
Changes by Brett Cannon : -- assignee: docs@python -> brett.cannon nosy: +brett.cannon ___ Python tracker ___ ___ Python-bugs-list mai

[issue29688] Document Path.absolute

2017-03-01 Thread Jim Fasarakis-Hilliard
Changes by Jim Fasarakis-Hilliard : -- pull_requests: +321 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http

[issue29688] Document Path.absolute

2017-03-01 Thread Jim Fasarakis-Hilliard
New submission from Jim Fasarakis-Hilliard: Method absolute of Path objects lacked documentation, proposed PR adds relevant method to docs. -- assignee: docs@python components: Documentation messages: 288767 nosy: Jim Fasarakis-Hilliard, docs@python priority: normal severity: normal sta