xml-general-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From shan...@apache.org
Subject cvs commit: xml-site/targets/cocoon/userdocs/xsp esql.html logicsheet-forms.html
Date Thu, 22 Aug 2002 02:39:06 GMT
shannon     2002/08/21 19:39:06

  Modified:    targets/cocoon/userdocs/actions actions.html
                        database-actions.html
               targets/cocoon/userdocs/concepts catalog.html modules.html
                        sitemap.html
               targets/cocoon/userdocs/generators directory-generator.html
                        error-generator.html extractor-generator.html
                        file-generator.html generators.html
                        html-generator.html imagedirectory-generator.html
                        jsp-generator.html linkstatus-generator.html
                        php-generator.html profile-generator.html
                        request-generator.html script-generator.html
                        search-generator.html serverpages-generator.html
                        status-generator.html stream-generator.html
                        velocity-generator.html xmldb-generator.html
                        xmldbcollection-generator.html
               targets/cocoon/userdocs/serializers link-serializer.html
               targets/cocoon/userdocs/transformers
                        cinclude-transformer.html
                        encodeurl-transformer.html
                        extractor-transformer.html filter-transformer.html
                        i18n-transformer.html ldap-transformer.html
                        log-transformer.html
                        readdomsession-transformer.html
                        sourcewriting-transformer.html sql-transformer.html
                        transformers.html writedomsession-transformer.html
                        xinclude-transformer.html xslt-transformer.html
                        xt-transformer.html
               targets/cocoon/userdocs/xsp esql.html logicsheet-forms.html
  Added:       targets/cocoon/userdocs/actions session-action.html
               targets/cocoon/userdocs/generators textparser-generator.html
               targets/cocoon/userdocs/generators/images note.gif
               targets/cocoon/userdocs/transformers
                        augment-transformer.html
                        textparser-transformer.html
  Log:
  update site
  
  Revision  Changes    Path
  1.7       +7 -0      xml-site/targets/cocoon/userdocs/actions/actions.html
  
  Index: actions.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/actions/actions.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- actions.html	15 Jul 2002 13:57:04 -0000	1.6
  +++ actions.html	22 Aug 2002 02:39:02 -0000	1.7
  @@ -90,6 +90,9 @@
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="session-action.html">Session Action</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>
  @@ -134,6 +137,10 @@
   				
   <li>
   <font face="verdana, helvetica, sans serif"><a href="database-actions.html">Database Actions</a></font>
  +</li>
  +				
  +<li>
  +<font face="verdana, helvetica, sans serif"><a href="session-action.html">Session Action</a></font>
   </li>
   			
   </ul>
  
  
  
  1.4       +3 -0      xml-site/targets/cocoon/userdocs/actions/database-actions.html
  
  Index: database-actions.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/actions/database-actions.html,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- database-actions.html	15 Jul 2002 13:57:04 -0000	1.3
  +++ database-actions.html	22 Aug 2002 02:39:02 -0000	1.4
  @@ -90,6 +90,9 @@
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="session-action.html">Session Action</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>
  
  
  
  1.1                  xml-site/targets/cocoon/userdocs/actions/session-action.html
  
  Index: session-action.html
  ===================================================================
  <html xmlns:NetUtils="org.apache.cocoon.util.NetUtils">
  <head>
  <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  <title>Session Action</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">Session Action</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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../../index.html">Main</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../index.html">User Documentation</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
  <span class="menutitle">Actions</span></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="actions.html">Overview</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="database-actions.html">Database</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
  <span class="menutitle">Default</span></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
  <span class="menutitle">Core</span></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
  <span class="menutitle">Optional</span></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><span class="menuselected">Session Action</span></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">Session Action</font>
  <hr style="color: #0086b2" size="1">
     
  <p>
  <font color="black" face="verdana,helvetica,sanserif">
      The session action helps in managing the session of a user on
      the server. It can create and terminate a session. The function
      is controlled by a parameter named 'action'.
     </font>
  </p>
     
  <p>
  <font color="black" face="verdana,helvetica,sanserif">For more information on session handling and session contexts
        have a look at the <a href="../../developing/webapps/session.html">Session Context documentation</a>.</font>
  </p>
     
  <font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>Creating a Session</b></font>
       
  <p>
  <font color="black" face="verdana,helvetica,sanserif">
        To create a session (if it not already exists) simply add the
        action in your 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:act type="session"/&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">This is the equivalent to specify the 'action' parameter
         with the value 'create':</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:act type="session"&gt;
          &lt;map:parameter name="action" value="create"/&gt;
      &lt;/map:act&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>
     
     
  <font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>Terminating a Session</b></font>
      
  <p>
  <font color="black" face="verdana,helvetica,sanserif">Terminating a session is as easy as creating a session, simply
        add the action to your pipeline and set the 'action' parameter
        to 'terminate':</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:act type="session"&gt;
          &lt;map:parameter name="action" value="terminate"/&gt;
      &lt;/map:act&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">This terminates the session immediately.</font>
  </p>
       
  <p>
  <font color="black" face="verdana,helvetica,sanserif">You can optionally specifiy the 'mode' parameter which controlls
          the termination of the session. You have the choice between
          'immediately' (the default) and 'if-unsued'. If you use the
          mode 'if-unused', the session is only terminated, if no session
          context exists for the user:</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:act type="session"&gt;
          &lt;map:parameter name="action" value="terminate"/&gt;
          &lt;map:parameter name="mode" value="if-unused"/&gt;
      &lt;/map:act&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>
     
     
     
  <font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Configuration</font>
  <hr style="color: #0086b2" size="1">
     
  <blockquote>
  <ul>
      
  <li>
  <font face="verdana, helvetica, sans serif">Name : session</font>
  </li>
      
  <li>
  <font face="verdana, helvetica, sans serif">Class: org.apache.cocoon.webapps.session.acting.SessionAction</font>
  </li>
     
  </ul>
  </blockquote>
    
   
  
  </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>
  
  
  
  1.7       +6 -7      xml-site/targets/cocoon/userdocs/concepts/catalog.html
  
  Index: catalog.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/concepts/catalog.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- catalog.html	15 Jul 2002 13:57:04 -0000	1.6
  +++ catalog.html	22 Aug 2002 02:39:02 -0000	1.7
  @@ -713,7 +713,7 @@
   <font color="black" face="verdana,helvetica,sanserif">
      A default catalog and some base entities (e.g. ISO*.pen character
      entity sets) are included in the Cocoon distribution at 
  -   <code><font face="courier, monospaced">webapp/resources/entities/</font></code>
  +   <code><font face="courier, monospaced">WEB-INF/entities/</font></code>
      - the default catalog is automatically loaded when Cocoon starts.
     </font>
   </p>
  @@ -746,7 +746,7 @@
      
   <p>
   <font color="black" face="verdana,helvetica,sanserif">Parameters (properties) for the resolver component can be specified in the
  -   <code><font face="courier, monospaced">java/org/apache/cocoon/components/resolver/resolver.xconf</font></code>
  +   <code><font face="courier, monospaced">src/webapp/WEB-INF/cocoon.xconf</font></code>
       configuration file. See the detailed internal notes - here is a precis.
      </font>
   </p>
  @@ -794,11 +794,10 @@
      
   <p>
   <font color="black" face="verdana,helvetica,sanserif">
  -    The build process will automatically copy the properties file from
  -<code><font face="courier, monospaced">$COCOON_HOME/webapp/resources/entities/CatalogManager.properties</font></code>
  -    to
  -<code><font face="courier, monospaced">$TOMCAT_HOME/webapps/cocoon/WEB-INF/classes/CatalogManager.properties</font></code>
  -    thereby making it available to the Java classpath.
  +    The file is at 
  +<code><font face="courier, monospaced">webapp/WEB-INF/classes/CatalogManager.properties</font></code>
  +    thereby making it available to the Java classpath during startup of the
  +    servlet engine.
      </font>
   </p>
   
  
  
  
  1.4       +11 -11    xml-site/targets/cocoon/userdocs/concepts/modules.html
  
  Index: modules.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/concepts/modules.html,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- modules.html	15 Jul 2002 13:57:05 -0000	1.3
  +++ modules.html	22 Aug 2002 02:39:02 -0000	1.4
  @@ -149,17 +149,6 @@
   		of the underlying rationale and principles.
   	  </font>
   </p>
  -	  
  -<p>
  -<table border="0" cellpadding="0" cellspacing="3" width="100%">
  -<tr>
  -<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i>
  -		To use modules, Apache Cocoon needs to have been build to include
  -		scratchpad components.
  -	  </i></font></td>
  -</tr>
  -</table>
  -</p>
   	
   	
   <font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Types of Modules</font>
  @@ -351,6 +340,17 @@
   			declared above allows to override the skin with a request parameter
   			named "skin".
   		  </font>
  +</p>
  +		  
  +<p>
  +<table border="0" cellpadding="0" cellspacing="3" width="100%">
  +<tr>
  +<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i>
  +			The above sitemap syntax is only available with the 2.1-dev version
  +			of Apache Cocoon.
  +		  </i></font></td>
  +</tr>
  +</table>
   </p>
   		  
   <div align="center">
  
  
  
  1.7       +56 -105   xml-site/targets/cocoon/userdocs/concepts/sitemap.html
  
  Index: sitemap.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/concepts/sitemap.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- sitemap.html	15 Jul 2002 13:57:05 -0000	1.6
  +++ sitemap.html	22 Aug 2002 02:39:02 -0000	1.7
  @@ -270,7 +270,6 @@
   <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;?xml version="1.0"?&gt;
  -
     &lt;map:sitemap 
         xmlns:map="http://apache.org/cocoon/sitemap/1.0"&gt;
       &lt;map:components/&gt;
  @@ -278,7 +277,7 @@
       &lt;map:resources/&gt;
       &lt;map:action-sets/&gt;
       &lt;map:pipelines/&gt;
  -  &lt;/map:sitemap&gt;</pre>
  +  &lt;/map:sitemap&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>
  @@ -299,7 +298,7 @@
   <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:sitemap 
  -    xmlns:map="http://apache.org/cocoon/sitemap/1.0"&gt;</pre>
  +    xmlns:map="http://apache.org/cocoon/sitemap/1.0"&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>
  @@ -340,18 +339,15 @@
   <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:components&gt;
  -  &lt;map:generators/&gt;
  -  &lt;map:transformers/&gt;
  -  &lt;map:serializers/&gt;
  -  &lt;map:readers/&gt;
  -  &lt;map:selectors/&gt;
  -  &lt;map:matchers/&gt;
  -  &lt;map:actions/&gt;
  -&lt;/map:components&gt;
  -
  -    </pre>
  +  &lt;map:components&gt;
  +    &lt;map:generators/&gt;
  +    &lt;map:transformers/&gt;
  +    &lt;map:serializers/&gt;
  +    &lt;map:readers/&gt;
  +    &lt;map:selectors/&gt;
  +    &lt;map:matchers/&gt;
  +    &lt;map:actions/&gt;
  +  &lt;/map:components&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>
  @@ -415,9 +411,7 @@
        &lt;!-- This is a parameter to the transformer component --&gt;
        &lt;use-request-parameters&gt;false&lt;/use-request-parameters&gt;
     &lt;/map:transformer&gt;
  -&lt;/map:components&gt;
  -
  -     </pre>
  +&lt;/map:components&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>
  @@ -461,9 +455,7 @@
       src="org.apache.cocoon.generation.ServerPagesGenerator"&gt;
      ...
     &lt;/map:generator&gt;
  -&lt;/map:generators&gt;
  -
  -     </pre>
  +&lt;/map:generators&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>
  @@ -509,9 +501,7 @@
     &lt;/map:transformer&gt;
     &lt;map:transformer name="xinclude" 
     src="org.apache.cocoon.transformation.XIncludeTransformer"/&gt;
  -&lt;/map:transformers&gt;
  -
  -     </pre>
  +&lt;/map:transformers&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>
  @@ -579,9 +569,7 @@
     &lt;map:serializer name="svg2png" mime-type="image/png" 
             src="org.apache.cocoon.serialization.SVGSerializer"&gt;
     &lt;/map:serializer&gt;
  -&lt;/map:serializers&gt;
  -
  -     </pre>
  +&lt;/map:serializers&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>
  @@ -640,9 +628,7 @@
       &lt;browser name="netscape" useragent="Mozilla"/&gt;
      ...
     &lt;/map:selection&gt;
  -&lt;/map:selection&gt;
  -
  -     </pre>
  +&lt;/map:selection&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>
  @@ -689,9 +675,7 @@
             src="org.apache.cocoon.matching.RegexpURIMatcher"&gt;
      ...
     &lt;/map:matcher&gt;
  -&lt;/map:matchers&gt;
  -
  -     </pre>
  +&lt;/map:matchers&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>
  @@ -741,9 +725,7 @@
             src="org.apache.cocoon.acting.RequestParamAction"/&gt;
     &lt;map:action name="form-validator"
             src="org.apache.cocoon.acting.FormValidatorAction"/&gt;
  -&lt;/map:actions&gt;
  -
  -     </pre>
  +&lt;/map:actions&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>
  @@ -785,9 +767,7 @@
     &lt;map:view name="links" from-position="last"&gt;
       &lt;map:serialize type="links"/&gt;
     &lt;/map:view&gt;
  -&lt;/map:views&gt;
  -
  -    </pre>
  +&lt;/map:views&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>
  @@ -822,9 +802,7 @@
       &lt;map:transform src="./stylesheets/general-browser.xsl"/&gt;
       &lt;map:serialize status-code="401"/&gt;
     &lt;/map:resource&gt;
  -&lt;/map:resources&gt;
  -
  -    </pre>
  +&lt;/map:resources&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>
  @@ -861,9 +839,7 @@
      &lt;map:act type="upd-employee" action="Update"/&gt;
      &lt;map:act type="sel-employee" action="Select"/&gt;
     &lt;/map:action-set&gt;
  -&lt;/map:action-sets&gt;
  -
  -    </pre>
  +&lt;/map:action-sets&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>
  @@ -1105,8 +1081,7 @@
   <pre>
   &lt;map:aggregate element="the-aggregated-content"&gt;
     &lt;!-- define your map:parts here --&gt;
  -&lt;/map:aggregate&gt;
  -    </pre>
  +&lt;/map:aggregate&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>
  @@ -1226,8 +1201,7 @@
     &lt;map:part src="cocoon:/book-{1}.xml"/&gt;
     &lt;map:part src="cocoon:/body-{1}.xml"/&gt;
    &lt;/map:aggregate&gt;
  - ...
  -    </pre>
  + ... </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>
  @@ -1259,8 +1233,7 @@
     &lt;!-- content of body xml --&gt;
     ...
    &lt;/document&gt;
  -&lt;/site&gt;
  -    </pre>
  +&lt;/site&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>
  @@ -1353,8 +1326,7 @@
     &lt;map:transform type="i18n"/&gt;
     &lt;map:serialize/&gt;
    &lt;/map:error-handler&gt;
  -&lt;/map:pipeline&gt;
  -    </pre>
  +&lt;/map:pipeline&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>
  @@ -1421,8 +1393,7 @@
    &lt;/map:match&gt;
    &lt;map:match pattern="welcome"&gt;
    ...
  -&lt;/map:pipeline&gt;
  -    </pre>
  +&lt;/map:pipeline&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>
  @@ -1472,8 +1443,7 @@
      &lt;map:parameter name="target" value="target-1"/&gt;
     &lt;/map:call&gt;
    ...
  -&lt;/map:pipeline&gt;
  -    </pre>
  +&lt;/map:pipeline&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>
  @@ -1484,7 +1454,10 @@
       
       
   <font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>Mounting sitemaps</b></font>
  -     <font face="verdana, helvetica, sans serif" size="+1" color="#0086b2">Introduction</font>
  +    
  +<br> 
  +     
  +<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2">Introduction</font>
       
   <p>
   <font color="black" face="verdana,helvetica,sanserif">
  @@ -1514,9 +1487,7 @@
   &lt;map:match pattern="faq/*"&gt; 
     &lt;map:mount uri-prefix="faq" check-reload="no"
                src="faq/sitemap.xmap"/&gt;
  -&lt;/map:match&gt; 
  -
  -    </pre>
  +&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>
  @@ -1653,9 +1624,7 @@
   
       &lt;/map:pipeline&gt;
     &lt;/map:pipelines&gt;
  -&lt;/map:sitemap&gt;
  -
  -     </pre>
  +&lt;/map:sitemap&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>
  @@ -1684,9 +1653,7 @@
   &lt;map:match pattern="faq/*"&gt; 
     &lt;map:mount uri-prefix="faq/" check-reload="no" 
        src="faq/sitemap.xmap" reload-method="asynchron"/&gt; 
  -&lt;/map:match&gt; 
  -
  -     </pre>
  +&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>
  @@ -1852,9 +1819,7 @@
        */
       public void setConsumer(XMLConsumer consumer);
   
  -}
  -
  -    </pre>
  +} </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>
  @@ -1891,9 +1856,7 @@
   public interface XMLConsumer extends ContentHandler,
                                        LexicalHandler {
   
  -}
  -
  -    </pre>
  +} </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>
  @@ -1930,9 +1893,7 @@
   
   public interface XMLPipe extends XMLConsumer , XMLProducer {
   
  -}
  -
  -    </pre>
  +} </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>
  @@ -1973,9 +1934,7 @@
       void setup(SourceResolver resolver, Map objectModel,
                  String src, Parameters par)
       throws ProcessingException, SAXException, IOException;
  -}
  -
  -    </pre>
  +} </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>
  @@ -2024,9 +1983,7 @@
        * Test if the component wants to set the content length
        */
       boolean shouldSetContentLength();
  -}
  -
  -    </pre>
  +} </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>
  @@ -2064,9 +2021,7 @@
       public void generate()
       throws IOException, SAXException, ProcessingException;
   
  -}
  -
  -    </pre>
  +} </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>
  @@ -2102,9 +2057,7 @@
   
       String ROLE = "org.apache.cocoon.transformation.Transformer";
   
  -}
  -
  -    </pre>
  +} </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>
  @@ -2140,9 +2093,7 @@
   
       String ROLE = "org.apache.cocoon.serialization.Serializer";
   
  -}
  -
  -    </pre>
  +} </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>
  @@ -2191,9 +2142,7 @@
        */
       boolean select (String expression, Map objectModel,
                       Parameters parameters);
  -}
  -
  -    </pre>
  +} </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>
  @@ -2244,9 +2193,7 @@
        *                    If the return value is null there was no match.
        */
       Map match (String pattern, Map objectModel, Parameters parameters);      
  -}
  -
  -    </pre>
  +} </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>
  @@ -2311,9 +2258,7 @@
       Map act(Redirector redirector, SourceResolver resolver,
               Map objectModel, String source, Parameters par)
       throws Exception;
  -}
  -
  -    </pre>
  +} </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>
  @@ -2325,14 +2270,20 @@
     
   
     
  -<font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Additional information</font>
  +<font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Additional resources</font>
   <hr style="color: #0086b2" size="1">
  -   
  +  
  +<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 Ziegler's <i>Cocoon: Building XML Applications</i> available at the New Riders web site.
  +  </font>
  +</p>
  +  
   <p>
   <font color="black" face="verdana,helvetica,sanserif">
  -     Also there is a draft XML Schema <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-cocoon2/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. There you will also find a poster diagram of
  -     the sitemap structure.
  +     Check out a draft XML Schema <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-cocoon2/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>
     
  
  
  
  1.7       +3 -0      xml-site/targets/cocoon/userdocs/generators/directory-generator.html
  
  Index: directory-generator.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/directory-generator.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- directory-generator.html	15 Jul 2002 13:57:05 -0000	1.6
  +++ directory-generator.html	22 Aug 2002 02:39:02 -0000	1.7
  @@ -132,6 +132,9 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.7       +3 -0      xml-site/targets/cocoon/userdocs/generators/error-generator.html
  
  Index: error-generator.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/error-generator.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- error-generator.html	15 Jul 2002 13:57:05 -0000	1.6
  +++ error-generator.html	22 Aug 2002 02:39:02 -0000	1.7
  @@ -132,6 +132,9 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.7       +3 -0      xml-site/targets/cocoon/userdocs/generators/extractor-generator.html
  
  Index: extractor-generator.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/extractor-generator.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- extractor-generator.html	15 Jul 2002 13:57:05 -0000	1.6
  +++ extractor-generator.html	22 Aug 2002 02:39:02 -0000	1.7
  @@ -132,6 +132,9 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.7       +3 -0      xml-site/targets/cocoon/userdocs/generators/file-generator.html
  
  Index: file-generator.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/file-generator.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- file-generator.html	15 Jul 2002 13:57:05 -0000	1.6
  +++ file-generator.html	22 Aug 2002 02:39:02 -0000	1.7
  @@ -132,6 +132,9 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.7       +7 -0      xml-site/targets/cocoon/userdocs/generators/generators.html
  
  Index: generators.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/generators.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- generators.html	15 Jul 2002 13:57:05 -0000	1.6
  +++ generators.html	22 Aug 2002 02:39:02 -0000	1.7
  @@ -132,6 +132,9 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  @@ -265,6 +268,10 @@
   				
   <li>
   <font face="verdana, helvetica, sans serif"><a href="xmldbcollection-generator.html">XML:DB Collection Generator</a> (optional)</font>
  +</li>
  +        
  +<li>
  +<font face="verdana, helvetica, sans serif"><a href="textparser-generator.html">Text Parser Generator</a></font>
   </li>
   			
   </ul>
  
  
  
  1.7       +3 -0      xml-site/targets/cocoon/userdocs/generators/html-generator.html
  
  Index: html-generator.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/html-generator.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- html-generator.html	15 Jul 2002 13:57:05 -0000	1.6
  +++ html-generator.html	22 Aug 2002 02:39:02 -0000	1.7
  @@ -132,6 +132,9 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.7       +3 -0      xml-site/targets/cocoon/userdocs/generators/imagedirectory-generator.html
  
  Index: imagedirectory-generator.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/imagedirectory-generator.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- imagedirectory-generator.html	15 Jul 2002 13:57:05 -0000	1.6
  +++ imagedirectory-generator.html	22 Aug 2002 02:39:03 -0000	1.7
  @@ -132,6 +132,9 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.7       +3 -0      xml-site/targets/cocoon/userdocs/generators/jsp-generator.html
  
  Index: jsp-generator.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/jsp-generator.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- jsp-generator.html	15 Jul 2002 13:57:05 -0000	1.6
  +++ jsp-generator.html	22 Aug 2002 02:39:03 -0000	1.7
  @@ -132,6 +132,9 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.2       +3 -0      xml-site/targets/cocoon/userdocs/generators/linkstatus-generator.html
  
  Index: linkstatus-generator.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/linkstatus-generator.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- linkstatus-generator.html	15 Jul 2002 14:01:30 -0000	1.1
  +++ linkstatus-generator.html	22 Aug 2002 02:39:03 -0000	1.2
  @@ -132,6 +132,9 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><span class="menuselected">LinkStatus Generator</span></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.7       +3 -0      xml-site/targets/cocoon/userdocs/generators/php-generator.html
  
  Index: php-generator.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/php-generator.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- php-generator.html	15 Jul 2002 13:57:05 -0000	1.6
  +++ php-generator.html	22 Aug 2002 02:39:03 -0000	1.7
  @@ -132,6 +132,9 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.6       +3 -0      xml-site/targets/cocoon/userdocs/generators/profile-generator.html
  
  Index: profile-generator.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/profile-generator.html,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- profile-generator.html	15 Jul 2002 13:57:05 -0000	1.5
  +++ profile-generator.html	22 Aug 2002 02:39:03 -0000	1.6
  @@ -132,6 +132,9 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.7       +56 -0     xml-site/targets/cocoon/userdocs/generators/request-generator.html
  
  Index: request-generator.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/request-generator.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- request-generator.html	15 Jul 2002 13:57:05 -0000	1.6
  +++ request-generator.html	22 Aug 2002 02:39:03 -0000	1.7
  @@ -132,6 +132,9 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  @@ -206,6 +209,7 @@
                  <code><font face="courier, monospaced">http://xml.apache.org/cocoon/requestgenerator/2.0</font></code></font>
   </p>
   
  +
   <div align="center">
   <table border="0" cellpadding="0" cellspacing="4">
   <tr>
  @@ -244,6 +248,16 @@
       &lt;/parameter&gt;
     &lt;/requestParameters&gt;
   
  +  &lt;!-- All request attributes; see below the note on generate-attributes parameter. 
  +       (This feature is available startign with version 2.1 --&gt;
  +  &lt;requestAttributes&gt;
  +    &lt;!-- Create an attribute element for each attribute --&gt;
  +    &lt;attribute name="errorMessage"&gt;
  +      &lt;!-- Create a value element for the attribute value --&gt;
  +      &lt;value&gt;I was put here by an earlier action.&lt;/value&gt;
  +    &lt;/attribute&gt;
  +  &lt;/requestAttributes&gt;
  +
     &lt;!-- All configuration parameters: --&gt;
     &lt;configurationParameters&gt;
       &lt;!-- Create a parameter element for each parameter specified 
  @@ -252,6 +266,48 @@
     &lt;/configurationParameters&gt;
   
   &lt;/request&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>
  +<table border="0" cellpadding="0" cellspacing="3" width="100%">
  +<tr>
  +<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i>If you want request attributes to be generated, you must specify <code><font face="courier, monospaced">generate-attributes</font></code> parameter at generator definition or invocation in the sitemap.</i></font></td>
  +</tr>
  +</table>
  +</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;!-- This will turn on attribute generation on by default --&gt;
  +&lt;map:generator name="request" src="org.apache.cocoon.generation.RequestGenerator"&gt; 
  +    &lt;map:parameter name="generate-attributes" value="true"/&gt;
  +&lt;/map:generator&gt;
  +
  +&lt;!-- or --&gt;
  +
  +    &lt;!-- This will turn on attribute generation for this invocation only. --&gt;
  +    &lt;map:match pattern="request"&gt;
  +        &lt;map:generate type="request"&gt;
  +	    &lt;map:parameter name="generate-attributes" value="true"/&gt;
  +        &lt;/map:generate&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>
  
  
  
  1.7       +3 -0      xml-site/targets/cocoon/userdocs/generators/script-generator.html
  
  Index: script-generator.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/script-generator.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- script-generator.html	15 Jul 2002 13:57:05 -0000	1.6
  +++ script-generator.html	22 Aug 2002 02:39:03 -0000	1.7
  @@ -132,6 +132,9 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.6       +3 -0      xml-site/targets/cocoon/userdocs/generators/search-generator.html
  
  Index: search-generator.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/search-generator.html,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- search-generator.html	15 Jul 2002 13:57:05 -0000	1.5
  +++ search-generator.html	22 Aug 2002 02:39:03 -0000	1.6
  @@ -132,6 +132,9 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.7       +3 -0      xml-site/targets/cocoon/userdocs/generators/serverpages-generator.html
  
  Index: serverpages-generator.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/serverpages-generator.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- serverpages-generator.html	15 Jul 2002 13:57:05 -0000	1.6
  +++ serverpages-generator.html	22 Aug 2002 02:39:03 -0000	1.7
  @@ -132,6 +132,9 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.7       +3 -0      xml-site/targets/cocoon/userdocs/generators/status-generator.html
  
  Index: status-generator.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/status-generator.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- status-generator.html	15 Jul 2002 13:57:05 -0000	1.6
  +++ status-generator.html	22 Aug 2002 02:39:03 -0000	1.7
  @@ -132,6 +132,9 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.7       +3 -0      xml-site/targets/cocoon/userdocs/generators/stream-generator.html
  
  Index: stream-generator.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/stream-generator.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- stream-generator.html	15 Jul 2002 13:57:05 -0000	1.6
  +++ stream-generator.html	22 Aug 2002 02:39:03 -0000	1.7
  @@ -132,6 +132,9 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.7       +3 -0      xml-site/targets/cocoon/userdocs/generators/velocity-generator.html
  
  Index: velocity-generator.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/velocity-generator.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- velocity-generator.html	15 Jul 2002 13:57:06 -0000	1.6
  +++ velocity-generator.html	22 Aug 2002 02:39:03 -0000	1.7
  @@ -132,6 +132,9 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.6       +3 -0      xml-site/targets/cocoon/userdocs/generators/xmldb-generator.html
  
  Index: xmldb-generator.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/xmldb-generator.html,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- xmldb-generator.html	15 Jul 2002 13:57:06 -0000	1.5
  +++ xmldb-generator.html	22 Aug 2002 02:39:03 -0000	1.6
  @@ -132,6 +132,9 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.6       +3 -0      xml-site/targets/cocoon/userdocs/generators/xmldbcollection-generator.html
  
  Index: xmldbcollection-generator.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/xmldbcollection-generator.html,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- xmldbcollection-generator.html	15 Jul 2002 13:57:06 -0000	1.5
  +++ xmldbcollection-generator.html	22 Aug 2002 02:39:03 -0000	1.6
  @@ -132,6 +132,9 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.1                  xml-site/targets/cocoon/userdocs/generators/textparser-generator.html
  
  Index: textparser-generator.html
  ===================================================================
  <html xmlns:NetUtils="org.apache.cocoon.util.NetUtils">
  <head>
  <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  <title>Text Parser Generator</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">Text Parser Generator</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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../../index.html">Main</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../index.html">User Documentation</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
  <span class="menutitle">Generators</span></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="generators.html">Overview</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
  <span class="menutitle">Default</span></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="file-generator.html">File Generator</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
  <span class="menutitle">Core</span></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="html-generator.html">HTML Generator</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="directory-generator.html">Directory Generator</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="imagedirectory-generator.html">Image Directory Generator</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="extractor-generator.html">Fragment Extractor Generator</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="jsp-generator.html">JSP Generator</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="script-generator.html">Script Generator</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="serverpages-generator.html">Server Pages Generator</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="velocity-generator.html">Velocity Generator</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="request-generator.html">Request Generator</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="status-generator.html">Status Generator</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="stream-generator.html">Stream Generator</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="profile-generator.html">Profile Generator</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="error-generator.html">Error Generator</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="search-generator.html">Search Generator</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><span class="menuselected">Text Parser Generator</span></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
  <span class="menutitle">Optional</span></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="php-generator.html">Php Generator</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="xmldb-generator.html">XML:DB Generator</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="xmldbcollection-generator.html">XML:DB Collection Generator</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">Text Parser Generator</font>
  <hr style="color: #0086b2" size="1">
     
  <p>
  <font color="black" face="verdana,helvetica,sanserif">The text parser generator parser a text file, which an specified grammar, and 
        generates a XML file from it.</font>
  </p>
  
     
  <blockquote>
  <ul>
      
  <li>
  <font face="verdana, helvetica, sans serif">Name : textparser</font>
  </li>
      
  <li>
  <font face="verdana, helvetica, sans serif">Class: org.apache.cocoon.generation.TextParserGenerator</font>
  </li>
      
  <li>
  <font face="verdana, helvetica, sans serif">Cacheable: yes - uses the last modification date of the text document and of the grammar file 
          for validation.</font>
  </li>
     
  </ul>
  </blockquote>
  
     
  <p>
  <font color="black" face="verdana,helvetica,sanserif">The location of the source xml document is specified in
        the pipeline by the src attribute.</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:generate src="example.txt" type="textparser"&gt;
   &lt;map:parameter name="grammar" value="example.grm"/&gt;
   &lt;map:parameter name="includeignorabletokens" value="false"/&gt;
  &lt;/map:generate&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">The parameter to specify the grammar must be declared. The second paramter tells the parser
        if it should include all obsolete tokens, and must not specified.</font>
  </p>
  
     
  <p>
  <font color="black" face="verdana,helvetica,sanserif">The explanation of function and the grammar format can be found at the <a href="../../howto/chaperon/howto-chaperon-intro.html">howto section</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>
  
  
  
  1.1                  xml-site/targets/cocoon/userdocs/generators/images/note.gif
  
  	<<Binary file>>
  
  
  1.7       +56 -9     xml-site/targets/cocoon/userdocs/serializers/link-serializer.html
  
  Index: link-serializer.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/serializers/link-serializer.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- link-serializer.html	15 Jul 2002 13:57:06 -0000	1.6
  +++ link-serializer.html	22 Aug 2002 02:39:04 -0000	1.7
  @@ -142,29 +142,76 @@
   	
   		<font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Link Serializer</font>
   <hr style="color: #0086b2" size="1">
  -			
  +		  
   <p>
  -<font color="black" face="verdana,helvetica,sanserif">????.</font>
  +<font color="black" face="verdana,helvetica,sanserif">The link serializer generates a list of links
  +                   using <a href="http://www.w3.org/TR/xlink/">XLink</a>
  +                   from the sax events.
  +                   Most <a href="http://www.w3.org/MarkUp/">XHTML</a>
  +                   attributes are also supported (href, src, longdesc,
  +                   background). The mime-type of the output is 
  +                   <code><font face="courier, monospaced">application/x-cocoon-links</font></code>. This serializer is
  +                   required by the link status generator and the command line
  +                   mode to follow links.</font>
   </p>
  -			
  +		   
   <blockquote>
   <ul>
  -				
  +		     
   <li>
  -<font face="verdana, helvetica, sans serif">Name : links</font>
  +<font face="verdana, helvetica, sans serif">Name: links</font>
   </li>
  -				
  +		     
   <li>
   <font face="verdana, helvetica, sans serif">Class: org.apache.cocoon.serialization.LinkSerializer</font>
   </li>
  -				
  +	             
   <li>
  -<font face="verdana, helvetica, sans serif">Cacheable: ????.</font>
  +<font face="verdana, helvetica, sans serif">Cacheable: no</font>
   </li>
  -			
  +		   
   </ul>
   </blockquote>
   		
  +                
  +<font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Usage</font>
  +<hr style="color: #0086b2" size="1">
  +		  
  +<p>
  +<font color="black" face="verdana,helvetica,sanserif">To use the link serializer for the command-line or the
  +                    link status generator, you need the following entries in
  +                    your sitemap:</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:components&gt;
  +  &lt;map:serializers&gt;
  +    &lt;map:serializer logger="sitemap.serializer.links" name="links"
  +                    src="org.apache.cocoon.serialization.LinkSerializer" /&gt;
  +  &lt;/map:serializers&gt;
  +&lt;/map:components&gt;
  +
  +&lt;map:views&gt;
  +  &lt;map:view from-position="last" name="links"&gt;
  +    &lt;map:serialize type="links" /&gt;
  +  &lt;/map:view&gt;
  +&lt;/map:views&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>
  +                
   	
   
   </td>
  
  
  
  1.7       +6 -0      xml-site/targets/cocoon/userdocs/transformers/cinclude-transformer.html
  
  Index: cinclude-transformer.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/cinclude-transformer.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- cinclude-transformer.html	15 Jul 2002 13:57:07 -0000	1.6
  +++ cinclude-transformer.html	22 Aug 2002 02:39:04 -0000	1.7
  @@ -120,6 +120,12 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.2       +6 -0      xml-site/targets/cocoon/userdocs/transformers/encodeurl-transformer.html
  
  Index: encodeurl-transformer.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/encodeurl-transformer.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- encodeurl-transformer.html	15 Jul 2002 14:01:30 -0000	1.1
  +++ encodeurl-transformer.html	22 Aug 2002 02:39:04 -0000	1.2
  @@ -120,6 +120,12 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.7       +6 -0      xml-site/targets/cocoon/userdocs/transformers/extractor-transformer.html
  
  Index: extractor-transformer.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/extractor-transformer.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- extractor-transformer.html	15 Jul 2002 13:57:07 -0000	1.6
  +++ extractor-transformer.html	22 Aug 2002 02:39:04 -0000	1.7
  @@ -120,6 +120,12 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.7       +6 -0      xml-site/targets/cocoon/userdocs/transformers/filter-transformer.html
  
  Index: filter-transformer.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/filter-transformer.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- filter-transformer.html	15 Jul 2002 13:57:07 -0000	1.6
  +++ filter-transformer.html	22 Aug 2002 02:39:04 -0000	1.7
  @@ -120,6 +120,12 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.7       +6 -0      xml-site/targets/cocoon/userdocs/transformers/i18n-transformer.html
  
  Index: i18n-transformer.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/i18n-transformer.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- i18n-transformer.html	15 Jul 2002 13:57:07 -0000	1.6
  +++ i18n-transformer.html	22 Aug 2002 02:39:04 -0000	1.7
  @@ -120,6 +120,12 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.7       +6 -0      xml-site/targets/cocoon/userdocs/transformers/ldap-transformer.html
  
  Index: ldap-transformer.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/ldap-transformer.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- ldap-transformer.html	15 Jul 2002 13:57:07 -0000	1.6
  +++ ldap-transformer.html	22 Aug 2002 02:39:04 -0000	1.7
  @@ -120,6 +120,12 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.7       +7 -1      xml-site/targets/cocoon/userdocs/transformers/log-transformer.html
  
  Index: log-transformer.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/log-transformer.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- log-transformer.html	15 Jul 2002 13:57:07 -0000	1.6
  +++ log-transformer.html	22 Aug 2002 02:39:05 -0000	1.7
  @@ -120,6 +120,12 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  @@ -167,7 +173,7 @@
     &lt;map:transform type="log"&gt;
     &nbsp;&nbsp;&lt;map:parameter name="logfile" value="logfile.log"/&gt;
     &nbsp;&nbsp;&lt;map:parameter name="append" value="no"/&gt;
  -  &lt;/map:transform&gt;&gt;
  +  &lt;/map:transform&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>
  
  
  
  1.7       +6 -0      xml-site/targets/cocoon/userdocs/transformers/readdomsession-transformer.html
  
  Index: readdomsession-transformer.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/readdomsession-transformer.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- readdomsession-transformer.html	15 Jul 2002 13:57:07 -0000	1.6
  +++ readdomsession-transformer.html	22 Aug 2002 02:39:05 -0000	1.7
  @@ -120,6 +120,12 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.2       +6 -0      xml-site/targets/cocoon/userdocs/transformers/sourcewriting-transformer.html
  
  Index: sourcewriting-transformer.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/sourcewriting-transformer.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- sourcewriting-transformer.html	15 Jul 2002 14:01:30 -0000	1.1
  +++ sourcewriting-transformer.html	22 Aug 2002 02:39:05 -0000	1.2
  @@ -120,6 +120,12 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><span class="menuselected">SourceWriting Transformer</span></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.7       +6 -0      xml-site/targets/cocoon/userdocs/transformers/sql-transformer.html
  
  Index: sql-transformer.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/sql-transformer.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- sql-transformer.html	15 Jul 2002 13:57:07 -0000	1.6
  +++ sql-transformer.html	22 Aug 2002 02:39:05 -0000	1.7
  @@ -120,6 +120,12 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.7       +14 -0     xml-site/targets/cocoon/userdocs/transformers/transformers.html
  
  Index: transformers.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/transformers.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- transformers.html	15 Jul 2002 13:57:07 -0000	1.6
  +++ transformers.html	22 Aug 2002 02:39:05 -0000	1.7
  @@ -120,6 +120,12 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  @@ -224,6 +230,10 @@
   <li>
   <font face="verdana, helvetica, sans serif"><a href="sourcewriting-transformer.html">SourceWriting Transformer</a></font>
   </li>
  +                                
  +<li>
  +<font face="verdana, helvetica, sans serif"><a href="augment-transformer.html">Augment Transformer</a></font>
  +</li>
   				
   <li>
   <font face="verdana, helvetica, sans serif"><a href="xt-transformer.html">XT Transformer</a> (optional)</font>
  @@ -231,6 +241,10 @@
   				
   <li>
   <font face="verdana, helvetica, sans serif"><a href="ldap-transformer.html">LDAP Transformer</a> (optional)</font>
  +</li>
  +        
  +<li>
  +<font face="verdana, helvetica, sans serif"><a href="textparser-transformer.html">Text Parser Transformer</a></font>
   </li>
   			
   </ul>
  
  
  
  1.7       +6 -0      xml-site/targets/cocoon/userdocs/transformers/writedomsession-transformer.html
  
  Index: writedomsession-transformer.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/writedomsession-transformer.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- writedomsession-transformer.html	15 Jul 2002 13:57:07 -0000	1.6
  +++ writedomsession-transformer.html	22 Aug 2002 02:39:05 -0000	1.7
  @@ -120,6 +120,12 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.7       +6 -0      xml-site/targets/cocoon/userdocs/transformers/xinclude-transformer.html
  
  Index: xinclude-transformer.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/xinclude-transformer.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- xinclude-transformer.html	15 Jul 2002 13:57:07 -0000	1.6
  +++ xinclude-transformer.html	22 Aug 2002 02:39:05 -0000	1.7
  @@ -120,6 +120,12 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.7       +7 -1      xml-site/targets/cocoon/userdocs/transformers/xslt-transformer.html
  
  Index: xslt-transformer.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/xslt-transformer.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- xslt-transformer.html	15 Jul 2002 13:57:07 -0000	1.6
  +++ xslt-transformer.html	22 Aug 2002 02:39:05 -0000	1.7
  @@ -120,6 +120,12 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  @@ -271,7 +277,7 @@
   			
   <p>
   <font color="black" face="verdana,helvetica,sanserif">In addition all other parameters to the transformer are
  -                  available in the stylesheet as xsl:variables (These values
  +                  available in the stylesheet as &lt;xsl:param/&gt;s (These values
                     are also used in the caching algorithm.)</font>
   </p>
   		
  
  
  
  1.7       +6 -0      xml-site/targets/cocoon/userdocs/transformers/xt-transformer.html
  
  Index: xt-transformer.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/xt-transformer.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- xt-transformer.html	15 Jul 2002 13:57:07 -0000	1.6
  +++ xt-transformer.html	22 Aug 2002 02:39:05 -0000	1.7
  @@ -120,6 +120,12 @@
   <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
   </tr>
   <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  +<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
  +</tr>
  +<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
   <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
   <span class="menutitle">Optional</span></td>
   </tr>
  
  
  
  1.1                  xml-site/targets/cocoon/userdocs/transformers/augment-transformer.html
  
  Index: augment-transformer.html
  ===================================================================
  <html xmlns:NetUtils="org.apache.cocoon.util.NetUtils">
  <head>
  <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  <title>Augment Transformer</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">Augment Transformer</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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../../index.html">Main</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../index.html">User Documentation</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
  <span class="menutitle">Transformers</span></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="transformers.html">Overview</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
  <span class="menutitle">Default</span></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="xslt-transformer.html">XSLT Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
  <span class="menutitle">Core</span></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="extractor-transformer.html">Fragment Extractor Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="i18n-transformer.html">I18n Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="log-transformer.html">Log Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sql-transformer.html">SQL Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="filter-transformer.html">Filter Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="readdomsession-transformer.html">Read DOM Session Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="writedomsession-transformer.html">Write DOM Session Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="xinclude-transformer.html">XInclude Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="cinclude-transformer.html">CInclude Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="encodeurl-transformer.html">EncodeURL Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><span class="menuselected">Augment Transformer</span></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
  <span class="menutitle">Optional</span></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="xt-transformer.html">XT Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="ldap-transformer.html">LDAP Transformer</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">Augment Transformer</font>
  <hr style="color: #0086b2" size="1">
     
  <p>
  <font color="black" face="verdana,helvetica,sanserif">
      The AugmentTransformer 
      augments all <code><font face="courier, monospaced">href</font></code> attributes with the full path to the request.
      If a <code><font face="courier, monospaced">href</font></code> is already a full HTTP URL, or HTTPS URL the value of
      href is not changed.
     </font>
  </p>
     
  <p>
  <font color="black" face="verdana,helvetica,sanserif">
      The AugmentTransformer has serveral configuration options. These options
      may be specified by each request.
     </font>
  </p>
     
  <blockquote>
  <font face="verdana, helvetica, sans serif">
  <dl>
       
  <dt>
  <strong>mount</strong> - </dt>
       
  <dd>If this request parameter is specified it defines the URI relative
         to the servlet's context-path. If no mount parameter is specified the 
         resolution is calculated relative to the request URI.
       </dd>
     
  </dl>
  </font>
  </blockquote>
     
     
  <blockquote>
  <ul>
      
  <li>
  <font face="verdana, helvetica, sans serif">Name : augment</font>
  </li>
      
  <li>
  <font face="verdana, helvetica, sans serif">Class: org.apache.cocoon.transformation.AugmentTransformer</font>
  </li>
      
  <li>
  <font face="verdana, helvetica, sans serif">Cacheable: no.</font>
  </li>
     
  </ul>
  </blockquote>
     
  <p>
  <font color="black" face="verdana,helvetica,sanserif">
      A simple example might help to use the AugmentTransformer effectivly:
     </font>
  </p>
     
  <p>
  <font color="black" face="verdana,helvetica,sanserif">
      Add the AugmentTransformer to the components in your sitemap.xmap
     </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:components&gt;
  ...
    &lt;map:transformers default="xslt"&gt;
    ...
      &lt;map:transformer name="augment"
        src="org.apache.cocoon.transformation.AugmentTransformer"&gt;
      &lt;/map:transformer&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">
       Next define in your pipeline to use the AugmentTransformer
     </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="**book-**.xml"&gt;
    &lt;map:generate src="docs/{1}book.xml"/&gt;
    &lt;map:transform type="augment"&gt;
      &lt;map:parameter name="mount" value="samples/flow/"/&gt;
    &lt;/map:transform&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">
       In the example above all href attributes which do not start with <code><font face="courier, monospaced">http</font></code>, or
       <code><font face="courier, monospaced">https</font></code> are augmented.
     </font>
  </p>
     
  <p>
  <font color="black" face="verdana,helvetica,sanserif">
       Assuming Cocoon is deployed at <code><font face="courier, monospaced">http://localhost:8080/cocoon</font></code> a 
       href <code><font face="courier, monospaced">href="overview.html"</font></code> is augmented 
       to <code><font face="courier, monospaced">href="http://localhost:8080/cocoon/samples/flow/overview.html"</font></code>.
     </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>
  
  
  
  1.1                  xml-site/targets/cocoon/userdocs/transformers/textparser-transformer.html
  
  Index: textparser-transformer.html
  ===================================================================
  <html xmlns:NetUtils="org.apache.cocoon.util.NetUtils">
  <head>
  <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  <title>Text Parser Transformer</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">Text Parser Transformer</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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../../index.html">Main</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../index.html">User Documentation</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
  <span class="menutitle">Transformers</span></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="transformers.html">Overview</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
  <span class="menutitle">Default</span></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="xslt-transformer.html">XSLT Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
  <span class="menutitle">Core</span></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="extractor-transformer.html">Fragment Extractor Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="i18n-transformer.html">I18n Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="log-transformer.html">Log Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sql-transformer.html">SQL Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="filter-transformer.html">Filter Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="readdomsession-transformer.html">Read DOM Session Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="writedomsession-transformer.html">Write DOM Session Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="xinclude-transformer.html">XInclude Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="cinclude-transformer.html">CInclude Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="encodeurl-transformer.html">EncodeURL Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><span class="menuselected">Text Parser Transformer</span></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
  <span class="menutitle">Optional</span></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="xt-transformer.html">XT Transformer</a></td>
  </tr>
  <tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
  <td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="ldap-transformer.html">LDAP Transformer</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">Text Parser Transformer</font>
  <hr style="color: #0086b2" size="1">
     
  <p>
  <font color="black" face="verdana,helvetica,sanserif">The text parser transformer parse the content of special marked element of a SAX stream, by using
        a grammar file.</font>
  </p>
  
     
  <blockquote>
  <ul>
      
  <li>
  <font face="verdana, helvetica, sans serif">Name : textparser</font>
  </li>
      
  <li>
  <font face="verdana, helvetica, sans serif">Class: org.apache.cocoon.transformation.TextFragmentParserTransformer</font>
  </li>
      
  <li>
  <font face="verdana, helvetica, sans serif">Cacheable: yes - uses the last modification date of the grammar document for validation.</font>
  </li>
     
  </ul>
  </blockquote>
  
     
  <p>
  <font color="black" face="verdana,helvetica,sanserif">The parser parse following elements from the SAX stream, and replace them through
        generated documents.</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;tf:textfragment xmlns:tf="http://chaperon.sourceforge.net/schema/textfragment/1.0"&gt;
   [Text, which should be parsed]
  &lt;/tf:textfragment&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">The parameter to specify the grammar must be declared. The second parameter tells the parser
        if it should include all obsolete tokens, and must not specified.</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:transform type="textparser"&gt;
   &lt;map:parameter name="grammar" value="example.grm"/&gt;
   &lt;map:parameter name="includeignorabletokens" value="false"/&gt;
  &lt;/map:transform&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">The explanation of function and the grammar format can be found at the <a href="../../howto/chaperon/howto-chaperon-intro.html">howto section</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>
  
  
  
  1.7       +57 -4     xml-site/targets/cocoon/userdocs/xsp/esql.html
  
  Index: esql.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/xsp/esql.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- esql.html	15 Jul 2002 13:57:08 -0000	1.6
  +++ esql.html	22 Aug 2002 02:39:05 -0000	1.7
  @@ -232,6 +232,57 @@
   </tr>
   </table>
   </div>
  +	  
  +   
  +<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>Connection</b></font>
  +	
  +<p>
  +<font color="black" face="verdana,helvetica,sanserif">Esql can use connection pools configured in <code><font face="courier, monospaced">cocoon.xconf</font></code> or
  +	 individually set up connections.</font>
  +</p>
  +	
  +	
  +<p>
  +<font color="black" face="verdana,helvetica,sanserif"><code><font face="courier, monospaced">esql:pool</font></code> gives the name of the connection pool to use.</font>
  +</p>
  +
  +	
  +<p>
  +<font color="black" face="verdana,helvetica,sanserif">Individually configured connections use the <code><font face="courier, monospaced">esql:driver,
  +	  esql:dburl, esql:username, esql:password</font></code> tags. Their meaning
  +	 should be obvious.</font>
  +</p>
  +
  +	
  +<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2">Connection Options</font>
  +	
  +<p>
  +<font color="black" face="verdana,helvetica,sanserif">Per default, esql will try to switch a connection to <i>autocommit</i>
  +	 mode. This is because it prevents hanging transactions that hold locks and
  +	 disturb further database accesses. Esql can be forced to not use
  +	 autocommit, by giving the
  +	 <code><font face="courier, monospaced">&lt;esql:autocommit&gt;false&lt;/esql:autocommit&gt;</font></code> nested
  +	 element to <code><font face="courier, monospaced">esql:connection</font></code>.</font>
  +</p>
  +
  +	
  +<p>
  +<table border="0" cellpadding="0" cellspacing="3" width="100%">
  +<tr>
  +<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i>Even if a connection is configured with autocommit off in
  +	 <code><font face="courier, monospaced">cocoon.xconf</font></code>, esql will switch autocommit on if not
  +	 instructed to do otherwise.</i></font></td>
  +</tr>
  +</table>
  +</p>
  +
  +	
  +<p>
  +<font color="black" face="verdana,helvetica,sanserif">Other options like limiting the size of the resultset are discussed
  +	 below.</font>
  +</p>
  +   
  +
     
   
     
  @@ -608,10 +659,12 @@
       
   <p>
   <font color="black" face="verdana,helvetica,sanserif">Parameters for a stored procedure call may be of
  -     <code><font face="courier, monospaced">direction="in|out|inout"</font></code> with the usual JDBC meaning. In
  -     addition a <code><font face="courier, monospaced">type</font></code> needs to be supplied as well. This would be
  -     the same "XXX" as used in a <code><font face="courier, monospaced">get-XXX</font></code> JDBC-method call.</font>
  -</p>
  +	 <code><font face="courier, monospaced">direction="in|out|inout"</font></code> with the usual JDBC meaning. In
  +	 addition a <code><font face="courier, monospaced">type</font></code> needs to be supplied for "out" and "inout"
  +	 parameters. This would be the same "XXX" as used in a <code><font face="courier, monospaced">get-XXX</font></code>
  +	 JDBC-method call. Alternatively, you can use a fully qualified field name,
  +	 e.g. "java.sql.Types.CHAR"</font>
  +</p> 
   
       
   <p>
  
  
  
  1.7       +453 -164  xml-site/targets/cocoon/userdocs/xsp/logicsheet-forms.html
  
  Index: logicsheet-forms.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/xsp/logicsheet-forms.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- logicsheet-forms.html	15 Jul 2002 13:57:08 -0000	1.6
  +++ logicsheet-forms.html	22 Aug 2002 02:39:06 -0000	1.7
  @@ -112,49 +112,56 @@
   <table cellspacing="15" cellpadding="0" border="0">
   <tr>
   <td> 
  -   
  -   
  -   <font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Introduction</font>
  +  
  +  
  +  <font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Introduction</font>
   <hr style="color: #0086b2" size="1">
  +
      
   <p>
   <font color="black" face="verdana,helvetica,sanserif">
  -   For most web applications input is essential. Apache Cocoon provides a
  -   variety of modules to support basic interaction like simple syntax
  -   checking of input data or writing input data to databases.
  +    For most web applications input is essential. Apache Cocoon provides a
  +    variety of modules to support basic interaction like simple syntax checking
  +    of input data or writing input data to databases.
      </font>
   </p>
  +
      
   <p>
   <font color="black" face="verdana,helvetica,sanserif">
  -   This is about syntax checking. See
  -   org.apache.cocoon.acting.DatabaseAbstractAction (in javadocs) for
  -   details on database interaction.
  +    Two different packages deal with validating user input:<a href="../../howto/xmlform-wizard/howto-xmlform-wizard.html">XMLForm</a>
  +    which tries to stay as close as possible with the <a href="www.w3.org">W3C</a> <a href="http://www.w3.org/MarkUp/Forms/">XForms</a> working draft.
  +    Another, simpler and older implementation is the validation using the
  +    <code><font face="courier, monospaced">FormValidatorAction</font></code>, which is described here.
      </font>
   </p>
  -    
  +
  +   
   <p>
   <font color="black" face="verdana,helvetica,sanserif">
  -    FormValidatorAction communicates to the application a verbose
  -    error status through an request attribute. In addition a taglib
  -    allows easy access to the results. On top of that this taglib
  -    gives access to the attributes for parameters declared in those
  -    sections in descriptor.xml relevant to the validation process.
  -    </font>
  +    To validate user input, an action, the <code><font face="courier, monospaced">FormValidatorAction</font></code>, is
  +    placed in your pipeline. Together with a descriptor file, that specifies
  +    the allowed input, this action validates the request parameters. Based on
  +    the result, a different page can be displayed and feedback can be given to
  +    the user either using XSP and the <code><font face="courier, monospaced">formval</font></code> logicsheet or the
  +    <code><font face="courier, monospaced">SimpleFormTransformer</font></code>.
  +   </font>
   </p>
  -    
  -<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>The Descriptor File</b></font>
  +
  +   
  +<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>Sitemap Usage</b></font>
       
   <p>
   <font color="black" face="verdana,helvetica,sanserif">
  -    For details on the syntax of the descriptor file see
  -    javadocs. Basically it consists of two sections, a list of
  -    parameters and their properties and a list of constraints or
  -    constraint sets. The file syntax is set up so that it can be
  -    shared with the database actions.
  +     To take advantage of the form validator action, create two pages. One for
  +     the input form and one indicating the acceptance of the reservation.
  +     Create a pipeline in your sitemap so that the confirmation page is only
  +     shown when the action completed successfully and the input form is
  +     returned otherwise.
       </font>
   </p>
  -     
  +
  +    
   <div align="center">
   <table border="0" cellpadding="0" cellspacing="4">
   <tr>
  @@ -165,22 +172,21 @@
   <pre>
   
   &lt;?xml version="1.0"?&gt;
  -&lt;root&gt;
  -
  -  &lt;parameter name="persons" type="long" min="1" default="4" nullable="no"/&gt;
  -  &lt;parameter name="deposit" type="double" min="10.0" max="999.99"/&gt;
  -  &lt;parameter name="email" type="string" max-len="50"
  -             matches-regex="^[\d\w][\d\w\-_\.]*@([\d\w\-_]+\.)\w\w\w?$"&gt;
  -
  -  &lt;constraint-set name="car-reservation"&gt;
  -    &lt;validate name="persons"/&gt;
  -    &lt;validate name="deposit" min="50.0"/&gt;
  -    &lt;validate name="email"/&gt;
  -  &lt;/constraint-set&gt;
  -
  -&lt;/root&gt;
  +   &lt;map:match pattern="car-reservation"&gt;
  +     &lt;map:act type="form-validator"&gt;
  +        &lt;!-- add you favourite database action here --&gt;
  +        &lt;map:parameter name="descriptor" value="descriptor.xml"/&gt;
  +        &lt;map:parameter name="validate-set" value="car-reservation"/&gt;
  +    &lt;map:generate type="serverpages" src="OK.xsp"/&gt;
  +    &lt;map:transform src="stylesheets/dynamic-page2html.xsl"/&gt;
  +    &lt;map:serialize/&gt;
  +     &lt;/map:act&gt;
  +     &lt;map:generate type="serverpages" src="test/ERROR.xsp"/&gt;
  +     &lt;map:transform src="stylesheets/dynamic-page2html.xsl"/&gt;
  +     &lt;map:serialize/&gt;
  +   &lt;/map:match&gt;
   
  -     </pre>
  +    </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>
  @@ -188,28 +194,26 @@
   </tr>
   </table>
   </div>
  +
       
   <p>
   <font color="black" face="verdana,helvetica,sanserif">
  -    The above could for example describe expected input from a reservation
  -    form. Specifications in a constraint set take precedence over
  -    the general ones.
  +     Note here that you may not use a redirection to point to the pages if you
  +     would like to access the validation results e.g. on the error page. A
  +     redirection would create a new request object and thus discard the
  +     validation results.
       </font>
   </p>
  -    
  -    
  -<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>Sitemap Usage</b></font>
  +
       
   <p>
   <font color="black" face="verdana,helvetica,sanserif">
  -    To take advantage of the form validator action create two
  -    pages. One for the input form and one indicating the acceptance of
  -    the reservation. Create a pipeline in your sitemap so that the
  -    confirmation page is only shown when the action completed
  -    successfully and the input form is returned otherwise.
  +     A different example, that does not need serverpages but the
  +     <code><font face="courier, monospaced">SimpleFormTransformer</font></code>:
       </font>
   </p>
  -     
  +
  +    
   <div align="center">
   <table border="0" cellpadding="0" cellspacing="4">
   <tr>
  @@ -221,20 +225,26 @@
   
   &lt;?xml version="1.0"?&gt;
      &lt;map:match pattern="car-reservation"&gt;
  -     &lt;map:act type="form-validator"&gt;
  -        &lt;!-- add you favourite database action here --&gt;
  -        &lt;map:parameter name="descriptor" value="descriptor.xml"/&gt;
  -        &lt;map:parameter name="validate-set" value="car-reservation"/&gt;
  -	&lt;map:generate type="serverpages" src="OK.xsp"/&gt;
  -	&lt;map:transform src="stylesheets/dynamic-page2html.xsl"/&gt;
  -	&lt;map:serialize/&gt;
  +     &lt;map:act type="req-params"&gt;
  +       &lt;map:parameter name="parameters" value="order"/&gt;
  +
  +       &lt;map:act type="form-validator"&gt;
  +         &lt;map:parameter name="descriptor" value="descriptor.xml"/&gt;
  +         &lt;map:parameter name="validate-set" value="car-reservation"/&gt;
  +         &lt;!-- add you favourite database action here --&gt;
  +
  +         &lt;map:generate type="file" src="OK.xml"/&gt;
  +         &lt;map:transform src="stylesheets/dynamic-page2html.xsl"/&gt;
  +         &lt;map:serialize/&gt;
  +       &lt;/map:act&gt;
        &lt;/map:act&gt;
  -     &lt;map:generate type="serverpages" src="test/ERROR.xsp"/&gt;
  +     &lt;map:generate type="file" src="test/ERROR.xml"/&gt;
        &lt;map:transform src="stylesheets/dynamic-page2html.xsl"/&gt;
  +     &lt;map:transform type="simple-form"/&gt;
        &lt;map:serialize/&gt;
      &lt;/map:match&gt;
   
  -     </pre>
  +    </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>
  @@ -242,33 +252,209 @@
   </tr>
   </table>
   </div>
  +
  +    
  +<p>
  +<font color="black" face="verdana,helvetica,sanserif">
  +     Although this looks more complicated at first, it has advantages if you
  +     don't want to or cannot use XSP. For example, if the form is stored as
  +     XHTML in a database, XSP could not be used to fill the form with values
  +     from request parameters or to display detailed error messages.
  +    </font>
  +</p>
  +    
  +<p>
  +<table border="0" cellpadding="0" cellspacing="3" width="100%">
  +<tr>
  +<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i>
  +     Keep in mind that files, here the descriptor file, could be specified
  +     using the <code><font face="courier, monospaced">cocoon:</font></code> pseudo-protocol. Thus the file could be
  +     generated dynamically from another pipeline!
  +    </i></font></td>
  +</tr>
  +</table>
  +</p>
  +
  +   
  +
  +   
  +<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>The Descriptor File</b></font>
  +
  +    
  +<p>
  +<font color="black" face="verdana,helvetica,sanserif">
  +     For details on the syntax of the descriptor file see javadocs. Basically
  +     it consists of two sections, a list of parameters and their properties and
  +     a list of constraints or constraint sets. The file syntax is set up so
  +     that it can be shared with the database actions.
  +    </font>
  +</p>
  +
  +    
  +<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2">The types recognized by validator and their attributes</font>
  +    
  +<table cellpadding="2" cellspacing="2" border="0" width="100%">
  +<caption>
  +<font face="verdana,helvetica,sanserif"></font>
  +</caption>
  +     
  +<tr>
  +      
  +<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">string</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">nullable="yes|no" default="str"</font></td>
  +     
  +</tr>
  +     
  +<tr>
  +      
  +<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">long</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">nullable="yes|no" default="123123"</font></td>
        
  +</tr>
  +     
  +<tr>
  +      
  +<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">double</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">nullable="yes|no" default="0.5"</font></td>
  +     
  +</tr>
  +    
  +</table>
  +
  +    
   <p>
   <font color="black" face="verdana,helvetica,sanserif">
  -     Note here that you may not use a redirection to point to the
  -     pages if you would like to access the validation results e.g. on
  -     the error page. A redirection would create a new request object
  -     and thus discard the validation results.
  -     </font>
  +     Default value takes place only when specified parameter is nullable and
  +     really is null or empty. Long numbers may be specified in decimal, hex or
  +     octal values as accepted by java.Lang.decode (String s).
  +    </font>
   </p>
  +
       
  +<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2">Constraints</font>
       
  +<table cellpadding="2" cellspacing="2" border="0" width="100%">
  +<caption>
  +<font face="verdana,helvetica,sanserif"></font>
  +</caption>
  +     
  +<tr>
  +      
  +<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">matches-regex</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">POSIX regular expression</font></td>
  +     
  +</tr>
  +     
  +<tr>
  +      
  +<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">one-of</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">List of strings, enclosed and separated by <code><font face="courier, monospaced">|</font></code></font></td>
  +     
  +</tr>
  +     
  +<tr>
  +      
  +<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">min-len</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">positive integer</font></td>
  +     
  +</tr>
  +     
  +<tr>
  +      
  +<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">max-len</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">positive integer</font></td>
  +     
  +</tr>
  +     
  +<tr>
  +      
  +<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">min</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">Double / Long</font></td>
  +     
  +</tr>
  +     
  +<tr>
  +      
  +<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">max</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">Double / Long</font></td>
  +     
  +</tr>
  +    
  +</table>
  +    
  +<p>
  +<font color="black" face="verdana,helvetica,sanserif">
  +     Constraints can be defined globally for a parameter and can be overridden
  +     by redefinition in a constraint-set. Thus if e.g. a database field can take
  +     at maximum 200 character, this property can be set globally.
  +    </font>
  +</p>
  +    
  +<p>
  +<font color="black" face="verdana,helvetica,sanserif">
  +     Values in parameter arrays are validated individually and the worst
  +     error is reported back.
  +    </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;?xml version="1.0"?&gt;
  +&lt;root&gt;
  +
  +  &lt;parameter name="persons" type="long" min="1" default="4" nullable="no"/&gt;
  +  &lt;parameter name="deposit" type="double" min="10.0" max="999.99"/&gt;
  +  &lt;parameter name="email" type="string" max-len="50"
  +             matches-regex="^[\d\w][\d\w\-_\.]*@([\d\w\-_]+\.)\w\w\w?$"/&gt;
  +  &lt;parameter name="colour" type="string" one-of="|red|green|blue|white|"/&gt;
  +
  +  &lt;constraint-set name="car-reservation"&gt;
  +    &lt;validate name="persons"/&gt;
  +    &lt;validate name="deposit" min="50.0"/&gt;
  +    &lt;validate name="email"/&gt;
  +  &lt;/constraint-set&gt;
  +
  +&lt;/root&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">
  +     The above could for example describe expected input from a reservation
  +     form. Specifications in a constraint set take precedence over the general
  +     ones.
  +    </font>
  +</p>
  +
  +   
  +
  +
  +   
   <font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>XSP Usage</b></font>
  +
       
   <p>
   <font color="black" face="verdana,helvetica,sanserif">
  -    To give the user some feedback why her/his submitted data was rejected
  -    there is a special taglib "xsp-formval". Declare its name space as
  -    usual.
  +     To give the user some feedback why her/his submitted data was rejected
  +     there is a special taglib "xsp-formval". Declare its name space as usual.
       </font>
   </p>
  +
       
   <p>
   <font color="black" face="verdana,helvetica,sanserif">
  -    If only interested in validation results, just:
  +     If only interested in validation results, just:
       </font>
   </p>
  -     
  +
  +    
   <div align="center">
   <table border="0" cellpadding="0" cellspacing="4">
   <tr>
  @@ -282,7 +468,7 @@
          &lt;myapp:error&gt;(ERROR)&lt;/myapp:error&gt;
        &lt;/xsp-formval:on-ok&gt;
   
  -     </pre>
  +    </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>
  @@ -290,14 +476,16 @@
   </tr>
   </table>
   </div>
  -     
  +
  +    
   <p>
   <font color="black" face="verdana,helvetica,sanserif">
  -       Alternatively, if you just want a boolean value from the logicsheet
  -       if a test is successful, use this method:
  -     </font>
  +     Alternatively, if you just want a boolean value from the logicsheet if a
  +     test is successful, use this method:
  +    </font>
   </p>
  -     
  +    
  +    
   <div align="center">
   <table border="0" cellpadding="0" cellspacing="4">
   <tr>
  @@ -308,12 +496,12 @@
   <pre>
   
        &lt;xsp:logic&gt;
  -	 if (!&lt;xsp-formval:is-ok name="persons"/&gt;) {
  -	      &lt;myapp:error&gt;(ERROR)&lt;/myapp:error&gt;
  +     if (!&lt;xsp-formval:is-ok name="persons"/&gt;) {
  +          &lt;myapp:error&gt;(ERROR)&lt;/myapp:error&gt;
            };
        &lt;/xsp:logic&gt;
   
  -     </pre>
  +    </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>
  @@ -321,115 +509,105 @@
   </tr>
   </table>
   </div>
  -     
  +
  +    
   <p>
   <font color="black" face="verdana,helvetica,sanserif">
  -     Internationalization issues are a separate concern and are not
  -     discussed here.
  -     </font>
  +     Internationalization issues are a separate concern and are not discussed
  +     here.
  +    </font>
   </p>
  -     
  +    
   <p>
   <font color="black" face="verdana,helvetica,sanserif">
        Currently the following validation result codes are supported:
  -     </font>
  +    </font>
   </p>
  -	 
  +
  +    
   <table cellpadding="2" cellspacing="2" border="0" width="100%">
   <caption>
   <font face="verdana,helvetica,sanserif"></font>
   </caption>
  -	 
  +     
   <tr>
   <td align="center" valign="center" rowspan="1" colspan="1" bgcolor="#039acc"><font face="verdana,helvetica,sanserif" size="-1" color="white"><b>tag</b></font></td><td align="center" valign="center" rowspan="1" colspan="1" bgcolor="#039acc"><font face="verdana,helvetica,sanserif" size="-1" color="white"><b>Meaning</b></font></td>
   </tr>
  -	 
  +     
   <tr>
  -<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-ok</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">no error occurred,
  -	                                   parameter successfully 
  -					   checked</font></td>
  +<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-ok</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">no error occurred, parameter
  +       successfully checked</font></td>
   </tr>
  -	 
  +     
   <tr>
  -<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-error</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">some error occurred, 
  -	                                      this is a result that 
  -					      is never set but serves 
  -					      as a comparison target
  -					   </font></td>
  +<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-error</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">some error occurred, this is a result
  +       that is never set but serves as a comparison target
  +      </font></td>
   </tr>
  -	 
  +     
   <tr>
   <td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-null</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">the parameter is null but 
  -	                                     isn't allowed to</font></td>
  +       isn't allowed to</font></td>
   </tr>
  -	 
  +     
   <tr>
  -<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-toosmall</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">either value or
  -	                                        length in case of a
  -						string is less than
  -						the specified
  -						minimum</font></td>
  +<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-toosmall</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">either value or length in case of
  +       a string is less than the specified minimum</font></td>
   </tr>
  -	 
  +     
   <tr>
  -<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-toolarge</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">either value or
  -	                                         length in case of a
  -						 string is greater
  -						 than the specified
  -						 maximum</font></td>
  -</tr>			 
  -	 
  +<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-toolarge</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">either value or length in case of
  +       a string is greater than the specified maximum</font></td>
  +</tr>          
  +     
   <tr>
  -<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-nomatch</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">a string parameter's
  -	                                        value is not matched
  -						by the specified
  -						regular expression</font></td>
  +<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-nomatch</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">a string parameter's value is not
  +       matched by the specified regular expression</font></td>
   </tr>
  -	 
  +     
   <tr>
  -<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-notpresent</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">this is returned
  -	                                           when the result of
  -	                                           a validation is
  -						   requested but no
  -						   such result is
  -						   found in the
  -						   request attribute </font></td>
  +<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-notpresent</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">this is returned when the result
  +       of a validation is requested but no such result is found in the request
  +       attribute </font></td>
   </tr>
  -	 
  +    
   </table>
  -     
  +
  +    
   <p>
   <font color="black" face="verdana,helvetica,sanserif">
  -     For debugging purposes or if you would like to iterate over the
  -     validation results, <code><font face="courier, monospaced">xsp-formval:results</font></code> returns a
  +     For debugging purposes or if you would like to iterate over the validation
  +     results, <code><font face="courier, monospaced">xsp-formval:results</font></code> returns a
        <code><font face="courier, monospaced">java.util.Map</font></code> containing them all.
  -     </font>
  +    </font>
   </p>
  -     
  +    
  +    
   <p>
   <font color="black" face="verdana,helvetica,sanserif">
  -     If you would like to be more specific what went wrong, you can
  -     query the descriptor file for attributes.
  -     </font>
  +     If you would like to be more specific what went wrong, you can query the
  +     descriptor file for attributes.
  +    </font>
   </p>
  -     
  +    
  +    
   <p>
   <font color="black" face="verdana,helvetica,sanserif">
  -     First set the url of the file or resource that contains the
  -     parameter descriptions and constraint sets.  This needs to be an
  -     ancestor to all other tags (of this taglib). Multiple use of this
  -     tag is allowed (although probably not necessary).
  -     </font>
  +     First set the url of the file or resource that contains the parameter
  +     descriptions and constraint sets.  This needs to be an ancestor to all
  +     other tags (of this taglib). Multiple use of this tag is allowed (although
  +     probably not necessary).
  +    </font>
   </p>       
  -     
  +
  +    
   <p>
  -<font color="black" face="verdana,helvetica,sanserif">  
  -     You need to do this only if you plan to query the
  -     descriptor file or if you'd like to use the shorthand
  -     below. 
  -     </font>
  +<font color="black" face="verdana,helvetica,sanserif"> You need to do this only if you plan to query the descriptor file or if
  +     you'd like to use the shorthand below. 
  +    </font>
   </p>
  -     
  +
  +    
   <div align="center">
   <table border="0" cellpadding="0" cellspacing="4">
   <tr>
  @@ -444,7 +622,7 @@
      &lt;xsp-formval:get-attribute parameter="deposit" name="min"/&gt;
   &lt;/xsp-formval:descriptor&gt;
   
  -     </pre>
  +    </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>
  @@ -452,26 +630,28 @@
   </tr>
   </table>
   </div>
  -     
  +
  +    
   <p>
   <font color="black" face="verdana,helvetica,sanserif">
  -     If you need to use one parameter a lot, there's a short hand. Use
  -     this e.g. if you'd like to set up the properties of an input tag
  -     according to the information from the descriptor file or if you'd
  -     like to give detailed error messages.
  -     </font>
  +     If you need to use one parameter a lot, there's a short hand. Use this
  +     e.g. if you'd like to set up the properties of an input tag according to
  +     the information from the descriptor file or if you'd like to give detailed
  +     error messages.
  +    </font>
   </p>
  -     
  +
  +    
   <p>
   <font color="black" face="verdana,helvetica,sanserif">
  -     Note that you can specify additional attributes in the
  -     description file that are not understood (and therefore ignored)
  -     by the FormValidatorAction but that could be queried here. This
  -     might be e.g. the size of the input field which might be
  -     different from the max-len a parameter can take.
  -     </font>
  +     Note that you can specify additional attributes in the description file
  +     that are not understood (and therefore ignored) by the FormValidatorAction
  +     but that could be queried here. This might be e.g. the size of the input
  +     field which might be different from the max-len a parameter can take.
  +    </font>
   </p>
  -     
  +
  +    
   <div align="center">
   <table border="0" cellpadding="0" cellspacing="4">
   <tr>
  @@ -501,7 +681,7 @@
     &lt;/xsp-formval:validate&gt;
   &lt;/xsp-formval:descriptor&gt;
   
  -     </pre>
  +    </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>
  @@ -509,8 +689,117 @@
   </tr>
   </table>
   </div>
  -     
  +
  +   
  +
      
  +<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>SimpleFormTransformer</b></font>
  +    
  +    
  +<p>
  +<font color="black" face="verdana,helvetica,sanserif">
  +     An alternative solution to using the <code><font face="courier, monospaced">formval</font></code> logicsheet and
  +     XSP is to use the <code><font face="courier, monospaced">SimpleFormTransformer</font></code>. If fills the form
  +     with values obtained from request parameters, overwriting existing
  +     values. Hence the data entered by the user is not discarded when it does
  +     not validate successfully.
  +    </font>
  +</p>
  +
  +    
  +<p>
  +<table border="0" cellpadding="0" cellspacing="3" width="100%">
  +<tr>
  +<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i>
  +     Beware when using the <code><font face="courier, monospaced">SimpleFormTransformer</font></code> together with
  +     XSP: The observer behaviour can be very confusing when trying to set a
  +     value from XSP and it is silently overwritten by the transformer!
  +    </i></font></td>
  +</tr>
  +</table>
  +</p>
  +
  +    
  +<p>
  +<font color="black" face="verdana,helvetica,sanserif">
  +     When a form element carries the attribute <code><font face="courier, monospaced">fixed="true"</font></code>, the
  +     transformer does not replace the value.
  +    </font>
  +</p>
  +
  +    
  +<p>
  +<font color="black" face="verdana,helvetica,sanserif">
  +     Feedback can be given to the user through <code><font face="courier, monospaced">&lt;error/&gt;</font></code>
  +     tags. Error tags need to have a name attribute identical to the input
  +     element they refer to. Multiple error elements may be present for any
  +     input element. The <code><font face="courier, monospaced">FormValidatorAction</font></code> sets a special field
  +     <code><font face="courier, monospaced">*</font></code> that indicates whether all parameters were validated
  +     successfully or not.
  +    </font>
  +</p>
  +
  +    
  +<p>
  +<font color="black" face="verdana,helvetica,sanserif">
  +     An error element is omitted together with all contents whenever the
  +     specified condition is not met. Conditions are either exact or greater
  +     equal constraints indicated by the attribute <code><font face="courier, monospaced">when</font></code> or
  +     <code><font face="courier, monospaced">when-ge</font></code> respectively.
  +    </font>
  +</p>
  +
  +    
  +<p>
  +<font color="black" face="verdana,helvetica,sanserif">
  +     Allowed values for error conditions are: <code><font face="courier, monospaced">ok, not-present, error,
  +      is-null, too-small, too-large, no-match </font></code>
  +    </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;input name="email" type="text"/&gt;&lt;error name="email" when-ge="error"&gt;*&lt;/error&gt;
  +     &lt;!-- ... --&gt;
  +     &lt;error name="email" when="is-null"&gt;Please enter your email address.&lt;/errro&gt;
  +     &lt;error name="email" when="no-match"&gt;Please enter a &lt;em&gt;syntacticly&lt;/em&gt; correct
  +     email address.&lt;/errro&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>
  +   
  +
  +   
  +<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>Other Validations</b></font>
  +
  +	
  +<p>
  +<font color="black" face="verdana,helvetica,sanserif">
  +	 In addition to validating form input, other actions exists that validate
  +	 values from different sources using the same techniques and syntax. For
  +	 example, the <code><font face="courier, monospaced">SessionValidatorAction</font></code> operates on session
  +	 attributes.
  +	</font>
  +</p>
  +
  +   
  +
  +   
  +
     
   
   </td>
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: general-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: general-cvs-help@xml.apache.org


Mime
View raw message