[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}