diff options
| author | Tomas R <tomas.roun8@gmail.com> | 2024-04-11 15:16:39 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2024-04-11 15:16:39 (GMT) |
| commit | c06be6bbb8d138dde50c0a07cbd64496bee537c5 (patch) | |
| tree | d3f310645b8f7651b3b63cf3b5f603f4ce328d18 | |
| parent | b8eaad30090b46f115dfed23266305b6546fb364 (diff) | |
| download | cpython-c06be6bbb8d138dde50c0a07cbd64496bee537c5.zip cpython-c06be6bbb8d138dde50c0a07cbd64496bee537c5.tar.gz cpython-c06be6bbb8d138dde50c0a07cbd64496bee537c5.tar.bz2 | |
gh-104269: Document `glob.glob` duplicates when using multiple `**` patterns (#105406)
| -rw-r--r-- | Doc/library/glob.rst | 8 |
1 files changed, 8 insertions, 0 deletions
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 "``**``". |