From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Sun, 11 Jan 2026 19:42:10 +0000 (+0100)
Subject: [3.14] gh-142972: Document arbitrary ordering in `Path.glob` and `Path.rglob` (GH... 
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=bfc57f70acf7b9c32b0f75e77f5181212bf0af61;p=thirdparty%2FPython%2Fcpython.git

[3.14] gh-142972: Document arbitrary ordering in `Path.glob` and `Path.rglob` (GH-143025) (GH-143709)

gh-142972: Document arbitrary ordering in `Path.glob` and `Path.rglob` (GH-143025)
(cherry picked from commit 9d13ca97c1a83ed649a16fb0512b5f1c5f9ad108)

Co-authored-by: Bartosz Sławecki <bartosz@ilikepython.com>
---

diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
index 8d16009bc809..b8876c4ca14f 100644
--- a/Doc/library/pathlib.rst
+++ b/Doc/library/pathlib.rst
@@ -1345,6 +1345,10 @@ Reading directories
        PosixPath('setup.py'),
        PosixPath('test_pathlib.py')]
 
+   .. note::
+      The paths are returned in no particular order.
+      If you need a specific order, sort the results.
+
    .. seealso::
       :ref:`pathlib-pattern-language` documentation.
 
@@ -1379,6 +1383,10 @@ Reading directories
    Glob the given relative *pattern* recursively.  This is like calling
    :func:`Path.glob` with "``**/``" added in front of the *pattern*.
 
+   .. note::
+      The paths are returned in no particular order.
+      If you need a specific order, sort the results.
+
    .. seealso::
       :ref:`pathlib-pattern-language` and :meth:`Path.glob` documentation.