Return-Path: 
 <cvs-return-34014-apmail-cocoon-cvs-archive=cocoon.apache.org@cocoon.apache.org>
Delivered-To: apmail-cocoon-cvs-archive@www.apache.org
Received: (qmail 95256 invoked from network); 13 Jan 2009 17:11:08 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2)
  by minotaur.apache.org with SMTP; 13 Jan 2009 17:11:08 -0000
Received: (qmail 10450 invoked by uid 500); 13 Jan 2009 17:11:07 -0000
Delivered-To: apmail-cocoon-cvs-archive@cocoon.apache.org
Received: (qmail 10390 invoked by uid 500); 13 Jan 2009 17:11:07 -0000
Mailing-List: contact cvs-help@cocoon.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@cocoon.apache.org
list-help: <mailto:cvs-help@cocoon.apache.org>
list-unsubscribe: <mailto:cvs-unsubscribe@cocoon.apache.org>
List-Post: <mailto:cvs@cocoon.apache.org>
List-Id: <cvs.cocoon.apache.org>
Delivered-To: mailing list cvs@cocoon.apache.org
Received: (qmail 10371 invoked by uid 99); 13 Jan 2009 17:11:07 -0000
Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230)
    by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 13 Jan 2009 09:11:07 -0800
X-ASF-Spam-Status: No, hits=-2000.0 required=10.0
	tests=ALL_TRUSTED
X-Spam-Check-By: apache.org
Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4)
    by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 13 Jan 2009 17:10:56 +0000
Received: by eris.apache.org (Postfix, from userid 65534)
	id AE8A5238895D; Tue, 13 Jan 2009 09:10:34 -0800 (PST)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r734183 [1/2] - in /cocoon/site/site/3.0: ./ reference/
 reference/html-single/ reference/html-single/css/ reference/html/
 reference/html/css/ reference/pdf/
Date: Tue, 13 Jan 2009 17:10:16 -0000
To: cvs@cocoon.apache.org
From: reinhard@apache.org
X-Mailer: svnmailer-1.0.8
Message-Id: <20090113171034.AE8A5238895D@eris.apache.org>
X-Virus-Checked: Checked by ClamAV on apache.org

Author: reinhard
Date: Tue Jan 13 09:10:04 2009
New Revision: 734183

URL: http://svn.apache.org/viewvc?rev=734183&view=rev
Log:
update docs for the upcoming release

Modified:
    cocoon/site/site/3.0/building.html
    cocoon/site/site/3.0/changes-report.html
    cocoon/site/site/3.0/dependencies.html
    cocoon/site/site/3.0/download.html
    cocoon/site/site/3.0/features.html
    cocoon/site/site/3.0/index.html
    cocoon/site/site/3.0/integration.html
    cocoon/site/site/3.0/issue-tracking.html
    cocoon/site/site/3.0/license.html
    cocoon/site/site/3.0/mail-lists.html
    cocoon/site/site/3.0/project-info.html
    cocoon/site/site/3.0/project-reports.html
    cocoon/site/site/3.0/project-summary.html
    cocoon/site/site/3.0/reference/html-single/css/html.css
    cocoon/site/site/3.0/reference/html-single/index.html
    cocoon/site/site/3.0/reference/html/css/html.css
    cocoon/site/site/3.0/reference/html/index.html
    cocoon/site/site/3.0/reference/html/introduction.html
    cocoon/site/site/3.0/reference/html/pipelines.html
    cocoon/site/site/3.0/reference/index.html
    cocoon/site/site/3.0/reference/pdf/cocoon3-reference.pdf
    cocoon/site/site/3.0/roadmap.html
    cocoon/site/site/3.0/source-repository.html
    cocoon/site/site/3.0/team-list.html

Modified: cocoon/site/site/3.0/building.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/3.0/building.html?rev=734183&r1=734182&r2=734183&view=diff
==============================================================================
--- cocoon/site/site/3.0/building.html (original)
+++ cocoon/site/site/3.0/building.html Tue Jan 13 09:10:04 2009
@@ -69,9 +69,9 @@
            <h1 class="projectTitle"><a href="./index.html">  Cocoon 3
   </a></h1>
                          <ul class="projectList">
-                <li><strong><a href="..//2.2/">Cocoon 2.2</a></em></strong></li>
+                <li><strong><a href="../2.2/">Cocoon 2.2</a></em></strong></li>
                 <li><strong><a href="../3.0/">Cocoon 3.0 <span class="pl-version-small">[alpha]</span></a></em></strong></li>                
-                <li><strong><a href="../$project.getProperties().get("docs.m.site-subprojects.relPath")">Subprojects</a></strong></li>
+                <li><strong><a href="../subprojects/">Subprojects</a></strong></li>
               </ul>              
                     </div>
          <div class="projectBarClear"><!-- --></div>
@@ -97,10 +97,6 @@
         </li>
                   
     <li >
-              <a href="reference/index.html">Userguide</a>
-        </li>
-                  
-    <li >
               <a href="features.html">Features</a>
         </li>
               </ul>
@@ -126,7 +122,7 @@
         </li>
                   
     <li >
-              <a href="api-docs.html">API</a>
+              <a href="apidocs/index.html">API</a>
         </li>
                   
     <li >
@@ -147,7 +143,7 @@
     <!-- end of content -->
     <div id="footer">
       <p>&#169;  
-          2008
+          2008-2009
     
           The Apache Software Foundation
       </p>

Modified: cocoon/site/site/3.0/changes-report.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/3.0/changes-report.html?rev=734183&r1=734182&r2=734183&view=diff
==============================================================================
--- cocoon/site/site/3.0/changes-report.html (original)
+++ cocoon/site/site/3.0/changes-report.html Tue Jan 13 09:10:04 2009
@@ -69,9 +69,9 @@
            <h1 class="projectTitle"><a href="./index.html">  Cocoon 3
   </a></h1>
                          <ul class="projectList">
-                <li><strong><a href="..//2.2/">Cocoon 2.2</a></em></strong></li>
+                <li><strong><a href="../2.2/">Cocoon 2.2</a></em></strong></li>
                 <li><strong><a href="../3.0/">Cocoon 3.0 <span class="pl-version-small">[alpha]</span></a></em></strong></li>                
-                <li><strong><a href="../$project.getProperties().get("docs.m.site-subprojects.relPath")">Subprojects</a></strong></li>
+                <li><strong><a href="../subprojects/">Subprojects</a></strong></li>
               </ul>              
                     </div>
          <div class="projectBarClear"><!-- --></div>
@@ -97,10 +97,6 @@
         </li>
                   
     <li >
-              <a href="reference/index.html">Userguide</a>
-        </li>
-                  
-    <li >
               <a href="features.html">Features</a>
         </li>
               </ul>
@@ -126,7 +122,7 @@
         </li>
                   
     <li >
-              <a href="api-docs.html">API</a>
+              <a href="apidocs/index.html">API</a>
         </li>
                   
     <li >
@@ -140,14 +136,14 @@
     </li>
       </ul>
        <div class="main">
-         <h2><a name="Changes Report"></a>Changes Report</h2><h3><a name="Release History"></a>Release History</h3><table class="bodyTable"><tr class="a"><th>Version</th><th>Date</th><th>Description</th></tr><tr class="b"><td><a href="#a3.0.0-alpha-2-SNAPSHOT">3.0.0-alpha-2-SNAPSHOT</a></td><td>2008-00-00</td><td>unreleased</td></tr><tr class="a"><td><a href="#a3.0.0-alpha-1">3.0.0-alpha-1</a></td><td>2008-00-00</td><td>unreleased</td></tr></table><br /><br /><h3><a name="a3.0.0-alpha-2-SNAPSHOT"></a>Release 3.0.0-alpha-2-SNAPSHOT - 2008-00-00</h3><table class="bodyTable"><tr class="b"><th>Type</th><th>Changes</th><th>By</th></tr><tr class="a"><td><img src="images/fix.gif" alt="fix" /></td><td>[cocoon-sitemap] Make junit-addons a test dependency.</td><td><a href="team-list.html#reinhard">reinhard</a></td></tr></table><h3><a name="a3.0.0-alpha-1"></a>Release 3.0.0-alpha-1 - 2008-00-00</h3><table class="bodyTable"><tr class="b"><th>Type</th><th>Changes</th><th>By</th></tr><tr 
 class="a"><td><img src="images/add.gif" alt="add" /></td><td>Initial creation.</td><td><a href="team-list.html#reinhard">reinhard</a></td></tr></table>
+         <div class="section"><h2><a name="Changes Report"></a>Changes Report</h2><div class="section"><h3><a name="Release History"></a>Release History</h3><table class="bodyTable"><tr class="a"><th>Version</th><th>Date</th><th>Description</th></tr><tr class="b"><td><a href="#a3.0.0-alpha-1">3.0.0-alpha-1</a></td><td>2008-12-18</td><td>released</td></tr></table></div><div class="section"><h3><a name="a3.0.0-alpha-1"></a>Release 3.0.0-alpha-1 - 2008-12-18</h3><table class="bodyTable"><tr class="a"><th>Type</th><th>Changes</th><th>By</th></tr><tr class="b"><td><img src="images/add.gif" alt="add" /></td><td>Initial creation.</td><td><a href="team-list.html#reinhard">reinhard</a></td></tr></table></div></div>
        </div>
     </div>
 
     <!-- end of content -->
     <div id="footer">
       <p>&#169;  
-          2008
+          2008-2009
     
           The Apache Software Foundation
       </p>

Modified: cocoon/site/site/3.0/dependencies.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/3.0/dependencies.html?rev=734183&r1=734182&r2=734183&view=diff
==============================================================================
--- cocoon/site/site/3.0/dependencies.html (original)
+++ cocoon/site/site/3.0/dependencies.html Tue Jan 13 09:10:04 2009
@@ -69,9 +69,9 @@
            <h1 class="projectTitle"><a href="./index.html">  Cocoon 3
   </a></h1>
                          <ul class="projectList">
