[issue39808] pathlib: reword docs for stat()
New submission from swgmma <jason.nader@protonmail.com>: The docs for stat() (https://docs.python.org/3.9/library/pathlib.html#pathlib.Path.stat) state:
Return information about this path (similarly to os.stat()). The result is looked up at each call to this method."
Nit picks: 1) It states "similarly to os.stat()" which implies there may be differences between the two, when in fact they both return the same `os.stat_result` object. 2) It should mention that `stat()` returns a `os.stat_result` object without having to go digging into the docs for `os` to find out. ---------- assignee: docs@python components: Documentation messages: 363052 nosy: docs@python, swgmma priority: normal severity: normal status: open title: pathlib: reword docs for stat() versions: Python 3.5, Python 3.6, Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue39808> _______________________________________
Change by swgmma <jason.nader@protonmail.com>: ---------- keywords: +patch pull_requests: +18076 stage: -> patch review pull_request: https://github.com/python/cpython/pull/18719 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue39808> _______________________________________
Brett Cannon <brett@python.org> added the comment: New changeset 67152d0ed670227b61b5df683655b196ab04ca1a by Brett Cannon in branch 'master': bpo-39808: Improve docs for pathlib.Path.stat() (GH-18719) https://github.com/python/cpython/commit/67152d0ed670227b61b5df683655b196ab0... ---------- nosy: +brett.cannon _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue39808> _______________________________________
Brett Cannon <brett@python.org> added the comment: Thanks! ---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue39808> _______________________________________
Change by miss-islington <mariatta.wijaya+miss-islington@gmail.com>: ---------- nosy: +miss-islington nosy_count: 3.0 -> 4.0 pull_requests: +18141 pull_request: https://github.com/python/cpython/pull/18782 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue39808> _______________________________________
Change by miss-islington <mariatta.wijaya+miss-islington@gmail.com>: ---------- pull_requests: +18142 pull_request: https://github.com/python/cpython/pull/18783 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue39808> _______________________________________
miss-islington <mariatta.wijaya+miss-islington@gmail.com> added the comment: New changeset 6bb67452d4f21e2d948dafce7644b1d66e5efcb8 by Miss Islington (bot) in branch '3.7': [3.7] bpo-39808: Improve docs for pathlib.Path.stat() (GH-18719) (GH-18782) https://github.com/python/cpython/commit/6bb67452d4f21e2d948dafce7644b1d66e5... ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue39808> _______________________________________
Brett Cannon <brett@python.org> added the comment: Thanks, swgmma! ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue39808> _______________________________________
miss-islington <mariatta.wijaya+miss-islington@gmail.com> added the comment: New changeset 7b39c474e4ce7057a9e16b06d40261ff563b1e9d by Miss Islington (bot) in branch '3.8': [3.8] bpo-39808: Improve docs for pathlib.Path.stat() (GH-18719) (GH-18783) https://github.com/python/cpython/commit/7b39c474e4ce7057a9e16b06d40261ff563... ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue39808> _______________________________________
Ned Deily <nad@python.org> added the comment: New changeset c157edb73b234409263ca0d7b6b41ad5f0b455d6 by Ned Deily (Miss Islington (bot)) in branch '3.7': [3.7] bpo-39808: Improve docs for pathlib.Path.stat() (GH-18719) (GH-18782) https://github.com/python/cpython/commit/c157edb73b234409263ca0d7b6b41ad5f0b... ---------- nosy: +ned.deily _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue39808> _______________________________________
participants (4)
-
Brett Cannon -
miss-islington
-
Ned Deily
-
swgmma