[Zodb-checkins] CVS: Packages/ZConfig/doc - zconfig.tex:1.19
Fred L. Drake, Jr.
fred@zope.com
Mon, 25 Nov 2002 17:52:18 -0500
Update of /cvs-repository/Packages/ZConfig/doc
In directory cvs.zope.org:/tmp/cvs-serv29105/doc
Modified Files:
zconfig.tex
Log Message:
Update the API slightly: when a named section has been requested and is not
available, raise a more reasonable exception.
=== Packages/ZConfig/doc/zconfig.tex 1.18 => 1.19 ===
--- Packages/ZConfig/doc/zconfig.tex:1.18 Fri Nov 22 11:43:48 2002
+++ Packages/ZConfig/doc/zconfig.tex Mon Nov 25 17:52:17 2002
@@ -472,7 +472,8 @@
Returns a single typed section. The type of the retrieved section
is given by \var{type}. If \var{name} is given and not \code{None},
the name of the section must match \var{name}. If there is no
- section matching in both name and type, \exception{KeyError} is
+ section matching in both name and type,
+ \exception{ConfigurationMissingSectionError} is
raised. If \var{name} is not given or is \code{None}, there must be
exactly one child section of type \var{type}; that section is
returned. If there is more than one section of type \var{type},
@@ -535,9 +536,12 @@
\end{excdesc}
\begin{excdesc}{ConfigurationMissingSectionError}
+ Raised when a requested named section is not available.
\end{excdesc}
\begin{excdesc}{ConfigurationConflictingSectionError}
+ Raised when a request for a section cannot be fulfilled without
+ ambiguity.
\end{excdesc}