-                <li><strong><a href="..//2.2/">Cocoon 2.2</a></em></strong></li>
+                <li><strong><a href="../2.2/">Cocoon 2.2</a></em></strong></li>
                 <li><strong><a href="../3.0/">Cocoon 3.0 <span class="pl-version-small">[alpha]</span></a></em></strong></li>                
-                <li><strong><a href="../$project.getProperties().get("docs.m.site-subprojects.relPath")">Subprojects</a></strong></li>
+                <li><strong><a href="../subprojects/">Subprojects</a></strong></li>
               </ul>              
                     </div>
          <div class="projectBarClear"><!-- --></div>
@@ -97,10 +97,6 @@
         </li>
                   
     <li >
-              <a href="reference/index.html">Userguide</a>
-        </li>
-                  
-    <li >
               <a href="features.html">Features</a>
         </li>
               </ul>
@@ -126,7 +122,7 @@
         </li>
                   
     <li >
-              <a href="api-docs.html">API</a>
+              <a href="apidocs/index.html">API</a>
         </li>
                   
     <li >
@@ -147,7 +143,7 @@
     <!-- end of content -->
     <div id="footer">
       <p>&#169;  
-          2008
+          2008-2009
     
           The Apache Software Foundation
       </p>

Modified: cocoon/site/site/3.0/download.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/3.0/download.html?rev=734183&r1=734182&r2=734183&view=diff
==============================================================================
--- cocoon/site/site/3.0/download.html (original)
+++ cocoon/site/site/3.0/download.html Tue Jan 13 09:10:04 2009
@@ -69,9 +69,9 @@
            <h1 class="projectTitle"><a href="./index.html">  Cocoon 3
   </a></h1>
                          <ul class="projectList">
-                <li><strong><a href="..//2.2/">Cocoon 2.2</a></em></strong></li>
+                <li><strong><a href="../2.2/">Cocoon 2.2</a></em></strong></li>
                 <li><strong><a href="../3.0/">Cocoon 3.0 <span class="pl-version-small">[alpha]</span></a></em></strong></li>                
-                <li><strong><a href="../$project.getProperties().get("docs.m.site-subprojects.relPath")">Subprojects</a></strong></li>
+                <li><strong><a href="../subprojects/">Subprojects</a></strong></li>
               </ul>              
                     </div>
          <div class="projectBarClear"><!-- --></div>
@@ -97,10 +97,6 @@
         </li>
                   
     <li >
-              <a href="reference/index.html">Userguide</a>
-        </li>
-                  
-    <li >
               <a href="features.html">Features</a>
         </li>
               </ul>
@@ -126,7 +122,7 @@
         </li>
                   
     <li >
-              <a href="api-docs.html">API</a>
+              <a href="apidocs/index.html">API</a>
         </li>
                   
     <li >
@@ -140,14 +136,43 @@
     </li>
       </ul>
        <div class="main">
-         <p>Cocoon 3 hasn't been released yet.</p>
+         <div class="section"><h2>Download</h2><div class="section"><h3>Cocoon 3.0.0-alpha-1</h3><ul><li><a href="http://www.apache.org/dyn/closer.cgi/cocoon/3.0/cocoon-all-3.0.0-alpha-1-dist.zip"> cocoon-all-3.0.0-alpha-1-dist.zip</a> <a href="http://www.apache.org/dyn/closer.cgi/cocoon/3.0/cocoon-all-3.0.0-alpha-1-dist.zip.md5">[MD5]</a> <a href="http://www.apache.org/dyn/closer.cgi/cocoon/3.0/cocoon-all-3.0.0-alpha-1-dist.zip.asc">[PGP]</a></li><li><a href="http://www.apache.org/dyn/closer.cgi/cocoon/3.0/cocoon-all-3.0.0-alpha-1-dist.tar.gz"> cocoon-all-3.0.0-alpha-1-dist.tar.gz</a> <a href="http://www.apache.org/dyn/closer.cgi/cocoon/3.0/cocoon-all-3.0.0-alpha-1-dist.tar.gz.md5">[MD5]</a> <a href="http://www.apache.org/dyn/closer.cgi/cocoon/3.0/cocoon-all-3.0.0-alpha-1-dist.tar.gz.asc">[PGP]</a></li></ul></div></div><div class="section"><h2>Maven 2 artifacts</h2><div class="section"><h3>Cocoon pipelines</h3><p>The 'cocoon-pipeline' library was designed to be used stand-a
 lone without any other dependencies than Apache Commons Logging: </p><div class="source"><pre>&lt;dependency&gt;
+  &lt;groupId&gt;org.apache.cocoon.pipeline&lt;/groupId&gt;
+  &lt;artifactId&gt;cocoon-pipeline&lt;/artifactId&gt;
+  &lt;version&gt;3.0.0-alpha-1&lt;/version&gt;
+&lt;/dependency&gt;
+</pre></div><p>In order to use the other Cocoon 3 modules (web applications, REST support, etc.), we highly recommend to start off with the archetypes listed below.</p></div></div><div class="section"><h2>Maven 2 archetypes</h2><p>Create a Cocoon 3 block that contains the samples. After running the archetype plugin, change to the base directory of the new module and enter 'mvn jetty:run' and point your browser at http://localhost:8080: If you use Eclipse, run 'mvn eclipse:eclipse' before and import the project into your workspace. Your resources but also the Java files are reloaded at runtime. </p><div class="source"><pre>mvn org.apache.maven.plugins:maven-archetype-plugin:1.0-alpha-7:create 
+    -DarchetypeGroupId=org.apache.cocoon.archetype-sample 
+    -DarchetypeArtifactId=cocoon-archetype-sample 
+    -DarchetypeVersion=3.0.0-alpha-1 
+    -DgroupId=com.mycompany 
+    -DartifactId=mysample 
+</pre></div><p>Create an empty Cocoon 3 block in order to create your own Cocoon 3 web application. </p><div class="source"><pre>mvn org.apache.maven.plugins:maven-archetype-plugin:1.0-alpha-7:create 
+    -DarchetypeGroupId=org.apache.cocoon.archetype-block 
+    -DarchetypeArtifactId=cocoon-archetype-block 
+    -DarchetypeVersion=3.0.0-alpha-1 
+    -DgroupId=com.mycompany 
+    -DartifactId=mysite 
+</pre></div><p>Create an empty Java web application project. After that add your Cocoon block as dependency.</p><div class="source"><pre>mvn org.apache.maven.plugins:maven-archetype-plugin:1.0-alpha-7:create 
+    -DarchetypeGroupId=org.apache.cocoon.archetype-webapp 
+    -DarchetypeArtifactId=cocoon-archetype-webapp 
+    -DarchetypeVersion=3.0.0-alpha-1 
+    -DgroupId=com.mycompany 
+    -DartifactId=mywebapp
+</pre></div><p>Create a parent module for your Cocoon project.</p><div class="source"><pre>mvn org.apache.maven.plugins:maven-archetype-plugin:1.0-alpha-7:create 
+    -DarchetypeGroupId=org.apache.cocoon.archetype-parent 
+    -DarchetypeArtifactId=cocoon-archetype-parent 
+    -DarchetypeVersion=3.0.0-alpha-1 
+    -DgroupId=com.mycompany 
+    -DartifactId=myparent 
+</pre></div></div>
        </div>
     </div>
 
     <!-- end of content -->
     <div id="footer">
       <p>&#169;  
-          2008
+          2008-2009
     
           The Apache Software Foundation
       </p>

Modified: cocoon/site/site/3.0/features.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/3.0/features.html?rev=734183&r1=734182&r2=734183&view=diff
==============================================================================
--- cocoon/site/site/3.0/features.html (original)
+++ cocoon/site/site/3.0/features.html Tue Jan 13 09:10:04 2009
@@ -69,9 +69,9 @@
            <h1 class="projectTitle"><a href="./index.html">  Cocoon 3
   </a></h1>
                          <ul class="projectList">
-                <li><strong><a href="..//2.2/">Cocoon 2.2</a></em></strong></li>
+                <li><strong><a href="../2.2/">Cocoon 2.2</a></em></strong></li>
                 <li><strong><a href="../3.0/">Cocoon 3.0 <span class="pl-version-small">[alpha]</span></a></em></strong></li>                
-                <li><strong><a href="../$project.getProperties().get("docs.m.site-subprojects.relPath")">Subprojects</a></strong></li>
+                <li><strong><a href="../subprojects/">Subprojects</a></strong></li>
               </ul>              
                     </div>
          <div class="projectBarClear"><!-- --></div>
@@ -97,10 +97,6 @@
         </li>
                   
     <li >
-              <a href="reference/index.html">Userguide</a>
-        </li>
-                  
-    <li >
               <strong>Features</strong>
         </li>
               </ul>
@@ -126,7 +122,7 @@
         </li>
                   
     <li >
-              <a href="api-docs.html">API</a>
+              <a href="apidocs/index.html">API</a>
         </li>
                   
     <li >
@@ -198,7 +194,7 @@
     <!-- end of content -->
     <div id="footer">
       <p>&#169;  
-          2008
+          2008-2009
     
           The Apache Software Foundation
       </p>

Modified: cocoon/site/site/3.0/index.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/3.0/index.html?rev=734183&r1=734182&r2=734183&view=diff
==============================================================================
--- cocoon/site/site/3.0/index.html (original)
+++ cocoon/site/site/3.0/index.html Tue Jan 13 09:10:04 2009
@@ -69,9 +69,9 @@
            <h1 class="projectTitle"><a href="./index.html">  Cocoon 3
   </a></h1>
                          <ul class="projectList">
-                <li><strong><a href="..//2.2/">Cocoon 2.2</a></em></strong></li>
+                <li><strong><a href="../2.2/">Cocoon 2.2</a></em></strong></li>
                 <li><strong><a href="../3.0/">Cocoon 3.0 <span class="pl-version-small">[alpha]</span></a></em></strong></li>                
