You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by ra...@apache.org on 2005/10/15 06:01:47 UTC

svn commit: r321286 - in /jakarta/commons/sandbox/scxml/trunk/xdocs: ./ api-notes/

Author: rahul
Date: Fri Oct 14 21:01:42 2005
New Revision: 321286

URL: http://svn.apache.org/viewcvs?rev=321286&view=rev
Log:
A set of notes about the Commons SCXML API, "Getting Started" tutorials snippets.

Bits about:
 * SCXML digester
 * SCXML engine
 * Firing events on an SCXML engine
 * Standalone testing 
 * Fun with EL

Added:
    jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/
    jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes.xml   (with props)
    jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/core-digester.xml   (with props)
    jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/core-engine.xml   (with props)
    jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/core-events.xml   (with props)
    jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/side-effect-el.xml   (with props)
    jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/testing-standalone.xml   (with props)
Modified:
    jakarta/commons/sandbox/scxml/trunk/xdocs/index.xml
    jakarta/commons/sandbox/scxml/trunk/xdocs/navigation.xml

Added: jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes.xml?rev=321286&view=auto
==============================================================================
--- jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes.xml (added)
+++ jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes.xml Fri Oct 14 21:01:42 2005
@@ -0,0 +1,68 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+   Copyright 2003-2004 The Apache Software Foundation
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+-->
+
+<document>
+
+ <properties>
+  <title>Commons SCXML API notes</title>
+  <author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
+ </properties>
+
+ <body>
+
+ <section name="Commons SCXML API notes">
+
+  <p>This is a collection of notes about the Commons SCXML API, a scratch pad of
+  sorts, aimed at noting down usages for the frequently needed bits of Commons
+  SCXML and some interesting (to some of us) side-effects.
+  </p>
+
+  <subsection name="Core">
+   <p>Contains notes about the core Commons SCXML APIs.</p>
+   <p>The first set of notes walks through the most common usage pattern,
+   end-to-end.</p>
+   <ul>
+    <li><a href="api-notes/core-digester.html">Digester</a> - Digesting SCXML
+    into the Commons SCXML Java object model.</li>
+    <li><a href="api-notes/core-engine.html">Executor</a> - Instantiating
+    an SCXML executor (engine).</li>
+    <li><a href="api-notes/core-events.html">Triggering events</a> - Executing
+    the event driven state machine.</li>
+   </ul>
+  </subsection>
+
+  <subsection name="Testing">
+   <p>Contains notes about trying Commons SCXML and testing SCXML documents.</p>
+   <ul>
+    <li><a href="api-notes/testing-standalone.html">Standalone</a> - Rev'ing the
+    engine.</li>
+   </ul>
+  </subsection>
+
+  <subsection name="Side-effects">
+   <p>Contains notes about interesting non-primary uses for Commons SCXML.</p>
+   <ul>
+    <li><a href="api-notes/side-effect-el.html">EL</a> - Trying Commons EL outside
+    a servlet container.</li>
+   </ul>
+  </subsection>
+
+ </section>
+
+ </body>
+
+</document>

