[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