[Python-checkins] cpython (2.7): #16420: document a way to escape metacharacters in glob/fnmatch.

Sat Nov 17 16:39:24 CET 2012

http://hg.python.org/cpython/rev/333fe4c4897a
changeset: 80469:333fe4c4897a
branch: 2.7
parent: 80463:770bbc93ae89
user: Ezio Melotti <ezio.melotti at gmail.com>
date: Sat Nov 17 17:38:11 2012 +0200
summary:
 #16420: document a way to escape metacharacters in glob/fnmatch.
files:
 Doc/library/fnmatch.rst | 5 +++--
 Doc/library/glob.rst | 3 +++
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/Doc/library/fnmatch.rst b/Doc/library/fnmatch.rst
--- a/Doc/library/fnmatch.rst
+++ b/Doc/library/fnmatch.rst
@@ -29,6 +29,9 @@
 | ``[!seq]`` | matches any character not in *seq* |
 +------------+------------------------------------+
 
+For a literal match, wrap the meta-characters in brackets.
+For example, ``'[?]'`` matches the character ``'?'``.
+
 .. index:: module: glob
 
 Note that the filename separator (``'/'`` on Unix) is *not* special to this
@@ -76,8 +79,6 @@
 
 Return the shell-style *pattern* converted to a regular expression.
 
- Be aware there is no way to quote meta-characters.
-
 Example:
 
 >>> import fnmatch, re
diff --git a/Doc/library/glob.rst b/Doc/library/glob.rst
--- a/Doc/library/glob.rst
+++ b/Doc/library/glob.rst
@@ -19,6 +19,9 @@
 subshell. (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.
+For example, ``'[?]'`` matches the character ``'?'``.
+
 
 .. function:: glob(pathname)
 
-- 
Repository URL: http://hg.python.org/cpython
