From c06be6bbb8d138dde50c0a07cbd64496bee537c5 Mon Sep 17 00:00:00 2001 From: Tomas R Date: Thu, 11 Apr 2024 17:16:39 +0200 Subject: gh-104269: Document `glob.glob` duplicates when using multiple `**` patterns (#105406) --- Doc/library/glob.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/Doc/library/glob.rst b/Doc/library/glob.rst index 15fef74..ab6da98 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 "``**``". -- cgit v0.12