https://github.com/python/cpython/commit/18eeec4beae1b16b5000efe1281e3f8fa55ecc95
commit: 18eeec4beae1b16b5000efe1281e3f8fa55ecc95
branch: 3.13
author: Miss Islington (bot) <[email protected]>
committer: ZeroIntensity <[email protected]>
date: 2026-01-11T19:42:44Z
summary:

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

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

Co-authored-by: Bartosz SÅ‚awecki <[email protected]>

files:
M Doc/library/pathlib.rst

diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
index 59a72a95559742..cfb9971cec8c3d 100644
--- a/Doc/library/pathlib.rst
+++ b/Doc/library/pathlib.rst
@@ -1287,6 +1287,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.
 
@@ -1321,6 +1325,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.
 

_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]

Reply via email to