-                <li><strong><a href="../$project.getProperties().get("docs.m.site-subprojects.relPath")">Subprojects</a></strong></li>
+                <li><strong><a href="../subprojects/">Subprojects</a></strong></li>
               </ul>              
                     </div>
          <div class="projectBarClear"><!-- --></div>
@@ -97,10 +97,6 @@
         </li>
                   
     <li >
-              <a href="reference/index.html">Userguide</a>
-        </li>
-                  
-    <li >
               <a href="features.html">Features</a>
         </li>
               </ul>
@@ -126,7 +122,7 @@
         </li>
                   
     <li >
-              <a href="api-docs.html">API</a>
+              <a href="apidocs/index.html">API</a>
         </li>
                   
     <li >
@@ -140,7 +136,7 @@
     </li>
       </ul>
        <div class="main">
-         <div class="section"><h2>Apache Cocoon 3</h2><p>Apache Cocoon 3 is a major rewrite of Cocoon 2.2. Like Cocoon 2 it is based around the concept of pipelines and sitemaps and it is very similar to Cocoon 2.2 in many respects but is slimmed down and designed to be <b>easily usable from within any Java environment</b>. On top of this, Cocoon 3 has the goal of becoming the best available platform for <b>RESTful webservices</b> and web applications.</p><div class="section"><h3>Using Pipelines in Java has never been so easy</h3><p>Here is an example that transforms an XML String by using two stylesheets:</p><div class="source"><pre>Pipeline pipeline = new NonCachingPipeline();
+         <div class="section"><h2>Apache Cocoon 3</h2><p>Apache Cocoon 3 is a major rewrite of Cocoon 2.2. Like Cocoon 2 it is based around the concept of pipelines and sitemaps and it is very similar to Cocoon 2.2 in many respects but is slimmed down and designed to be <b>easily used with Java code</b> (= no frameworks required!). On top of this, Cocoon 3 has the goal of becoming the best available platform for <b>RESTful webservices</b> and web applications.</p><div class="section"><h3>Download</h3><p>Apache Cocoon 3.0.0-alpha-1 is available for <a href="download.html"> download</a>. </p></div><div class="section"><h3>Using Pipelines in Java has never been so easy</h3><p>Here is an example that transforms an XML String by using two stylesheets:</p><div class="source"><pre>Pipeline pipeline = new NonCachingPipeline();
 pipeline.addComponent(new StringGenerator(&quot;&lt;x&gt;&lt;/x&gt;&quot;));
 pipeline.addComponent(new XSLTTransformer(this.getClass().getResource(&quot;/test1.xslt&quot;)));
 pipeline.addComponent(new XSLTTransformer(this.getClass().getResource(&quot;/test2.xslt&quot;)));
@@ -156,7 +152,7 @@
     <!-- end of content -->
     <div id="footer">
       <p>&#169;  
-          2008
+          2008-2009
     
           The Apache Software Foundation
       </p>

Modified: cocoon/site/site/3.0/integration.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/3.0/integration.html?rev=734183&r1=734182&r2=734183&view=diff
==============================================================================
--- cocoon/site/site/3.0/integration.html (original)
+++ cocoon/site/site/3.0/integration.html Tue Jan 13 09:10:04 2009
@@ -69,9 +69,9 @@
            <h1 class="projectTitle"><a href="./index.html">  Cocoon 3
   </a></h1>
                          <ul class="projectList">
-                <li><strong><a href="..//2.2/">Cocoon 2.2</a></em></strong></li>
+                <li><strong><a href="../2.2/">Cocoon 2.2</a></em></strong></li>
                 <li><strong><a href="../3.0/">Cocoon 3.0 <span class="pl-version-small">[alpha]</span></a></em></strong></li>                
-                <li><strong><a href="../$project.getProperties().get("docs.m.site-subprojects.relPath")">Subprojects</a></strong></li>
+                <li><strong><a href="../subprojects/">Subprojects</a></strong></li>
               </ul>              
                     </div>
          <div class="projectBarClear"><!-- --></div>
@@ -97,10 +97,6 @@
         </li>
                   
     <li >
-              <a href="reference/index.html">Userguide</a>
-        </li>
-                  
-    <li >
               <a href="features.html">Features</a>
         </li>
               </ul>
@@ -126,7 +122,7 @@
         </li>
                   
     <li >
-              <a href="api-docs.html">API</a>
+              <a href="apidocs/index.html">API</a>
         </li>
                   
     <li >
@@ -147,7 +143,7 @@
     <!-- end of content -->
     <div id="footer">
       <p>&#169;  
-          2008
+          2008-2009
     
           The Apache Software Foundation
       </p>

Modified: cocoon/site/site/3.0/issue-tracking.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/3.0/issue-tracking.html?rev=734183&r1=734182&r2=734183&view=diff
==============================================================================
--- cocoon/site/site/3.0/issue-tracking.html (original)
+++ cocoon/site/site/3.0/issue-tracking.html Tue Jan 13 09:10:04 2009
@@ -69,9 +69,9 @@
            <h1 class="projectTitle"><a href="./index.html">  Cocoon 3
   </a></h1>
                          <ul class="projectList">
-                <li><strong><a href="..//2.2/">Cocoon 2.2</a></em></strong></li>
+                <li><strong><a href="../2.2/">Cocoon 2.2</a></em></strong></li>
                 <li><strong><a href="../3.0/">Cocoon 3.0 <span class="pl-version-small">[alpha]</span></a></em></strong></li>                
-                <li><strong><a href="../$project.getProperties().get("docs.m.site-subprojects.relPath")">Subprojects</a></strong></li>
+                <li><strong><a href="../subprojects/">Subprojects</a></strong></li>
               </ul>              
                     </div>
          <div class="projectBarClear"><!-- --></div>
@@ -97,10 +97,6 @@
         </li>
                   
     <li >
-              <a href="reference/index.html">Userguide</a>
-        </li>
-                  
-    <li >
               <a href="features.html">Features</a>
         </li>
               </ul>
@@ -126,7 +122,7 @@
         </li>
                   
     <li >
-              <a href="api-docs.html">API</a>
+              <a href="apidocs/index.html">API</a>
         </li>
                   
     <li >
@@ -147,7 +143,7 @@
     <!-- end of content -->
     <div id="footer">
       <p>&#169;  
-          2008
+          2008-2009
     
           The Apache Software Foundation
       </p>

Modified: cocoon/site/site/3.0/license.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/3.0/license.html?rev=734183&r1=734182&r2=734183&view=diff
==============================================================================
--- cocoon/site/site/3.0/license.html (original)
+++ cocoon/site/site/3.0/license.html Tue Jan 13 09:10:04 2009
@@ -69,9 +69,9 @@
            <h1 class="projectTitle"><a href="./index.html">  Cocoon 3
   </a></h1>
                          <ul class="projectList">
-                <li><strong><a href="..//2.2/">Cocoon 2.2</a></em></strong></li>
+                <li><strong><a href="../2.2/">Cocoon 2.2</a></em></strong></li>
                 <li><strong><a href="../3.0/">Cocoon 3.0 <span class="pl-version-small">[alpha]</span></a></em></strong></li>                
-                <li><strong><a href="../$project.getProperties().get("docs.m.site-subprojects.relPath")">Subprojects</a></strong></li>
+                <li><strong><a href="../subprojects/">Subprojects</a></strong></li>
               </ul>              
                     </div>
          <div class="projectBarClear"><!-- --></div>
@@ -97,10 +97,6 @@
         </li>
                   
     <li >
-              <a href="reference/index.html">Userguide</a>
-        </li>
-                  
-    <li >
               <a href="features.html">Features</a>
         </li>
               </ul>
@@ -126,7 +122,7 @@
         </li>
                   
     <li >
-              <a href="api-docs.html">API</a>
+              <a href="apidocs/index.html">API</a>
         </li>
                   
     <li >
@@ -348,7 +344,7 @@
     <!-- end of content -->
     <div id="footer">
       <p>&#169;  
-          2008
+          2008-2009
     
           The Apache Software Foundation
       </p>

Modified: cocoon/site/site/3.0/mail-lists.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/3.0/mail-lists.html?rev=734183&r1=734182&r2=734183&view=diff
==============================================================================
--- cocoon/site/site/3.0/mail-lists.html (original)
+++ cocoon/site/site/3.0/mail-lists.html Tue Jan 13 09:10:04 2009
@@ -69,9 +69,9 @@
            <h1 class="projectTitle"><a href="./index.html">  Cocoon 3
   </a></h1>
                          <ul class="projectList">
-                <li><strong><a href="..//2.2/">Cocoon 2.2</a></em></strong></li>
+                <li><strong><a href="../2.2/">Cocoon 2.2</a></em></strong></li>
                 <li><strong><a href="../3.0/">Cocoon 3.0 <span class="pl-version-small">[alpha]</span></a></em></strong></li>                
-                <li><strong><a href="../$project.getProperties().get("docs.m.site-subprojects.relPath")">Subprojects</a></strong></li>
+                <li><strong><a href="../subprojects/">Subprojects</a></strong></li>
               </ul>              
                     </div>
          <div class="projectBarClear"><!-- --></div>
@@ -97,10 +97,6 @@
         </li>
                   
     <li >
-              <a href="reference/index.html">Userguide</a>
-        </li>
-                  
-    <li >
               <a href="features.html">Features</a>
         </li>
               </ul>
@@ -126,7 +122,7 @@
         </li>
                   
     <li >
-              <a href="api-docs.html">API</a>
+              <a href="apidocs/index.html">API</a>
         </li>
                   
     <li >
@@ -147,7 +143,7 @@
     <!-- end of content -->
     <div id="footer">
       <p>&#169;  
-          2008
+          2008-2009
     
           The Apache Software Foundation
       </p>

