Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

Issue #25615: Document unsorted behaviour of glob; patch by Dave Jones

This commit is contained in:
Martin Panter 2015-11-16 23:46:22 +00:00
parent a4afc4876b
commit 9f3c094e68
1 changed files with 7 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
Doc/library/glob.rst
View File

@ -12,13 +12,13 @@
-------------- --------------
The :mod:`glob` module finds all the pathnames matching a specified pattern The :mod:`glob` module finds all the pathnames matching a specified pattern
according to the rules used by the Unix shell. No tilde expansion is done, but according to the rules used by the Unix shell, although results are returned in
``*``, ``?``, and character ranges expressed with ``[]`` will be correctly arbitrary order. No tilde expansion is done, but ``*``, ``?``, and character
matched. This is done by using the :func:`os.listdir` and ranges expressed with ``[]`` will be correctly matched. This is done by using
:func:`fnmatch.fnmatch` functions in concert, and not by actually invoking a the :func:`os.listdir` and :func:`fnmatch.fnmatch` functions in concert, and
subshell. Note that unlike :func:`fnmatch.fnmatch`, :mod:`glob` treats not by actually invoking a subshell. Note that unlike :func:`fnmatch.fnmatch`,
filenames beginning with a dot (``.``) as special cases. (For tilde and shell :mod:`glob` treats filenames beginning with a dot (``.``) as special cases.
variable expansion, use :func:`os.path.expanduser` and (For tilde and shell variable expansion, use :func:`os.path.expanduser` and
:func:`os.path.expandvars`.) :func:`os.path.expandvars`.)
For a literal match, wrap the meta-characters in brackets. For a literal match, wrap the meta-characters in brackets.