Propchange: jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes.xml
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/core-digester.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/core-digester.xml?rev=321286&view=auto
==============================================================================
--- jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/core-digester.xml (added)
+++ jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/core-digester.xml Fri Oct 14 21:01:42 2005
@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+   Copyright 2003-2004 The Apache Software Foundation
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+-->
+
+<document>
+
+ <properties>
+  <title>Commons SCXML Usage - API notes - Digester</title>
+  <author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
+ </properties>
+
+ <body>
+
+  <section name="Commons SCXML - Digesting SCXML documents for Commons SCXML">
+    <p>Commons SCXML provides its own implementation of the
+    <a href="http://svn.apache.org/repos/asf/jakarta/commons/sandbox/scxml/trunk/src/main/java/org/apache/commons/scxml/model/">
+    Java object model for SCXML</a>
+    and a configured <a href="http://jakarta.apache.org/commons/digester">
+    Digester</a> that can digest SCXML documents into that object model.</p>
+
+    <subsection name="Usage">
+     <p>The primary convenience method exposed by the <code>SCXMLDigester</code>
+     is:</p>
+     <pre>
+        //import java.net.URL;
+        //import org.apache.commons.scxml.Context;
+        //import org.apache.commons.scxml.Evaluator;
+        //import org.apache.commons.scxml.SCXMLDigester;
+        //import org.apache.commons.scxml.model.SCXML;
+        //import org.xml.sax.ErrorHandler;
+
+        SCXML scxml = SCXMLDigester.digest(&lt;URL&gt;, &lt;ErroHandler&gt;,
+                                    &lt;Context&gt;, &lt;Evaluator&gt;);
+
+        if (scxml == null) {
+          // Digestion failed
+        }
+     </pre>
+
+     <p>It returns an <code>SCXML</code> object, which is the state machine /
+     chart represented in the Commons SCXML Java object model. This method
+     uses the <code>URL</code> of the initial SCXML document to resolve any
+     relative URLs referenced by the document, such as <code>src</code>
+     attributes of <code>State</code> SCXML elements.</p>
+
+     <p>Commons SCXML provides convenience implementations of most of the
+     interfaces such as <code>Context</code>, <code>ErrorHandler</code>,
+     and an implementation of <code>Evaluator</code> for the JSP 2.0 EL,
+     that uses Commons EL.</p>
+
+     <p>The SCXMLDigester exposes another convenience method which can handle
+     a SCXML document specified using its &quot;real path&quot; on the local
+     system, in which case an additional 
+     <code>org.apache.commons.SCXML.PathResolver</code>parameter needs to be
+     supplied for resolving relative document references. A serialization
+     method is also available, primarily for debugging.</p>
+
+     <p>The <code>SCXMLDigester</code> Javadoc is available
+     <a href="../apidocs/org/apache/commons/scxml/SCXMLDigester.html">
+     here</a>.
+     </p>
+    </subsection>
+
+    <subsection name="API notes set">
+     <p>The next note in this set describes the
+     <a href="core-engine.html">SCXML engine</a>.</p>
+    </subsection>
+
+  </section> 
+
+ </body>
+
+</document>

Propchange: jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/core-digester.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/core-digester.xml
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/core-engine.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/core-engine.xml?rev=321286&view=auto
==============================================================================
--- jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/core-engine.xml (added)
+++ jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/core-engine.xml Fri Oct 14 21:01:42 2005
@@ -0,0 +1,87 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+   Copyright 2003-2004 The Apache Software Foundation
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+-->
+
+<document>
+
+ <properties>
+  <title>Commons SCXML Usage - API notes - Engine</title>
+  <author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
+ </properties>
+
+ <body>
+
+  <section name="Commons SCXML - Creating and configuring the SCXML engine">
+
+   <p>The Commons SCXML executor is the engine that runs the state machine.
+   Commons SCXML also allows listeners to be added to the
+   <code>SCXMLExecutor</code>, which are informed about the progress of
+   the state machine via <code>onEntry</code> and <code>onExit</code>
+   notifications for <code>TransitionTarget</code>s, as well as
+   <code>onTransition</code> notificatins when transitions are followed.</p>
+
+   <subsection name="Usage">
+     <p>The <code>SCXMLExecutor</code> is usually initialized as follows:</p>
+     <pre>
+        //import org.apache.commons.scxml.SCXMLExecutor;
+        //import org.apache.commons.scxml.Evaluator;
+        //import org.apache.commons.scxml.EventDispatcher;
+        //import org.apache.commons.scxml.ErrorReporter;
+        //import org.apache.commons.scxml.SCXMLListener;
+        //import org.apache.commons.scxml.model.SCXML;
+        //import org.apache.commons.scxml.model.ModelException;
+
+        SCXMLExecutor exec = null;
+        try {
+            exec = new SCXMLExecutor(&lt;Evaluator&gt;,
+                       &lt;EventDispatcher&gt;, &lt;ErrorReporter&gt;);
+            scxml.addListener(&lt;SCXMLListener&gt;);
+            exec.setSuperStep(true);
+            exec.setStateMachine(&lt;SCXML&gt;);
+        } catch (ModelException me) {
+        	// Executor initialization failed, because the
+            // state machine specified has inconsistencies
+        }
+     </pre>
+
+     <p>Commons SCXML provides basic implementations of the
+     <code>EventDispatcher</code>, <code>ErrorReporter</code>, and
+     <code>SCXMLListener</code> interfaces, which simply log
+     all the events received. Commons SCXML uses Commons Logging.</p>
+
+     <p>An engine, once initialized,
+     should be cached till the state machine reaches a terminal or
+     &quot;final&quot; state, and no more.
+     </p>
+
+     <p>The <code>SCXMLExecutor</code> Javadoc is available
+     <a href="../apidocs/org/apache/commons/scxml/SCXMLExecutor.html">
+     here</a>.
+     </p>
+   </subsection>
+
+   <subsection name="API notes set">
+    <p>The previous note in this set describes the
+    <a href="core-digester.html">SCXML digester</a>.<br/>
+    The next note in this set describes
+    <a href="core-events.html">triggering events</a>.</p>
+   </subsection>
+
+  </section>
+
+ </body>
+
+</document>

