DPML Notify

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

Author: mcconnell
Date: 2007-03-20 16:27:34 +0100 (Tue, 20 Mar 2007)
New Revision: 1926

Added:
   trunk/tutorials/tooling/complex/plugin/impl/etc/component.xml
Removed:
   trunk/tutorials/tooling/complex/plugin/impl/etc/plugin.xml
Modified:
   trunk/central/site/src/docs/util/command/index.xml
   trunk/central/site/src/docs/util/depot/tutorials/alias.xml
   trunk/central/site/src/docs/util/depot/tutorials/automation.xml
   trunk/central/site/src/docs/util/depot/tutorials/export.xml
   trunk/central/site/src/docs/util/depot/tutorials/plugins.xml
   trunk/central/site/src/docs/util/depot/tutorials/unit.xml
   trunk/central/site/src/docs/util/transit/tutorials/artifacts.xml
   trunk/tutorials/tooling/complex/plugin/module.xml
Log:
cleaning up the depot tutorials

Modified: trunk/central/site/src/docs/util/command/index.xml
===================================================================
--- trunk/central/site/src/docs/util/command/index.xml  2007-03-19 15:50:08 
UTC (rev 1925)
+++ trunk/central/site/src/docs/util/command/index.xml  2007-03-20 15:27:34 
UTC (rev 1926)
@@ -30,7 +30,7 @@
       <pre>@UTIL-CLI-URI@</pre>
 
       <p>
-        The CLI indexprovides an API for processing command line interfaces.
+        The CLI utility package provides an API for processing command line 
interfaces.
       </p>
       <p>
         The implementation is based on the Jakarta Commons CLI2 library 
written 

Modified: trunk/central/site/src/docs/util/depot/tutorials/alias.xml
===================================================================
--- trunk/central/site/src/docs/util/depot/tutorials/alias.xml  2007-03-19 
15:50:08 UTC (rev 1925)
+++ trunk/central/site/src/docs/util/depot/tutorials/alias.xml  2007-03-20 
15:27:34 UTC (rev 1926)
@@ -86,27 +86,14 @@
         versioned artifact (similar to a unix symlink for artifacts).  This 
tutorial
         has covered the creation of a simple non-versioned alias associated 
with the 
         produced jar file. Alias attributes may be used on any resource type
-        production statement.  An alternative form of versioned alias 
production
-        is available using the <tt>version</tt> attribute in place of 
<tt>alias</tt>.
-        For example - the following statement would result in the generation 
of a alias
-        artifact referencing version 1.0.
+        production statement.  
         </p>
         
-<pre>
-  &lt;project name="demo" basedir="."&gt;
-    &lt;properties&gt;
-      &lt;property name="location" value="New York"/&gt;
-      &lt;property name="message" value="Hello from ${user.name} in 
${location}"/&gt;
-    &lt;/properties&gt;
-    &lt;types&gt;
-      <font color="darkred">&lt;type id="jar" version="1.0"/&gt;</font>
-    &lt;/types&gt;
-    &lt;filters&gt;
-      &lt;filter token="MESSAGE" value="${message}"/&gt;
-    &lt;/filters&gt;
-  &lt;/project&gt;
-</pre>
-
+        <p>
+        The <a href="unit.html">following tutorial</a> moves on to the 
broader subject of unit 
+        testing in an environment backed by a rich project model.
+        </p>
+        
       </subsection>
 
     </section>

Modified: trunk/central/site/src/docs/util/depot/tutorials/automation.xml
===================================================================
--- trunk/central/site/src/docs/util/depot/tutorials/automation.xml     
2007-03-19 15:50:08 UTC (rev 1925)
+++ trunk/central/site/src/docs/util/depot/tutorials/automation.xml     
2007-03-20 15:27:34 UTC (rev 1926)
@@ -11,7 +11,7 @@
     <section name="Build Automation using Templates">
     
         <p>
-        One of the nice features added to Ant 1.6 is the support for 
+        One of the nice features added to Ant 1.6 wassupport for 
         the import of template build files. The Depot system comes with 
         a default template that handles the establishment of a number of 
         tasks that are project-aware.  Using information about a target 
@@ -28,10 +28,9 @@
         </p>
         
 <pre>
