Commit 81e4aa70 authored by Fred Drake's avatar Fred Drake

- re-mark ESR's warning about extended registry syntax

- document InterpolationSyntaxError
parent ce1d944b
...@@ -13,11 +13,14 @@ This module defines the class \class{ConfigParser}. ...@@ -13,11 +13,14 @@ This module defines the class \class{ConfigParser}.
\index{Windows ini file} \index{Windows ini file}
The \class{ConfigParser} class implements a basic configuration file The \class{ConfigParser} class implements a basic configuration file
parser language which provides a structure similar to what you would parser language which provides a structure similar to what you would
find on Microsoft Windows INI files. (Beware: this library does \emph{not} find on Microsoft Windows INI files. You can use this to write Python
interpret or write the value-type prefixes used in the Windows
Registry extended version of INI syntax.) You can use this to write Python
programs which can be customized by end users easily. programs which can be customized by end users easily.
\begin{notice}[warning]
This library does \emph{not} interpret or write the value-type
prefixes used in the Windows Registry extended version of INI syntax.
\end{notice}
The configuration file consists of sections, led by a The configuration file consists of sections, led by a
\samp{[section]} header and followed by \samp{name: value} entries, \samp{[section]} header and followed by \samp{name: value} entries,
with continuations in the style of \rfc{822}; \samp{name=value} is with continuations in the style of \rfc{822}; \samp{name=value} is
...@@ -95,6 +98,11 @@ Exception raised when string interpolation cannot be completed because ...@@ -95,6 +98,11 @@ Exception raised when string interpolation cannot be completed because
the number of iterations exceeds \constant{MAX_INTERPOLATION_DEPTH}. the number of iterations exceeds \constant{MAX_INTERPOLATION_DEPTH}.
\end{excdesc} \end{excdesc}
\begin{excdesc}{InterpolationSyntaxError}
Exception raised when the source text into which substitutions are
made does not conform to the required syntax.
\end{excdesc}
\begin{excdesc}{MissingSectionHeaderError} \begin{excdesc}{MissingSectionHeaderError}
Exception raised when attempting to parse a file which has no section Exception raised when attempting to parse a file which has no section
headers. headers.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment