From: Nikita Sobolev <mail@sobolevn.me>
Date: Wed, 9 Nov 2022 22:05:07 +0000 (+0300)
Subject: gh-98832: Change wording in docstring of `pathlib.Path.iterdir` (GH-98833)
X-Git-Tag: v3.12.0a2~60
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=87f5180cd79617223ac513e9f45933f774134e32;p=thirdparty%2FPython%2Fcpython.git

gh-98832: Change wording in docstring of `pathlib.Path.iterdir` (GH-98833)



Found while working on https://github.com/python/cpython/issues/98829

Automerge-Triggered-By: GH:AlexWaygood
---

diff --git a/Lib/pathlib.py b/Lib/pathlib.py
index db1c7c9618ef..068d1b02f484 100644
--- a/Lib/pathlib.py
+++ b/Lib/pathlib.py
@@ -867,8 +867,10 @@ class Path(PurePath):
         return os.path.samestat(st, other_st)
 
     def iterdir(self):
-        """Iterate over the files in this directory.  Does not yield any
-        result for the special paths '.' and '..'.
+        """Yield path objects of the directory contents.
+
+        The children are yielded in arbitrary order, and the
+        special entries '.' and '..' are not included.
         """
         for name in os.listdir(self):
             yield self._make_child_relpath(name)
diff --git a/Misc/NEWS.d/next/Documentation/2022-10-29-02-33-46.gh-issue-98832.DudEIH.rst b/Misc/NEWS.d/next/Documentation/2022-10-29-02-33-46.gh-issue-98832.DudEIH.rst
new file mode 100644
index 000000000000..c4a456650251
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2022-10-29-02-33-46.gh-issue-98832.DudEIH.rst
@@ -0,0 +1 @@
+Changes wording of docstring for :func:`pathlib.Path.iterdir`.