Modified: cocoon/site/site/3.0/project-info.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/3.0/project-info.html?rev=734183&r1=734182&r2=734183&view=diff
==============================================================================
--- cocoon/site/site/3.0/project-info.html (original)
+++ cocoon/site/site/3.0/project-info.html Tue Jan 13 09:10:04 2009
@@ -69,9 +69,9 @@
            <h1 class="projectTitle"><a href="./index.html">  Cocoon 3
   </a></h1>
                          <ul class="projectList">
-                <li><strong><a href="..//2.2/">Cocoon 2.2</a></em></strong></li>
+                <li><strong><a href="../2.2/">Cocoon 2.2</a></em></strong></li>
                 <li><strong><a href="../3.0/">Cocoon 3.0 <span class="pl-version-small">[alpha]</span></a></em></strong></li>                
-                <li><strong><a href="../$project.getProperties().get("docs.m.site-subprojects.relPath")">Subprojects</a></strong></li>
+                <li><strong><a href="../subprojects/">Subprojects</a></strong></li>
               </ul>              
                     </div>
          <div class="projectBarClear"><!-- --></div>
@@ -97,10 +97,6 @@
         </li>
                   
     <li >
-              <a href="reference/index.html">Userguide</a>
-        </li>
-                  
-    <li >
               <a href="features.html">Features</a>
         </li>
               </ul>
@@ -126,7 +122,7 @@
         </li>
                   
     <li >
-              <a href="api-docs.html">API</a>
+              <a href="apidocs/index.html">API</a>
         </li>
                   
     <li >
@@ -147,7 +143,7 @@
     <!-- end of content -->
     <div id="footer">
       <p>&#169;  
-          2008
+          2008-2009
     
           The Apache Software Foundation
       </p>

Modified: cocoon/site/site/3.0/project-reports.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/3.0/project-reports.html?rev=734183&r1=734182&r2=734183&view=diff
==============================================================================
--- cocoon/site/site/3.0/project-reports.html (original)
+++ cocoon/site/site/3.0/project-reports.html Tue Jan 13 09:10:04 2009
@@ -69,9 +69,9 @@
            <h1 class="projectTitle"><a href="./index.html">  Cocoon 3
   </a></h1>
                          <ul class="projectList">
-                <li><strong><a href="..//2.2/">Cocoon 2.2</a></em></strong></li>
+                <li><strong><a href="../2.2/">Cocoon 2.2</a></em></strong></li>
                 <li><strong><a href="../3.0/">Cocoon 3.0 <span class="pl-version-small">[alpha]</span></a></em></strong></li>                
-                <li><strong><a href="../$project.getProperties().get("docs.m.site-subprojects.relPath")">Subprojects</a></strong></li>
+                <li><strong><a href="../subprojects/">Subprojects</a></strong></li>
               </ul>              
                     </div>
          <div class="projectBarClear"><!-- --></div>
@@ -97,10 +97,6 @@
         </li>
                   
     <li >
-              <a href="reference/index.html">Userguide</a>
-        </li>
-                  
-    <li >
               <a href="features.html">Features</a>
         </li>
               </ul>
@@ -126,7 +122,7 @@
         </li>
                   
     <li >
-              <a href="api-docs.html">API</a>
+              <a href="apidocs/index.html">API</a>
         </li>
                   
     <li >
@@ -147,7 +143,7 @@
     <!-- end of content -->
     <div id="footer">
       <p>&#169;  
-          2008
+          2008-2009
     
           The Apache Software Foundation
       </p>

Modified: cocoon/site/site/3.0/project-summary.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/3.0/project-summary.html?rev=734183&r1=734182&r2=734183&view=diff
==============================================================================
--- cocoon/site/site/3.0/project-summary.html (original)
+++ cocoon/site/site/3.0/project-summary.html Tue Jan 13 09:10:04 2009
@@ -69,9 +69,9 @@
            <h1 class="projectTitle"><a href="./index.html">  Cocoon 3
   </a></h1>
                          <ul class="projectList">
-                <li><strong><a href="..//2.2/">Cocoon 2.2</a></em></strong></li>
+                <li><strong><a href="../2.2/">Cocoon 2.2</a></em></strong></li>
                 <li><strong><a href="../3.0/">Cocoon 3.0 <span class="pl-version-small">[alpha]</span></a></em></strong></li>                
-                <li><strong><a href="../$project.getProperties().get("docs.m.site-subprojects.relPath")">Subprojects</a></strong></li>
+                <li><strong><a href="../subprojects/">Subprojects</a></strong></li>
               </ul>              
                     </div>
          <div class="projectBarClear"><!-- --></div>
@@ -97,10 +97,6 @@
         </li>
                   
     <li >
-              <a href="reference/index.html">Userguide</a>
-        </li>
-                  
-    <li >
               <a href="features.html">Features</a>
         </li>
               </ul>
@@ -126,7 +122,7 @@
         </li>
                   
     <li >
-              <a href="api-docs.html">API</a>
+              <a href="apidocs/index.html">API</a>
         </li>
                   
     <li >
@@ -147,7 +143,7 @@
     <!-- end of content -->
     <div id="footer">
       <p>&#169;  
-          2008
+          2008-2009
     
           The Apache Software Foundation
       </p>

Modified: cocoon/site/site/3.0/reference/html-single/css/html.css
URL: http://svn.apache.org/viewvc/cocoon/site/site/3.0/reference/html-single/css/html.css?rev=734183&r1=734182&r2=734183&view=diff
==============================================================================
--- cocoon/site/site/3.0/reference/html-single/css/html.css (original)
+++ cocoon/site/site/3.0/reference/html-single/css/html.css Tue Jan 13 09:10:04 2009
@@ -328,4 +328,12 @@
 .mhSpacer {
     padding: 129px 0 0 0;
 }
+
+div.calloutlist * td {
+    text-align: left;
+}
+
+body {
+   text-align: left;
+}
 /* END */

Modified: cocoon/site/site/3.0/reference/html-single/index.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/3.0/reference/html-single/index.html?rev=734183&r1=734182&r2=734183&view=diff
==============================================================================
--- cocoon/site/site/3.0/reference/html-single/index.html (original)
+++ cocoon/site/site/3.0/reference/html-single/index.html Tue Jan 13 09:10:04 2009
@@ -5,4 +5,127 @@
             </span></div></div><div><p class="releaseinfo">Cocoon 3.0 ALPHA</p></div><div><div class="legalnotice"><a name="d0e16"></a><p>Copies of this document may be made for your own use and for
       distribution to others, provided that you do not charge any fee for such
       copies and further provided that each copy contains this Copyright
-      Notice, whether distributed in print or electronically.</p></div></div></div><hr></div><div class="toc"><dl><dt><span class="chapter"><a href="#introduction">1. Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="#introduction.why-cocoon3">1.1. Why Cocoon 3 - Motivation</a></span></dt><dt><span class="section"><a href="#introduction.requirements">1.2. Requirements</a></span></dt></dl></dd><dt><span class="chapter"><a href="#pipelines">2. Pipelines</a></span></dt><dd><dl><dt><span class="section"><a href="#pipelines.definition">2.1. What is a pipeline?</a></span></dt><dt><span class="section"><a href="#pipelines.implementations">2.2. Pipeline implementations</a></span></dt><dt><span class="section"><a href="#pipelines.embedding">2.3. Embedding a pipeline</a></span></dt><dt><span class="section"><a href="#pipeline.components">2.4. Components</a></span></dt></dl></dd><dt><span class="chapter"><a href="#sitemap">3. Sitemaps</a></span></dt><dd><dl><dt><sp
 an class="section"><a href="#sitemaps.definition">3.1. What is a sitemap?</a></span></dt><dt><span class="section"><a href="#sitemaps.evaluation">3.2. Sitemap evaluation?</a></span></dt><dt><span class="section"><a href="#sitemaps.expression-languages">3.3. Expression languages</a></span></dt><dt><span class="section"><a href="#sitemaps.spring">3.4. Spring integration</a></span></dt><dt><span class="section"><a href="#sitemaps.embedding">3.5. Embedding a sitemap</a></span></dt></dl></dd><dt><span class="chapter"><a href="#webapps">4. Web applications</a></span></dt><dd><dl><dt><span class="section"><a href="#webapps.scenarios">4.1. Usage scenarios</a></span></dt><dt><span class="section"><a href="#webapps.servlet-service-fw">4.2. Servlet-Service framework integration</a></span></dt><dt><span class="section"><a href="#webapps.http-environments">4.3. Sitemaps in an HTTP environement</a></span></dt><dt><span class="section"><a href="#webapps.system-setup">4.4. System setup</a><
 /span></dt><dt><span class="section"><a href="#webapps.pipeline-fragments">4.5. Connecting pipeline fragments</a></span></dt><dt><span class="section"><a href="#webapps.rest">4.6. RESTful web services</a></span></dt><dt><span class="section"><a href="#webapps.caching">4.7. Caching and conditional GET requests</a></span></dt><dt><span class="section"><a href="#webapps.auth">4.8. Authentication</a></span></dt><dt><span class="section"><a href="#webapps.testing">4.9. Testing</a></span></dt><dt><span class="section"><a href="#webapps.tutorial">4.10. Tutorial</a></span></dt></dl></dd></dl></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="introduction"></a>Chapter&nbsp;1.&nbsp;Introduction</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="introduction.why-cocoon3"></a>1.1.&nbsp;Why Cocoon 3 - Motivation</h2></div></div></div><p>TBW</p></div><div class="
 section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="introduction.requirements"></a>1.2.&nbsp;Requirements</h2></div></div></div><p>TBW</p></div></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="pipelines"></a>Chapter&nbsp;2.&nbsp;Pipelines</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="pipelines.definition"></a>2.1.&nbsp;What is a pipeline?</h2></div></div></div><p>TBW</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="pipelines.implementations"></a>2.2.&nbsp;Pipeline implementations</h2></div></div></div><p>TBW: noncaching, caching, async-caching, expires caching, own implementations</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="pipelines.embedding"></a>2.3
 .&nbsp;Embedding a pipeline</h2></div></div></div><p>TBW: Passing parameters to the pipeline and to its components</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="pipeline.components"></a>2.4.&nbsp;Components</h2></div></div></div><p>TBW: SAX, StAX, own implementations</p></div></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="sitemap"></a>Chapter&nbsp;3.&nbsp;Sitemaps</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sitemaps.definition"></a>3.1.&nbsp;What is a sitemap?</h2></div></div></div><p>TBW</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sitemaps.evaluation"></a>3.2.&nbsp;Sitemap evaluation?</h2></div></div></div><p>TBW</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 c
 lass="title" style="clear: both"><a name="sitemaps.expression-languages"></a>3.3.&nbsp;Expression languages</h2></div></div></div><p>TBW</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sitemaps.spring"></a>3.4.&nbsp;Spring integration</h2></div></div></div><p>TBW</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sitemaps.embedding"></a>3.5.&nbsp;Embedding a sitemap</h2></div></div></div><p>TBW</p></div></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="webapps"></a>Chapter&nbsp;4.&nbsp;Web applications</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="webapps.scenarios"></a>4.1.&nbsp;Usage scenarios</h2></div></div></div><p>TBW</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class
 ="title" style="clear: both"><a name="webapps.servlet-service-fw"></a>4.2.&nbsp;Servlet-Service framework integration</h2></div></div></div><p>TBW: Composition, servlet: protocol, inheritence</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="webapps.http-environments"></a>4.3.&nbsp;Sitemaps in an HTTP environement</h2></div></div></div><p>TBW: Status codes, Conditional GET requests, Mime-type handling</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="webapps.system-setup"></a>4.4.&nbsp;System setup</h2></div></div></div><p>TBW: Logging, JNet, Configuration, Spring integration Deployment: Blocks as deployment units AND Creating a web archive (WAR), Devleopment with Eclispe and Maven</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="webapps.pipeline-fragments"></a>4.5.&n
 bsp;Connecting pipeline fragments</h2></div></div></div><p>TBW</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="webapps.rest"></a>4.6.&nbsp;RESTful web services</h2></div></div></div><p>TBW: REST controller, Rendering views using StringTemplate, Request-wide transactions (incl. Subrequests)</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="webapps.caching"></a>4.7.&nbsp;Caching and conditional GET requests</h2></div></div></div><p>TBW</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="webapps.auth"></a>4.8.&nbsp;Authentication</h2></div></div></div><p>TBW</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="webapps.testing"></a>4.9.&nbsp;Testing</h2></div></div></div><p>TBW: Integeration tests</p></div>
 <div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="webapps.tutorial"></a>4.10.&nbsp;Tutorial</h2></div></div></div><p>TBW</p></div></div></div></body></html>
