Commit 7f73797d authored by Fred Drake's avatar Fred Drake

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
parent 69fce97f
...@@ -252,17 +252,20 @@ knit together into concrete schema for applications. Neither ...@@ -252,17 +252,20 @@ knit together into concrete schema for applications. Neither
components nor extensions can add additional keys or sections in the components nor extensions can add additional keys or sections in the
application schema. 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 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 Components are identified using a dotted-name, similar to a Python
module name. For example, one component may be \code{zodb.storage}. module name. For example, one component may be \code{zodb.storage}.
There is no relationship between the schema component namespace and There is no relationship between the schema component namespace and
the Python module namespace. the Python module namespace.
A schema component \dfn{extension} is allowed to define new section A schema component \dfn{extension} is allowed to define new abstract
types, extend types provided by the component it extends, and include and section types, extend types provided by the component it extends,
new concrete types in section groups provided by the component. 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 A library of schema components is stored as a directory tree, where
each component is located in a directory within the tree. That each component is located in a directory within the tree. That
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment