summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2022-05-02 15:33:39 (GMT)
committerGitHub <noreply@github.com>2022-05-02 15:33:39 (GMT)
commit9b7cdfdf357fa819fd47f0ebe1c0e2010a5d4e31 (patch)
treec85f60eec7a34e900733606091d81ded1bbf0fb7 /Doc
parent0c011cc6c2a7629b8120ec26d7776713c096e69c (diff)
downloadcpython-9b7cdfdf357fa819fd47f0ebe1c0e2010a5d4e31.zip
cpython-9b7cdfdf357fa819fd47f0ebe1c0e2010a5d4e31.tar.gz
cpython-9b7cdfdf357fa819fd47f0ebe1c0e2010a5d4e31.tar.bz2
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@users.noreply.github.com>
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/glob.rst7
1 files changed, 5 insertions, 2 deletions
diff --git a/Doc/library/glob.rst b/Doc/library/glob.rst
index 3c468eb..ced84c7 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`.)