+      Notice, whether distributed in print or electronically.</p></div></div></div><hr></div><div class="toc"><dl><dt><span class="chapter"><a href="#introduction">1. Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="#introduction.why-cocoon3">1.1. Why Cocoon 3 - Motivation</a></span></dt><dt><span class="section"><a href="#introduction.previous-versions">1.2. Relationship to previous versions</a></span></dt><dt><span class="section"><a href="#introduction.requirements">1.3. Requirements</a></span></dt></dl></dd><dt><span class="chapter"><a href="#pipelines">2. Pipelines</a></span></dt><dd><dl><dt><span class="section"><a href="#pipelines.definition">2.1. What is a pipeline?</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e88">2.1.1. Linear pipelines</a></span></dt><dt><span class="section"><a href="#d0e98">2.1.2. Pipelines by example</a></span></dt></dl></dd><dt><span class="section"><a href="#pipelines.implementations">2.2. Pipeline implem
 entations</a></span></dt><dt><span class="section"><a href="#pipelines.embedding">2.3. Embedding a pipeline</a></span></dt><dt><span class="section"><a href="#pipeline.sax">2.4. SAX components</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e363">2.4.1. Available components</a></span></dt><dt><span class="section"><a href="#d0e368">2.4.2. Writing custom components</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e371">2.4.2.1. SAX generator</a></span></dt><dt><span class="section"><a href="#d0e376">2.4.2.2. SAX transformer</a></span></dt><dt><span class="section"><a href="#d0e383">2.4.2.3. SAX serializer</a></span></dt></dl></dd></dl></dd><dt><span class="section"><a href="#pipeline.stax">2.5. StAX components</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e393">2.5.1. Available components</a></span></dt><dt><span class="section"><a href="#d0e398">2.5.2. Writing custom components</a></span></dt><dd><dl><dt><span class="section"><a href="
 #d0e401">2.5.2.1. StAX generator</a></span></dt><dt><span class="section"><a href="#d0e406">2.5.2.2. StAX transformer</a></span></dt><dt><span class="section"><a href="#d0e413">2.5.2.3. StAX serializer</a></span></dt></dl></dd><dt><span class="section"><a href="#d0e418">2.5.3. Using StAX and SAX components in the same pipeline</a></span></dt><dt><span class="section"><a href="#d0e422">2.5.4. Java 1.5 support</a></span></dt></dl></dd><dt><span class="section"><a href="#pipelines.utils">2.6. Utilities</a></span></dt></dl></dd><dt><span class="chapter"><a href="#sitemap">3. Sitemaps</a></span></dt><dd><dl><dt><span class="section"><a href="#sitemaps.definition">3.1. What is a sitemap?</a></span></dt><dt><span class="section"><a href="#sitemaps.evaluation">3.2. Sitemap evaluation?</a></span></dt><dt><span class="section"><a href="#sitemaps.expression-languages">3.3. Expression languages</a></span></dt><dt><span class="section"><a href="#sitemaps.spring">3.4. Spring integration</
 a></span></dt><dt><span class="section"><a href="#sitemaps.embedding">3.5. Embedding a sitemap</a></span></dt></dl></dd><dt><span class="chapter"><a href="#webapps">4. Web applications</a></span></dt><dd><dl><dt><span class="section"><a href="#webapps.scenarios">4.1. Usage scenarios</a></span></dt><dt><span class="section"><a href="#webapps.servlet-service-fw">4.2. Servlet-Service framework integration</a></span></dt><dt><span class="section"><a href="#webapps.http-environments">4.3. Sitemaps in an HTTP environement</a></span></dt><dt><span class="section"><a href="#webapps.system-setup">4.4. System setup</a></span></dt><dt><span class="section"><a href="#webapps.pipeline-fragments">4.5. Connecting pipeline fragments</a></span></dt><dt><span class="section"><a href="#webapps.rest">4.6. RESTful web services</a></span></dt><dt><span class="section"><a href="#webapps.caching">4.7. Caching and conditional GET requests</a></span></dt><dt><span class="section"><a href="#webapps.au
 th">4.8. Authentication</a></span></dt><dt><span class="section"><a href="#webapps.testing">4.9. Testing</a></span></dt><dt><span class="section"><a href="#webapps.tutorial">4.10. Tutorial</a></span></dt></dl></dd></dl></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="introduction"></a>Chapter&nbsp;1.&nbsp;Introduction</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="introduction.why-cocoon3"></a>1.1.&nbsp;Why Cocoon 3 - Motivation</h2></div></div></div><p>
