Commit 31fc1fac authored by Fred Drake's avatar Fred Drake

update description of schema components to reflect two relatively

recent changes:
- the addition of the "file" attribute of the import element
- the removal of the restriction about what sectiontypes components
  can extend
parent af84ec6e
...@@ -632,17 +632,17 @@ into concrete schema for applications. Components cannot add ...@@ -632,17 +632,17 @@ into concrete schema for applications. Components cannot add
additional keys or sections in the application schema. additional keys or sections in the application schema.
A schema \dfn{component} is allowed to define new abstract 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.
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}.
Schema components are stored alongside application code since they Schema components are stored alongside application code since they
directly reference datatype code. Schema components are provided by directly reference datatype code. Schema components are provided by
Python packages; packages which contain a file named Python packages. The component definition is normally stored in the
\file{component.xml} can be ``imported''. The \file{component.xml} file \file{component.xml}; an alternate filename may be specified
file defines the types provided by that component; it must have a using the \attribute{file} attribute of the \element{import} element.
\element{component} element as the document element. The component defines the types provided by that component; it must
have a \element{component} element as the document element.
The following element is used as the document element for schema The following element is used as the document element for schema
components. Note that schema components do not allow keys and components. Note that schema components do not allow keys and
......
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