[Zope3-checkins] CVS: Zope3/lib/python/Zope/Configuration - meta.py:1.6

[R. David Murray]

Update of /cvs-repository/Zope3/lib/python/Zope/Configuration
In directory cvs.zope.org:/tmp/cvs-serv24099

Modified Files:
	meta.py 
Log Message:
Make _clear docstring more meaningful and add some clarifying comments.


=== Zope3/lib/python/Zope/Configuration/meta.py 1.5 => 1.6 ===
--- Zope3/lib/python/Zope/Configuration/meta.py:1.5	Mon Sep 16 01:52:40 2002
+++ Zope3/lib/python/Zope/Configuration/meta.py	Tue Sep 17 17:58:17 2002
@@ -56,7 +56,7 @@
     directives is the subdirective registry for the containing
     directive, which may be either a top-level directive or an
     intermediate sub-directive (if subdirectives are nested more than
-    two deep).
+    two deep.
 
     The name argument is a tuple with a namespace URI and an
     name string.
@@ -248,7 +248,16 @@
         return ()
 
 def _clear():
-    "To support unit tests"
+    """Initialize _directives data structure with bootstrap directives."""
+
+    #We initialize _directives with handlers for three (sub)directives:
+    #directives, directive, and subdirective.  Given these three
+    #(whose implementation is defined in this module) we can use
+    #zcml to define any other directives needed for a given system.
+    #
+    #This initialziation is done in a function to facilitate support
+    #the unittest CleanUp class.
+
     _directives.clear()
     _directives[('http://namespaces.zope.org/zope', 'directive')] = (
         Directive, {