+      The main idea behind Cocoon is the concept of pipelines. Cocoon 1.x and 2.x
+      applied this idea with a focus on web applications.
+      But sometimes pipelines would be useful although you don't develop a web application.
+      Those former Cocoon versions don't really help you in that case. 
+    </p><p>
+      In contrast, Cocoon 3 follows a layered approach so that its basic module - 
+      the pipeline module - can be used from within any Java environment without 
+      requiring you adding a huge stack of dependencies. 
+    </p><p>
+      On top of this, Cocoon 3 has the goal to make the development of 
+      RESTful web services and web applications a simple task.
+    </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="introduction.previous-versions"></a>1.2.&nbsp;Relationship to previous versions</h2></div></div></div><p>
+      Cocoon 3 has been built completely from scratch and doesn't have any dependencies
+      on Cocoon 2.x or 1.x. 
+    </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="introduction.requirements"></a>1.3.&nbsp;Requirements</h2></div></div></div><p>
+      Cocoon 3 requires Java 5 or higher.
+    </p></div></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="pipelines"></a>Chapter&nbsp;2.&nbsp;Pipelines</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="pipelines.definition"></a>2.1.&nbsp;What is a pipeline?</h2></div></div></div><p>
+      A Cocoon 3 pipeline expects one or more component(s). These components get linked with each other in the
+      order they were added. There is no restriction on the content that flows through the pipeline.
+    </p><p>
+      A pipeline works based on two fundamental concepts:
+      </p><div class="itemizedlist"><ul type="disc"><li><p>The first component of a pipeline is of type 
+            <code class="literal">org.apache.cocoon.pipeline.component.Starter</code>.
+            The last component is of type <code class="literal">org.apache.cocoon.pipeline.component.Finisher</code>.
+          </p></li><li><p>
+            In order to link components with each other, the first has to be a 
+            <code class="literal">org.apache.cocoon.pipeline.component.Finisher</code>, the latter
+            <code class="literal">org.apache.cocoon.pipeline.component.Producer</code>.
+          </p></li></ul></div><p>
+      When the pipeline links the components, it merely checks whether the above mentioned interfaces are present. So the
+      pipeline does not know about the specific capabilities or the compatibility of the components. It is the
+      responsibility of the <code class="literal">Producer</code> to decide whether a specific <code class="literal">Consumer</code> 
+      can be linked to it or not (that is, whether it can produce output in the desired format of the <code class="literal">Consumer</code> 
+      or not). It is also conceivable that a <code class="literal">Producer</code> is capable of accepting different types of 
+      <code class="literal">Consumer</code> and adjust the output format
+    </p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e88"></a>2.1.1.&nbsp;Linear pipelines</h3></div></div></div><p>
+        A Cocoon 3 pipeline always goes through the same sequence of components to produce its output. There is no
+        support for conditionals, loops, tees or alternative flows in the case of errors. The reason for this restriction
+        is simplicity and that non-linear pipelines are more difficult (or even impossible) to be cached. In practice this means
+        that a pipeline has to be contructed completely at build-time.
+      </p><p>
+        If non-linear XML pipes with runtime-support for conditionals, loops, tees and error-flows are a requirement for you, 
+        see the <a xmlns:xlink="http://www.w3.org/1999/xlink" href="http://en.wikipedia.org/wiki/XProc" target="_top">XProc</a> standard of the W3C. There
+        are several available implementations for it.
+      </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e98"></a>2.1.2.&nbsp;Pipelines by example</h3></div></div></div><p>
+        But let's get more specific by giving an example: Cocoon has become famous for its SAX pipelines that consist 
+        of exactly one SAX-based XML generator, zero, one or more SAX-based XML transformers and exactly one SAX-based 
+        XML serializer. Of course, these specific SAX-based XML pipelines can be build by using general
+        Cocoon 3 pipelines: generators, transformers and serializers are pipeline components. A generator is a 
+        <code class="literal">Starter</code> and a <code class="literal">Producer</code>, a transformer can't be neither a 
+        <code class="literal">Starter</code>, nor a <code class="literal">Finisher</code> but is always a <code class="literal">Producer</code> 
+        and a <code class="literal">Consumer</code> and a serializer is a <code class="literal">Consumer</code> and a <code class="literal">Finisher</code>.
+      </p><p>
+        Here is some Java code that demonstrates how a pipeline can be utilized with SAX-based XML components:      
+      </p><div class="programlistingco"><pre class="programlisting">Pipeline pipeline = <span class="hl-keyword">new</span> NonCachingPipeline();                                            <span class="co"><img src="images/callouts/1.png" alt="(1)"></span>
+pipeline.addComponent(<span class="hl-keyword">new</span> StringGenerator(<span class="hl-string">"&lt;x&gt;&lt;/x&gt;"</span>));                                   <span class="co"><img src="images/callouts/2.png" alt="(2)"></span>
+pipeline.addComponent(<span class="hl-keyword">new</span> XSLTTransformer(<span class="hl-keyword">this</span>.getClass().getResource(<span class="hl-string">"/test1.xslt"</span>)));  <span class="co"><img src="images/callouts/3.png" alt="(3)"></span>
+pipeline.addComponent(<span class="hl-keyword">new</span> XSLTTransformer(<span class="hl-keyword">this</span>.getClass().getResource(<span class="hl-string">"/test2.xslt"</span>)));  <span class="co"><img src="images/callouts/4.png" alt="(4)"></span>
+pipeline.addComponent(<span class="hl-keyword">new</span> XMLSerializer());                                              <span class="co"><img src="images/callouts/5.png" alt="(5)"></span>
+
+pipeline.setup(System.out);                                                              <span class="co"><img src="images/callouts/6.png" alt="(6)"></span>
+pipeline.execute();                                                                      <span class="co"><img src="images/callouts/7.png" alt="(7)"></span>
+</pre><div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><img src="images/callouts/1.png" alt="1" border="0"></td><td valign="top" align="left"><p>
+              Create a <code class="literal">NonCachingPipeline</code>. It's the simplest available pipeline implementation. The 
+              <code class="literal">org.apache.cocoon.pipeline.Pipeline</code> interface doesn't impose any restrictions on the
+              content that flows in it.
+            </p></td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/2.png" alt="2" border="0"></td><td valign="top" align="left"><p>
+              Add a generator, that implements the <code class="literal">org.apache.cocoon.pipeline.component.PipelineComponent</code> interface to the
+              pipeline by using the pipeline's <code class="literal">addComponent(pipelineComponent)</code> interface.
+            </p><p>
+              The <code class="literal">StringGenerator</code> expects a <code class="literal">java.lang.String</code> object and produces SAX events by using a SAX parser.
+              Hence it has to implement the <code class="literal">org.apache.cocoon.pipeline.component.sax.SAXProducer</code> interface.
+            </p><p>
+              The <code class="literal">SAXProducer</code> interface extends the <code class="literal">org.apache.cocoon.pipeline.component.Producer</code> interface. This
+              means that it expects the next (or the same!) component to implement the <code class="literal">org.apache.cocoon.pipeline.component.Consumer</code>
+              interface. The check that the next pipeline component is of type <code class="literal">org.apache.cocoon.pipeline.component.sax.SAXConsumer</code>
+              isn't done at interface level but by the implementation (see the <code class="literal">org.apache.cocoon.pipeline.component.sax.AbstractXMLProducer</code>
+              for details which the <code class="literal">StringGenerator</code> is inherited from).
+            </p><p>
+              Since a generator is the first component of a pipeline, it also has to implement the <code class="literal">Starter</code> interface.
+            </p></td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/3.png" alt="3" border="0"></td><td valign="top" align="left"><p>
+              Add a transformer, that implements the <code class="literal">org.apache.cocoon.pipeline.component.PipelineComponent</code> interface to the
+              pipeline by using the pipeline's <code class="literal">addComponent(pipelineComponent)</code> interface.
+            </p><p>
+              This <code class="literal">XSLTTransformer</code> expects the <code class="literal">java.net.URL</code> of an XSLT stylesheet. It uses the rules of the stylesheet
+              to add, change or delete nodes of the XML SAX stream.
+            </p><p>
+              Since it implements the <code class="literal">org.apache.cocoon.pipeline.component.Consumer</code> interface, it fulfills the general contract that a <code class="literal">Consumer</code>
+              is linked with a <code class="literal">Producer</code>. By implementing the <code class="literal">org.apache.cocoon.pipeline.component.sax.SAXConsumer</code> interface,
+              it fulfills the specific requirement of the previous <code class="literal">StringGenerator</code> that expects a next pipeline component of that type. 
+            </p><p>
+              This transformer also implements the <code class="literal">org.apache.cocoon.pipeline.component.sax.SAXProducer</code> interface. This interface extends the
+              <code class="literal">org.apache.cocoon.pipeline.component.Producer</code> interface which means that the next component has to be a 
+              <code class="literal">org.apache.cocoon.pipeline.component.Consumer</code>. Like the previous <code class="literal">StringGenerator</code>, the <code class="literal">XSLTTransformer</code>
+              inherits from the <code class="literal">org.apache.cocoon.pipeline.component.sax.AbstractXMLProducer</code> which contains the check that the next component
+              is of type <code class="literal">org.apache.cocoon.pipeline.component.sax.SAXConsumer</code>. 
+            </p></td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/4.png" alt="4" border="0"></td><td valign="top" align="left"><p>
+              Add another transformer to the pipeline. A pipeline can contain any number of components that implement the <code class="literal">Producer</code> and 
+              <code class="literal">Consumer</code> interfaces at the same time. However, they mustn't be neither of type <code class="literal">Starter</code> nor <code class="literal">Finisher</code>.
+            </p></td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/5.png" alt="5" border="0"></td><td valign="top" align="left"><p>
+              Add a serializer, that implements the <code class="literal">org.apache.cocoon.pipeline.component.PipelineComponent</code> interface to the
+              pipeline by using the pipeline's <code class="literal">addComponent(pipelineComponent)</code> interface.
+            </p><p>
+              The XML serializer receives SAX events and serializes them into an <code class="literal">java.io.OutputStream</code>.
+            </p><p>
+              A serializer component is the last component of a pipeline and hence it has to implement the <code class="literal">org.apache.cocoon.pipeline.Finisher</code>
+              interface.
+            </p><p>
+              Since it receives SAX events, it implements the <code class="literal">org.apache.cocoon.pipeline.sax.SAXConsumer</code> interface.
+            </p></td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/6.png" alt="6" border="0"></td><td valign="top" align="left"><p>
+              A pipeline has to be initialized first by calling its <code class="literal">setup(outputStream)</code> method. This method expects the output stream
+              where the pipeline result should be streamed.
+            </p></td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/7.png" alt="7" border="0"></td><td valign="top" align="left"><p>
+              After the pipeline has been initialized, it can be executed by invoking its <code class="literal">execute()</code> method. The first pipeline component, a <code class="literal">Starter</code>,
+              will be invoked which will trigger the next component and so on. Finally the last pipeline component, a <code class="literal">Finisher</code> will be reached which is responsible 
+              for the serialization of the pipeline content.
+            </p><p>
+              Once the pipeline has been started, it either succeeds or fails. There is no way to react on any (error) conditions.
+            </p></td></tr></table></div></div><div class="table"><a name="pipeline.components.sax"></a><p class="title"><b>Table&nbsp;2.1.&nbsp;SAX components and their interfaces</b></p><div class="table-contents"><table summary="SAX components and their interfaces" width="100%" border="1"><colgroup><col><col align="center"><col align="center"><col><col></colgroup><thead><tr><th>Component type</th><th align="center">Structural interfaces</th><th align="center">Content-specific interfaces</th><td class="auto-generated">&nbsp;</td><td class="auto-generated">&nbsp;</td></tr></thead><tbody><tr><td>SAX generator</td><td align="center">Starter, Producer, PipelineComponent</td><td align="center">SAXProducer</td><td class="auto-generated">&nbsp;</td><td class="auto-generated">&nbsp;</td></tr><tr><td>SAX transformer</td><td align="center">Producer, Consumer, PipelineComponent</td><td align="center">SAXProducer, SAXConsumer</td><td class="auto-generated">&nbsp;</td><td class="auto-ge
 nerated">&nbsp;</td></tr><tr><td>SAX serializer</td><td align="center">Finisher, Consumer, PipelineComponent</td><td align="center">SAXConsumer</td><td class="auto-generated">&nbsp;</td><td class="auto-generated">&nbsp;</td></tr></tbody></table></div></div><br class="table-break"></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="pipelines.implementations"></a>2.2.&nbsp;Pipeline implementations</h2></div></div></div><p>TBW: noncaching, caching, async-caching, expires caching, own implementations</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="pipelines.embedding"></a>2.3.&nbsp;Embedding a pipeline</h2></div></div></div><p>TBW: Passing parameters to the pipeline and its components, finsih() method</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="pipeline.sax"></a>2
 .4.&nbsp;SAX components</h2></div></div></div><p>concept, writing custom SAX components, link to Javadocs</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e363"></a>2.4.1.&nbsp;Available components</h3></div></div></div><p>Link to Javadocs</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e368"></a>2.4.2.&nbsp;Writing custom components</h3></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e371"></a>2.4.2.1.&nbsp;SAX generator</h4></div></div></div><p>explain from a user's point of view, what she needs to do to implement one
