You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@cocoon.apache.org by jo...@apache.org on 2003/05/31 01:05:40 UTC
cvs commit: cocoon-2.1/src/documentation/xdocs/userdocs/flow api.xml jpath.xml velocity.xml views.xml
joerg 2003/05/30 16:05:39
Modified: src/documentation/xdocs/userdocs/flow api.xml jpath.xml
velocity.xml views.xml
Log:
fixed broken files, please do "build validate-xdocs" the next time ;-)
Revision Changes Path
1.10 +176 -176 cocoon-2.1/src/documentation/xdocs/userdocs/flow/api.xml
Index: api.xml
===================================================================
RCS file: /home/cvs/cocoon-2.1/src/documentation/xdocs/userdocs/flow/api.xml,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- api.xml 30 May 2003 15:48:08 -0000 1.9
+++ api.xml 30 May 2003 23:05:32 -0000 1.10
@@ -1,176 +1,176 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" "../../dtd/document-v10.dtd">
-
-<document>
- <header>
- <title>Advanced Control Flow</title>
- <authors>
- <person name="Ovidiu Predescu" email="ovidiu@apache.org"/>
- <person name="Christopher Oliver" email="coliver@apache.org"/>
- </authors>
- </header>
-
- <body>
- <s1 title="JavaScript API">
- <p>Cocoon provides a JavaScript API to manage control flow based on an <link href="http://cvs.cocoondev.org/cgi-bin/viewcvs.cgi/?cvsroot=rhino">extended</link> version of <link href="http://www.mozilla.org/rhino">Mozilla Rhino</link> that supports continuations.</p>
- </s1>
- <s1 title="Functions">
- <s2 title = "sendPage"><anchor id="sendPage"/>
- <p>
- <em>Function</em> <code>sendPage([String] uri, [Object] bean)</code>
- </p>
- <p>
- Passes control to the Cocoon sitemap to generate the output page.
- </p>
- <p>
- <code>uri</code> is the relative URL of the page to be sent back to the client.
- </p>
- <p>
- <code>bean</code> is a context object which can be accessed inside this page to extract various values and place them in the generated page.
- </p>
- </s2>
- <s2 title = "sendPageAndWait"><anchor id="sendPageAndWait"/>
- <p>
- <em>Function</em> <code>[WebContinuation] sendPageAndWait([String] uri, [Object] bean, [Number] timeToLive)</code>
- </p>
- <p>
- Passes control to the Cocoon sitemap to generate the output page.
- </p>
- <p>The flow script is suspended after the page is generated and the whole execution stack saved in the WebContinuation object returned from this function. </p>
- <p> <code>uri</code> is the relative URL of the page to be sent back to the client. <code>bean</code> is a context object which can be accessed inside this page to extract various values and place them in the generated page.</p>
- <p><code>timeToLive</code> is the time to live in milliseconds for the continuation created.</p>
- <p>The return value is the <link href="#WebContinuation">continuation</link> object.</p>
- </s2>
- </s1>
- <s1 title="Objects">
- <s2 title = "cocoon">
- <p>The <code>cocoon</code> object represents the current Cocoon sitemap and provides the following readonly properties:</p>
- <s3 title="request">
- <p>The current Cocoon request:</p>
- <p>
- <em>Property</em> <code>[<link href="../../../api/java/org/apache/cocoon/environment/Request.html">org.apache.cocoon.environment.Request</link>] request</code>
- </p>
- </s3>
- <s3 title="response">
- <p>The current Cocoon response:</p>
- <p>
- <em>Property</em> <code>[<link href="../../../api/java/org/apache/cocoon/environment/Response.html">org.apache.cocoon.environment.Response</link>] response</code>
- </p>
- </s3>
- <s3 title="session">
- <p>The current Cocoon session:</p>
- <p>
- <em>Property</em> <code>[<link href="../../../api/java/org/apache/cocoon/environment/Session.html">org.apache.cocoon.environment.Session</link>] session</code>
- </p>
- </s3>
- <s3 title="context">
- <p>The current Cocoon application context:</p>
- <p>
- <em>Property</em> <code>[<link href="../../../api/java/org/apache/cocoon/environment/Context.html">org.apache.cocoon.environment.Context</link>] context</code>
- </p>
- </s3>
- <s3 title="environment">
- <p>The current Cocoon environment:</p>
- <p>
- <em>Property</em> <code>[<link href="../../../api/java/org/apache/cocoon/environment/Environment.html">org.apache.cocoon.environment.Environment</link>] environment</code>
- </p>
- </s3>
- <s3 title="componentManager">
- <p>The current Sitemap's component manager:</p>
- <p>
- <em>Property</em> <code>[org.apache.avalon.framework.component.ComponentManager] componentManager</code>
- </p>
- </s3>
- <s3 title="parameters">
- <p>Any parameters passed to the script by the Sitemap:</p>
- <p>
- <em>Property</em> <code>[Array [org.apache.avalon.framework.parameters.Parameters]] parameters</code>
- </p>
- <p>The <code>cocoon</code> object also provides the following functions:</p>
- </s3>
- <s3 title="process">
- <p>
- <em>Function</em> <code>[Boolean] process([String] uri, [Object] bizData, [java.io.OutputStream] stream)</code></p>
- <p>
- Call the Cocoon sitemap for the given URI, sending the output of the
- eventually matched pipeline to the specified <code>OutputStream</code>.</p>
- <p><code>uri</code> is the URI for which the request should be generated.</p>
- <p><code>bizData</code> is the business data object
- to be made available to the forwarded pipeline</p>
- <p><code>stream</code> is an <code>OutputStream</code> where the output should be written to.</p>
- <p>Returns the result from the Cocoon processor.
- </p>
- </s3>
- <s3 title="createSession"><anchor id="createSession"/>
-
- <p> <em>Function</em> <code>createSession()</code></p>
- <p>
- Associate the current set of JavaScript global variables with the user's session. This means that all invocations from the
- sitemap of a JavaScript function (using the <link href="sitemap.html#callFunction"><map:call
- function="..."></link>), will share global JavaScript variables.
- </p>
-
- </s3>
- <s3 title="removeSession">
- <p>
- <em>Function</em> <code>removeSession()</code>
- </p>
- <p>
- Dissociate global JavaScript variables from the user's session.
- </p>
- </s3>
- <s3 title="load">
- <p><em>Function</em> <code>load([String] uri)</code></p>
- <p>
- Load the JavaScript script specified by <code>uri</code>. The Cocoon
- source resolver is used to resolve <code>uri</code>.
- </p>
- </s3>
- </s2>
- <s2 title="WebContinuation"><anchor id="WebContinuation"/>
- <p>A <code>WebContinuation</code> represents a continuation of a Flowscript. Because a user may click on the back button in the browser and restart a saved computation in a continuation, each <code>WebContinuation</code> becomes the parent of a subtree of continuations.
- </p>
- <p>
- If there is no parent <code>WebContinuation</code>, the created continuation becomes the root of a tree of <code>WebContinuation</code>s.
- </p>
- <p>
- <code>WebContinuation</code> objects support the following functions and properties:
- </p>
- <s3 title="getContinuation">
- <p>
- <em>Function</em> <code>[WebContinuation] getContinuation([Number] level)</code>
- </p>
- <p>
- Return the ancestor continuation situated <code>level</code>s
- above the current continuation. The current instance is
- considered to be at level 0. The parent continuation of the
- receiving instance at level 1, its parent is at level 2 relative
- to the receiving instance. If <code>level</code> is bigger than
- the depth of the tree, the root of the tree is returned.
-
- </p>
- </s3>
- <s3 title="invalidate">
- <p>
- <em>Function</em> <code>invalidate()</code>
- </p>
- <p>
- Invalidates a <code>WebContinuation</code>. This effectively
- means that the continuation object associated with it will no
- longer be accessible from Web pages. Invalidating a
- <code>WebContinuation</code> invalidates all the
- <code>WebContinuation</code>s which are children of it.
- </p>
- </s3>
- <s3 title="id">
- <p>
- <em>Property</em> <code>[String] id</code>
- </p>
- <p>
- Returns the unique string identifier of this continuation
- </p>
- </s3>
- </s2>
- </s1>
- </body>
-</document>
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" "../../dtd/document-v10.dtd">
+
+<document>
+ <header>
+ <title>Advanced Control Flow</title>
+ <authors>
+ <person name="Ovidiu Predescu" email="ovidiu@apache.org"/>
+ <person name="Christopher Oliver" email="coliver@apache.org"/>
+ </authors>
+ </header>
+
+ <body>
+ <s1 title="JavaScript API">
+ <p>Cocoon provides a JavaScript API to manage control flow based on an
+ <link href="http://cvs.cocoondev.org/cgi-bin/viewcvs.cgi/?cvsroot=rhino">extended</link>
+ version of <link href="http://www.mozilla.org/rhino">Mozilla Rhino</link> that supports continuations.</p>
+ </s1>
+ <s1 title="Functions">
+ <s2 title = "sendPage"><anchor id="sendPage"/>
+ <p>
+ <em>Function</em> <code>sendPage([String] uri, [Object] bean)</code>
+ </p>
+ <p>
+ Passes control to the Cocoon sitemap to generate the output page.
+ </p>
+ <p>
+ <code>uri</code> is the relative URL of the page to be sent back to the client.
+ </p>
+ <p>
+ <code>bean</code> is a context object which can be accessed inside this page to extract
+ various values and place them in the generated page.
+ </p>
+ </s2>
+ <s2 title = "sendPageAndWait"><anchor id="sendPageAndWait"/>
+ <p>
+ <em>Function</em> <code>[WebContinuation] sendPageAndWait([String] uri, [Object] bean, [Number] timeToLive)</code>
+ </p>
+ <p>
+ Passes control to the Cocoon sitemap to generate the output page.
+ </p>
+ <p>The flow script is suspended after the page is generated and the whole execution stack
+ saved in the WebContinuation object returned from this function. </p>
+ <p><code>uri</code> is the relative URL of the page to be sent back to the client.
+ <code>bean</code> is a context object which can be accessed inside this page to extract
+ various values and place them in the generated page.</p>
+ <p><code>timeToLive</code> is the time to live in milliseconds for the continuation created.</p>
+ <p>The return value is the <link href="#WebContinuation">continuation</link> object.</p>
+ </s2>
+ </s1>
+ <s1 title="Objects">
+ <s2 title = "cocoon">
+ <p>The <code>cocoon</code> object represents the current Cocoon sitemap and provides the following readonly properties:</p>
+ <s3 title="request">
+ <p>The current Cocoon request:</p>
+ <p>
+ <em>Property</em> <code>[</code><link href="../../../api/java/org/apache/cocoon/environment/Request.html"><code>org.apache.cocoon.environment.Request</code></link><code>] request</code>
+ </p>
+ </s3>
+ <s3 title="response">
+ <p>The current Cocoon response:</p>
+ <p>
+ <em>Property</em> <code>[</code><link href="../../../api/java/org/apache/cocoon/environment/Response.html"><code>org.apache.cocoon.environment.Response</code></link><code>] response</code>
+ </p>
+ </s3>
+ <s3 title="session">
+ <p>The current Cocoon session:</p>
+ <p>
+ <em>Property</em> <code>[</code><link href="../../../api/java/org/apache/cocoon/environment/Session.html"><code>org.apache.cocoon.environment.Session</code></link><code>] session</code>
+ </p>
+ </s3>
+ <s3 title="context">
+ <p>The current Cocoon application context:</p>
+ <p>
+ <em>Property</em> <code>[</code><link href="../../../api/java/org/apache/cocoon/environment/Context.html"><code>org.apache.cocoon.environment.Context</code></link><code>] context</code>
+ </p>
+ </s3>
+ <s3 title="environment">
+ <p>The current Cocoon environment:</p>
+ <p>
+ <em>Property</em> <code>[</code><link href="../../../api/java/org/apache/cocoon/environment/Environment.html"><code>org.apache.cocoon.environment.Environment</code></link><code>] environment</code>
+ </p>
+ </s3>
+ <s3 title="componentManager">
+ <p>The current Sitemap's component manager:</p>
+ <p>
+ <em>Property</em> <code>[org.apache.avalon.framework.component.ComponentManager] componentManager</code>
+ </p>
+ </s3>
+ <s3 title="parameters">
+ <p>Any parameters passed to the script by the Sitemap:</p>
+ <p>
+ <em>Property</em> <code>[Array [org.apache.avalon.framework.parameters.Parameters]] parameters</code>
+ </p>
+ <p>The <code>cocoon</code> object also provides the following functions:</p>
+ </s3>
+ <s3 title="process">
+ <p>
+ <em>Function</em> <code>[Boolean] process([String] uri, [Object] bizData, [java.io.OutputStream] stream)</code></p>
+ <p>
+ Call the Cocoon sitemap for the given URI, sending the output of the
+ eventually matched pipeline to the specified <code>OutputStream</code>.</p>
+ <p><code>uri</code> is the URI for which the request should be generated.</p>
+ <p><code>bizData</code> is the business data object
+ to be made available to the forwarded pipeline</p>
+ <p><code>stream</code> is an <code>OutputStream</code> where the output should be written to.</p>
+ <p>Returns the result from the Cocoon processor.
+ </p>
+ </s3>
+ <s3 title="createSession"><anchor id="createSession"/>
+ <p><em>Function</em> <code>createSession()</code></p>
+ <p>
+ Associate the current set of JavaScript global variables with the user's session. This means
+ that all invocations from the sitemap of a JavaScript function (using the
+ <link href="sitemap.html#callFunction"><map:call function="..."></link>), will share
+ global JavaScript variables.
+ </p>
+ </s3>
+ <s3 title="removeSession">
+ <p>
+ <em>Function</em> <code>removeSession()</code>
+ </p>
+ <p>
+ Dissociate global JavaScript variables from the user's session.
+ </p>
+ </s3>
+ <s3 title="load">
+ <p><em>Function</em> <code>load([String] uri)</code></p>
+ <p>
+ Load the JavaScript script specified by <code>uri</code>. The Cocoon
+ source resolver is used to resolve <code>uri</code>.
+ </p>
+ </s3>
+ </s2>
+ <s2 title="WebContinuation"><anchor id="WebContinuation"/>
+ <p>A <code>WebContinuation</code> represents a continuation of a Flowscript. Because a user may click on the back button in the browser and restart a saved computation in a continuation, each <code>WebContinuation</code> becomes the parent of a subtree of continuations.
+ </p>
+ <p>
+ If there is no parent <code>WebContinuation</code>, the created continuation becomes the root of a tree of <code>WebContinuation</code>s.
+ </p>
+ <p>
+ <code>WebContinuation</code> objects support the following functions and properties:
+ </p>
+ <s3 title="getContinuation">
+ <p>
+ <em>Function</em> <code>[WebContinuation] getContinuation([Number] level)</code>
+ </p>
+ <p>
+ Return the ancestor continuation situated <code>level</code>s
+ above the current continuation. The current instance is
+ considered to be at level 0. The parent continuation of the
+ receiving instance at level 1, its parent is at level 2 relative
+ to the receiving instance. If <code>level</code> is bigger than
+ the depth of the tree, the root of the tree is returned.
+ </p>
+ </s3>
+ <s3 title="invalidate">
+ <p>
+ <em>Function</em> <code>invalidate()</code>
+ </p>
+ <p>
+ Invalidates a <code>WebContinuation</code>. This effectively
+ means that the continuation object associated with it will no
+ longer be accessible from Web pages. Invalidating a
+ <code>WebContinuation</code> invalidates all the
+ <code>WebContinuation</code>s which are children of it.
+ </p>
+ </s3>
+ <s3 title="id">
+ <p><em>Property</em> <code>[String] id</code></p>
+ <p>Returns the unique string identifier of this continuation</p>
+ </s3>
+ </s2>
+ </s1>
+ </body>
+</document>
1.9 +111 -107 cocoon-2.1/src/documentation/xdocs/userdocs/flow/jpath.xml
Index: jpath.xml
===================================================================
RCS file: /home/cvs/cocoon-2.1/src/documentation/xdocs/userdocs/flow/jpath.xml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- jpath.xml 30 May 2003 16:06:06 -0000 1.8
+++ jpath.xml 30 May 2003 23:05:32 -0000 1.9
@@ -1,107 +1,111 @@
-<?xml version='1.0' encoding='ISO-8859-1'?>
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN"
-"../../dtd/document-v10.dtd">
-<document>
- <header>
- <title>Advanced Control Flow</title>
- <authors>
- <person name="Christopher Oliver" email="coliver@apache.org" />
- <person name="Ovidiu Predescu" email="ovidiu@apache.org" />
- </authors>
- </header>
-<body>
- <s1 title="JPath Logic Sheet">
- <p>
-The JPath Logic Sheet is an <link href="../xsp/index.html">XSP</link> logic sheet that allows you to access data from a Cocoon Flowscript in an XSP page and inject it into a Cocoon pipeline. It provides a set of tags (similar to the those defined by <link href="http://www.w3.org/TR/xslt">XSLT</link>) that allow you to iterate over Java collections (and Java or JavaScript arrays) and to test for the presence of optional or alternate bean properties. It is based on <link href="http://jakarta.apache.org/commons/jxpath">Apache JXPath</link>.
- </p>
-</s1>
-<s1 title ="Tags">
-<p>The JPath tags are defined in the namespace</p>
-<source>
-http://apache.org/xsp/jpath/1.0
-</source>
-<s2 title ="if">
-<p>The <code>if</code> tag allows the conditional execution of its body
-according to value of a <code>test</code> attribute:</p>
-<source>
- <if test="XPathExpression">
- body
- </if>
-</source>
-<p>Example:</p>
-<source>
-<jpath:if test="cart/numberOfItems = 0">
- Your cart is empty
-</jpath:if>
-</source>
-</s2>
-<s2 title ="choose">
-<p>The <code>choose</code> tag performs conditional block execution by the
-embedded <code>when</code> sub tags. It renders the body of the first
-<code>when</code> tag whose <code>test</code> condition evaluates to true.
-If none of the <code>test</code> conditions of nested <code>when</code> tags
-evaluate to <code>true</code>, then the body of an <code>otherwise</code>
-tag is evaluated, if present:</p>
-<source>
- <choose>
- <when test="XPathExpression">
- body
- </when>+
- <otherwise>
- body
- </otherwise>?
- </choose>
-</source>
-<p>Example:</p>
-<source>
-<choose>
- <when test="not(user/loggedIn)">
- You're not logged in
- </when>
- <otherwise>
- You're already logged in
- </otherwise>
-</choose>
-</source>
-</s2>
-<s2 title="value-of">
-<p>The <code>value-of</code> tag evaluates an expression and outputs
-the result of the evaluation:</p>
-<source>
-<value-of select="XPathExpression"/>
-</source>
-<p>Example:</p>
-<source>
-<value-of select="cart/numberOfItems">
-</source>
-</s2>
-<s2 title="for-each">
-<p>The <code>for-each</code> tag allows you to iterate over a collection
-of objects:</p>
-<source>
- <for-each select="XPathExpression">
- body
- </for-each>
-</source>
-<p>When using XPath expressions within <code>for-each</code> the current element is the context node and can be referenced with XPath dot operator:
-<source>.</source></p>
-<p>Example:</p>
-<source>
-<for-each select="cart/cartItems[position() <= $count]">
- <td><value-of select="./productId"></td>
-</for-each>
-</source>
-</s2>
-<s2 title="continuation">
-<p>The <code>continuation</code> tag returns the id of the current web continuation of your Flowscript. You can refer to previous continuations by supplying the optional <code>level</code> attribute. Zero is the current level, <code>-1</code> refers to the previous continuation, and so on.</p>
-<source>
-<continuation [level="Number"]/>
-</source>
-<p>Example:</p>
-<source>
-<xsp:attribute name="action"><xsp:expr><jpath:continuation/>+".form"</xsp:expr></xsp:attribute>
-</source>
-</s2>
-</s1>
-</body>
-</document>
+<?xml version='1.0' encoding='ISO-8859-1'?>
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" "../../dtd/document-v10.dtd">
+<document>
+ <header>
+ <title>Advanced Control Flow</title>
+ <authors>
+ <person name="Christopher Oliver" email="coliver@apache.org"/>
+ <person name="Ovidiu Predescu" email="ovidiu@apache.org"/>
+ </authors>
+ </header>
+ <body>
+ <s1 title="JPath Logic Sheet">
+ <p>
+ The JPath Logic Sheet is an <link href="../xsp/index.html">XSP</link> logic sheet that allows
+ you to access data from a Cocoon Flowscript in an XSP page and inject it into a Cocoon
+ pipeline. It provides a set of tags (similar to the those defined by
+ <link href="http://www.w3.org/TR/xslt">XSLT</link>) that allow you to iterate over Java
+ collections (and Java or JavaScript arrays) and to test for the presence of optional or
+ alternate bean properties. It is based on
+ <link href="http://jakarta.apache.org/commons/jxpath">Apache JXPath</link>.
+ </p>
+ </s1>
+ <s1 title ="Tags">
+ <p>The JPath tags are defined in the namespace</p>
+ <source>http://apache.org/xsp/jpath/1.0</source>
+ <s2 title ="if">
+ <p>The <code>if</code> tag allows the conditional execution of its body according to value of
+ a <code>test</code> attribute:</p>
+ <source>
+<if test="XPathExpression">
+ body
+</if>
+ </source>
+ <p>Example:</p>
+ <source>
+<jpath:if test="cart/numberOfItems = 0">
+ Your cart is empty
+</jpath:if>
+ </source>
+ </s2>
+ <s2 title ="choose">
+ <p>The <code>choose</code> tag performs conditional block execution by the embedded
+ <code>when</code> sub tags. It renders the body of the first <code>when</code> tag whose
+ <code>test</code> condition evaluates to true. If none of the <code>test</code> conditions
+ of nested <code>when</code> tags evaluate to <code>true</code>, then the body of an
+ <code>otherwise</code> tag is evaluated, if present:</p>
+ <source>
+<choose>
+ <when test="XPathExpression">
+ body
+ </when>
+ <otherwise>
+ body
+ </otherwise>?
+</choose>
+ </source>
+ <p>Example:</p>
+ <source>
+<choose>
+ <when test="not(user/loggedIn)">
+ You're not logged in
+ </when>
+ <otherwise>
+ You're already logged in
+ </otherwise>
+</choose>
+ </source>
+ </s2>
+ <s2 title="value-of">
+ <p>The <code>value-of</code> tag evaluates an expression and outputs the result of the evaluation:</p>
+ <source>
+<value-of select="XPathExpression"/>
+ </source>
+ <p>Example:</p>
+ <source>
+<value-of select="cart/numberOfItems">
+ </source>
+ </s2>
+ <s2 title="for-each">
+ <p>The <code>for-each</code> tag allows you to iterate over a collection of objects:</p>
+ <source>
+<for-each select="XPathExpression">
+ body
+</for-each>
+ </source>
+ <p>When using XPath expressions within <code>for-each</code> the current element is the
+ context node and can be referenced with XPath dot operator:</p>
+ <source>.</source>
+ <p>Example:</p>
+ <source>
+<for-each select="cart/cartItems[position() <= $count]">
+ <td><value-of select="./productId"></td>
+</for-each>
+ </source>
+ </s2>
+ <s2 title="continuation">
+ <p>The <code>continuation</code> tag returns the id of the current web continuation of your
+ Flowscript. You can refer to previous continuations by supplying the optional
+ <code>level</code> attribute. Zero is the current level, <code>-1</code> refers to the
+ previous continuation, and so on.</p>
+ <source>
+<continuation [level="Number"]/>
+ </source>
+ <p>Example:</p>
+ <source>
+<xsp:attribute name="action"><xsp:expr><jpath:continuation/>+".form"</xsp:expr></xsp:attribute>
+ </source>
+ </s2>
+ </s1>
+ </body>
+</document>
1.7 +44 -46 cocoon-2.1/src/documentation/xdocs/userdocs/flow/velocity.xml
Index: velocity.xml
===================================================================
RCS file: /home/cvs/cocoon-2.1/src/documentation/xdocs/userdocs/flow/velocity.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- velocity.xml 30 May 2003 16:06:06 -0000 1.6
+++ velocity.xml 30 May 2003 23:05:32 -0000 1.7
@@ -1,46 +1,44 @@
-<?xml version='1.0' encoding='ISO-8859-1'?>
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN"
-"../../dtd/document-v10.dtd">
-<document>
- <header>
- <title>Advanced Control Flow</title>
- <authors>
- <person name="Christopher Oliver" email="coliver@apache.org" />
- <person name="Ovidiu Predescu" email="ovidiu@apache.org" />
- </authors>
- </header>
-<body>
- <s1 title="Velocity Generator">
- <p>
-If called from a Flowscript, the Cocoon <link href="http://jakarta.apache.org/velocity">Velocity</link> <link href="../generators/velocity-generator.html">Generator</link> provides access to the immediate properties of the context object passed to <code><link href="api.html#sendPage">sendPage</link></code> and <code><link href="api.html#sendPageAndWait">sendPageAndWait</link></code>. In that case, the current <code><link href="api.html#WebContinuation">WebContinuation</link></code> is also available as a variable named <code>$continuation</code>
- You would
-typically access its <code>id</code>:</p>
-<source>
- <form action="$continuation.id">
-</source>
-<p>You can also reach previous continuations by using the <code>getContinuation()</code> function:</p>
-<source>
- <form action="$continuation.getContinuation(1).id" >
-</source>
-
-<p>In addition the following implicit objects are always available in
-the Velocity context:</p>
-<dl>
-<dt><code>$request</code> (<code>org.apache.cocoon.environment.Request</code>)</dt>
-<dd>The current Cocoon request</dd>
-
-<dt><code>$response</code> (<code>org.apache.cocoon.environment.Response</code>)</dt>
-<dd>The Cocoon response associated with the current request</dd>
-
-<dt><code>$session</code> (<code>org.apache.cocoon.environment.Session</code>)</dt>
-<dd>The Cocoon session associated with the current request</dd>
-
-<dt><code>$context</code> (<code>org.apache.cocoon.environment.Context</code>)</dt>
-<dd>The Cocoon context associated with the current request</dd>
-
-<dt><code>$parameters</code> (<code>org.apache.avalon.framework.parameters.Parameters</code>)</dt>
-<dd>Any parameters passed to the generator in the pipeline</dd>
-</dl>
-</s1>
-</body>
-</document>
+<?xml version='1.0' encoding='ISO-8859-1'?>
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" "../../dtd/document-v10.dtd">
+<document>
+ <header>
+ <title>Advanced Control Flow</title>
+ <authors>
+ <person name="Christopher Oliver" email="coliver@apache.org" />
+ <person name="Ovidiu Predescu" email="ovidiu@apache.org" />
+ </authors>
+ </header>
+ <body>
+ <s1 title="Velocity Generator">
+ <p>If called from a Flowscript, the Cocoon
+ <link href="http://jakarta.apache.org/velocity">Velocity</link>
+ <link href="../generators/velocity-generator.html">Generator</link>
+ provides access to the immediate properties of the context object passed to
+ <link href="api.html#sendPage"><code>sendPage</code></link> and
+ <link href="api.html#sendPageAndWait"><code>sendPageAndWait</code></link>. In that case,
+ the current <link href="api.html#WebContinuation"><code>WebContinuation</code></link>
+ is also available as a variable named <code>$continuation</code>. You would typically access
+ its <code>id</code>:</p>
+ <source>
+ <form action="$continuation.id">
+ </source>
+ <p>You can also reach previous continuations by using the <code>getContinuation()</code> function:</p>
+ <source>
+ <form action="$continuation.getContinuation(1).id" >
+ </source>
+ <p>In addition the following implicit objects are always available in the Velocity context:</p>
+ <dl>
+ <dt><code>$request</code> (<code>org.apache.cocoon.environment.Request</code>)</dt>
+ <dd>The current Cocoon request</dd>
+ <dt><code>$response</code> (<code>org.apache.cocoon.environment.Response</code>)</dt>
+ <dd>The Cocoon response associated with the current request</dd>
+ <dt><code>$session</code> (<code>org.apache.cocoon.environment.Session</code>)</dt>
+ <dd>The Cocoon session associated with the current request</dd>
+ <dt><code>$context</code> (<code>org.apache.cocoon.environment.Context</code>)</dt>
+ <dd>The Cocoon context associated with the current request</dd>
+ <dt><code>$parameters</code> (<code>org.apache.avalon.framework.parameters.Parameters</code>)</dt>
+ <dd>Any parameters passed to the generator in the pipeline</dd>
+ </dl>
+ </s1>
+ </body>
+</document>
1.5 +27 -27 cocoon-2.1/src/documentation/xdocs/userdocs/flow/views.xml
Index: views.xml
===================================================================
RCS file: /home/cvs/cocoon-2.1/src/documentation/xdocs/userdocs/flow/views.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- views.xml 30 May 2003 16:06:06 -0000 1.4
+++ views.xml 30 May 2003 23:05:32 -0000 1.5
@@ -1,27 +1,27 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" "../../dtd/document-v10.dtd">
-
-<document>
- <header>
- <title>Advanced Control Flow</title>
- <authors>
- <person name="Ovidiu Predescu" email="ovidiu@apache.org"/>
- <person name="Christopher Oliver" email="coliver@apache.org"/>
- </authors>
- </header>
-
- <body>
- <s1 title="Flowscript-aware Generators">
-<p>
-The second argument to <code><link href="api.html#sendPage">sendPage</link></code> and <code><link href="api.html#sendPageAndWait">sendPageAndWait</link></code> is a context object, which can be a simple dictionary with values that need to be displayed by the View. More generally any Java or JavaScript object can be passed here, as long as the necessary get methods for the important values are provided.
-</p>
-<p>
-The page specified by the URL is processed by the sitemap, using the normal sitemap rules.
-</p>
-<p>
-Several Cocoon generators are provided that allow you to access the context object and inject its values into a pipeline. Currently, these are the <link href="jxtemplate.html">JXTemplate Generator</link>, <link href="jpath.html">JPath XSP Logic Sheet</link>, and <link href="velocity.html">Velocity Generator</link>.
-</p>
- </s1>
-
- </body>
-</document>
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" "../../dtd/document-v10.dtd">
+<document>
+ <header>
+ <title>Advanced Control Flow</title>
+ <authors>
+ <person name="Ovidiu Predescu" email="ovidiu@apache.org"/>
+ <person name="Christopher Oliver" email="coliver@apache.org"/>
+ </authors>
+ </header>
+ <body>
+ <s1 title="Flowscript-aware Generators">
+ <p>The second argument to <link href="api.html#sendPage"><code>sendPage</code></link> and
+ <link href="api.html#sendPageAndWait"><code>sendPageAndWait</code></link> is a context object,
+ which can be a simple dictionary with values that need to be displayed by the View. More
+ generally any Java or JavaScript object can be passed here, as long as the necessary get
+ methods for the important values are provided.</p>
+ <p>The page specified by the URL is processed by the sitemap, using the normal sitemap rules.</p>
+ <p>Several Cocoon generators are provided that allow you to access the context object and inject
+ its values into a pipeline. Currently, these are the
+ <link href="jxtemplate.html">JXTemplate Generator</link>,
+ <link href="jpath.html">JPath XSP Logic Sheet</link> and
+ <link href="velocity.html">Velocity Generator</link>.
+ </p>
+ </s1>
+ </body>
+</document>