[Zope3-checkins] CVS: Packages/ZConfig/doc - zconfig.tex:1.44
Fred L. Drake, Jr.
fred@zope.com
Thu, 9 Jan 2003 00:43:03 -0500
Update of /cvs-repository/Packages/ZConfig/doc
In directory cvs.zope.org:/tmp/cvs-serv29797/doc
Modified Files:
zconfig.tex
Log Message:
Change some naming based on a discussion with Chris and Shane; the primary
intent being to make this easier to explain.
- <sectiongroup type="foo"/> becomes <abstracttype name="foo"/>
- <sectiontype type="foo"/> becomes <sectiontype name="foo"/>
- <sectiontype ... group="foo"/> becomes <sectiontype ... implements="foo"/>
- several internal names get changed to use names consistent with the
new terminology
=== Packages/ZConfig/doc/zconfig.tex 1.43 => 1.44 ===
--- Packages/ZConfig/doc/zconfig.tex:1.43 Tue Jan 7 18:09:18 2003
+++ Packages/ZConfig/doc/zconfig.tex Thu Jan 9 00:42:30 2003
@@ -252,17 +252,20 @@
components nor extensions can add additional keys or sections in the
application schema.
-A schema \dfn{component} is allowed to define new section groups and
+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 section groups.
+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 section
-types, extend types provided by the component it extends, and include
-new concrete types in section groups provided by the component.
+A schema component \dfn{extension} is allowed to define new abstract
+and section types, extend types provided by the component it extends,
+and include new section types in abstract types provided by the
+component. The expected usage is that extensions will provide one or
+more concrete types that implement abstract types defined by the
+component.
A library of schema components is stored as a directory tree, where
each component is located in a directory within the tree. That