From: Tomas R <tomas.roun8@gmail.com>
Date: Thu, 11 Apr 2024 15:16:39 +0000 (+0200)
Subject: gh-104269: Document `glob.glob` duplicates when using multiple `**` patterns (#105406)
X-Git-Tag: v3.13.0b1~477
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=c06be6bbb8d138dde50c0a07cbd64496bee537c5;p=thirdparty%2FPython%2Fcpython.git

gh-104269: Document `glob.glob` duplicates when using multiple `**` patterns (#105406)
---

diff --git a/Doc/library/glob.rst b/Doc/library/glob.rst
index 15fef747296e..ab6da98bc74a 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 "``**``".