[Zope3-checkins] CVS: Zope3/doc/zcml - attribute_conventions.stx:1.4

[R. David Murray]

Update of /cvs-repository/Zope3/doc/zcml
In directory cvs.zope.org:/tmp/cvs-serv14250

Modified Files:
	attribute_conventions.stx 
Log Message:
Correct the documentation for composite factory after discussion with Jim.


=== Zope3/doc/zcml/attribute_conventions.stx 1.3 => 1.4 ===
--- Zope3/doc/zcml/attribute_conventions.stx:1.3	Fri Aug 30 15:00:57 2002
+++ Zope3/doc/zcml/attribute_conventions.stx	Sun Sep  1 14:43:28 2002
@@ -30,8 +30,16 @@
   factory
   
     A dotted name that resolves to a callable that acts as a factory.
-    A factory can also be made of several callables chained together.
-    In this case, the factory attribute is a whitespace separated list
-    of dotted-names.  If a factory attribute is given as "a b c"
-    (three chained factories), this results in a composite factory
-    of the form c(b(a(context))).
+    The argument list passed to the callable will depend on the
+    type of object whose creation is controlled by the particular
+    directive.
+
+    Some directives support the specification of a 'composite
+    factory'.  This consists of several callables chained together
+    to build the actual factory, and is specified by listing the
+    names of two or more callables separated by one or more blanks.
+    The first callable listed must accept the normal calling sequence
+    for the type of object being contructed.  The remaining callables
+    must be Adapters.  In other words, if the value of the factory
+    attribute is "a b c", then the composite factory is built by
+    doing c(b(a(<factory-argument-list>))).