+              (available abstract classes)
+        </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e376"></a>2.4.2.2.&nbsp;SAX transformer</h4></div></div></div><p>explain from a user's point of view, what she needs to do to implement one</p><p>buffering</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e383"></a>2.4.2.3.&nbsp;SAX serializer</h4></div></div></div><p>explain from a user's point of view, what she needs to do to implement one</p></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="pipeline.stax"></a>2.5.&nbsp;StAX components</h2></div></div></div><p>explain StAX in general, advantages (ease of writing fast transformers), links to external sources</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e393"></a>2.5.1.&nbsp;Available components</h3></div></div></div><p>Link to Javadocs
 </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e398"></a>2.5.2.&nbsp;Writing custom components</h3></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e401"></a>2.5.2.1.&nbsp;StAX generator</h4></div></div></div><p>explain from a user's point of view, what she needs to do to implement one
+              (available abstract classes)
+        </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e406"></a>2.5.2.2.&nbsp;StAX transformer</h4></div></div></div><p>explain from a user's point of view, what she needs to do to implement one</p><p>explain navigators by example</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e413"></a>2.5.2.3.&nbsp;StAX serializer</h4></div></div></div><p>explain from a user's point of view, what she needs to do to implement one</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e418"></a>2.5.3.&nbsp;Using StAX and SAX components in the same pipeline</h3></div></div></div><p></p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e422"></a>2.5.4.&nbsp;Java 1.5 support</h3></div></div></div><p>What do you have to do to use StAX components, in a Java 1.5 environment</p></div></di
 v><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="pipelines.utils"></a>2.6.&nbsp;Utilities</h2></div></div></div><p>TBW: XMLUtils, TransformUtils</p></div></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="sitemap"></a>Chapter&nbsp;3.&nbsp;Sitemaps</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sitemaps.definition"></a>3.1.&nbsp;What is a sitemap?</h2></div></div></div><p>TBW</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sitemaps.evaluation"></a>3.2.&nbsp;Sitemap evaluation?</h2></div></div></div><p>TBW</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sitemaps.expression-languages"></a>3.3.&nbsp;Expression languages</h2></div></div></div><p>
 TBW</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sitemaps.spring"></a>3.4.&nbsp;Spring integration</h2></div></div></div><p>TBW</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sitemaps.embedding"></a>3.5.&nbsp;Embedding a sitemap</h2></div></div></div><p>TBW</p></div></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="webapps"></a>Chapter&nbsp;4.&nbsp;Web applications</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="webapps.scenarios"></a>4.1.&nbsp;Usage scenarios</h2></div></div></div><p>TBW</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="webapps.servlet-service-fw"></a>4.2.&nbsp;Servlet-Service framework integration</h2></div></div
 ></div><p>TBW: Composition, servlet: protocol, inheritence</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="webapps.http-environments"></a>4.3.&nbsp;Sitemaps in an HTTP environement</h2></div></div></div><p>TBW: Status codes, Conditional GET requests, Mime-type handling</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="webapps.system-setup"></a>4.4.&nbsp;System setup</h2></div></div></div><p>TBW: Logging, JNet, Configuration, Spring integration Deployment: Blocks as deployment units AND Creating a web archive (WAR), Devleopment with Eclispe and Maven</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="webapps.pipeline-fragments"></a>4.5.&nbsp;Connecting pipeline fragments</h2></div></div></div><p>TBW</p></div><div class="section" lang="en"><div class="titlepage"><div><d
 iv><h2 class="title" style="clear: both"><a name="webapps.rest"></a>4.6.&nbsp;RESTful web services</h2></div></div></div><p>TBW: REST controller, Rendering views using StringTemplate, Request-wide transactions (incl. Subrequests)</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="webapps.caching"></a>4.7.&nbsp;Caching and conditional GET requests</h2></div></div></div><p>TBW</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="webapps.auth"></a>4.8.&nbsp;Authentication</h2></div></div></div><p>TBW</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="webapps.testing"></a>4.9.&nbsp;Testing</h2></div></div></div><p>TBW: Integeration tests</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="webapps.tutorial"></a>
 4.10.&nbsp;Tutorial</h2></div></div></div><p>TBW</p></div></div></div></body></html>

Modified: cocoon/site/site/3.0/reference/html/css/html.css
URL: http://svn.apache.org/viewvc/cocoon/site/site/3.0/reference/html/css/html.css?rev=734183&r1=734182&r2=734183&view=diff
==============================================================================
--- cocoon/site/site/3.0/reference/html/css/html.css (original)
+++ cocoon/site/site/3.0/reference/html/css/html.css Tue Jan 13 09:10:04 2009
@@ -328,4 +328,12 @@
 .mhSpacer {
     padding: 129px 0 0 0;
 }
+
+div.calloutlist * td {
+    text-align: left;
+}
+
+body {
+   text-align: left;
+}
 /* END */

Modified: cocoon/site/site/3.0/reference/html/index.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/3.0/reference/html/index.html?rev=734183&r1=734182&r2=734183&view=diff
==============================================================================
--- cocoon/site/site/3.0/reference/html/index.html (original)
+++ cocoon/site/site/3.0/reference/html/index.html Tue Jan 13 09:10:04 2009
@@ -5,4 +5,4 @@
             </span></div></div><div><p class="releaseinfo">Cocoon 3.0 ALPHA</p></div><div><div class="legalnotice"><a name="d0e16"></a><p>Copies of this document may be made for your own use and for
       distribution to others, provided that you do not charge any fee for such
       copies and further provided that each copy contains this Copyright
-      Notice, whether distributed in print or electronically.</p></div></div></div><hr></div><div class="toc"><dl><dt><span class="chapter"><a href="introduction.html">1. Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="introduction.html#introduction.why-cocoon3">1.1. Why Cocoon 3 - Motivation</a></span></dt><dt><span class="section"><a href="introduction.html#introduction.requirements">1.2. Requirements</a></span></dt></dl></dd><dt><span class="chapter"><a href="pipelines.html">2. Pipelines</a></span></dt><dd><dl><dt><span class="section"><a href="pipelines.html#pipelines.definition">2.1. What is a pipeline?</a></span></dt><dt><span class="section"><a href="pipelines.html#pipelines.implementations">2.2. Pipeline implementations</a></span></dt><dt><span class="section"><a href="pipelines.html#pipelines.embedding">2.3. Embedding a pipeline</a></span></dt><dt><span class="section"><a href="pipelines.html#pipeline.components">2.4. Components</a></span></dt
 ></dl></dd><dt><span class="chapter"><a href="sitemap.html">3. Sitemaps</a></span></dt><dd><dl><dt><span class="section"><a href="sitemap.html#sitemaps.definition">3.1. What is a sitemap?</a></span></dt><dt><span class="section"><a href="sitemap.html#sitemaps.evaluation">3.2. Sitemap evaluation?</a></span></dt><dt><span class="section"><a href="sitemap.html#sitemaps.expression-languages">3.3. Expression languages</a></span></dt><dt><span class="section"><a href="sitemap.html#sitemaps.spring">3.4. Spring integration</a></span></dt><dt><span class="section"><a href="sitemap.html#sitemaps.embedding">3.5. Embedding a sitemap</a></span></dt></dl></dd><dt><span class="chapter"><a href="webapps.html">4. Web applications</a></span></dt><dd><dl><dt><span class="section"><a href="webapps.html#webapps.scenarios">4.1. Usage scenarios</a></span></dt><dt><span class="section"><a href="webapps.html#webapps.servlet-service-fw">4.2. Servlet-Service framework integration</a></span></dt><dt><s
 pan class="section"><a href="webapps.html#webapps.http-environments">4.3. Sitemaps in an HTTP environement</a></span></dt><dt><span class="section"><a href="webapps.html#webapps.system-setup">4.4. System setup</a></span></dt><dt><span class="section"><a href="webapps.html#webapps.pipeline-fragments">4.5. Connecting pipeline fragments</a></span></dt><dt><span class="section"><a href="webapps.html#webapps.rest">4.6. RESTful web services</a></span></dt><dt><span class="section"><a href="webapps.html#webapps.caching">4.7. Caching and conditional GET requests</a></span></dt><dt><span class="section"><a href="webapps.html#webapps.auth">4.8. Authentication</a></span></dt><dt><span class="section"><a href="webapps.html#webapps.testing">4.9. Testing</a></span></dt><dt><span class="section"><a href="webapps.html#webapps.tutorial">4.10. Tutorial</a></span></dt></dl></dd></dl></div></div><div xmlns:fo="http://www.w3.org/1999/XSL/Format" class="navfooter"><hr><table width="100%" summary=
 "Navigation footer"><tr><td width="40%" align="left">&nbsp;</td><td width="20%" align="center">&nbsp;</td><td width="40%" align="right">&nbsp;<a accesskey="n" href="introduction.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">&nbsp;</td><td width="20%" align="center"><span style="color:white;font-size:85%;"><a href="http://cocoon.apache.org/3.0/" title="The Apache Cocoon community">The Apache Cocoon community</a></span></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;1.&nbsp;Introduction</td></tr></table></div></body></html>
