summaryrefslogtreecommitdiffstats
path: root/Doc/lib/libcfgparser.tex
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>1999-01-26 21:49:05 (GMT)
committerFred Drake <fdrake@acm.org>1999-01-26 21:49:05 (GMT)
commitebe2a12de8d036ebc254c5743be3c6e6529cf2d5 (patch)
tree31f73fafab59306089a5e785b41ededbbbf6621c /Doc/lib/libcfgparser.tex
parente6506e753bd3c1fc5c32271d30db46fb41f8486f (diff)
downloadcpython-ebe2a12de8d036ebc254c5743be3c6e6529cf2d5.zip
cpython-ebe2a12de8d036ebc254c5743be3c6e6529cf2d5.tar.gz
cpython-ebe2a12de8d036ebc254c5743be3c6e6529cf2d5.tar.bz2
Incorporate changes for patched version of ConfigParser.
Diffstat (limited to 'Doc/lib/libcfgparser.tex')
-rw-r--r--Doc/lib/libcfgparser.tex13
1 files changed, 8 insertions, 5 deletions
diff --git a/Doc/lib/libcfgparser.tex b/Doc/lib/libcfgparser.tex
index 7f09581..f3678ce 100644
--- a/Doc/lib/libcfgparser.tex
+++ b/Doc/lib/libcfgparser.tex
@@ -17,7 +17,7 @@ The configuration file consists of sections, lead by a
with continuations in the style of \rfc{959}. The optional values
can contain format strings which refer to other values in the same
section, or values in a special \code{DEFAULT} section. Additional
-defaults can provided upon instantiation of the class.
+defaults can be provided upon initialization and retrieval.
For example:
@@ -29,7 +29,9 @@ would resolve the \samp{\%(dir)s} to the value of dir. All reference
expansions are done late, on demand.
Intrinsic defaults can be specified by passing them into the
-\class{ConfigParser} constructor as a dictionary.
+\class{ConfigParser} constructor as a dictionary. Additional defaults
+may be passed into the \method{get} method which will override all
+others.
\begin{classdesc}{ConfigParser}{\optional{defaults}}
Return a new instance of the \class{ConfigParser} class. When
@@ -66,6 +68,7 @@ headers.
Exception raised when errors occur attempting to parse a file.
\end{excdesc}
+
\subsection{ConfigParser Objects \label{ConfigParser-objects}}
\class{ConfigParser} instances have the following methods:
@@ -91,11 +94,11 @@ Returns a list of options available in the specified \var{section}.
Read and parse a list of filenames.
\end{methoddesc}
-\begin{methoddesc}{get}{section, option\optional{, raw}}
+\begin{methoddesc}{get}{section, option\optional{, raw\optional{, vars}}}
Get an \var{option} value for the provided \var{section}. All the
\samp{\%} interpolations are expanded in the return values, based on
-the defaults passed into the constructor, unless the \var{raw}
-argument is true.
+the defaults passed into the constructor, as well as the options
+\var{vars} provided, unless the \var{raw} argument is true.
\end{methoddesc}
\begin{methoddesc}{getint}{section, option}