[Zope3-checkins] CVS: Zope3/src/zope/configuration - README.txt:1.2
Jim Fulton
jim@zope.com
Wed, 30 Jul 2003 10:34:53 -0400
Update of /cvs-repository/Zope3/src/zope/configuration
In directory cvs.zope.org:/tmp/cvs-serv974/src/zope/configuration
Modified Files:
README.txt
Log Message:
Added a pointer to test_simple which provides documentation for
writing simple directives the new way.
=== Zope3/src/zope/configuration/README.txt 1.1 => 1.2 ===
--- Zope3/src/zope/configuration/README.txt:1.1 Mon Jul 28 18:22:39 2003
+++ Zope3/src/zope/configuration/README.txt Wed Jul 30 10:34:47 2003
@@ -41,6 +41,9 @@
are typically functions that take a context and zero or more
keyword arguments and return a sequence of configuration actions.
+ To learn how to create simple directives, see tests/test_simple.py.
+
+
- Grouping directives collect information to be used by nested
directives. They are called with a context object which they adapt
to some interface that extends IConfigurationContext.
@@ -54,9 +57,15 @@
subdirectives. These objects also have __call__ methods that are
called when processing of subdirectives is finished.
+ Complex directives only exist to support old directive
+ handlers. They will probably be deprecated in the future.
+
- Subdirectives are nested in complex directives. They are like
simple directives except that they hane handlers that are complex
directive methods.
+
+ Subdirectives, like complex directives only exist to support old
+ directive handlers. They will probably be deprecated in the future.
Directives are defined for an interface, which is
IConfigurationContext by default.