Propchange: jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/core-engine.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/core-engine.xml
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/core-events.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/core-events.xml?rev=321286&view=auto
==============================================================================
--- jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/core-events.xml (added)
+++ jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/core-events.xml Fri Oct 14 21:01:42 2005
@@ -0,0 +1,98 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+   Copyright 2003-2004 The Apache Software Foundation
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+-->
+
+<document>
+
+ <properties>
+  <title>Commons SCXML Usage - API notes - Triggering Events</title>
+  <author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
+ </properties>
+
+ <body>
+
+  <section name="Commons SCXML - Firing events on the SCXML engine">
+
+   <p>Once the SCXML engine has been initialized, the state machine
+   progresses based on the events that are fired on it. When an event
+   is fired, if the current set of states have transitions waiting
+   for that event, and the guard condition on one of those transitions
+   is satisfied, the state machine is said to &quot;follow&quot; that
+   transition, which may possibly yield a new set of current states.
+   Most state machines will ultimately reach a &quot;final&quot; state,
+   wherein the state machine has said to have executed to completion.
+   </p>
+
+   <subsection name="Usage">
+     <p>An event &quot;foo.bar&quot; may be fired on the engine as
+     follows:</p>
+     <pre>
+        //import org.apache.commons.scxml.SCXMLExecutor;
+        //import org.apache.commons.scxml.TriggerEvent;
+        //import org.apache.commons.scxml.model.ModelException;
+
+        // where &quot;exec&quot; is the SCXMLExecutor instance
+        TriggerEvent[] te = { new TriggerEvent("foo.bar",
+        	              TriggerEvent.SIGNAL_EVENT) };
+        try {
+        	exec.triggerEvents(te);
+        } catch (ModelException me) {
+        	// The events left the engine in inconsistent state
+        }
+     </pre>
+
+     <p>If the resulting events leave the state machine in an inconsistent
+     state, a <code>ModelException</code> may be thrown.
+     </p>
+
+     <p>More than one events may be triggered on the state machine at a
+     time. After the engine processes a set of trigger events, it is
+     customary to check whether the state machine has reached a &lt;final&gt;
+     state.</p>
+
+     <p>The following snippet illustrates how the <code>SCXMLExecutor</code>
+     <code>Status</code> is queried for state machine run to completion.</p>
+
+     <pre>
+        //import org.apache.commons.scxml.SCXMLExecutor;
+        //import org.apache.commons.scxml.Status;
+
+        // where &quot;exec&quot; is the SCXMLExecutor instance    
+        Status status = exec.getCurrentStatus();
+        if (status.isFinal()) {
+        	// run to completion, release cached objects
+        }
+     </pre>
+
+     <p>The <code>TriggerEvent</code> Javadoc is available
+     <a href="../apidocs/org/apache/commons/scxml/TriggerEvent.html">
+     here</a>.<br/>
+     The <code>Status</code> Javadoc is available
+     <a href="../apidocs/org/apache/commons/scxml/Status.html">
+     here</a><br/>
+     </p>
+   </subsection>
+
+   <subsection name="API notes set">
+    <p>The previous note in this set describes the
+    <a href="core-engine.html">SCXML engine</a>.</p>
+   </subsection>
+
+  </section> 
+
+ </body>
+
+</document>

