summaryrefslogtreecommitdiffstats
path: root/Doc/lib/libglob.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Doc/lib/libglob.tex')
-rw-r--r--Doc/lib/libglob.tex12
1 files changed, 9 insertions, 3 deletions
diff --git a/Doc/lib/libglob.tex b/Doc/lib/libglob.tex
index 5ef06f3..9efc5aa 100644
--- a/Doc/lib/libglob.tex
+++ b/Doc/lib/libglob.tex
@@ -1,7 +1,7 @@
\section{\module{glob} ---
- \UNIX{} shell style pathname pattern expansion.}
-\declaremodule{standard}{glob}
+ \UNIX{} style pathname pattern expansion}
+\declaremodule{standard}{glob}
\modulesynopsis{\UNIX{} shell style pathname pattern expansion.}
@@ -13,13 +13,14 @@ using the \function{os.listdir()} and \function{fnmatch.fnmatch()}
functions in concert, and not by actually invoking a subshell. (For
tilde and shell variable expansion, use \function{os.path.expanduser()}
and \function{os.path.expandvars()}.)
+\index{filenames!pathname expansion}
\begin{funcdesc}{glob}{pathname}
Returns a possibly-empty list of path names that match \var{pathname},
which must be a string containing a path specification.
\var{pathname} can be either absolute (like
\file{/usr/src/Python-1.5/Makefile}) or relative (like
-\file{../../Tools/*.gif}), and can contain shell-style wildcards.
+\file{../../Tools/*/*.gif}), and can contain shell-style wildcards.
\end{funcdesc}
For example, consider a directory containing only the following files:
@@ -36,3 +37,8 @@ of the path are preserved.
>>> glob.glob('?.gif')
['1.gif']
\end{verbatim}
+
+
+\begin{seealso}
+ \seemodule{fnmatch}{Shell-style filename (not path) expansion}
+\end{seealso}