[Zodb-checkins] CVS: Packages/ZConfig/doc - zconfig.tex:1.14

Fred L. Drake, Jr. fred@zope.com
Thu, 7 Nov 2002 14:13:34 -0500


Update of /cvs-repository/Packages/ZConfig/doc
In directory cvs.zope.org:/tmp/cvs-serv3491

Modified Files:
	zconfig.tex 
Log Message:
Describe the search up the containment chain for substitution values.


=== Packages/ZConfig/doc/zconfig.tex 1.13 => 1.14 ===
--- Packages/ZConfig/doc/zconfig.tex:1.13	Thu Nov  7 11:21:41 2002
+++ Packages/ZConfig/doc/zconfig.tex	Thu Nov  7 14:13:31 2002
@@ -547,8 +547,13 @@
 \end{description}
 
 In each case, \var{name} is a non-empty sequence of alphanumeric and
-underscore characters not starting with a digit.  If there is not
-a replacement for \var{name}, it is replaced with an empty string.
+underscore characters not starting with a digit.  If there is not a
+replacement for \var{name}, these functions search up the containment
+chain for a suitable replacement.  The containment chain is found by
+looking for an attribute \member{container} on the \var{mapping}
+object; the value of that attribute should be another mapping or
+\code{None}.  If this search does not yield a value, an empty string
+is used.
 
 For these functions, the \var{mapping} argument can be a \class{dict},
 or any type that supports the \method{get()} method of the mapping