Propchange: jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/core-events.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/core-events.xml
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/side-effect-el.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/side-effect-el.xml?rev=321286&view=auto
==============================================================================
--- jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/side-effect-el.xml (added)
+++ jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/side-effect-el.xml Fri Oct 14 21:01:42 2005
@@ -0,0 +1,68 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+   Copyright 2003-2004 The Apache Software Foundation
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+-->
+
+<document>
+
+ <properties>
+  <title>Commons SCXML Usage - API notes - EL</title>
+  <author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
+ </properties>
+
+ <body>
+
+  <section name="Commons SCXML - Trying out EL without the servlet container">
+   <p>Someone asked about Commons EL:<br/>
+   &quot;<i>Is there no way to test this stuff outside of a Servlet/JSP
+   container?</i>&quot;</p>
+
+   <p>Commons SCXML supports EL as an expression language that may be used
+   within the expressions in an SCXML document. As a side-effect, a simple
+   API may be available for anyone who has the need to test without wanting
+   to deal with a Servlet/JSP container. <i>We understand this has limited
+   use.</i>
+   </p>
+
+   <p>To test an expression language implementation, one minimally needs a
+   context of evaluation and an evaluator, which gives us the following
+   usage:</p>
+   <pre>
+   //import org.apache.commons.scxml.Context;
+   //import org.apache.commons.scxml.Evaluator;
+   //import org.apache.commons.scxml.SCXMLExpressionException;
+   //import org.apache.commons.scxml.env.jsp.ELContext;
+   //import org.apache.commons.scxml.env.jsp.ELEvaluator;
+
+   Context context = new ELContext();
+   // Say we have an instance 'foo' of type Foo which
+   // has a property 'bar' of type String
+   context.set("foo", foo);
+
+   Evaluator evaluator = new ELEvaluator();
+
+   String bar = null;
+   try {
+     bar = (String) evaluator.eval(context, "${foo.bar}");
+   } catch (SCXMLExpressionException see) {
+     // Commons SCXML wraps the underlying exception,
+     // in this case, a javax.servlet.jsp.el.ELException
+   }
+   </pre>
+  </section> 
+
+ </body>
+
+</document>