-&lt;project name="demo" default="install"
-    xmlns:transit="antlib:dpml.tools.transit"&gt;
+&lt;project name="demo" default="install" xmlns:x="antlib:dpml.tools"&gt;
 
-  <font color="darkred">&lt;transit:import 
uri="local:template:dpml/tools/standard"/&gt;</font>
+  <font color="darkred">&lt;x:import 
uri="local:template:dpml/tools/standard"/&gt;</font>
 
 &lt;/project&gt;
 </pre>

Modified: trunk/central/site/src/docs/util/depot/tutorials/export.xml
===================================================================
--- trunk/central/site/src/docs/util/depot/tutorials/export.xml 2007-03-19 
15:50:08 UTC (rev 1925)
+++ trunk/central/site/src/docs/util/depot/tutorials/export.xml 2007-03-20 
15:27:34 UTC (rev 1926)
@@ -24,8 +24,7 @@
         <p>
         Our index definition remains unchanged except for the addition of 
         a type production statement declaring that the module build produces
-        a module artifact (and just for fun we have requested a version alias
-        to be produced at the same time).
+        a module artifact.
         </p>
 
 <pre>
@@ -40,7 +39,7 @@
   &lt;module name="org/acme" basedir="."&gt;
   
     <font color="darkred">&lt;types&gt;
-      &lt;type id="module" version="1.0"&gt;
+      &lt;type id="module"&gt;
     &lt;/types&gt;</font>
   
     &lt;project name="clock-api" basedir="api"&gt;

Modified: trunk/central/site/src/docs/util/depot/tutorials/plugins.xml
===================================================================
--- trunk/central/site/src/docs/util/depot/tutorials/plugins.xml        
2007-03-19 15:50:08 UTC (rev 1925)
+++ trunk/central/site/src/docs/util/depot/tutorials/plugins.xml        
2007-03-20 15:27:34 UTC (rev 1926)
@@ -40,8 +40,7 @@
 
 <pre>
 &lt;?xml version="1.0" encoding="ISO-8859-1"?&gt;
-&lt;index xmlns="dpml:library"
-    <font color="darkred">xmlns:part="dpml:part"</font>&gt;
+&lt;index xmlns="dpml:library"&gt;
 
   &lt;imports&gt;
     &lt;import uri="link:module:ant"/&gt;
@@ -86,8 +85,8 @@
       <subsection name="The Part Artifact">
 
         <p>
-        During the build the following part defintion is created based on 
the input
-        part definition source.
+        During the build the following part defintion is created based on 
the 
+        depolyment strategy input resource from the source data.
         </p>
         
         <p><i>Generated part:</i> 
<tt>artifact:part:org/acme/plugin/clock-impl#SNAPSHOT</tt></p>
@@ -100,10 +99,12 @@
 
   <info/>
 
-  <strategy xsi:type="plugin" class="org.acme.impl.SimpleClock">
-    <param value="h:mm"/>
-    <param class="java.util.Locale" method="getDefault"/>
-  </strategy>
+  <component xmlns="dpml:metro" type="org.acme.impl.SimpleClock">
+    <context>
+      <entry key="format" value="h:mm"/>
+      <entry key="locale" class="java.util.Locale" method="getDefault"/>
+    </context>
+  </component>
 
   <classpath>
     <private>

Modified: trunk/central/site/src/docs/util/depot/tutorials/unit.xml
===================================================================
--- trunk/central/site/src/docs/util/depot/tutorials/unit.xml   2007-03-19 
15:50:08 UTC (rev 1925)
+++ trunk/central/site/src/docs/util/depot/tutorials/unit.xml   2007-03-20 
15:27:34 UTC (rev 1926)
@@ -30,13 +30,16 @@
 &lt;index xmlns="dpml:library"&gt;
 
   &lt;project name="demo" basedir="."&gt;
+  
     &lt;properties&gt;
       &lt;property name="location" value="New York"/&gt;
       &lt;property name="message" value="Hello from ${user.name} in 
${location}"/&gt;
     &lt;/properties&gt;
+    
     &lt;types&gt;
       &lt;type id="jar" alias="true"/&gt;
     &lt;/types&gt;
+    
     <font color="darkred">&lt;dependencies&gt;
       &lt;test&gt;
         &lt;include uri="artifact:jar:ant/ant-junit#1.6.5"/&gt;
