[Zodb-checkins] CVS: Packages/ZConfig/doc - zconfig.tex:1.47
Fred L. Drake, Jr.
fred@zope.com
Thu, 9 Jan 2003 17:31:29 -0500
Update of /cvs-repository/Packages/ZConfig/doc
In directory cvs.zope.org:/tmp/cvs-serv1108
Modified Files:
zconfig.tex
Log Message:
Update information on schema components, at least partly.
=== Packages/ZConfig/doc/zconfig.tex 1.46 => 1.47 ===
--- Packages/ZConfig/doc/zconfig.tex:1.46 Thu Jan 9 11:05:36 2003
+++ Packages/ZConfig/doc/zconfig.tex Thu Jan 9 17:31:25 2003
@@ -242,23 +242,21 @@
XXX to be written
-\section{Libraries of Schema Components \label{schema-library}}
+\section{Schema Components \label{schema-components}}
XXX need more explanation
-\module{ZConfig} supports a library of extensible schema components
-that can be provided by disparate components, and allows them to be
-knit together into concrete schema for applications. Neither
-components nor extensions can add additional keys or sections in the
-application schema.
+\module{ZConfig} supports extensible schema components that can be
+provided by disparate components, and allows them to be knit together
+into concrete schema for applications. Neither components nor
+extensions can add additional keys or sections in the application
+schema.
A schema \dfn{component} is allowed to define new abstract and
section types. It is not allowed to extend application types or
include additional types in application-provided abstract types.
Components are identified using a dotted-name, similar to a Python
module name. For example, one component may be \code{zodb.storage}.
-There is no relationship between the schema component namespace and
-the Python module namespace.
A schema component \dfn{extension} is allowed to define new abstract
and section types, extend types provided by the component it extends,
@@ -980,14 +978,11 @@
for the instance to be used via the public API.
\end{classdesc}
-\begin{classdesc}{ConfigLoader}{schema\optional{, library}}
+\begin{classdesc}{ConfigLoader}{schema}
Loader for configuration files. Each configuration file must
conform to the schema \var{schema}. The \method{load*()} methods
return a tuple consisting of the configuration object and a
composite handler.
- The schema component directory is stored in the directory identified
- by \var{library}, which defaults to \constant{LIBRARY_DIR} if
- omitted or \code{None}.
\end{classdesc}
\begin{classdesc}{SchemaLoader}{\optional{registry}}
@@ -997,10 +992,6 @@
otherwise an instance of \class{ZConfig.datatypes.Registry} will be
used.
\end{classdesc}
-
-\begin{datadesc}{LIBRARY_DIR}
- Default directory for the schema component library.
-\end{datadesc}
\subsection{Loader Objects}