DPML Notify

[mcconnell at BerliOS <mcconnell AT mail.berlios.de>]

Author: mcconnell
Date: 2007-03-18 12:49:10 +0100 (Sun, 18 Mar 2007)
New Revision: 1918

Modified:
   trunk/central/site/src/docs/metro/component/directive/context.xml
   trunk/central/site/src/docs/metro/component/directive/index.xml
   trunk/central/site/src/docs/metro/component/directive/parts.xml
Log:
more docs

Modified: trunk/central/site/src/docs/metro/component/directive/context.xml
===================================================================
--- trunk/central/site/src/docs/metro/component/directive/context.xml   
2007-03-18 04:48:51 UTC (rev 1917)
+++ trunk/central/site/src/docs/metro/component/directive/context.xml   
2007-03-18 11:49:10 UTC (rev 1918)
@@ -80,16 +80,6 @@
 
     </section>
 
-    <section name="Technical Notes">
-    
-      <p>
-      The context descriptor class provides support for the declaration of 
-      an alternative context class hewever this feature is not currently 
-      supporting within the runtime.
-      </p>
-      
-    </section>
-
   </body>
 
 </document>

Modified: trunk/central/site/src/docs/metro/component/directive/index.xml
===================================================================
--- trunk/central/site/src/docs/metro/component/directive/index.xml     
2007-03-18 04:48:51 UTC (rev 1917)
+++ trunk/central/site/src/docs/metro/component/directive/index.xml     
2007-03-18 11:49:10 UTC (rev 1918)
@@ -11,26 +11,40 @@
 
     <section name="Component Directives">
 
+      <p>
+      A <a href="component.html">component directive</a> defines a component 
deployment solution.  Technically
+      speaking a directive is expressed as part <a 
href="../../parts/strategy/index.html">strategy</a>
+      defintion encapsulating solution data for the construction of a 
component context 
+      model and a component internal structure.  The XML defintion is used 
to establish
+      internal datatypes, which in turn are used to establish the initial 
state of a 
+      component model.
+      </p>
+      
       <subsection name="Namespace">
       
         <pre>dpml:metro</pre>
       
       </subsection>
       
-      <subsection name="Description">
+      <subsection name="Sample Component Directive">
       
         <p>
-        The <a href="component.html"><tt>&lt;component&gt;</tt></a> element 
defines a 
-        part deployment strategy. It identifies the Java class, allows for 
the 
-        declaration of policies concerning lifestyle, collection, and 
activation 
-        semantics, provides the framework for the supply of data to a 
component 
-        <a href="context.html"><tt>&lt;context&gt;</tt></a>, and provides 
the 
-        framework for the declaration of <a href="parts.html">
-        <tt>&lt;parts&gt;</tt></a> defining the component structure .
+        The following sample part XML file contains a component directive
+        as the part strategy definition.
         </p>
-        
+<pre>
+&lt;part xmlns="dpml:part"&gt;
+  &lt;info/&gt;
+  <font color="darkred">&lt;component xmlns="dpml:metro" name="demo" 
class="org.acme.Demo"/&gt;</font>
+  &lt;classpath&gt;
+    &lt;private&gt;
+      &lt;uri>artifact:jar:org/acme/acme-hello#1.0.3&lt;/uri&gt;
+    &lt;/private&gt;
+  &lt;/classpath&gt;
+&lt;/part&gt;
+</pre>
       </subsection>
-     
+      
     </section>
 
   </body>

Modified: trunk/central/site/src/docs/metro/component/directive/parts.xml
===================================================================
--- trunk/central/site/src/docs/metro/component/directive/parts.xml     
2007-03-18 04:48:51 UTC (rev 1917)
+++ trunk/central/site/src/docs/metro/component/directive/parts.xml     
2007-03-18 11:49:10 UTC (rev 1918)
@@ -33,18 +33,25 @@
       
     </section>
 
-    <!--
     <section name="Example">
 
       <p>
-      The following component defines an HHTP server deployment profile.
+      The following XML fragment demonstrates a component directive 
containing a single nested part.
       </p>
 
-<source><![CDATA[
-]]></source>
+<pre>
+  &lt;component xmlns="dpml:metro" name="demo" class="org.acme.Demo"&gt;
+    <font color="darkred">&lt;parts&gt;</font>
+      &lt;component key="widget" name="widget" class="org.acme.Widget"&gt;
+        &lt;context&gt;
+          &lt;entry key="color" method="BLUE"/&gt;
+        &lt;/context&gt;
+      &lt;/component&gt;
+    <font color="darkred">&lt;/parts&gt;</font>
+  &lt;/component&gt;
+</pre>
 
     </section>
-    -->
     
   </body>