@@ -44,10 +47,10 @@
         &lt;include uri="artifact:jar:junit/junit#3.8.1"/&gt;
       &lt;/test&gt;
     &lt;/dependencies&gt;</font>
+    
     &lt;filters&gt;
       &lt;filter token="MESSAGE" value="${message}"/&gt;
     &lt;/filters&gt;
-    &lt;dependencies&gt;
 
   &lt;/project&gt;
 

Modified: trunk/central/site/src/docs/util/transit/tutorials/artifacts.xml
===================================================================
--- trunk/central/site/src/docs/util/transit/tutorials/artifacts.xml    
2007-03-19 15:50:08 UTC (rev 1925)
+++ trunk/central/site/src/docs/util/transit/tutorials/artifacts.xml    
2007-03-20 15:27:34 UTC (rev 1926)
@@ -102,7 +102,7 @@
         When the new URL constructor is invoked the JVM checks available 
URLStreamHandlers
         using a number of mechanisms - one of which is to check the value of 
the 
         "java.protocol.handler.pkgs" system property.  The JVM will look for 
a protocol
-        handler named "net.dpml.transit" + [protocol].Handler.  The 
Transit's artifact
+        handler named "dpml.transit" + [protocol].Handler.  The Transit's 
artifact
         Handler class is primarily responsible for the establishment of a 
ArtifactURLConnection.
         The ArtifactURLConnection holds a reference to the Transit system.  
When the openStream
         operation is invoked the Artifact URL connection will use a cache 
handler to resolve
@@ -128,14 +128,17 @@
 
       </subsection>
 
-      <subsection name="Next Topic - Plugins">
+      <subsection name="Next Topic - the Local Protocol">
       
         <p>
-        This page has presented a more in-depth look at the 
<tt>artifact</tt> protocol.
-        The <a href="plugins.html">next tutorial</a> introduced a simple 
datatype called a 
-        <tt>part</tt> that describes an object instantiation strategy with a 
classloader 
-        chain definition.  This datatype is commonly referred to as a 
<tt>plugin</tt> and 
-        demonstrates the usage of one artifact to describe the usage of many 
artifacts.
+        The machinery underlying the artifact uri is designed around the 
availability of 
+        local or remote hosts which serve as the resource source repository. 
This is apropriate
+        when dealing with general integration of multiple projects, however 
- it is not suitable
+        for the management of local configuration data. The <a 
href="local.html">next tutorial</a> introduces
+        the local protocol which provides support for the resolution of 
preference information
+        local to the application runtime environment. In general terms it 
follows the same patterns 
+        as the artifact protocol but the underlying machining resolves 
resources relative to a 
+        local system wide preference root directory.
         </p>
 
       </subsection>

Copied: trunk/tutorials/tooling/complex/plugin/impl/etc/component.xml (from 
rev 1924, trunk/tutorials/tooling/complex/plugin/impl/etc/plugin.xml)

Deleted: trunk/tutorials/tooling/complex/plugin/impl/etc/plugin.xml
===================================================================
--- trunk/tutorials/tooling/complex/plugin/impl/etc/plugin.xml  2007-03-19 
15:50:08 UTC (rev 1925)
+++ trunk/tutorials/tooling/complex/plugin/impl/etc/plugin.xml  2007-03-20 
15:27:34 UTC (rev 1926)
@@ -1,8 +0,0 @@
-<?xml version="1.0"?>
-
-<component xmlns="dpml:metro" type="org.acme.impl.SimpleClock">
-  <context>
-    <entry key="format" value="h:mm"/>
-    <entry key="locale" class="java.util.Locale" method="getDefault"/>
-  </context>
-</component>

Modified: trunk/tutorials/tooling/complex/plugin/module.xml
===================================================================
--- trunk/tutorials/tooling/complex/plugin/module.xml   2007-03-19 15:50:08 
UTC (rev 1925)
+++ trunk/tutorials/tooling/complex/plugin/module.xml   2007-03-20 15:27:34 
UTC (rev 1926)
@@ -15,7 +15,7 @@
     <project name="clock-impl" basedir="impl">
       <types>
         <type id="jar"/>
-        <type id="part" source="etc/plugin.xml"/>
+        <type id="part" source="etc/component.xml"/>
       </types>
       <dependencies>
         <runtime>