Propchange: jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/side-effect-el.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/side-effect-el.xml
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/testing-standalone.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/testing-standalone.xml?rev=321286&view=auto
==============================================================================
--- jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/testing-standalone.xml (added)
+++ jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/testing-standalone.xml Fri Oct 14 21:01:42 2005
@@ -0,0 +1,72 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+   Copyright 2003-2004 The Apache Software Foundation
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+-->
+
+<document>
+
+ <properties>
+  <title>Commons SCXML Usage - API notes - Testing Standalone</title>
+  <author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
+ </properties>
+
+ <body>
+
+  <section name="Commons SCXML - Standalone testing, trying out samples">
+
+   <p>The SCXML distribution provides a utility class 
+   <code>org.apache.commons.scxml.env.jsp.Standalone</code> which provides
+   a mock environment allowing users to try out samples. The core dependencies
+   for Commons SCXML are Commons Digester (which introduces a transitive 
+   dependency on Commons BeanUtils, at the least) and Commons Logging. In 
+   addition, an environment specific expression language is used in SCXML 
+   documents. The Standalone class anticipates expressions in the JSP 2.0 
+   Expression Language, and hence requires commons-el.jar and jsp-api.jar. 
+   View the <a href="../dependencies.html">dependencies</a> page for the
+   recommended version numbers. <i>It may be possible to use lower version
+   numbers for the Commons dependencies.</i>
+   </p>
+
+   <p>So that amounts to:</p>
+
+   <pre>
+   java -classpath
+
+   commons-digester-1.7.jar;commons-beanutils-1.7.0.jar;
+   commons-logging-1.0.4.jar;commons-scxml-1.0-SNAPSHOT.jar;
+   commons-el-1.0.jar;jsp-api-2.0.jar
+
+   org.apache.commons.scxml.env.jsp.Standalone 
+
+   microwave01.xml
+   </pre>
+
+   <p>with the correct local paths to the <code>jar</code> files and the XML
+   (SCXML) document (and without the line breaks). You could set up something
+   more elegant (a script, an ant task etc.), but that is what it boils down 
+   to. If the document is a well-formed SCXML document, you will be able to 
+   type ? or help at the console and you can follow the directions thereafter 
+   (to simulate events, set variable values, reset the state machine or quit).
+   </p>
+
+   <p>A few examples are available as part of the 
+   <a href="http://svn.apache.org/repos/asf/jakarta/commons/sandbox/scxml/trunk/src/test/java/org/apache/commons/scxml/">
+   Commons SCXML test suite</a>.</p>
+
+  </section> 
+
+ </body>
+
+</document>

Propchange: jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/testing-standalone.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: jakarta/commons/sandbox/scxml/trunk/xdocs/api-notes/testing-standalone.xml
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Modified: jakarta/commons/sandbox/scxml/trunk/xdocs/index.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/scxml/trunk/xdocs/index.xml?rev=321286&r1=321285&r2=321286&view=diff
==============================================================================
--- jakarta/commons/sandbox/scxml/trunk/xdocs/index.xml (original)
+++ jakarta/commons/sandbox/scxml/trunk/xdocs/index.xml Fri Oct 14 21:01:42 2005
@@ -67,6 +67,7 @@
       <li>The <a href="http://cvs.apache.org/builds/jakarta-commons/nightly/commons-scxml">nightly build</a>.</li>
       <li>The <a href="http://wiki.apache.org/jakarta-commons/SCXML">wiki</a>.</li>
       <li>Commons SCXML <a href="usecases.html">usecases</a> (case studies).</li>
+      <li>Assorted <a href="api-notes.html">API notes</a> (tutorials).</li>
     </ul>
   </p>
  </section>

Modified: jakarta/commons/sandbox/scxml/trunk/xdocs/navigation.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/scxml/trunk/xdocs/navigation.xml?rev=321286&r1=321285&r2=321286&view=diff
==============================================================================
--- jakarta/commons/sandbox/scxml/trunk/xdocs/navigation.xml (original)
+++ jakarta/commons/sandbox/scxml/trunk/xdocs/navigation.xml Fri Oct 14 21:01:42 2005
@@ -32,6 +32,27 @@
 
       </item>
 
+      <item       name="API notes"
+                  href="/api-notes.html"
+              collapse="true">
+
+        <item     name="SCXML Digester"  
+                  href="/api-notes/core-digester.html" />
+
+        <item     name="SCXML Engine"  
+                  href="/api-notes/core-engine.html" />
+
+        <item     name="Triggering Events"  
+                  href="/api-notes/core-events.html" />
+
+        <item     name="Standalone Testing"  
+                  href="/api-notes/testing-standalone.html" />
+
+        <item     name="Side Effect - EL"  
+                  href="/api-notes/side-effect-el.html" />
+
+      </item>
+
     </menu>
 
     &common-menus;



---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org