DPML Notify

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

Author: mcconnell
Date: 2007-04-06 19:21:07 +0200 (Fri, 06 Apr 2007)
New Revision: 1950

Modified:
   trunk/central/site/src/docs/station/plan/index.xml
   trunk/central/site/src/docs/station/plan/navigation.xml
   trunk/central/site/src/docs/station/plan/plan.xml
Log:


Modified: trunk/central/site/src/docs/station/plan/index.xml
===================================================================
--- trunk/central/site/src/docs/station/plan/index.xml  2007-04-06 16:53:12 
UTC (rev 1949)
+++ trunk/central/site/src/docs/station/plan/index.xml  2007-04-06 17:21:07 
UTC (rev 1950)
@@ -15,12 +15,18 @@
       A deployment plan is an XML document referenced as an artificat that
       defines the configuration of a station instance.  The plan datatype 
       declares a root <a href="plan.html"><tt>&lt;plan&gt;</tt></a> element 
-      which contains zero or more <a 
href="entry.html"><tt>&lt;entry&gt;</tt></a>
-      elements where each entry associates a key with a codebase uri.
-      A plan is referenced as an artifact using the <a 
href="../cli/index.html">
-      station</a> command line tool. 
+      which contains zero or more appliance defintions. A plan is referenced 
+      as an artifact using the <a href="../cli/index.html"> station</a> 
+      command line tool. 
       </p>
+
+      <subsection name="Namespace">
       
+        <pre>dpml:station</pre>
+      
+      </subsection>
+      
+      
       <subsection name="Executing a Plan">
       
         <p>
@@ -37,20 +43,33 @@
     <section name="Examples">
     
       <p>
-      The following example plan includes three deployment entries.  The 
first two entries
-      reference <a href="../appliance/index.html">appliance</a> datatypes 
which trigger the 
-      establishment of the respective applications in their own JVMs.  The 
third entry is a 
-      <a href="../../metro/parts/index.html">part</a> datatype to be loaded 
into the current 
-      virtual machine.
+      The following example plan includes three deployment entries.  The 
first entry includes
+      an externally defined appliance into the plan defintion.  The second 
entry is an appliance 
+      defintion deriectly included within the plan defintition.  Both of 
these example will result
+      in the establioshment of a new jvm using the supplied process criteria 
and codebase.  The 
+      third entry includes an part defintion (by reference) into the current 
jvm. 
       </p>
       
 <source>&lt;plan xmlns="dpml:station" name="demo" title="Plan Demo"&gt;
 
-  &lt;entry key="foo" uri="link:appliance:dpml/metro/demo-foo"/&gt;
-  &lt;entry key="bar" uri="link:appliance:dpml/metro/demo-bar"/&gt;
-  &lt;entry key="toto" 
uri="link:part:dpml/metro/dpml-metro-sample?message=Hello%20World&amp;port=1024"/&gt;
+  &lt;include key="foo" uri="link:appliance:dpml/metro/demo-foo"/&gt;
+    
+  &lt;appliance key="bar"&gt;
+    &lt;info name="bar"/&gt;
+    &lt;process startup="0" shutdown="0"&gt;
+      &lt;environment&gt;
+        &lt;variable name="FOO" value="BAR"/&gt;
+      &lt;/environment&gt;
+      &lt;properties&gt;
+        &lt;property name="foo" value="bar"/&gt;
+      &lt;/properties&gt;
+    &lt;/process&gt;
+    &lt;codebase 
uri="link:part:dpml/metro/dpml-metro-sample?message=Bar"/&gt;
+  &lt;/appliance&gt;
+
+  &lt;include key="toto" 
uri="link:part:dpml/metro/dpml-metro-sample?message=Hello%20World&amp;port=1024"/&gt;
   
-&lt;/plan>
+&lt;/plan&gt;
 </source>
 
     </section>

Modified: trunk/central/site/src/docs/station/plan/navigation.xml
===================================================================
--- trunk/central/site/src/docs/station/plan/navigation.xml     2007-04-06 
16:53:12 UTC (rev 1949)
+++ trunk/central/site/src/docs/station/plan/navigation.xml     2007-04-06 
17:21:07 UTC (rev 1950)
@@ -26,7 +26,8 @@
 
     <menu>
       <item name="Plan" href="plan.html"/>
-      <item name="Entry" href="entry.html"/>
+      <item name="Appliance" href="appliance/index.html"/>
+      <item name="Include" href="include.html"/>
     </menu>
 
  </body>

Modified: trunk/central/site/src/docs/station/plan/plan.xml
===================================================================
--- trunk/central/site/src/docs/station/plan/plan.xml   2007-04-06 16:53:12 
UTC (rev 1949)
+++ trunk/central/site/src/docs/station/plan/plan.xml   2007-04-06 17:21:07 
UTC (rev 1950)
@@ -18,7 +18,7 @@
         </p>
 
       </subsection>
-      
+
       <subsection name="Attributes">
         <table>
           <tr>
@@ -37,12 +37,19 @@
 
         <table>
           <tr>
-            <td><tt><a href="entry.html">entry</a></tt></td>
+            <td><tt><a href="appliance/index.html">appliance</a></tt></td>
             <td>
-            Declaration of a deployment entry. Zero or more entry elements
-            may be declared.  Entries will be deployed sequentially.
+            Declaration of an embedded jvm deployment screnario.
             </td>
           </tr>
+          <tr>
+            <td><tt><a href="include.html">include</a></tt></td>
+            <td>
+            Declaration of a deployment entry by reference. Zero or more 
include elements
+            may be declared.  Include entries may reference stand-alone 
appliance or part
+            datatypes.
+            </td>
+          </tr>
         </table>
 
       </subsection>