+      Notice, whether distributed in print or electronically.</p></div></div></div><hr></div><div class="toc"><dl><dt><span class="chapter"><a href="introduction.html">1. Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="introduction.html#introduction.why-cocoon3">1.1. Why Cocoon 3 - Motivation</a></span></dt><dt><span class="section"><a href="introduction.html#introduction.previous-versions">1.2. Relationship to previous versions</a></span></dt><dt><span class="section"><a href="introduction.html#introduction.requirements">1.3. Requirements</a></span></dt></dl></dd><dt><span class="chapter"><a href="pipelines.html">2. Pipelines</a></span></dt><dd><dl><dt><span class="section"><a href="pipelines.html#pipelines.definition">2.1. What is a pipeline?</a></span></dt><dd><dl><dt><span class="section"><a href="pipelines.html#d0e88">2.1.1. Linear pipelines</a></span></dt><dt><span class="section"><a href="pipelines.html#d0e98">2.1.2. Pipelines by example</a></sp
 an></dt></dl></dd><dt><span class="section"><a href="pipelines.html#pipelines.implementations">2.2. Pipeline implementations</a></span></dt><dt><span class="section"><a href="pipelines.html#pipelines.embedding">2.3. Embedding a pipeline</a></span></dt><dt><span class="section"><a href="pipelines.html#pipeline.sax">2.4. SAX components</a></span></dt><dd><dl><dt><span class="section"><a href="pipelines.html#d0e363">2.4.1. Available components</a></span></dt><dt><span class="section"><a href="pipelines.html#d0e368">2.4.2. Writing custom components</a></span></dt><dd><dl><dt><span class="section"><a href="pipelines.html#d0e371">2.4.2.1. SAX generator</a></span></dt><dt><span class="section"><a href="pipelines.html#d0e376">2.4.2.2. SAX transformer</a></span></dt><dt><span class="section"><a href="pipelines.html#d0e383">2.4.2.3. SAX serializer</a></span></dt></dl></dd></dl></dd><dt><span class="section"><a href="pipelines.html#pipeline.stax">2.5. StAX components</a></span></dt><dd
 ><dl><dt><span class="section"><a href="pipelines.html#d0e393">2.5.1. Available components</a></span></dt><dt><span class="section"><a href="pipelines.html#d0e398">2.5.2. Writing custom components</a></span></dt><dd><dl><dt><span class="section"><a href="pipelines.html#d0e401">2.5.2.1. StAX generator</a></span></dt><dt><span class="section"><a href="pipelines.html#d0e406">2.5.2.2. StAX transformer</a></span></dt><dt><span class="section"><a href="pipelines.html#d0e413">2.5.2.3. StAX serializer</a></span></dt></dl></dd><dt><span class="section"><a href="pipelines.html#d0e418">2.5.3. Using StAX and SAX components in the same pipeline</a></span></dt><dt><span class="section"><a href="pipelines.html#d0e422">2.5.4. Java 1.5 support</a></span></dt></dl></dd><dt><span class="section"><a href="pipelines.html#pipelines.utils">2.6. Utilities</a></span></dt></dl></dd><dt><span class="chapter"><a href="sitemap.html">3. Sitemaps</a></span></dt><dd><dl><dt><span class="section"><a href="s
 itemap.html#sitemaps.definition">3.1. What is a sitemap?</a></span></dt><dt><span class="section"><a href="sitemap.html#sitemaps.evaluation">3.2. Sitemap evaluation?</a></span></dt><dt><span class="section"><a href="sitemap.html#sitemaps.expression-languages">3.3. Expression languages</a></span></dt><dt><span class="section"><a href="sitemap.html#sitemaps.spring">3.4. Spring integration</a></span></dt><dt><span class="section"><a href="sitemap.html#sitemaps.embedding">3.5. Embedding a sitemap</a></span></dt></dl></dd><dt><span class="chapter"><a href="webapps.html">4. Web applications</a></span></dt><dd><dl><dt><span class="section"><a href="webapps.html#webapps.scenarios">4.1. Usage scenarios</a></span></dt><dt><span class="section"><a href="webapps.html#webapps.servlet-service-fw">4.2. Servlet-Service framework integration</a></span></dt><dt><span class="section"><a href="webapps.html#webapps.http-environments">4.3. Sitemaps in an HTTP environement</a></span></dt><dt><span
  class="section"><a href="webapps.html#webapps.system-setup">4.4. System setup</a></span></dt><dt><span class="section"><a href="webapps.html#webapps.pipeline-fragments">4.5. Connecting pipeline fragments</a></span></dt><dt><span class="section"><a href="webapps.html#webapps.rest">4.6. RESTful web services</a></span></dt><dt><span class="section"><a href="webapps.html#webapps.caching">4.7. Caching and conditional GET requests</a></span></dt><dt><span class="section"><a href="webapps.html#webapps.auth">4.8. Authentication</a></span></dt><dt><span class="section"><a href="webapps.html#webapps.testing">4.9. Testing</a></span></dt><dt><span class="section"><a href="webapps.html#webapps.tutorial">4.10. Tutorial</a></span></dt></dl></dd></dl></div></div><div xmlns:fo="http://www.w3.org/1999/XSL/Format" class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left">&nbsp;</td><td width="20%" align="center">&nbsp;</td><td width="40%" align="ri
 ght">&nbsp;<a accesskey="n" href="introduction.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">&nbsp;</td><td width="20%" align="center"><span style="color:white;font-size:85%;"><a href="http://cocoon.apache.org/3.0/" title="The Apache Cocoon community">The Apache Cocoon community</a></span></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;1.&nbsp;Introduction</td></tr></table></div></body></html>

Modified: cocoon/site/site/3.0/reference/html/introduction.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/3.0/reference/html/introduction.html?rev=734183&r1=734182&r2=734183&view=diff
==============================================================================
--- cocoon/site/site/3.0/reference/html/introduction.html (original)
+++ cocoon/site/site/3.0/reference/html/introduction.html Tue Jan 13 09:10:04 2009
@@ -1,3 +1,20 @@
 <html><head>
       <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-   <title>Chapter&nbsp;1.&nbsp;Introduction</title><link rel="stylesheet" href="css/html.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.72.0"><link rel="start" href="index.html" title="Cocoon 3.0 ALPHA - Reference Documentation"><link rel="up" href="index.html" title="Cocoon 3.0 ALPHA - Reference Documentation"><link rel="prev" href="index.html" title="Cocoon 3.0 ALPHA - Reference Documentation"><link rel="next" href="pipelines.html" title="Chapter&nbsp;2.&nbsp;Pipelines"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div xmlns:fo="http://www.w3.org/1999/XSL/Format" id="top"><div id="header"><div class="projectlogo"><a href="./"><img class="logoImage" src="images/cocoon_logo.jpg" alt="Apache Cocoon" border="0"></a></div></div></div><div xmlns:fo="http://www.w3.org/1999/XSL/Format" class="mhSpacer"></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="introdu
 ction"></a>Chapter&nbsp;1.&nbsp;Introduction</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="introduction.why-cocoon3"></a>1.1.&nbsp;Why Cocoon 3 - Motivation</h2></div></div></div><p>TBW</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="introduction.requirements"></a>1.2.&nbsp;Requirements</h2></div></div></div><p>TBW</p></div></div><div xmlns:fo="http://www.w3.org/1999/XSL/Format" class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="index.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="pipelines.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Cocoon 3.0 ALPHA - Reference Documentation&nbsp;</td><td width="20%" alig
 n="center"><span style="color:white;font-size:85%;"><a href="http://cocoon.apache.org/3.0/" title="The Apache Cocoon community">The Apache Cocoon community</a></span></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;2.&nbsp;Pipelines</td></tr></table></div></body></html>
+   <title>Chapter&nbsp;1.&nbsp;Introduction</title><link rel="stylesheet" href="css/html.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.72.0"><link rel="start" href="index.html" title="Cocoon 3.0 ALPHA - Reference Documentation"><link rel="up" href="index.html" title="Cocoon 3.0 ALPHA - Reference Documentation"><link rel="prev" href="index.html" title="Cocoon 3.0 ALPHA - Reference Documentation"><link rel="next" href="pipelines.html" title="Chapter&nbsp;2.&nbsp;Pipelines"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div xmlns:fo="http://www.w3.org/1999/XSL/Format" id="top"><div id="header"><div class="projectlogo"><a href="./"><img class="logoImage" src="images/cocoon_logo.jpg" alt="Apache Cocoon" border="0"></a></div></div></div><div xmlns:fo="http://www.w3.org/1999/XSL/Format" class="mhSpacer"></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="introdu
 ction"></a>Chapter&nbsp;1.&nbsp;Introduction</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="introduction.why-cocoon3"></a>1.1.&nbsp;Why Cocoon 3 - Motivation</h2></div></div></div><p>
+      The main idea behind Cocoon is the concept of pipelines. Cocoon 1.x and 2.x
+      applied this idea with a focus on web applications.
+      But sometimes pipelines would be useful although you don't develop a web application.
+      Those former Cocoon versions don't really help you in that case. 
+    </p><p>
+      In contrast, Cocoon 3 follows a layered approach so that its basic module - 
+      the pipeline module - can be used from within any Java environment without 
+      requiring you adding a huge stack of dependencies. 
+    </p><p>
+      On top of this, Cocoon 3 has the goal to make the development of 
+      RESTful web services and web applications a simple task.
+    </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="introduction.previous-versions"></a>1.2.&nbsp;Relationship to previous versions</h2></div></div></div><p>
+      Cocoon 3 has been built completely from scratch and doesn't have any dependencies
+      on Cocoon 2.x or 1.x. 
+    </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="introduction.requirements"></a>1.3.&nbsp;Requirements</h2></div></div></div><p>
+      Cocoon 3 requires Java 5 or higher.
+    </p></div></div><div xmlns:fo="http://www.w3.org/1999/XSL/Format" class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="index.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="pipelines.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Cocoon 3.0 ALPHA - Reference Documentation&nbsp;</td><td width="20%" align="center"><span style="color:white;font-size:85%;"><a href="http://cocoon.apache.org/3.0/" title="The Apache Cocoon community">The Apache Cocoon community</a></span></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;2.&nbsp;Pipelines</td></tr></table></div></body></html>