[Python-checkins] gh-88546: glob.glob docs: Make new paragraph for emphasis and reordered sentence (GH-91614)

miss-islington webhook-mailer at python.org
Mon May 2 11:34:01 EDT 2022


https://github.com/python/cpython/commit/9b7cdfdf357fa819fd47f0ebe1c0e2010a5d4e31
commit: 9b7cdfdf357fa819fd47f0ebe1c0e2010a5d4e31
branch: 3.9
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: miss-islington <31488909+miss-islington at users.noreply.github.com>
date: 2022-05-02T08:33:39-07:00
summary:

gh-88546: glob.glob docs: Make new paragraph for emphasis and reordered sentence (GH-91614)

(cherry picked from commit b9ab6cea0819bd498063f0934cb5bb0bb5a6a2d4)

Co-authored-by: slateny <46876382+slateny at users.noreply.github.com>

files:
M Doc/library/glob.rst

diff --git a/Doc/library/glob.rst b/Doc/library/glob.rst
index 3c468ebf73769..ced84c7fd8d11 100644
--- a/Doc/library/glob.rst
+++ b/Doc/library/glob.rst
@@ -23,8 +23,11 @@ according to the rules used by the Unix shell, although results are returned in
 arbitrary order.  No tilde expansion is done, but ``*``, ``?``, and character
 ranges expressed with ``[]`` will be correctly matched.  This is done by using
 the :func:`os.scandir` and :func:`fnmatch.fnmatch` functions in concert, and
-not by actually invoking a subshell.  Note that unlike :func:`fnmatch.fnmatch`,
-:mod:`glob` treats filenames beginning with a dot (``.``) as special cases.
+not by actually invoking a subshell.
+
+Note that files beginning with a dot (``.``) can only be matched by
+patterns that also start with a dot,
+unlike :func:`fnmatch.fnmatch` or :func:`pathlib.Path.glob`.
 (For tilde and shell variable expansion, use :func:`os.path.expanduser` and
 :func:`os.path.expandvars`.)
 



More information about the Python-checkins mailing list