mirror of https://github.com/python/cpython
Issue #25615: Document unsorted behaviour of glob; patch by Dave Jones
This commit is contained in:
parent
a4afc4876b
commit
9f3c094e68
|
@ -12,13 +12,13 @@
|
|||
--------------
|
||||
|
||||
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
|
||||
``*``, ``?``, and character ranges expressed with ``[]`` will be correctly
|
||||
matched. This is done by using the :func:`os.listdir` 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. (For tilde and shell
|
||||
variable expansion, use :func:`os.path.expanduser` and
|
||||
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.listdir` 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.
|
||||
(For tilde and shell variable expansion, use :func:`os.path.expanduser` and
|
||||
:func:`os.path.expandvars`.)
|
||||
|
||||
For a literal match, wrap the meta-characters in brackets.
|
||||
|
|
Loading…
Reference in New Issue