[Zope-Checkins] CVS: Packages/ZConfig/doc - zconfig.tex:1.44

Fred L. Drake, Jr. fred@zope.com
Thu, 9 Jan 2003 00:43:02 -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