DPML Notify

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

Author: mcconnell
Date: 2007-04-29 18:34:41 +0200 (Sun, 29 Apr 2007)
New Revision: 1996

Modified:
   trunk/central/site/src/docs/metro/tutorials/index.xml
   trunk/central/site/src/docs/util/depot/tutorials/index.xml
Log:
documentation enhancements

Modified: trunk/central/site/src/docs/metro/tutorials/index.xml
===================================================================
--- trunk/central/site/src/docs/metro/tutorials/index.xml       2007-04-28 
17:56:21 UTC (rev 1995)
+++ trunk/central/site/src/docs/metro/tutorials/index.xml       2007-04-29 
16:34:41 UTC (rev 1996)
@@ -12,11 +12,7 @@
     <section name="Metro Tutorial">
     
       <p>
-      In the Depot tutorials dealing with 
-      <a href="../../util/depot/tutorials/plugins.html">strategy 
datatypes</a> 
-      we covered the general subject of a deployment unit descriptor that 
associated 
-      an object instantiation <tt>strategy</tt> with a <tt>classloader</tt> 
chain 
-      definition. The Metro platform provides the prefered deployment 
strategy and 
+      The Metro platform provides the prefered deployment strategy and 
       runtime handler that delivers a complete context driven IOC object 
       instantiation model. 
       In addition to instantiation there are several aspects of a class that 
@@ -24,7 +20,7 @@
       decommissioning lifecycle, garbage collection policy, etc.  Each of 
these concerns 
       are expresssed as well defined semantic features within the Metro 
component model.
       </p>
-
+      
       <subsection name="Totorial Objective">
       
         <p>
@@ -51,6 +47,23 @@
 
       </subsection>
       
+      <subsection name="Technical Note">
+      
+        <p>
+        This tutorial and the following tuitorials use the 
+        <a href="../../util/depot/index.html">Depot</a> build system which 
is basically
+        Ant driven by the depot command line handler.  Depot reads 
information about a 
+        target project from a <tt>index.xml</tt> file and uses this 
information to establish
+        an Ant project definition and supporting properties and classpath 
criteria.  In most
+        cases the project definition is sufficient to automate the build 
process. These tutorials
+        assumes that the reader is familiar with the concepts of a project 
defintion, centralized 
+        defintions under a common index, and the management deployment 
strategy datatypes (refer
+        <a href="../../util/depot/tutorials/index.html">Depot Tutorials</a> 
for additional 
+        information).
+        </p>
+        
+      </subsection>
+      
       <subsection name="Component Creation">
       
         <p>
@@ -60,13 +73,16 @@
         of a custom part strategy.
         </p>
         
-        <p><i>From the global index.xml we establish the reference to our 
target project:</i></p>
+        <p>
+        <i>From the global <tt>index.xml</tt> we establish the reference to 
our 
+        target project:</i>
+        </p>
 <pre>
 &lt;index ..... &gt;
 
   ...
   
-  &lt;project xmlns="dpml:library" name="hello"&gt;
+  <font color="darkred">&lt;project xmlns="dpml:library" name="hello"&gt;
 
     &lt;info title="DPML Metro Hello Tutorial"&gt;
       &lt;description&gt;Introductory Hello World demo.&lt;/description&gt;
@@ -84,7 +100,7 @@
       &lt;/test&gt;
     &lt;/dependencies&gt;
     
-  &lt;/project&gt;
+  &lt;/project&gt;</font>
   
   ...
   

Modified: trunk/central/site/src/docs/util/depot/tutorials/index.xml
===================================================================
--- trunk/central/site/src/docs/util/depot/tutorials/index.xml  2007-04-28 
17:56:21 UTC (rev 1995)
+++ trunk/central/site/src/docs/util/depot/tutorials/index.xml  2007-04-29 
16:34:41 UTC (rev 1996)
@@ -16,19 +16,19 @@
         </p>
         
         <ul>
-          <li><a href="101.html">Getting started.</a></li>
-          <li><a href="properties.html">Adding general properties.</a></li>
-          <li><a href="symbolic.html">Using symbolic references.</a></li>
-          <li><a href="filters.html">Declaring global filters.</a></li>
-          <li><a href="types.html">Examines the impact of type production 
statements.</a></li>
-          <li><a href="automation.html">Build automation using the Depot 
Antlib.</a></li>
-          <li><a href="alias.html">Alias creation and usage.</a></li>
-          <li><a href="unit.html">Automating unit-tests.</a></li>
-          <li><a href="imports.html">Using module imports.</a></li>
-          <li><a href="complex.html">Multiproject builds.</a></li>
-          <li><a href="modules.html">Working with modules.</a></li>
-          <li><a href="export.html">Exporting module defintions.</a></li>
-          <li><a href="plugins.html">Working with runtime metadata via 
plugins.</a></li>
+          <li><a href="101.html">Getting started</a></li>
+          <li><a href="properties.html">Adding general properties</a></li>
+          <li><a href="symbolic.html">Using symbolic references</a></li>
+          <li><a href="filters.html">Declaring global filters</a></li>
+          <li><a href="types.html">Examines the impact of type production 
statements</a></li>
+          <li><a href="automation.html">Build automation using the Depot 
Antlib</a></li>
+          <li><a href="alias.html">Alias creation and usage</a></li>
+          <li><a href="unit.html">Automating unit-tests</a></li>
+          <li><a href="imports.html">Using module imports</a></li>
+          <li><a href="complex.html">Multiproject builds</a></li>
+          <li><a href="modules.html">Working with modules</a></li>
+          <li><a href="export.html">Exporting module defintions</a></li>
+          <li><a href="plugins.html">Working with runtime metadata via 
plugins</a></li>
         </ul>
       
     </section>