https://github.com/python/cpython/commit/c06be6bbb8d138dde50c0a07cbd64496bee537c5
commit: c06be6bbb8d138dde50c0a07cbd64496bee537c5
branch: main
author: Tomas R <[email protected]>
committer: barneygale <[email protected]>
date: 2024-04-11T15:16:39Z
summary:
gh-104269: Document `glob.glob` duplicates when using multiple `**` patterns
(#105406)
files:
M Doc/library/glob.rst
diff --git a/Doc/library/glob.rst b/Doc/library/glob.rst
index 15fef747296ed4..ab6da98bc74ad2 100644
--- a/Doc/library/glob.rst
+++ b/Doc/library/glob.rst
@@ -75,6 +75,10 @@ The :mod:`glob` module defines the following functions:
Using the "``**``" pattern in large directory trees may consume
an inordinate amount of time.
+ .. note::
+ This function may return duplicate path names if *pathname*
+ contains multiple "``**``" patterns and *recursive* is true.
+
.. versionchanged:: 3.5
Support for recursive globs using "``**``".
@@ -94,6 +98,10 @@ The :mod:`glob` module defines the following functions:
.. audit-event:: glob.glob pathname,recursive glob.iglob
.. audit-event:: glob.glob/2 pathname,recursive,root_dir,dir_fd glob.iglob
+ .. note::
+ This function may return duplicate path names if *pathname*
+ contains multiple "``**``" patterns and *recursive* is true.
+
.. versionchanged:: 3.5
Support for recursive globs using "``**``".
_______________________________________________
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]
