You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@cocoon.apache.org by as...@apache.org on 2007/09/08 22:17:47 UTC

svn commit: r573901 [12/44] - in /cocoon/site: site/ site/2.0/ site/2.0/developing/ site/2.0/faq/ site/2.0/howto/chaperon/ site/2.0/installing/ site/2.0/plan/ site/2.0/snippet/ site/2.0/tutorial/ site/2.0/userdocs/ site/2.0/userdocs/actions/ site/2.0/u...

Modified: cocoon/site/site/2.0/faq/faq-sitemap.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/2.0/faq/faq-sitemap.html?rev=573901&r1=573900&r2=573901&view=diff
==============================================================================
--- cocoon/site/site/2.0/faq/faq-sitemap.html (original)
+++ cocoon/site/site/2.0/faq/faq-sitemap.html Sat Sep  8 13:17:41 2007
@@ -1,752 +1,752 @@
-<html>
-<head>
-<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Sitemap FAQs</title>
-<STYLE type="text/css">
-a.menu {
-	color: #FFFFFF;
-    text-align:left;               
-    font-size:12px;
-    font-family: Verdana, Arial, Helvetica, sans-serif;
-    font-weight:plain;
-    text-decoration:none;
-    padding-left: 14px
-}
-
-A.menu:hover {
-	color: #FFCC00
-}
-
-
-.menutitle {
-	color: #000000;
-    text-align:left;               
-    font-size:10px;
-    font-family: Verdana, Arial, Helvetica, sans-serif;
-    font-weight:bold;
-    padding-left: 8px
-}
-.menuselected {
-	color: #FFCC00;
-    text-align:left;               
-    font-size:12px;
-    font-family: Verdana, Arial, Helvetica, sans-serif;
-    font-weight:bold;
-    padding-left: 14px
-}
-</STYLE>
-</head>
-<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#cc0000" vlink="#0086b2" link="#039acc" text="#000000">
-<table border="0" cellpadding="0" cellspacing="0" width="100%">
-<tr>
-<td align="left" valign="top" rowspan="3" height="60" width="135"><img border="0" vspace="0" hspace="0" src="images/logo.gif" height="60" width="135"></td><td background="images/line.gif" rowspan="1" colSpan="2" align="left" valign="top" height="0" width="100%"></td><td align="left" valign="top" rowspan="3" height="60" width="29"><img border="0" vspace="0" hspace="0" src="images/right.gif" height="60" width="29"></td>
-</tr>
-<tr>
-<td bgcolor="#0086b2" colspan="2" align="right" valign="top" height="35" width="100%"><font color="#ffffff" face="Verdana, Arial, Helvetica, sans-serif" size="5">Sitemap FAQs</font></td>
-</tr>
-<tr>
-<td background="images/bottom.gif" colspan="2" width="100%" valign="top" height="20" bgcolor="#0086b2" align="right">
-<table width="288" cellspacing="0" cellpadding="0" border="0">
-<tr>
-<td align="left" valign="top" height="20" width="96"><a target="new" href="http://xml.apache.org/"><img border="0" vspace="0" hspace="0" name="xml" src="images/button-xml-lo.gif" height="20" width="96" alt="http://xml.apache.org/"></a></td><td align="left" valign="top" height="20" width="96"><a target="new" href="http://www.apache.org/"><img border="0" vspace="0" hspace="0" name="asf" src="images/button-asf-lo.gif" height="20" width="96" alt="http://www.apache.org/"></a></td><td align="left" valign="top" height="20" width="96"><a target="new" href="http://www.w3.org/"><img border="0" vspace="0" hspace="0" name="w3c" src="images/button-w3c-lo.gif" height="20" width="96" alt="http://www.w3.org/"></a></td>
-</tr>
-</table>
-</td>
-</tr>
-</table>
-<table width="100%" cellspacing="0" cellpadding="0" border="0">
-<tr width="100%">
-<td align="left" valign="top" width="120">
-<table width="120" cellspacing="0" cellpadding="0" border="0" bgcolor="#a0a0a0">
-<tr>
-<td valign="top" align="left"><img width="120" vspace="0" src="images/join.gif" hspace="0" height="14" border="0"><br>
-</td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../index.html">Main</a></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">FAQs</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="index.html">Index</a></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">Getting Started</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-install.html">Install</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-configure-environment.html">Configure</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-cvs.html">CVS</a></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">Using</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-configure-c2.html">Configure C2</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-databases.html">Databases</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-xsp.html">XSP</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-xslt.html">XSLT</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-debugging.html">Debugging</a></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">Sitemap</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><span class="menuselected">Sitemap</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-generators.html">Generators</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-transformers.html">Transformers</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-serializers.html">Serializers</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-matchers.html">Matchers</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-selectors.html">Selectors</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-actions.html">Actions</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-aggregators.html">Aggregators</a></td>
-</tr>
-<tr>
-<td align="left" valign="top"><img width="120" vspace="0" src="images/close.gif" hspace="0" height="14" border="0"><br>
-</td>
-</tr>
-</table>
-</td><td>
-<table cellspacing="15" cellpadding="0" border="0">
-<tr>
-<td><font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Questions</font>
-<hr style="color: #0086b2" size="1">
-<blockquote>
-<ul>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-1">
-    What are the steps to pre-compile the sitemap and XSP's?
-  </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-2">I don't want to hand edit the sitemap.  Are there any
-   tools?</a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-3">How do I create some content which isn't directly visible to
-   everyone?</a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-4">How can I concatenate two xml files?</a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-5">I want to use the XXX matcher/serializer/selecter/etc but there's no
-   examples :(</a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-6">
-    I changed the sitemap, but my changes don't show in the browser.
-    Do I need to restart the servlet container?
-  </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-7">When I add an action to a pipeline Cocoon returns an
-  error.</a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-8">
-    What is the syntax for absolute filesystem pathnames.
-  </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-9">
-What's the difference between having two pipelines with one matcher 
-each, and one pipeline with two matchers?
-  </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-10">
-Where can I find more information about the sitemap?
-  </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-11">
-  How can I add my FAQ to this document? 
- </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-12">
-  How can I suggest improvements to existing FAQs?
- </a></font>
-</li>
-</ul>
-</blockquote>
-<font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Answers</font>
-<hr style="color: #0086b2" size="1">
-<a name="faq-1">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
-    What are the steps to pre-compile the sitemap and XSP's?
-  </b></font>
-  
-  
-    
-<blockquote>
-<ul>
-      
-<li>
-<font face="verdana, helvetica, sans serif">Set the auto-reload to false in your sitemap.xmap as follows:</font>
-</li>
-    
-</ul>
-</blockquote>
-
-    
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
-&lt;parameter name="auto-reload" value="false"/&gt;
-</pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-    
-<blockquote>
-<ul>
-      
-<li>
-<font face="verdana, helvetica, sans serif">Use "-Dbuild.precompile=true" in your build command line when you are
-        building your WAR file.
-      </font>
-</li>
-    
-</ul>
-</blockquote>
-  
-
-<a name="faq-2">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>I don't want to hand edit the sitemap.  Are there any
-   tools?</b></font>
- 
- 
-   
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Try <a target="_blank" href="http://pollo.sourceforge.net/">this</a>
-     by Bruno Dumon.</font>
-</p>
- 
-
-<a name="faq-3">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>How do I create some content which isn't directly visible to
-   everyone?</b></font>
- 
- 
-   
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Put the content in an internal pipeline...</font>
-</p>
-
-   
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
-&lt;map:pipelines&gt;
- &lt;map:pipeline internal-only="true"&gt;
-   &lt;map:match pattern="int"&gt;
-     &lt;map:generate src="docs/description.xml"/&gt;
-     &lt;map:serialize type="xml"/&gt;
-   &lt;/map:match&gt;
- &lt;/map:pipeline&gt;
- &lt;map:pipeline&gt;
-   &lt;map:match pattern="desc.html"&gt;
-     &lt;map:generate src="cocoon:/int"/&gt;
-     &lt;map:transform src="stylesheets/description2html.xsl"/&gt;
-     &lt;map:serialize type="html"/&gt;
-   &lt;/map:match&gt;
- &lt;/map:pipeline&gt;
-&lt;/map:pipelines&gt;
-</pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
- 
-
-<a name="faq-4">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>How can I concatenate two xml files?</b></font>
- 
- 
-   
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
-&lt;map:pipelines&gt;
- &lt;map:pipeline internal-only="true"&gt;
-   &lt;map:match pattern="one"&gt;
-     &lt;map:generate src="docs/one.xml"/&gt;
-     &lt;map:serialize type="xml"/&gt;
-   &lt;/map:match&gt;
-   &lt;map:match pattern="two"&gt;
-     &lt;map:generate src="docs/two.xml"/&gt;
-     &lt;map:serialize type="xml"/&gt;
-   &lt;/map:match&gt;
- &lt;/map:pipeline&gt;
- &lt;map:pipeline&gt;
-   &lt;map:match pattern="desc.html"&gt;
-     &lt;map:aggregate element="newRootElement"&gt;
-       &lt;map:part src="cocoon:/one" element="firstXMLfile"/&gt;
-       &lt;map:part src="cocoon:/two" element="secondXMLfile"/&gt;
-     &lt;/map:aggregate&gt;
-     &lt;map:transform src="stylesheets/merge2html.xsl"/&gt;
-     &lt;map:serialize type="html"/&gt;
-   &lt;/map:match&gt;
- &lt;/map:pipeline&gt;
-&lt;/map:pipelines&gt;
-</pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-   
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Where the element attribute names are replaced with something more
-     meaningful!  Note that the map:part element attributes can be left off,
-     which results in the two parts being placed one immediately after the
-     other.</font>
-</p>
- 
-
-<a name="faq-5">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>I want to use the XXX matcher/serializer/selecter/etc but there's no
-   examples :(</b></font>
- 
- 
-   
-<p>
-<font color="black" face="verdana,helvetica,sanserif">If you've checked the sample webapps which come with Cocoon, and you've
-     looked in the documentation, then check both the user and
-     dev archives.  If it hasn't been resolved before <b>first</b>
-     email the user group and, after a <b>reasonable</b> (ie 1 or 2
-     days) length of time (remember not everyone lives in your timezone) email
-     the dev group.</font>
-</p>
-   
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Please don't cross-post to both the user and dev groups - very few people
-     like getting bombarded!</font>
-</p>
-   
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Oh, and once you do get it working - how about documenting it and
-     contributing it back to the group?</font>
-</p>
- 
-
-<a name="faq-6">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
-    I changed the sitemap, but my changes don't show in the browser.
-    Do I need to restart the servlet container?
-  </b></font>
-  
-  
-    
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Cocoon lets you decide whether it needs to poll for sitemap changes
-    (with its associated performance penalty) or not. It also lets you decide whether the re-compilation resulting from polling shoud happen in the
-    background or in the foreground.</font>
-</p>
-
-    
-<p>
-<font color="black" face="verdana,helvetica,sanserif">If you look at the cocoon.xconf file, you'll notice this element:</font>
-</p>
-    
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
-&lt;sitemap file="sitemap.xmap"
-         reload-method="asynchron"
-         check-reload="yes"/&gt;</pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-    
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Which means:</font>
-</p>
-      
-<blockquote>
-<ul>
-        
-<li>
-<font face="verdana, helvetica, sans serif">The <code><font face="courier, monospaced">check-reload</font></code> attribute determines if the sitemap
-        is reloaded on change. Set to "no", the sitemap is generated once
-        at startup. Set to "yes", the sitemap is regenerated if it changes.</font>
-</li>
-        
-<li>
-<font face="verdana, helvetica, sans serif">The <code><font face="courier, monospaced">reload-method</font></code> specifies the method for the
-          regeneration:
-          <blockquote>
-<ol>
-            
-<li>
-<font face="verdana, helvetica, sans serif"><code><font face="courier, monospaced">asynchron</font></code>: If the sitemap changes, the sitemap is
-            regenerated at the next request in the background and the incoming
-            request is served with the old sitemap. All subsequent requests
-            are served with the old sitemap until the regeneration in the
-            background has finished.</font>
-</li>
-            
-<li>
-<font face="verdana, helvetica, sans serif"><code><font face="courier, monospaced">synchron</font></code>: If the sitemap changes, the sitemap
-            is regenerated at the next request. When the regeneration is
-            finished, the request (and all subsequent ones) is served with
-            the new sitemap.</font>
-</li>
-          
-</ol>
-</blockquote>
-        
-</font>
-</li>
-      
-</ul>
-</blockquote>
-    
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-      For a development environment, set the reload-method to "synchron" and the
-      check-reload to "yes." For a production environment, 
-      set the reload-method to "asynchron." For more safety, set the check-reload
-      to "no."
-    </font>
-</p>
-
-    
-<p>
-<font color="black" face="verdana,helvetica,sanserif">In a nutshell: By default, reload is "asynchron" which means:</font>
-</p>
-      
-<blockquote>
-<ol>
-        
-<li>
-<font face="verdana, helvetica, sans serif">Change sitemap</font>
-</li>
-        
-<li>
-<font face="verdana, helvetica, sans serif">Hit reload</font>
-</li>
-        
-<li>
-<font face="verdana, helvetica, sans serif">Wait while CPU goes up to 100% and back down to 0%</font>
-</li>
-        
-<li>
-<font face="verdana, helvetica, sans serif">Hit reload</font>
-</li>
-        
-<li>
-<font face="verdana, helvetica, sans serif">Voila - new sitemap is used! :)</font>
-</li>
-      
-</ol>
-</blockquote>
-    
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Hence: you don't need to restart the servlet container.</font>
-</p>
-
-    
-<p>
-<font color="black" face="verdana,helvetica,sanserif">For sub-sitemaps, this issue is defined in the mounting element:</font>
-</p>
-    
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
-&lt;map:mount uri-prefix="foo" src="file:///c:/foo/"
-           check-reload="yes"
-           reload-method="synchron"/&gt;</pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-    
-<p>
-<font color="black" face="verdana,helvetica,sanserif">With these settings Cocoon will react to any changes in the sub-sitemap,
-      without even hitting the reload button twice. :)</font>
-</p>
-    
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-      Moreover, it is a good idea to use sub-sitemaps because they reduce
-      overall compilation time. For example, changes to a single sub-sitemap won't 
-      require recompilation for the the main sitemap or other sub-sitemaps. This
-      practice leads to greater degree of modularity.
-    </font>
-</p>
-  
-
-<a name="faq-7">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>When I add an action to a pipeline Cocoon returns an
-  error.</b></font>
-  
-  
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Before the action was added to the pipeline it worked fine. After
-  the change Cocoon seems not to find the file specified in the
-  variable that is returned by the matcher.</font>
-</p>
-
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
-&lt;map:match pattern="*"&gt;
-  &lt;map:act type="validate-session"&gt;
-    &lt;map:generate type="serverpages" src="{../1}.xsp"/&gt;
-  &lt;/map:act&gt;
-  &lt;map:serialize/&gt;
-&lt;/map:match&gt;
-</pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Please note in the above example the
-  "<b><code><font face="courier, monospaced">../1</font></code></b>".</font>
-</p> 
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Map objects returned from matchers, actions etc. are organised
-  <i>hierarchically</i>. Therefore they are not replaced by new ones
-  but older ones are still accessible through a path expression. Here
-  "<code><font face="courier, monospaced">../1</font></code>" references key ("variable") "1" in the next to
-  last Map. </font>
-</p>
-  
-
-<a name="faq-8">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
-    What is the syntax for absolute filesystem pathnames.
-  </b></font>
-  
-  
-   
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-    In your sitemaps you may need to refer to some resource that is outside
-    the webapp context (e.g. UNIX /foo/bar/this.xsl
-    e.g. Windows C:\foo\bar\this.xsl). You need to use the file: convention.
-   </font>
-</p>
-   
-<blockquote>
-<ul>
-    
-<li>
-<font face="verdana, helvetica, sans serif">UNIX ... <code><font face="courier, monospaced">file:///foo/bar/this.xsl</font></code></font>
-</li>
-    
-<li>
-<font face="verdana, helvetica, sans serif">Windows ... <code><font face="courier, monospaced">file:///C:/foo/bar/this.xsl</font></code></font>
-</li>
-   
-</ul>
-</blockquote>
-   
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-    See further explanation of
-    <a href="../userdocs/concepts/sitemap.html#file-url">file: URLs</a>
-   </font>
-</p>
-  
-
-<a name="faq-9">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
-What's the difference between having two pipelines with one matcher 
-each, and one pipeline with two matchers?
-  </b></font>
-  
-  
-   
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-If there is no other difference in pipeline declarations, then none, really. Note that pipelines can differ by:
-  </font>
-</p>
-
-<blockquote>
-<ul>
-	
-<li>
-<font face="verdana, helvetica, sans serif">
-visibility: internal-only="true" (not accessible for external requests) or not.
-   </font>
-</li>
-   
-<li>
-<font face="verdana, helvetica, sans serif">
-error handling: using different &lt;handle-errors&gt;s.
-   </font>
-</li>
-   
-<li>
-<font face="verdana, helvetica, sans serif">
-cachability (since 2.1): some requests can use cached responses
-from caching pipeline. Others, which should not be cached, can be
-handled by the non-caching pipeline implementation.
-  </font>
-</li>
-  
-<li>
-<font face="verdana, helvetica, sans serif">
-logical grouping: logically-related components can be grouped into
-separate pipelines to improve readability and ease administrative concerns.
-  </font>
-</li>
-  
-<li>
-<font face="verdana, helvetica, sans serif">
-ids: used to identify pipeline and other elements. See the "sitebuilder" sitemap editor
-in scratchpad samples for an example.
-  </font>
-</li>
-
-</ul>
-</blockquote>
- 
- 
-<a name="faq-10">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
-Where can I find more information about the sitemap?
-  </b></font>
-  
-  
-   
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-Learn more about advanced Sitemap features by downloading the free chapter, <a href="http://www.newriders.com/books/product.asp?product_id={C3C05052-BE3B-4E06-A60A-13FB40AF58F6}">A User's Look at the Cocoon architecture,</a> from Langham and Ziegeler's <i>Cocoon: Building XML Applications</i> available at the New Riders web site.
-  </font>
-</p>
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-Check out a draft XML Schema <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/cocoon-2.0/src/documentation/xdocs/drafts/sitemap-2.1-draft.xsd?rev=HEAD&content-type=text/plain">grammar for the Cocoon sitemap</a>, and some <a href="http://outerthought.net/sitemap/">external documentation</a> generated from this Schema. A poster diagram of the sitemap structure is also available.
-   </font>
-</p>
-  
-  
-<a name="faq-11">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
-  How can I add my FAQ to this document? 
- </b></font>
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-   Follow the instructions found in <a href="../howto/howto-author-faq.html">How-To Author an FAQ.</a></font>
-</p>
-<a name="faq-12">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
-  How can I suggest improvements to existing FAQs?
- </b></font>
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-  Given the rapid pace of change with Cocoon, many individual FAQs quickly become out-of-date and confusing to new users. If you have the relevant knowledge, please consider updating other FAQs on this page for technical errors. If you see a few typos, please consider fixing them too.  Follow the instructions found in <a href="../howto/howto-author-faq.html">How-To Author an FAQ.</a></font>
-</p>
-</td>
-</tr>
-</table>
-</td>
-</tr>
-</table>
-<table width="100%" cellspacing="0" cellpadding="0" border="0">
-<tr>
-<td bgcolor="#0086b2"><img width="1" src="images/dot.gif" height="1"></td>
-</tr>
-<tr>
-<td align="center"><font size="-1" face="arial,helvetica,sanserif" color="#0086b2"><i>Copyright &copy; 1999-2002 The Apache Software Foundation. All Rights Reserved.</i></font></td>
-</tr>
-</table>
-</body>
-</html>
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Sitemap FAQs</title>
+<STYLE type="text/css">
+a.menu {
+	color: #FFFFFF;
+    text-align:left;               
+    font-size:12px;
+    font-family: Verdana, Arial, Helvetica, sans-serif;
+    font-weight:plain;
+    text-decoration:none;
+    padding-left: 14px
+}
+
+A.menu:hover {
+	color: #FFCC00
+}
+
+
+.menutitle {
+	color: #000000;
+    text-align:left;               
+    font-size:10px;
+    font-family: Verdana, Arial, Helvetica, sans-serif;
+    font-weight:bold;
+    padding-left: 8px
+}
+.menuselected {
+	color: #FFCC00;
+    text-align:left;               
+    font-size:12px;
+    font-family: Verdana, Arial, Helvetica, sans-serif;
+    font-weight:bold;
+    padding-left: 14px
+}
+</STYLE>
+</head>
+<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#cc0000" vlink="#0086b2" link="#039acc" text="#000000">
+<table border="0" cellpadding="0" cellspacing="0" width="100%">
+<tr>
+<td align="left" valign="top" rowspan="3" height="60" width="135"><img border="0" vspace="0" hspace="0" src="images/logo.gif" height="60" width="135"></td><td background="images/line.gif" rowspan="1" colSpan="2" align="left" valign="top" height="0" width="100%"></td><td align="left" valign="top" rowspan="3" height="60" width="29"><img border="0" vspace="0" hspace="0" src="images/right.gif" height="60" width="29"></td>
+</tr>
+<tr>
+<td bgcolor="#0086b2" colspan="2" align="right" valign="top" height="35" width="100%"><font color="#ffffff" face="Verdana, Arial, Helvetica, sans-serif" size="5">Sitemap FAQs</font></td>
+</tr>
+<tr>
+<td background="images/bottom.gif" colspan="2" width="100%" valign="top" height="20" bgcolor="#0086b2" align="right">
+<table width="288" cellspacing="0" cellpadding="0" border="0">
+<tr>
+<td align="left" valign="top" height="20" width="96"><a target="new" href="http://xml.apache.org/"><img border="0" vspace="0" hspace="0" name="xml" src="images/button-xml-lo.gif" height="20" width="96" alt="http://xml.apache.org/"></a></td><td align="left" valign="top" height="20" width="96"><a target="new" href="http://www.apache.org/"><img border="0" vspace="0" hspace="0" name="asf" src="images/button-asf-lo.gif" height="20" width="96" alt="http://www.apache.org/"></a></td><td align="left" valign="top" height="20" width="96"><a target="new" href="http://www.w3.org/"><img border="0" vspace="0" hspace="0" name="w3c" src="images/button-w3c-lo.gif" height="20" width="96" alt="http://www.w3.org/"></a></td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+<table width="100%" cellspacing="0" cellpadding="0" border="0">
+<tr width="100%">
+<td align="left" valign="top" width="120">
+<table width="120" cellspacing="0" cellpadding="0" border="0" bgcolor="#a0a0a0">
+<tr>
+<td valign="top" align="left"><img width="120" vspace="0" src="images/join.gif" hspace="0" height="14" border="0"><br>
+</td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../index.html">Main</a></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">FAQs</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="index.html">Index</a></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">Getting Started</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-install.html">Install</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-configure-environment.html">Configure</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-cvs.html">CVS</a></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">Using</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-configure-c2.html">Configure C2</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-databases.html">Databases</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-xsp.html">XSP</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-xslt.html">XSLT</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-debugging.html">Debugging</a></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">Sitemap</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><span class="menuselected">Sitemap</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-generators.html">Generators</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-transformers.html">Transformers</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-serializers.html">Serializers</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-matchers.html">Matchers</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-selectors.html">Selectors</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-actions.html">Actions</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-aggregators.html">Aggregators</a></td>
+</tr>
+<tr>
+<td align="left" valign="top"><img width="120" vspace="0" src="images/close.gif" hspace="0" height="14" border="0"><br>
+</td>
+</tr>
+</table>
+</td><td>
+<table cellspacing="15" cellpadding="0" border="0">
+<tr>
+<td><font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Questions</font>
+<hr style="color: #0086b2" size="1">
+<blockquote>
+<ul>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-1">
+    What are the steps to pre-compile the sitemap and XSP's?
+  </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-2">I don't want to hand edit the sitemap.  Are there any
+   tools?</a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-3">How do I create some content which isn't directly visible to
+   everyone?</a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-4">How can I concatenate two xml files?</a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-5">I want to use the XXX matcher/serializer/selecter/etc but there's no
+   examples :(</a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-6">
+    I changed the sitemap, but my changes don't show in the browser.
+    Do I need to restart the servlet container?
+  </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-7">When I add an action to a pipeline Cocoon returns an
+  error.</a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-8">
+    What is the syntax for absolute filesystem pathnames.
+  </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-9">
+What's the difference between having two pipelines with one matcher 
+each, and one pipeline with two matchers?
+  </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-10">
+Where can I find more information about the sitemap?
+  </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-11">
+  How can I add my FAQ to this document? 
+ </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-12">
+  How can I suggest improvements to existing FAQs?
+ </a></font>
+</li>
+</ul>
+</blockquote>
+<font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Answers</font>
+<hr style="color: #0086b2" size="1">
+<a name="faq-1">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+    What are the steps to pre-compile the sitemap and XSP's?
+  </b></font>
+  
+  
+    
+<blockquote>
+<ul>
+      
+<li>
+<font face="verdana, helvetica, sans serif">Set the auto-reload to false in your sitemap.xmap as follows:</font>
+</li>
+    
+</ul>
+</blockquote>
+
+    
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+&lt;parameter name="auto-reload" value="false"/&gt;
+</pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+    
+<blockquote>
+<ul>
+      
+<li>
+<font face="verdana, helvetica, sans serif">Use "-Dbuild.precompile=true" in your build command line when you are
+        building your WAR file.
+      </font>
+</li>
+    
+</ul>
+</blockquote>
+  
+
+<a name="faq-2">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>I don't want to hand edit the sitemap.  Are there any
+   tools?</b></font>
+ 
+ 
+   
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Try <a target="_blank" href="http://pollo.sourceforge.net/">this</a>
+     by Bruno Dumon.</font>
+</p>
+ 
+
+<a name="faq-3">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>How do I create some content which isn't directly visible to
+   everyone?</b></font>
+ 
+ 
+   
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Put the content in an internal pipeline...</font>
+</p>
+
+   
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+&lt;map:pipelines&gt;
+ &lt;map:pipeline internal-only="true"&gt;
+   &lt;map:match pattern="int"&gt;
+     &lt;map:generate src="docs/description.xml"/&gt;
+     &lt;map:serialize type="xml"/&gt;
+   &lt;/map:match&gt;
+ &lt;/map:pipeline&gt;
+ &lt;map:pipeline&gt;
+   &lt;map:match pattern="desc.html"&gt;
+     &lt;map:generate src="cocoon:/int"/&gt;
+     &lt;map:transform src="stylesheets/description2html.xsl"/&gt;
+     &lt;map:serialize type="html"/&gt;
+   &lt;/map:match&gt;
+ &lt;/map:pipeline&gt;
+&lt;/map:pipelines&gt;
+</pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+ 
+
+<a name="faq-4">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>How can I concatenate two xml files?</b></font>
+ 
+ 
+   
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+&lt;map:pipelines&gt;
+ &lt;map:pipeline internal-only="true"&gt;
+   &lt;map:match pattern="one"&gt;
+     &lt;map:generate src="docs/one.xml"/&gt;
+     &lt;map:serialize type="xml"/&gt;
+   &lt;/map:match&gt;
+   &lt;map:match pattern="two"&gt;
+     &lt;map:generate src="docs/two.xml"/&gt;
+     &lt;map:serialize type="xml"/&gt;
+   &lt;/map:match&gt;
+ &lt;/map:pipeline&gt;
+ &lt;map:pipeline&gt;
+   &lt;map:match pattern="desc.html"&gt;
+     &lt;map:aggregate element="newRootElement"&gt;
+       &lt;map:part src="cocoon:/one" element="firstXMLfile"/&gt;
+       &lt;map:part src="cocoon:/two" element="secondXMLfile"/&gt;
+     &lt;/map:aggregate&gt;
+     &lt;map:transform src="stylesheets/merge2html.xsl"/&gt;
+     &lt;map:serialize type="html"/&gt;
+   &lt;/map:match&gt;
+ &lt;/map:pipeline&gt;
+&lt;/map:pipelines&gt;
+</pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+   
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Where the element attribute names are replaced with something more
+     meaningful!  Note that the map:part element attributes can be left off,
+     which results in the two parts being placed one immediately after the
+     other.</font>
+</p>
+ 
+
+<a name="faq-5">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>I want to use the XXX matcher/serializer/selecter/etc but there's no
+   examples :(</b></font>
+ 
+ 
+   
+<p>
+<font color="black" face="verdana,helvetica,sanserif">If you've checked the sample webapps which come with Cocoon, and you've
+     looked in the documentation, then check both the user and
+     dev archives.  If it hasn't been resolved before <b>first</b>
+     email the user group and, after a <b>reasonable</b> (ie 1 or 2
+     days) length of time (remember not everyone lives in your timezone) email
+     the dev group.</font>
+</p>
+   
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Please don't cross-post to both the user and dev groups - very few people
+     like getting bombarded!</font>
+</p>
+   
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Oh, and once you do get it working - how about documenting it and
+     contributing it back to the group?</font>
+</p>
+ 
+
+<a name="faq-6">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+    I changed the sitemap, but my changes don't show in the browser.
+    Do I need to restart the servlet container?
+  </b></font>
+  
+  
+    
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Cocoon lets you decide whether it needs to poll for sitemap changes
+    (with its associated performance penalty) or not. It also lets you decide whether the re-compilation resulting from polling shoud happen in the
+    background or in the foreground.</font>
+</p>
+
+    
+<p>
+<font color="black" face="verdana,helvetica,sanserif">If you look at the cocoon.xconf file, you'll notice this element:</font>
+</p>
+    
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+&lt;sitemap file="sitemap.xmap"
+         reload-method="asynchron"
+         check-reload="yes"/&gt;</pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+    
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Which means:</font>
+</p>
+      
+<blockquote>
+<ul>
+        
+<li>
+<font face="verdana, helvetica, sans serif">The <code><font face="courier, monospaced">check-reload</font></code> attribute determines if the sitemap
+        is reloaded on change. Set to "no", the sitemap is generated once
+        at startup. Set to "yes", the sitemap is regenerated if it changes.</font>
+</li>
+        
+<li>
+<font face="verdana, helvetica, sans serif">The <code><font face="courier, monospaced">reload-method</font></code> specifies the method for the
+          regeneration:
+          <blockquote>
+<ol>
+            
+<li>
+<font face="verdana, helvetica, sans serif"><code><font face="courier, monospaced">asynchron</font></code>: If the sitemap changes, the sitemap is
+            regenerated at the next request in the background and the incoming
+            request is served with the old sitemap. All subsequent requests
+            are served with the old sitemap until the regeneration in the
+            background has finished.</font>
+</li>
+            
+<li>
+<font face="verdana, helvetica, sans serif"><code><font face="courier, monospaced">synchron</font></code>: If the sitemap changes, the sitemap
+            is regenerated at the next request. When the regeneration is
+            finished, the request (and all subsequent ones) is served with
+            the new sitemap.</font>
+</li>
+          
+</ol>
+</blockquote>
+        
+</font>
+</li>
+      
+</ul>
+</blockquote>
+    
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+      For a development environment, set the reload-method to "synchron" and the
+      check-reload to "yes." For a production environment, 
+      set the reload-method to "asynchron." For more safety, set the check-reload
+      to "no."
+    </font>
+</p>
+
+    
+<p>
+<font color="black" face="verdana,helvetica,sanserif">In a nutshell: By default, reload is "asynchron" which means:</font>
+</p>
+      
+<blockquote>
+<ol>
+        
+<li>
+<font face="verdana, helvetica, sans serif">Change sitemap</font>
+</li>
+        
+<li>
+<font face="verdana, helvetica, sans serif">Hit reload</font>
+</li>
+        
+<li>
+<font face="verdana, helvetica, sans serif">Wait while CPU goes up to 100% and back down to 0%</font>
+</li>
+        
+<li>
+<font face="verdana, helvetica, sans serif">Hit reload</font>
+</li>
+        
+<li>
+<font face="verdana, helvetica, sans serif">Voila - new sitemap is used! :)</font>
+</li>
+      
+</ol>
+</blockquote>
+    
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Hence: you don't need to restart the servlet container.</font>
+</p>
+
+    
+<p>
+<font color="black" face="verdana,helvetica,sanserif">For sub-sitemaps, this issue is defined in the mounting element:</font>
+</p>
+    
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+&lt;map:mount uri-prefix="foo" src="file:///c:/foo/"
+           check-reload="yes"
+           reload-method="synchron"/&gt;</pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+    
+<p>
+<font color="black" face="verdana,helvetica,sanserif">With these settings Cocoon will react to any changes in the sub-sitemap,
+      without even hitting the reload button twice. :)</font>
+</p>
+    
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+      Moreover, it is a good idea to use sub-sitemaps because they reduce
+      overall compilation time. For example, changes to a single sub-sitemap won't 
+      require recompilation for the the main sitemap or other sub-sitemaps. This
+      practice leads to greater degree of modularity.
+    </font>
+</p>
+  
+
+<a name="faq-7">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>When I add an action to a pipeline Cocoon returns an
+  error.</b></font>
+  
+  
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Before the action was added to the pipeline it worked fine. After
+  the change Cocoon seems not to find the file specified in the
+  variable that is returned by the matcher.</font>
+</p>
+
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+&lt;map:match pattern="*"&gt;
+  &lt;map:act type="validate-session"&gt;
+    &lt;map:generate type="serverpages" src="{../1}.xsp"/&gt;
+  &lt;/map:act&gt;
+  &lt;map:serialize/&gt;
+&lt;/map:match&gt;
+</pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Please note in the above example the
+  "<b><code><font face="courier, monospaced">../1</font></code></b>".</font>
+</p> 
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Map objects returned from matchers, actions etc. are organised
+  <i>hierarchically</i>. Therefore they are not replaced by new ones
+  but older ones are still accessible through a path expression. Here
+  "<code><font face="courier, monospaced">../1</font></code>" references key ("variable") "1" in the next to
+  last Map. </font>
+</p>
+  
+
+<a name="faq-8">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+    What is the syntax for absolute filesystem pathnames.
+  </b></font>
+  
+  
+   
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+    In your sitemaps you may need to refer to some resource that is outside
+    the webapp context (e.g. UNIX /foo/bar/this.xsl
+    e.g. Windows C:\foo\bar\this.xsl). You need to use the file: convention.
+   </font>
+</p>
+   
+<blockquote>
+<ul>
+    
+<li>
+<font face="verdana, helvetica, sans serif">UNIX ... <code><font face="courier, monospaced">file:///foo/bar/this.xsl</font></code></font>
+</li>
+    
+<li>
+<font face="verdana, helvetica, sans serif">Windows ... <code><font face="courier, monospaced">file:///C:/foo/bar/this.xsl</font></code></font>
+</li>
+   
+</ul>
+</blockquote>
+   
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+    See further explanation of
+    <a href="../userdocs/concepts/sitemap.html#file-url">file: URLs</a>
+   </font>
+</p>
+  
+
+<a name="faq-9">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+What's the difference between having two pipelines with one matcher 
+each, and one pipeline with two matchers?
+  </b></font>
+  
+  
+   
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+If there is no other difference in pipeline declarations, then none, really. Note that pipelines can differ by:
+  </font>
+</p>
+
+<blockquote>
+<ul>
+	
+<li>
+<font face="verdana, helvetica, sans serif">
+visibility: internal-only="true" (not accessible for external requests) or not.
+   </font>
+</li>
+   
+<li>
+<font face="verdana, helvetica, sans serif">
+error handling: using different &lt;handle-errors&gt;s.
+   </font>
+</li>
+   
+<li>
+<font face="verdana, helvetica, sans serif">
+cachability (since 2.1): some requests can use cached responses
+from caching pipeline. Others, which should not be cached, can be
+handled by the non-caching pipeline implementation.
+  </font>
+</li>
+  
+<li>
+<font face="verdana, helvetica, sans serif">
+logical grouping: logically-related components can be grouped into
+separate pipelines to improve readability and ease administrative concerns.
+  </font>
+</li>
+  
+<li>
+<font face="verdana, helvetica, sans serif">
+ids: used to identify pipeline and other elements. See the "sitebuilder" sitemap editor
+in scratchpad samples for an example.
+  </font>
+</li>
+
+</ul>
+</blockquote>
+ 
+ 
+<a name="faq-10">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+Where can I find more information about the sitemap?
+  </b></font>
+  
+  
+   
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+Learn more about advanced Sitemap features by downloading the free chapter, <a href="http://www.newriders.com/books/product.asp?product_id={C3C05052-BE3B-4E06-A60A-13FB40AF58F6}">A User's Look at the Cocoon architecture,</a> from Langham and Ziegeler's <i>Cocoon: Building XML Applications</i> available at the New Riders web site.
+  </font>
+</p>
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+Check out a draft XML Schema <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/cocoon-2.0/src/documentation/xdocs/drafts/sitemap-2.1-draft.xsd?rev=HEAD&content-type=text/plain">grammar for the Cocoon sitemap</a>, and some <a href="http://outerthought.net/sitemap/">external documentation</a> generated from this Schema. A poster diagram of the sitemap structure is also available.
+   </font>
+</p>
+  
+  
+<a name="faq-11">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+  How can I add my FAQ to this document? 
+ </b></font>
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+   Follow the instructions found in <a href="../howto/howto-author-faq.html">How-To Author an FAQ.</a></font>
+</p>
+<a name="faq-12">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+  How can I suggest improvements to existing FAQs?
+ </b></font>
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+  Given the rapid pace of change with Cocoon, many individual FAQs quickly become out-of-date and confusing to new users. If you have the relevant knowledge, please consider updating other FAQs on this page for technical errors. If you see a few typos, please consider fixing them too.  Follow the instructions found in <a href="../howto/howto-author-faq.html">How-To Author an FAQ.</a></font>
+</p>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+<table width="100%" cellspacing="0" cellpadding="0" border="0">
+<tr>
+<td bgcolor="#0086b2"><img width="1" src="images/dot.gif" height="1"></td>
+</tr>
+<tr>
+<td align="center"><font size="-1" face="arial,helvetica,sanserif" color="#0086b2"><i>Copyright &copy; 1999-2002 The Apache Software Foundation. All Rights Reserved.</i></font></td>
+</tr>
+</table>
+</body>
+</html>