https://github.com/python/cpython/commit/84fb531fc2323cf3196366c3d0fbc0f43df99045 commit: 84fb531fc2323cf3196366c3d0fbc0f43df99045 branch: 3.12 author: Miss Islington (bot) <[email protected]> committer: barneygale <[email protected]> date: 2024-04-11T18:44:46+01:00 summary:
[3.12] gh-104269: Document `glob.glob` duplicates when using multiple `**` patterns (GH-105406) (#117757) gh-104269: Document `glob.glob` duplicates when using multiple `**` patterns (GH-105406) (cherry picked from commit c06be6bbb8d138dde50c0a07cbd64496bee537c5) Co-authored-by: Tomas R <[email protected]> files: M Doc/library/glob.rst diff --git a/Doc/library/glob.rst b/Doc/library/glob.rst index 0e4cfe7ebed797..293c2c4fed62fd 100644 --- a/Doc/library/glob.rst +++ b/Doc/library/glob.rst @@ -77,6 +77,10 @@ For example, ``'[?]'`` matches the character ``'?'``. 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 "``**``". @@ -96,6 +100,10 @@ For example, ``'[?]'`` matches the character ``'?'``. .. 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]
