forrest-site-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject svn commit: r527020 [4/20] - in /forrest/site: ./ docs_0_80/ docs_0_80/howto/ docs_0_80/howto/cvs-ssh/ docs_0_80/howto/multi/ dtdx/ plan/ pluginDocs/plugins_0_70/ pluginDocs/plugins_0_80/ procedures/ procedures/release/ skins/ tools/
Date Tue, 10 Apr 2007 04:44:05 GMT
Modified: forrest/site/docs_0_80/faq.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/faq.html?view=diff&rev=527020&r1=527019&r2=527020
==============================================================================
--- forrest/site/docs_0_80/faq.html (original)
+++ forrest/site/docs_0_80/faq.html Mon Apr  9 21:44:00 2007
@@ -566,8 +566,8 @@
 </div>
 <div style="margin-left: 15px">
 <p>
-          There is no particular order to these FAQs. Use your browser's
-          "Find in this page" facility to search for keywords.
+          There is no particular order to these FAQs. Use your browser's "Find
+          in this page" facility to search for keywords.
         </p>
 </div>
 <a name="N10018"></a><a name="overview"></a>
@@ -576,7 +576,9 @@
 <a href="#overview-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p> See the <a href="../docs_0_80/your-project.html">Using Forrest</a> guide. </p>
+<p>
+          See the <a href="../docs_0_80/your-project.html">Using Forrest</a> guide.
+        </p>
 </div>
 <a name="N10024"></a><a name="docs"></a>
 <h4 class="faq">1.3. Where is all of the documentation?</h4>
@@ -585,19 +587,20 @@
 </div>
 <div style="margin-left: 15px">
 <p>
-          You have a local copy of the main documentation with your version of Forrest.
-          Do 'cd site-author; forrest run' and visit http://localhost:8888/ in your browser.
-          The most recent documentation is in SVN trunk which creates the forrest.apache.org website.
+          You have a local copy of the main documentation with your version of
+          Forrest. Do 'cd site-author; forrest run' and visit
+          http://localhost:8888/ in your browser. The most recent documentation
+          is in SVN trunk which creates the forrest.apache.org website.
         </p>
 <p>
-          Each <a href="../pluginDocs/plugins_0_80/index.html">plugin</a> has its own documentation
-          and working examples of its techniques.
+          Each <a href="../pluginDocs/plugins_0_80/index.html">plugin</a> has its own
+          documentation and working examples of its techniques.
         </p>
 <p>
-          The example seed site has other documentation and working examples of various techniques.
-          Do 'cd my-new-directory; forrest seed-sample; forrest run'.
-          Every hour the forrestbot generates a static version of this documentation on our
-          <a href="http://forrest.zones.apache.org/">testing zone</a>.
+          The example seed site has other documentation and working examples of
+          various techniques. Do 'cd my-new-directory; forrest seed-sample;
+          forrest run'. Every hour the forrestbot generates a static version of
+          this documentation on our <a href="http://forrest.zones.apache.org/">testing zone</a>.
         </p>
 </div>
 <a name="N1003A"></a><a name="requirements"></a>
@@ -606,14 +609,16 @@
 <a href="#requirements-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p> Forrest includes everything necessary to build and run, except of course for Java. In
-          addition to all the Cocoon JARs, Forrest includes and uses its own version of Apache Ant.
+<p>
+          Forrest includes everything necessary to build and run, except of
+          course for Java. In addition to all the Cocoon JARs, Forrest includes
+          and uses its own version of Apache Ant.
         </p>
 <p>
           Java 1.4 (or newer) is required. If you are only going to use Forrest
-          as-is then you need only the Java Runtime Environment (JRE).
-          If you intend to enhance and rebuild Forrest (or use the Forrest sources
-          with Subversion or use a source snapshot) then you need the full JDK.
+          as-is then you need only the Java Runtime Environment (JRE). If you
+          intend to enhance and rebuild Forrest (or use the Forrest sources with
+          Subversion or use a source snapshot) then you need the full JDK.
         </p>
 </div>
 <a name="N10045"></a><a name="cvs"></a>
@@ -622,8 +627,10 @@
 <a href="#cvs-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p> Forrest switched from a CVS code repository to SVN (Subversion) code repository. The old
-          CVS repository is closed and not kept current. </p>
+<p>
+          Forrest switched from a CVS code repository to SVN (Subversion) code
+          repository. The old CVS repository is closed and not kept current.
+        </p>
 </div>
 <a name="N1004D"></a><a name="svn"></a>
 <h4 class="faq">1.6.  How can I use SVN to keep up to date with the latest codebase? </h4>
@@ -631,9 +638,14 @@
 <a href="#svn-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p> Follow these <a href="../docs_0_80/howto/../build.html">Building Forrest</a> notes. </p>
-<p> The <a href="../docs_0_80/your-project.html">Using Forrest</a> guide provides further
-          step-by-step assistance in getting started with Forrest for your project. </p>
+<p>
+          Follow these <a href="../docs_0_80/howto/../build.html">Building Forrest</a> notes.
+        </p>
+<p>
+          The <a href="../docs_0_80/your-project.html">Using Forrest</a> guide provides
+          further step-by-step assistance in getting started with Forrest for
+          your project.
+        </p>
 </div>
 <a name="N10060"></a><a name="older-plugins"></a>
 <h4 class="faq">1.7.  How to use older versions of specific plugins? </h4>
@@ -642,14 +654,14 @@
 </div>
 <div style="margin-left: 15px">
 <p>
-          Sometimes one does not want to use the most recent functionality
-          of a plugin and instead need to use an older version.
-          Information about changes to each plugin can be found in its
+          Sometimes one does not want to use the most recent functionality of a
+          plugin and instead need to use an older version. Information about
+          changes to each plugin can be found in its
           <a href="../pluginDocs/plugins_0_80/index.html">documentation</a>.
         </p>
 <p>
-          In the forrest.properties file, specify the version of the plugin
-          that you require, e.g.
+          In the forrest.properties file, specify the version of the plugin that
+          you require, e.g.
         </p>
 <pre class="code">project.required.plugins=org.apache.forrest.plugin.input.PhotoGallery-0.1,...</pre>
 <p>
@@ -672,19 +684,18 @@
 </div>
 <div style="margin-left: 15px">
 <p>
-          There is a trick that can cut down your turnaround time
-          with building. In forrest.properties ...
+          There is a trick that can cut down your turnaround time with building.
+          In forrest.properties ...
         </p>
 <pre class="code">
 # The URL to start crawling from
 #project.start-uri=linkmap.html
         </pre>
 <p>
-          Uncomment that and set it to the specific page that
-          you want. Forrest will build that single document, then of course
-          it will keep crawling links from there. It might be
-          confined to a sub-directory, but depending on links
-          could end up generating the whole site. The main
+          Uncomment that and set it to the specific page that you want. Forrest
+          will build that single document, then of course it will keep crawling
+          links from there. It might be confined to a sub-directory, but
+          depending on links could end up generating the whole site. The main
           thing is that your page of interest is built first.
         </p>
 <p>
@@ -695,24 +706,24 @@
 forrest -Dproject.start-uri=live-sites.html
         </pre>
 <p>
-          You can terminate forrest with 'kill' or Ctrl-C after it
-          has built your pages of interest.
+          You can terminate forrest with 'kill' or Ctrl-C after it has built
+          your pages of interest.
         </p>
 <p>
-          Cocoon can be instructed via the
-          <a href="#cli-xconf">Cocoon cli.xconf</a> file to not
-          follow links (see its "follow-links" parameter). So this will
-          build only the document that was specified. Be careful, if you
-          also usually build PDF pages, then they will not be built.
+          Cocoon can be instructed via the <a href="#cli-xconf">Cocoon
+          cli.xconf</a> file to not follow links (see its "follow-links"
+          parameter). So this will build only the document that was specified.
+          Be careful, if you also usually build PDF pages, then they will not be
+          built.
         </p>
 <p>
-          Cocoon can also be instructed to not process certain URIs
-          if you need to temporarily exclude then.
+          Cocoon can also be instructed to not process certain URIs if you need
+          to temporarily exclude then.
         </p>
 <p>
-          Another useful technique is to use 'wget' or Apache Ant's Get task
-          to retrieve individual files, e.g.
-          Do 'forrest run' and then 'wget http://localhost:8888/index.pdf'.
+          Another useful technique is to use 'wget' or Apache Ant's Get task to
+          retrieve individual files, e.g. Do 'forrest run' and then 'wget
+          http://localhost:8888/index.pdf'.
         </p>
 </div>
 <a name="N100A7"></a><a name="cygwin_mutex_error"></a>
@@ -722,8 +733,11 @@
 <a href="#cygwin_mutex_error-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p> This <a href="http://issues.apache.org/jira/secure/ViewIssue.jspa?key=FOR-10">appears
-            to be a bug in cygwin</a>. Please use the .bat script instead. </p>
+<p>
+          This
+          <a href="http://issues.apache.org/jira/secure/ViewIssue.jspa?key=FOR-10">appears
+          to be a bug in cygwin</a>. Please use the .bat script instead.
+        </p>
 </div>
 <a name="N100B9"></a><a name="maxmemory"></a>
 <h4 class="faq">1.10.  How can I specify the amount of memory to be used by Java? </h4>
@@ -731,17 +745,24 @@
 <a href="#maxmemory-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p> There are two ways to control this. If you get an OutOfMemoryError when Cocoon is
-          generating pages, see the first paragraph. If you get an OutOfMemoryError when outside of
-          Cocoon (e.g., copying raw files), see the second paragraph. </p>
-<p> The <span class="codefrag">maxmemory</span> property in the <span class="codefrag">forrest.properties</span> file controls
-          how much memory Cocoon uses. Like many other properties you can copy them from the default
+<p>
+          There are two ways to control this. If you get an OutOfMemoryError
+          when Cocoon is generating pages, see the first paragraph. If you get
+          an OutOfMemoryError when outside of Cocoon (e.g., copying raw files),
+          see the second paragraph.
+        </p>
+<p>
+          The <span class="codefrag">maxmemory</span> property in the
+          <span class="codefrag">forrest.properties</span> file controls how much memory Cocoon
+          uses. Like many other properties you can copy them from the default
           configuration at <span class="codefrag">main/fresh-site/forrest.properties</span>
         
 </p>
-<p> Set the <span class="codefrag">ANT_OPTS</span> environment variable before you run forrest. The exact
-          value you set it to is dependant on your JVM, but something like
-          <span class="codefrag">ANT_OPTS=-Xmx500M</span> will probably work. </p>
+<p>
+          Set the <span class="codefrag">ANT_OPTS</span> environment variable before you run
+          forrest. The exact value you set it to is dependant on your JVM, but
+          something like <span class="codefrag">ANT_OPTS=-Xmx500M</span> will probably work.
+        </p>
 </div>
 <a name="N100D6"></a><a name="debug"></a>
 <h4 class="faq">1.11.  How can I start forrest in Java debug mode? </h4>
@@ -749,9 +770,11 @@
 <a href="#debug-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p> The <span class="codefrag">forrest.jvmargs</span> property in the <span class="codefrag">forrest.properties</span> file 
-          can be used to start forrest in debug mode on a specific port.
-          <span class="codefrag">forrest.jvmargs=-Xdebug -Xrunjdwp:transport=dt_socket,address=8000,server=y,suspend=n</span>
+<p>
+          The <span class="codefrag">forrest.jvmargs</span> property in the
+          <span class="codefrag">forrest.properties</span> file can be used to start forrest in
+          debug mode on a specific port. <span class="codefrag">forrest.jvmargs=-Xdebug
+          -Xrunjdwp:transport=dt_socket,address=8000,server=y,suspend=n</span>
         
 </p>
 </div>
@@ -763,15 +786,26 @@
 <a href="#edit-content-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p>If you are using the Apache Forrest XML <a href="../docs_0_80/../dtdx/dtd-docs.html">document format</a>
-          or DocBook or other XML document types, then you can use any text editor or even a
-          dedicated XML editor. You must ensure valid XML. See our <a href="../docs_0_80/catalog.html">configuration notes</a> for various editors. </p>
-<p>There are content management systems like <a href="http://lenya.apache.org/">Apache Lenya</a>. </p>
-<p>Remember that Forrest can also use other source formats, such as OpenOffice.org docs or
-          JSPWiki. Use the appropriate editor for those document types and ensure that the document
-          stucture is consistent. Forrest can also use "html" as the source format, in which case
-          you can use text editors or "html editors" such as the one provided with the Mozilla web
-          browser. </p>
+<p>
+          If you are using the Apache Forrest XML
+          <a href="../docs_0_80/../dtdx/dtd-docs.html">document format</a> or DocBook or other
+          XML document types, then you can use any text editor or even a
+          dedicated XML editor. You must ensure valid XML. See our
+          <a href="../docs_0_80/catalog.html">configuration notes</a> for
+          various editors.
+        </p>
+<p>
+          There are content management systems like
+          <a href="http://lenya.apache.org/">Apache Lenya</a>.
+        </p>
+<p>
+          Remember that Forrest can also use other source formats, such as
+          OpenOffice.org docs or JSPWiki. Use the appropriate editor for those
+          document types and ensure that the document stucture is consistent.
+          Forrest can also use "html" as the source format, in which case you
+          can use text editors or "html editors" such as the one provided with
+          the Mozilla web browser.
+        </p>
 </div>
 <a name="N10105"></a><a name="site-xml"></a>
 <h4 class="faq">2.2. 
@@ -782,22 +816,24 @@
 </div>
 <div style="margin-left: 15px">
 <p>
-          The <span class="codefrag">site.xml</span> configuration file is used for two different purposes:
-          defining the navigation menus, and as a method for defining references
-          to be used when linking between documents.
-          This file is fully explained in
-          <a href="../docs_0_80/linking.html">Menus and Linking</a>. Here is a precis:
+          The <span class="codefrag">site.xml</span> configuration file is used for two different
+          purposes: defining the navigation menus, and as a method for defining
+          references to be used when linking between documents. This file is
+          fully explained in <a href="../docs_0_80/linking.html">Menus and Linking</a>.
+          Here is a precis:
         </p>
 <p>
           The labels can be whatever text you want.
         </p>
-<pre class="code">&lt;faq label="FAQs" href="faq.html"&gt;
+<pre class="code">
+&lt;faq label="FAQs" href="faq.html"&gt;
   &lt;tech label="Technical" href="faq-tech.html"&gt;
     &lt;docbook href="#docbook"/&gt;
     &lt;ignoring_javadocs href="#ignoring_javadocs"/&gt;
   &lt;/tech&gt;
   &lt;user label="User" href="faq-user.html"&gt;
-&lt;/faq&gt;</pre>
+&lt;/faq&gt;
+        </pre>
 <p>
           That will create a menu like this with three links:
         </p>
@@ -807,13 +843,17 @@
 <p>
           These documents can be linked to from other documents, like this:
         </p>
-<pre class="code">&lt;a href="site:faq/tech"&gt; link to the top of the Tech FAQs
-&lt;a href="site:faq/tech/docbook"&gt; link to the DocBook FAQ in the Tech FAQs</pre>
+<pre class="code">
+&lt;a href="site:faq/tech"&gt; link to the top of the Tech FAQs
+&lt;a href="site:faq/tech/docbook"&gt; link to the DocBook FAQ in the Tech FAQs
+        </pre>
 <p>
           If that "docbook" entry was a unique name in your site.xml then you
           can shorten that latter link:
         </p>
-<pre class="code">&lt;a href="site:docbook"&gt; link to the DocBook FAQ in the Tech FAQs</pre>
+<pre class="code">
+&lt;a href="site:docbook"&gt; link to the DocBook FAQ in the Tech FAQs
+        </pre>
 </div>
 <a name="N10133"></a><a name="examples"></a>
 <h4 class="faq">2.3. 
@@ -824,9 +864,9 @@
 </div>
 <div style="margin-left: 15px">
 <p>
-          There are examples in the 'forrest seed site' and also the Forrest website documents
-          are included with the distribution (<span class="codefrag">cd forrest/site-author;
-            forrest run</span>).
+          There are examples in the 'forrest seed site' and also the Forrest
+          website documents are included with the distribution (<span class="codefrag">cd
+          forrest/site-author; forrest run</span>).
         </p>
 </div>
 <a name="N1013E"></a><a name="crawler"></a>
@@ -843,15 +883,14 @@
           document and crawls the links to find other documents to process.
         </p>
 <p>
-          There are essentially two ways to create links. Via a site.xml file to define the
-          navigation and menu structure, or via direct relative linking. See the
-          to previous FAQs.
+          There are essentially two ways to create links. Via a site.xml file to
+          define the navigation and menu structure, or via direct relative
+          linking. See the to previous FAQs.
         </p>
 <p>
-          Normally the source material will be local. The Forrest crawler does not follow
-          and process off-site links. The new locationmap (0.8+) enables content
-          to be drawn from remote sources.
-          
+          Normally the source material will be local. The Forrest crawler does
+          not follow and process off-site links. The new locationmap (0.8+)
+          enables content to be drawn from remote sources.
         </p>
 </div>
 <a name="N1014C"></a><a name="PDF-output"></a>
@@ -860,19 +899,28 @@
 <a href="#PDF-output-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p>Add the following entries to your site.xml file:</p>
+<p>
+          Add the following entries to your site.xml file:
+        </p>
 <pre class="code">
+
   &lt;about tab="home" label="About" href=""&gt;
  	  ...
     &lt;all_site label="Full HTML" href="wholesite.html"/&gt;    
     &lt;all_sitePDF label="Full PDF" href="wholesite.pdf"/&gt;  
      ...
-  &lt;/about&gt;</pre>
-<p> In this case the menu labeled "About" will have 2 new items: "Full PDF" and "Full HTML".
-          (See also <a href="../docs_0_80/howto/howto-pdf-tab.html">How to create a PDF document for each
-          tab</a>.) </p>
-<p> This assumes that you use the <a href="../docs_0_80/linking.html">site.xml</a> method for your
-          site structure and navigation, rather than the old book.xml method. </p>
+  &lt;/about&gt;
+        </pre>
+<p>
+          In this case the menu labeled "About" will have 2 new items: "Full
+          PDF" and "Full HTML". (See also <a href="../docs_0_80/howto/howto-pdf-tab.html">How to
+          create a PDF document for each tab</a>.)
+        </p>
+<p>
+          This assumes that you use the
+          <a href="../docs_0_80/linking.html">site.xml</a> method for your site
+          structure and navigation, rather than the old book.xml method.
+        </p>
 </div>
 <a name="N10166"></a><a name="pageBreaks"></a>
 <h4 class="faq">2.6. How do I insert page breaks into documents?</h4>
@@ -880,16 +928,22 @@
 <a href="#pageBreaks-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p>Page breaks do not make a great deal of sense in HTML documents intended for display on a
-          screen. However, PDF documents are intended for printing and therefore page breaks can be
-          important.</p>
-<p>To insert a page break in a PDF document simply add <em>pageBreakBefore</em> and/or
-            <em>pageBreakAfter</em> to the class attribute of the block you wish to force a
-            page break on. All the common block grouping elements support this class, for example, 
-            note, warning, p and so on.</p>
-<p>If you want these classes to be processed in your HTML documents as well you should add
-          the following to the <span class="codefrag">extra-css</span> element in your projects
-          <span class="codefrag">skinconf.xml</span>
+<p>
+          Page breaks do not make a great deal of sense in HTML documents
+          intended for display on a screen. However, PDF documents are intended
+          for printing and therefore page breaks can be important.
+        </p>
+<p>
+          To insert a page break in a PDF document simply add
+          <em>pageBreakBefore</em> and/or <em>pageBreakAfter</em> to the class
+          attribute of the block you wish to force a page break on. All the
+          common block grouping elements support this class, for example, note,
+          warning, p and so on.
+        </p>
+<p>
+          If you want these classes to be processed in your HTML documents as
+          well you should add the following to the <span class="codefrag">extra-css</span>
+          element in your projects <span class="codefrag">skinconf.xml</span>
         
 </p>
 <pre class="code"> 
@@ -909,9 +963,11 @@
 <a href="#clickable-email-address-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p>You would override <span class="codefrag">
-            $FORREST_HOME/main/webapp/skins/common/xslt/html/document-to-html.xsl</span> and edit the
-          "headers/authors" template. </p>
+<p>
+          You would override <span class="codefrag">
+          $FORREST_HOME/main/webapp/skins/common/xslt/html/document-to-html.xsl</span>
+          and edit the "headers/authors" template.
+        </p>
 </div>
 <a name="N1018F"></a><a name="link_raw"></a>
 <h4 class="faq">2.8. How do I link to raw files such as config.txt and brochure.pdf? </h4>
@@ -919,9 +975,11 @@
 <a href="#link_raw-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p>Handling of raw files was significantly changed in Forrest 0.7. See 
-          <a href="../docs_0_70/upgrading_07.html#raw">Upgrading to Apache Forrest 0.7</a> for
-          all the details.</p>
+<p>
+          Handling of raw files was significantly changed in Forrest 0.7. See
+          <a href="../docs_0_70/upgrading_07.html#raw">Upgrading to Apache Forrest
+          0.7</a> for all the details.
+        </p>
 </div>
 <a name="N1019B"></a><a name="pdf_images"></a>
 <h4 class="faq">2.9. Images don't display in PDFs. How do I fix this?</h4>
@@ -929,52 +987,73 @@
 <a href="#pdf_images-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p> Forrest uses <a href="http://xml.apache.org/fop/">Apache FOP</a> for rendering
-          PDFs. FOP cannot handle all image types natively, and requires third-party jars to be
-          added. FOP natively handles BMP, GIF, JPG, TIFF and EPS (with a few limitations). FOP can
-          also handle SVG (via Batik!and PNG (see below). For details, see <a href="http://xml.apache.org/fop/graphics.html">FOP Graphics formats</a>
+<p>
+          Forrest uses <a href="http://xml.apache.org/fop/">Apache FOP</a>
+          for rendering PDFs. FOP cannot handle all image types natively, and
+          requires third-party jars to be added. FOP natively handles BMP, GIF,
+          JPG, TIFF and EPS (with a few limitations). FOP can also handle SVG
+          (via Batik!and PNG (see below). For details, see
+          <a href="http://xml.apache.org/fop/graphics.html">FOP
+          Graphics formats</a>
         
 </p>
-<p>To get PNGs working in PDFs with Jimi:</p>
+<p>
+          To get PNGs working in PDFs with Jimi:
+        </p>
 <ol>
           
 <li>Download Jimi from <a href="http://java.sun.com/products/jimi/">http://java.sun.com/products/jimi/</a>
-          
 </li>
           
 <li>Unpack the Jimi distribution and copy JimiProClasses.zip to
               <span class="codefrag">$FORREST/lib/optional/jimi-1.0.jar</span>.</li>
         
 </ol>
-<p>Alternatively you can use JAI (Java Advanced Imaging API at
-          <span class="codefrag">http://java.sun.com/products/java-media/jai</span>). For more info, see <a href="http://xml.apache.org/fop/graphics.html#packages">FOP Graphics Packages</a>
+<p>
+          Alternatively you can use JAI (Java Advanced Imaging API at
+          <span class="codefrag">http://java.sun.com/products/java-media/jai</span>). For more
+          info, see
+          <a href="http://xml.apache.org/fop/graphics.html#packages">FOP
+          Graphics Packages</a>
         
 </p>
 <div class="note">
 <div class="label">Note</div>
-<div class="content">Due to Sun's licensing, we cannot redistribute Jimi or JAI with Forrest.</div>
+<div class="content">
+          Due to Sun's licensing, we cannot redistribute Jimi or JAI with
+          Forrest.
+        </div>
 </div>
 </div>
-<a name="N101CB"></a><a name="tab-index"></a>
+<a name="N101CA"></a><a name="tab-index"></a>
 <h4 class="faq">2.10.  The tab link in my site incorrectly assumes that 'index.html' is present in the
         linked-to directory. How do I fix this? </h4>
 <div align="right">
 <a href="#tab-index-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p> In <span class="codefrag">tabs.xml</span>, use @href instead of @dir, and omit the trailing '/'. Which
-          file to serve is then a concern of the sitemap. For example, if the "User Manual" tab
-          should link to <span class="codefrag">manual/Introduction.html</span> then <span class="codefrag">tabs.xml</span> should
-          contain: </p>
+<p>
+          In <span class="codefrag">tabs.xml</span>, use @href instead of @dir, and omit the
+          trailing '/'. Which file to serve is then a concern of the sitemap.
+          For example, if the "User Manual" tab should link to
+          <span class="codefrag">manual/Introduction.html</span> then <span class="codefrag">tabs.xml</span>
+          should contain:
+        </p>
 <pre class="code">
-  &lt;tab label="User Manual" href="manual"/&gt;</pre>
-<p> and add this rule to the sitemap: </p>
+
+  &lt;tab label="User Manual" href="manual"/&gt;
+        </pre>
+<p>
+          and add this rule to the sitemap:
+        </p>
 <pre class="code">
+
   &lt;map:match pattern="manual"&gt;
     &lt;map:redirect-to uri="manual/Introduction.html"/&gt;
-  &lt;/map:match&gt;</pre>
+  &lt;/map:match&gt;
+        </pre>
 </div>
-<a name="N101E7"></a><a name="tab-site"></a>
+<a name="N101E6"></a><a name="tab-site"></a>
 <h4 class="faq">2.11. I need help with the interaction between tabs.xml and site.xml </h4>
 <div align="right">
 <a href="#tab-site-menu">^</a>
@@ -984,15 +1063,17 @@
           See the <a href="../docs_0_80/linking.html#tab-site">tips</a>.
         </p>
 </div>
-<a name="N101F3"></a><a name="defaultFileName"></a>
+<a name="N101F2"></a><a name="defaultFileName"></a>
 <h4 class="faq">2.12.  How can I change the default file name that Forrest will look for when I request a
         URL like http://myserver or http://myserver/mydir/ ? </h4>
 <div align="right">
 <a href="#defaultFileName-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p>To change the default file name from 'index.html' (default) to 'overview.html' you need to
-          make the following changes:</p>
+<p>
+          To change the default file name from 'index.html' (default) to
+          'overview.html' you need to make the following changes:
+        </p>
 <ol>
           
 <li> Create a '<a href="#cli-xconf">cli.xconf</a>' file for your project </li>
@@ -1004,39 +1085,51 @@
 <li> Edit your project's <a href="../docs_0_80/project-sitemap.html">sitemap.xmap</a> file. </li>
           
 <li> Add the following code just before the end of the pipelines-element:<pre class="code">
+
   &lt;map:pipeline&gt;
     &lt;map:match type="regexp" pattern="^.+/$"&gt;
        &lt;map:redirect-to uri="overview.html"/&gt;
     &lt;/map:match&gt;
   &lt;/map:pipeline&gt;
-          </pre>
+          
+            </pre>
 </li>
         
 </ol>
 </div>
-<a name="N1021B"></a><a name="defaultStartPage"></a>
+<a name="N1021A"></a><a name="defaultStartPage"></a>
 <h4 class="faq">2.13.  How can I use a start-up-page other than index.html? </h4>
 <div align="right">
 <a href="#defaultStartPage-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p>Forrest by default assumes that the first page (home page) of your site is named
-          index.html. Which is good because most web servers are configured to look for index.html
-          when you call a url like http://myserver</p>
-<p>Like most settings in Forrest however this can be changed, for example when you want your
-          start-up-page for a CD-based documentation project to be named 'start.html'. </p>
-<p>To change the start page of a site:</p>
+<p>
+          Forrest by default assumes that the first page (home page) of your
+          site is named index.html. Which is good because most web servers are
+          configured to look for index.html when you call a url like
+          http://myserver
+        </p>
+<p>
+          Like most settings in Forrest however this can be changed, for example
+          when you want your start-up-page for a CD-based documentation project
+          to be named 'start.html'.
+        </p>
+<p>
+          To change the start page of a site:
+        </p>
 <ol>
           
 <li>Edit your project's <a href="../docs_0_80/project-sitemap.html">sitemap.xmap</a> file.</li>
           
 <li>Add the following code just before the end of the pipelines-element:<pre class="code">
+
   &lt;map:pipeline&gt;
     &lt;map:match pattern=""&gt;
       &lt;map:redirect-to uri="start.html" /&gt;
     &lt;/map:match&gt;
   &lt;/map:pipeline&gt;
-          </pre>
+          
+            </pre>
 </li>
           
 <li>Name the uri-attribute whatever you'd like your start page to be.</li>
@@ -1045,25 +1138,38 @@
         
 </ol>
 </div>
-<a name="N1023F"></a><a name="label-entity"></a>
+<a name="N1023E"></a><a name="label-entity"></a>
 <h4 class="faq">2.14.  How to use special characters in the labels of the site.xml file? </h4>
 <div align="right">
 <a href="#label-entity-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p> Use the numeric values for character entities. For example, rather than using
-            <span class="codefrag">&amp;ouml;</span> use <span class="codefrag">&amp;#246;</span>
+<p>
+          Use the numeric values for character entities. For example, rather
+          than using <span class="codefrag">
+&amp;ouml;
+          </span> use <span class="codefrag">
+&amp;#246;
+          </span>
         
 </p>
-<p> See the <a href="http://www.w3.org/TR/xhtml-modularization/dtd_module_defs.html#a_xhtml_character_entities">XHTML Character Entities</a> and see more discussion at <a href="http://issues.apache.org/jira/browse/FOR-244">Issue FOR-244</a>. </p>
+<p>
+          See the
+          <a href="http://www.w3.org/TR/xhtml-modularization/dtd_module_defs.html#a_xhtml_character_entities">XHTML
+          Character Entities</a> and see more discussion at
+          <a href="http://issues.apache.org/jira/browse/FOR-244">Issue
+          FOR-244</a>.
+        </p>
 </div>
-<a name="N10258"></a><a name="encoding"></a>
+<a name="N10257"></a><a name="encoding"></a>
 <h4 class="faq">2.15. Does Forrest handle accents for non-English languages?</h4>
 <div align="right">
 <a href="#encoding-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p>Yes, Forrest can process text in any language, so you can include:</p>
+<p>
+          Yes, Forrest can process text in any language, so you can include:
+        </p>
 <ul>
           
 <li>accents: &aacute; &eacute; &iacute; &oacute; &uacute;</li>
@@ -1073,38 +1179,68 @@
 <li>tildes: &atilde; &ntilde; Ä© &otilde; Å©</li>
         
 </ul>
-<p>This is because sources for Forrest docs are XML documents, which can include any of
-          these, provided the encoding declared by the XML doc matches the actual encoding used in
-          the file. For example if you declare the default encoding:</p>
-<pre class="code">&lt;?xml version="1.0" encoding="UTF-8"?&gt;</pre>
-<p>but the file content is actually using ISO-8859-1 then you will receive validation
-          errors, especially if you include some non-ASCII characters.</p>
-<p> This situation is commonly encountered when you edit the templates created by
-            <span class="codefrag">forrest seed</span> with your favorite (probably localized) editor without paying
-          attention to the encoding, or when you create a new file and simply copy the headers from
-          another file. </p>
-<p>Although UTF-8 is an encoding well-suited for most languages, it is not usually the
-          default in popular editors or systems. In UNIX-like systems, most popular editors can
-          handle different encodings to write the file in disk. With some editors the encoding of
-          the file is preserved, while with others the default is used regardless of the original
-          encoding. In most cases the encoding used to write files can be controlled by setting the
-          environment variable <span class="codefrag">LANG</span> to an appropriate value, for instance: </p>
+<p>
+          This is because sources for Forrest docs are XML documents, which can
+          include any of these, provided the encoding declared by the XML doc
+          matches the actual encoding used in the file. For example if you
+          declare the default encoding:
+        </p>
+<pre class="code">
+&lt;?xml version="1.0" encoding="UTF-8"?&gt;
+        </pre>
+<p>
+          but the file content is actually using ISO-8859-1 then you will
+          receive validation errors, especially if you include some non-ASCII
+          characters.
+        </p>
+<p>
+          This situation is commonly encountered when you edit the templates
+          created by <span class="codefrag">forrest seed</span> with your favorite (probably
+          localized) editor without paying attention to the encoding, or when
+          you create a new file and simply copy the headers from another file.
+        </p>
+<p>
+          Although UTF-8 is an encoding well-suited for most languages, it is
+          not usually the default in popular editors or systems. In UNIX-like
+          systems, most popular editors can handle different encodings to write
+          the file in disk. With some editors the encoding of the file is
+          preserved, while with others the default is used regardless of the
+          original encoding. In most cases the encoding used to write files can
+          be controlled by setting the environment variable <span class="codefrag">LANG</span> to
+          an appropriate value, for instance:
+        </p>
 <pre class="code">[localhost]$ export LANG=en_US.UTF-8</pre>
-<p>Of course the <em>appropriate</em> way to set the encoding depends on the editor/OS, but
-          ultimately relys on the user preferences. So you can use the encoding you prefer, as long
-          as the <span class="codefrag">encoding</span> attribute of the XML declaration matches the actual encoding
-          of the file. This means that if you are not willing to abandon ISO-8859-1 you can always
-          use the following declaration instead:</p>
-<pre class="code">&lt;?xml version="1.0" encoding="ISO-8859-1"?&gt;</pre>
-<p>Another option is to use "character entities" such as <span class="codefrag">&amp;ouml;</span>
-          (&ouml;) or the numeric form <span class="codefrag">&amp;#246;</span> (&ouml;). </p>
-<p>Another related issue is that your webserver needs to send http headers with the matching
-          charset definitions to the html page. </p>
-<p>Here are some references which explain further: <a href="http://orixo.com/events/gt2004/bios.html#torsten">GT2004 presentation by Torsten
-            Schlabach</a> and <a href="http://www.alanwood.net/unicode/">Alan Wood's Unicode
-            resources</a>. </p>
+<p>
+          Of course the <em>appropriate</em> way to set the encoding depends on
+          the editor/OS, but ultimately relys on the user preferences. So you
+          can use the encoding you prefer, as long as the <span class="codefrag">encoding</span>
+          attribute of the XML declaration matches the actual encoding of the
+          file. This means that if you are not willing to abandon ISO-8859-1 you
+          can always use the following declaration instead:
+        </p>
+<pre class="code">
+&lt;?xml version="1.0" encoding="ISO-8859-1"?&gt;
+        </pre>
+<p>
+          Another option is to use "character entities" such as <span class="codefrag">
+&amp;ouml;
+          </span> (&ouml;) or the numeric form <span class="codefrag">
+&amp;#246;
+          </span> (&ouml;).
+        </p>
+<p>
+          Another related issue is that your webserver needs to send http
+          headers with the matching charset definitions to the html page.
+        </p>
+<p>
+          Here are some references which explain further:
+          <a href="http://orixo.com/events/gt2004/bios.html#torsten">GT2004
+          presentation by Torsten Schlabach</a> and
+          <a href="http://www.alanwood.net/unicode/">Alan Wood's Unicode
+          resources</a>.
+        </p>
 </div>
-<a name="N102AA"></a><a name="xml-entities"></a>
+<a name="N102A9"></a><a name="xml-entities"></a>
 <h4 class="faq">2.16. How to use XML entities, for example string
         replacement?</h4>
 <div align="right">
@@ -1112,15 +1248,14 @@
 </div>
 <div style="margin-left: 15px">
 <p>
-          A set of symbols is available. See the demonstration
-          in a fresh 'forrest seed' site (at samples/xml-entities.html).
-          For example, use "<span class="codefrag">&amp;myp-t;</span>" to represent the
-          project name together with trademark symbol
-          "My Project Name&trade;".
-          Avoid lengthy typing and potential spelling errors.
+          A set of symbols is available. See the demonstration in a fresh
+          'forrest seed' site (at samples/xml-entities.html). For example, use
+          "<span class="codefrag">&amp;myp-t;</span>" to represent the project name together with
+          trademark symbol "My Project Name&trade;". Avoid lengthy typing and
+          potential spelling errors.
         </p>
 </div>
-<a name="N102B5"></a><a name="cleanSite"></a>
+<a name="N102B4"></a><a name="cleanSite"></a>
 <h4 class="faq">2.17.  How to make Forrest clean up the project build directories? </h4>
 <div align="right">
 <a href="#cleanSite-menu">^</a>
@@ -1132,36 +1267,45 @@
           successive runs of forrest.
         </p>
 <p>
-        Doing 'forrest clean-site' will remove the contents of the project's
-        generated documents directory. Doing 'forrest clean-work' will remove the
-        project's work directories (usually build/tmp and build/webapp which
-        include the Cocoon cache and the Cocoon logs).
-        Doing 'forrest clean' will remove both sections.
+          Doing 'forrest clean-site' will remove the contents of the project's
+          generated documents directory. Doing 'forrest clean-work' will remove
+          the project's work directories (usually build/tmp and build/webapp
+          which include the Cocoon cache and the Cocoon logs). Doing 'forrest
+          clean' will remove both sections.
         </p>
 </div>
-<a name="N102C0"></a><a name="i18n"></a>
+<a name="N102BF"></a><a name="i18n"></a>
 <h4 class="faq">2.18. How can I internationalise (i18n) my content?</h4>
 <div align="right">
 <a href="#i18n-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p>The i18n features of Forrest are still under development (as of 0.7) however there are
-        some features available. For example, navigation menus can be i18n'd (see fresh-site for an
-        example). Currently, <a href="http://issues.apache.org/jira/browse/FOR-506">work is underway</a> to 
-        i18n skins</p>
-<p>All internationalistation of tokens in, for example, the skins and the menus, is carried out
-        by the <a href="http://cocoon.apache.org/2.1/userdocs/i18nTransformer.html">Cocoon i18n 
-        Transformer</a>. You can see an example of how it works in the above linked issue.</p>
+<p>
+          The i18n features of Forrest are still under development (as of 0.7)
+          however there are some features available. For example, navigation
+          menus can be i18n'd (see fresh-site for an example). Currently,
+          <a href="http://issues.apache.org/jira/browse/FOR-506">work is
+          underway</a> to i18n skins
+        </p>
+<p>
+          All internationalistation of tokens in, for example, the skins and the
+          menus, is carried out by the
+          <a href="http://cocoon.apache.org/2.1/userdocs/i18nTransformer.html">Cocoon
+          i18n Transformer</a>. You can see an example of how it works in the
+          above linked issue.
+        </p>
 </div>
-<a name="N102D3"></a><a name="rawHTML"></a>
+<a name="N102D2"></a><a name="rawHTML"></a>
 <h4 class="faq">2.19. How can I include HTML content that is not to be skinned by Forrest?</h4>
 <div align="right">
 <a href="#rawHTML-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p>To serve, for example a legacy HTML site, add something like the following 
-        to your project's sitemap and place the source content at the
-        <span class="codefrag">src/documentation/content/xdocs/old_site/</span> directory.</p>
+<p>
+          To serve, for example a legacy HTML site, add something like the
+          following to your project's sitemap and place the source content at
+          the <span class="codefrag">src/documentation/content/xdocs/old_site/</span> directory.
+        </p>
 <pre class="code">
 &lt;map:match pattern="old_site/**.html"&gt;
  &lt;map:select type="exists"&gt;
@@ -1176,12 +1320,16 @@
  &lt;/map:select&gt;
 &lt;/map:match&gt;
         </pre>
-<p>Exactly what the match should be is dependant on your content
-        structure. It is outside the scope of this FAQ to provide full details,
-        but new users may like to refer to the 
-        <a href="../docs_0_80/sitemap-ref.html">Cocoon sitemap</a> docs.</p>
-<p>There is a more detailed discussion of this topic in the samples
-        of a freshly seeded site. To see this documentation do the following:</p>
+<p>
+          Exactly what the match should be is dependant on your content
+          structure. It is outside the scope of this FAQ to provide full
+          details, but new users may like to refer to the
+          <a href="../docs_0_80/sitemap-ref.html">Cocoon sitemap</a> docs.
+        </p>
+<p>
+          There is a more detailed discussion of this topic in the samples of a
+          freshly seeded site. To see this documentation do the following:
+        </p>
 <ol>
           
 <li>mkdir seed</li>
@@ -1198,31 +1346,29 @@
         
 </ol>
 </div>
-<a name="N102FF"></a><a name="javascript"></a>
+<a name="N102FE"></a><a name="javascript"></a>
 <h4 class="faq">2.20. How to include additional Javascript and CSS files?</h4>
 <div align="right">
 <a href="#javascript-menu">^</a>
 </div>
 <div style="margin-left: 15px">
 <p>
-          Place various resources (e.g. javascript, css) into the
-          "project skins" directory. The default forrest.properties
-          has this at src/documentation/skins/$skin-name/
-          Javascript files would go in a "scripts" subdirectory.
-          CSS files would go in a "css" subdirectory.
+          Place various resources (e.g. javascript, css) into the "project
+          skins" directory. The default forrest.properties has this at
+          src/documentation/skins/$skin-name/ Javascript files would go in a
+          "scripts" subdirectory. CSS files would go in a "css" subdirectory.
         </p>
 <p>
-          Then refer to those from your source documents with
-          URIs like /skin/blah.js and /skin/foo.css
+          Then refer to those from your source documents with URIs like
+          /skin/blah.js and /skin/foo.css
         </p>
 <p>
-          See how this is handled in the core sitemap
-          called forrest/main/webapp/resources.xmap
-          Search for "javascript" then follow to the 
-          &lt;map:resource name="skin-read"&gt; section.
+          See how this is handled in the core sitemap called
+          forrest/main/webapp/resources.xmap Search for "javascript" then follow
+          to the &lt;map:resource name="skin-read"&gt; section.
         </p>
 </div>
-<a name="N1030D"></a><a name="linkmap"></a>
+<a name="N1030C"></a><a name="linkmap"></a>
 <h4 class="faq">2.21. How to show a Table Of Contents for the whole site?</h4>
 <div align="right">
 <a href="#linkmap-menu">^</a>
@@ -1230,18 +1376,19 @@
 <div style="margin-left: 15px">
 <p>
           Every site has an automatically generated document at
-          <span class="codefrag">/linkmap.html</span>
-          which is produced from the site.xml navigation configuration.
-          It uses the @label and absolutized @href and element name and @description attribute for
-          each node.
+          <span class="codefrag">/linkmap.html</span> which is produced from the site.xml
+          navigation configuration. It uses the @label and absolutized @href and
+          element name and @description attribute for each node.
         </p>
 <p>
-          For example, the Forrest project's <a href="../linkmap.html">Site Linkmap Table of Contents</a>.
+          For example, the Forrest project's <a href="../linkmap.html">Site
+          Linkmap Table of Contents</a>.
         </p>
 <p>
-          The document is also useful when developing your documentation and linking
-          to other docs. The element names (column #2) e.g.
-           href="site:<strong>mail-lists</strong>" or href="site:<strong>howto/overview</strong>"
+          The document is also useful when developing your documentation and
+          linking to other docs. The element names (column #2) e.g.
+          href="site:<strong>mail-lists</strong>" or
+          href="site:<strong>howto/overview</strong>"
         </p>
 <p>
           This is also the document that 'forrest site' uses to kick-start the
@@ -1249,9 +1396,9 @@
           project.start-uri in the forrest.properties file.
         </p>
 </div>
-<a name="N1032B"></a><a name="technical"></a>
+<a name="N1032A"></a><a name="technical"></a>
 <h3 class="underlined_5">3. Technical</h3>
-<a name="N1032F"></a><a name="java-code"></a>
+<a name="N1032E"></a><a name="java-code"></a>
 <h4 class="faq">3.1. Where is the Java code?</h4>
 <div align="right">
 <a href="#java-code-menu">^</a>
@@ -1259,13 +1406,14 @@
 <div style="margin-left: 15px">
 <p>
           Because we are based on Apache Cocoon, a lot of the functionality is
-          provided behind-the-scenes, i.e. we use Cocoon's sitemaps and sitemap components
-          such as XSLT transformers. So there is not much need for Java code in Forrest.
+          provided behind-the-scenes, i.e. we use Cocoon's sitemaps and sitemap
+          components such as XSLT transformers. So there is not much need for
+          Java code in Forrest.
         </p>
 <p>
-          For Forrest developers who want to explore or enhance that code, see the
-          Apache Cocoon SVN trunk. From time-to-time we update Forrest's packaged
-          version of Cocoon and so can include your contributions.
+          For Forrest developers who want to explore or enhance that code, see
+          the Apache Cocoon SVN trunk. From time-to-time we update Forrest's
+          packaged version of Cocoon and so can include your contributions.
         </p>
 <p>
           That said, you will find some Java code in Forrest at main/java/...
@@ -1274,130 +1422,176 @@
           with specialised purpose, e.g. PhotoGallery.
         </p>
 </div>
-<a name="N1033D"></a><a name="populate-cache"></a>
+<a name="N1033C"></a><a name="populate-cache"></a>
 <h4 class="faq">3.2. How to enhance the responsiveness of the cache?</h4>
 <div align="right">
 <a href="#populate-cache-menu">^</a>
 </div>
 <div style="margin-left: 15px">
 <p>
-          Apache Cocoon has a sophisticated cache. When running Forrest in dynamic
-          mode, the initial visitor will receive slower response. The very first
-          page served will cause Cocoon to cache the pipelines. Later requests
-          will re-use those cached components and add others to the cache.
-          A good technique is to warm up the cache after the forrest webapp has
-          been re-started. Requesting the front page alone will populate the
-          cache with the common items used for other pages. Using a spider
-          such as wget, will warm up everything.
+          Apache Cocoon has a sophisticated cache. When running Forrest in
+          dynamic mode, the initial visitor will receive slower response. The
+          very first page served will cause Cocoon to cache the pipelines. Later
+          requests will re-use those cached components and add others to the
+          cache. A good technique is to warm up the cache after the forrest
+          webapp has been re-started. Requesting the front page alone will
+          populate the cache with the common items used for other pages. Using a
+          spider such as wget, will warm up everything.
         </p>
 <p>
           The Cocoon cache and sitemaps can be tuned. See
-          <a href="http://cocoon.apache.org/2.1/performancetips.html">Cocoon Performance Tips</a>
-          and
+          <a href="http://cocoon.apache.org/2.1/performancetips.html">Cocoon
+          Performance Tips</a> and
           <a href="http://wiki.apache.org/cocoon/CocoonPerformance">CocoonPerformance</a>
-          and the "Object Stores" section of main/webapp/WEB-INF/forrest-core.xconf
+          and the "Object Stores" section of
+          main/webapp/WEB-INF/forrest-core.xconf
         </p>
-<p>Responsiveness can be further enhanced by utilising a transparent proxy server, e.g. Apache HTTP Server as a frontend. See <a href="http://wiki.apache.org/cocoon/ApacheModProxy">CocoonAndApacheModProxy</a>.
+<p>
+          Responsiveness can be further enhanced by utilising a transparent
+          proxy server, e.g. Apache HTTP Server as a frontend. See
+          <a href="http://wiki.apache.org/cocoon/ApacheModProxy">CocoonAndApacheModProxy</a>.
         </p>
 </div>
-<a name="N10357"></a><a name="proxy_config"></a>
+<a name="N10356"></a><a name="proxy_config"></a>
 <h4 class="faq">3.3. I'm behind a proxy and it's preventing Plugins from being downloaded, what should I
         do?</h4>
 <div align="right">
 <a href="#proxy_config-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p>You can configure the proxy in the <span class="codefrag">forrest.properties</span> file. Set the
-            <span class="codefrag">proxy.host</span> and <span class="codefrag">proxy.port</span> accordingly.</p>
-<p>You can also cross an authenticated proxy by setting the <span class="codefrag">proxy.user</span> and <span class="codefrag">proxy.password</span> accordingly.</p>
+<p>
+          You can configure the proxy in the <span class="codefrag">forrest.properties</span>
+          file. Set the <span class="codefrag">proxy.host</span> and <span class="codefrag">proxy.port</span>
+          accordingly.
+        </p>
+<p>
+          You can also cross an authenticated proxy by setting the
+          <span class="codefrag">proxy.user</span> and <span class="codefrag">proxy.password</span> accordingly.
+        </p>
 <div class="note">
 <div class="label">Generalise the proxy configuration</div>
-<div class="content">You certainly need to cross your proxy for every Forrest projects you have.
-        To avoid to edit every project <span class="codefrag">forrest.properties</span> files, you can do once in your <span class="codefrag">${user.home}/forrest.properties</span> !</div>
+<div class="content">
+          You certainly need to cross your proxy for every Forrest projects you
+          have. To avoid to edit every project <span class="codefrag">forrest.properties</span>
+          files, you can do once in your
+          <span class="codefrag">${user.home}/forrest.properties</span> !
+        </div>
 </div>
 </div>
-<a name="N1037B"></a><a name="CVS_revison_tags"></a>
+<a name="N1037A"></a><a name="CVS_revison_tags"></a>
 <h4 class="faq">3.4. How can I generate html-pages to show the Revision tag of CVS or SVN?</h4>
 <div align="right">
 <a href="#CVS_revison_tags-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p>If you have:<span class="codefrag">&lt;version&gt;$Revision: 1.30
+<p>
+          If you have:<span class="codefrag">&lt;version&gt;$Revision: 1.30
           $&lt;/version&gt;</span>The '1.30' will be extracted and
-          displayed at the bottom of the page as "version 1.30". See for example the
-          bottom of the <a href="../docs_0_80/your-project.html"> Using Forrest</a> document.</p>
-<p>This technique could also be used for a modification date with $Date: 2004/01/15 08:52:47
-          $</p>
+          displayed at the bottom of the page as "version 1.30". See for
+          example the bottom of the <a href="../docs_0_80/your-project.html"> Using
+          Forrest</a> document.
+        </p>
+<p>
+          This technique could also be used for a modification date with $Date:
+          2004/01/15 08:52:47 $
+        </p>
 <p>
-          When using Subversion, remember to set the relevant svn:keywords properties.
+          When using Subversion, remember to set the relevant svn:keywords
+          properties.
         </p>
 </div>
-<a name="N10390"></a><a name="cli-xconf"></a>
+<a name="N1038F"></a><a name="cli-xconf"></a>
 <h4 class="faq">3.5.  How to control the processing of URIs by Cocoon, e.g. exclude certain URIs, include
         other additional ones. </h4>
 <div align="right">
 <a href="#cli-xconf-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p> Forrest uses a configuration file to control the processing done by the Apache Cocoon
-          command-line called cli.xconf </p>
-<p> Your project can supply its own <span class="codefrag">cli.xconf</span> and define patterns for URIs to
-          exclude. There are also other powerful configuration features. </p>
-<p> This means creating a directory <span class="codefrag">src/documentation/conf</span> (or wherever
-            <span class="codefrag">${forrest.conf-dir}</span> points) and copying
-            <span class="codefrag">$FORREST_HOME/main/webapp/WEB-INF/cli.xconf</span> to it. Declare the location of
-          this file in the forrest.properties configuration, e.g.
-            <span class="codefrag">project.configfile=${project.home}/src/documentation/conf/cli.xconf</span>
+<p>
+          Forrest uses a configuration file to control the processing done by
+          the Apache Cocoon command-line called cli.xconf
+        </p>
+<p>
+          Your project can supply its own <span class="codefrag">cli.xconf</span> and define
+          patterns for URIs to exclude. There are also other powerful
+          configuration features.
+        </p>
+<p>
+          This means creating a directory <span class="codefrag">src/documentation/conf</span>
+          (or wherever <span class="codefrag">${forrest.conf-dir}</span> points) and copying
+          <span class="codefrag">$FORREST_HOME/main/webapp/WEB-INF/cli.xconf</span> to it.
+          Declare the location of this file in the forrest.properties
+          configuration, e.g.
+          <span class="codefrag">project.configfile=${project.home}/src/documentation/conf/cli.xconf</span>
         
 </p>
-<p> Then edit cli.xconf, and add any exclude sections that you require. The default
-          cli.xconf ignores directory links and links containing 'apidocs' or starting with 'api/': </p>
+<p>
+          Then edit cli.xconf, and add any exclude sections that you require.
+          The default cli.xconf ignores directory links and links containing
+          'apidocs' or starting with 'api/':
+        </p>
 <pre class="code">
+
    ....
    &lt;!-- Includes and excludes can be used to limit which URLs are rendered --&gt;
    <strong>
+
    &lt;exclude pattern="**/"/&gt;
    &lt;exclude pattern="**apidocs**"/&gt;
    &lt;exclude pattern="api/**"/&gt;
    </strong>
+
    &lt;uri src="favicon.ico"/&gt;
-&lt;/cocoon&gt;</pre>
-<p>This is just an example, and you should modify it appropriately for your site.</p>
+&lt;/cocoon&gt;
+        </pre>
+<p>
+          This is just an example, and you should modify it appropriately for
+          your site.
+        </p>
 <div class="note">
 <div class="label">Note</div>
-<div class="content"> Wildcards may be used. These are a powerful feature of Cocoon's <a href="../docs_0_80/sitemap-ref.html">sitemap</a>. For example, <strong>foo/*</strong> would match
-            <span class="codefrag">foo/bar</span>, but not <span class="codefrag">foo/bar/baz</span> &mdash; use
-          <strong>foo/**</strong> to match that. </div>
+<div class="content">
+          Wildcards may be used. These are a powerful feature of Cocoon's
+          <a href="../docs_0_80/sitemap-ref.html">sitemap</a>. For example,
+          <strong>foo/*</strong> would match <span class="codefrag">foo/bar</span>, but not
+          <span class="codefrag">foo/bar/baz</span> &mdash; use <strong>foo/**</strong> to match
+          that.
+        </div>
 </div>
 </div>
-<a name="N103CD"></a><a name="ignoring_javadocs"></a>
+<a name="N103CC"></a><a name="ignoring_javadocs"></a>
 <h4 class="faq">3.6.  How do I stop Forrest breaking on links to external files that may not exist, like
         javadocs? </h4>
 <div align="right">
 <a href="#ignoring_javadocs-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p> This can be done by overriding the <a href="#cli-xconf">
-            <span class="codefrag">cli.xconf</span>
-          </a> Cocoon config file, and defining patterns for URLs to exclude. </p>
+<p>
+          This can be done by overriding the <a href="#cli-xconf">
+          <span class="codefrag">cli.xconf</span> </a> Cocoon config file, and defining
+          patterns for URLs to exclude.
+        </p>
 </div>
-<a name="N103DC"></a><a name="claimed_patterns"></a>
+<a name="N103DB"></a><a name="claimed_patterns"></a>
 <h4 class="faq">3.7. Some of my files are not being processed because they use common filenames. </h4>
 <div align="right">
 <a href="#claimed_patterns-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p> Certain patterns are claimed by the default sitemaps for special processing. These reserved words
-          include: <span class="codefrag">site, changes, todo, faq, images, my-images, skinconf, community,
-          howto</span>
+<p>
+          Certain patterns are claimed by the default sitemaps for special
+          processing. These reserved words include: <span class="codefrag">site, changes, todo,
+          faq, images, my-images, skinconf, community, howto</span>
         
 </p>
-<p> Sometimes there are workarounds, e.g. faq.html or faq-interview.html would fail, but
-          interview-faq.html would be fine. In future versions of Forrest we will attempt to deal
-          with this issue (<a href="http://issues.apache.org/jira/browse/FOR-217">FOR-217</a>).
+<p>
+          Sometimes there are workarounds, e.g. faq.html or faq-interview.html
+          would fail, but interview-faq.html would be fine. In future versions
+          of Forrest we will attempt to deal with this issue
+          (<a href="http://issues.apache.org/jira/browse/FOR-217">FOR-217</a>).
         </p>
 </div>
-<a name="N103EE"></a><a name="build_msg_a"></a>
+<a name="N103ED"></a><a name="build_msg_a"></a>
 <h4 class="faq">3.8. What do the symbols and numbers mean when Forrest lists each document that it has
         built? </h4>
 <div align="right">
@@ -1405,15 +1599,18 @@
 </div>
 <div style="margin-left: 15px">
 <p>
-          Each time that Cocoon processes a link, it will report the status messages ...
+          Each time that Cocoon processes a link, it will report the status
+          messages ...
         </p>
-<pre class="code">...
+<pre class="code">
+...
 * [212/166] [0/0]  1.16s  62.4Kb  docs_0_60/your-project.pdf
 X [0]         /docs_0_80/upgrading_08.html  BROKEN: No pipeline matched...
 * [213/164] [0/0]  0.391s 29.2Kb  docs_0_70/howto/howto-buildPlugin.pdf
 ^                           apidocs/index.html
 * [214/170] [7/66] 1.476s 45.5Kb  docs_0_60/sitemap-ref.html
-...</pre>
+...
+        </pre>
 <ul>
           
 <li>Column 1 is the page build status (*=okay X=brokenLink ^=pageSkipped).</li>
@@ -1428,20 +1625,26 @@
         
 </ul>
 </div>
-<a name="N1040C"></a><a name="headless_operation"></a>
+<a name="N1040B"></a><a name="headless_operation"></a>
 <h4 class="faq">3.9.  When generating PNG images from SVG, I get an error: Can't connect to X11 window
         server using ':0.0' as the value of the DISPLAY variable. </h4>
 <div align="right">
 <a href="#headless_operation-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p> If you are using JDK 1.4.0 or newer, you can enable <em>headless</em> operation by
-          running Forrest with the <span class="codefrag">forrest.jvmarg</span> parameter set to
-            <span class="codefrag">-Djava.awt.headless=true</span>, like this: </p>
+<p>
+          If you are using JDK 1.4.0 or newer, you can enable <em>headless</em>
+          operation by running Forrest with the <span class="codefrag">forrest.jvmarg</span>
+          parameter set to <span class="codefrag">-Djava.awt.headless=true</span>, like this:
+        </p>
 <pre class="code">forrest -Dforrest.jvmargs=-Djava.awt.headless=true site</pre>
-<p> See also <a href="http://cocoon.apache.org/2.1/faq/faq-configure-environment.html">Cocoon FAQ</a>. </p>
+<p>
+          See also
+          <a href="http://cocoon.apache.org/2.1/faq/faq-configure-environment.html">Cocoon
+          FAQ</a>.
+        </p>
 </div>
-<a name="N10428"></a><a name="project-logo-svg"></a>
+<a name="N10427"></a><a name="project-logo-svg"></a>
 <h4 class="faq">3.10.  
         The project logo that is generated from SVG is truncating my project name.
       </h4>
@@ -1450,28 +1653,32 @@
 </div>
 <div style="margin-left: 15px">
 <p>
-          In a 'forrest seed site' the project and the group logo are generated from a
-          Scalable Vector Graphics (SVG) file, using the text from the
-          <span class="codefrag">&lt;project-name&gt;</span> and
-          <span class="codefrag">&lt;group-name&gt;</span> elements of the <span class="codefrag">skinconf.xml</span> file.
-          If you have a long project-name then you may need to adjust the width of the image.
+          In a 'forrest seed site' the project and the group logo are generated
+          from a Scalable Vector Graphics (SVG) file, using the text from the
+          <span class="codefrag">&lt;project-name&gt;</span> and <span class="codefrag">&lt;group-name&gt;</span>
+          elements of the <span class="codefrag">skinconf.xml</span> file. If you have a long
+          project-name then you may need to adjust the width of the image.
           Perhaps you want to change the colours too. Edit the file at
-          <span class="codefrag">src/documentation/content/xdocs/images/project.svg</span> and adjust the "width"
-          attribute of the &lt;svg&gt; element. For further details see
-          <a href="http://www.w3.org/Graphics/SVG/">SVG</a> resources.
+          <span class="codefrag">src/documentation/content/xdocs/images/project.svg</span> and
+          adjust the "width" attribute of the &lt;svg&gt; element. For further
+          details see <a href="http://www.w3.org/Graphics/SVG/">SVG</a>
+          resources.
         </p>
 </div>
-<a name="N10440"></a><a name="catalog"></a>
+<a name="N1043F"></a><a name="catalog"></a>
 <h4 class="faq">3.11.  How do i configure my favourite XML editor or parser to find the local Forrest
         DTDs? </h4>
 <div align="right">
 <a href="#catalog-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p> Notes are provided for various tools at <a href="../docs_0_80/catalog.html">Using Catalog Entity
-            Resolver for local DTDs</a>. </p>
+<p>
+          Notes are provided for various tools at
+          <a href="../docs_0_80/catalog.html">Using Catalog Entity Resolver for local
+          DTDs</a>.
+        </p>
 </div>
-<a name="N1044C"></a><a name="project-dtd"></a>
+<a name="N1044B"></a><a name="project-dtd"></a>
 <h4 class="faq">3.12. How to configure the Catalog Entity Resolver to use my own local project DTDs?</h4>
 <div align="right">
 <a href="#project-dtd-menu">^</a>
@@ -1482,7 +1689,7 @@
           configuration guidance.
         </p>
 </div>
-<a name="N10458"></a><a name="local-catalog"></a>
+<a name="N10457"></a><a name="local-catalog"></a>
 <h4 class="faq">3.13. We need an additional system-wide catalog to share DTDs between projects</h4>
 <div align="right">
 <a href="#local-catalog-menu">^</a>
@@ -1493,7 +1700,7 @@
           configuration guidance.
         </p>
 </div>
-<a name="N10464"></a><a name="debug-catalog"></a>
+<a name="N10463"></a><a name="debug-catalog"></a>
 <h4 class="faq">3.14. How to debug the Catalog Entity Resolver and local DTDs?</h4>
 <div align="right">
 <a href="#debug-catalog-menu">^</a>
@@ -1503,86 +1710,116 @@
           See <a href="../docs_0_80/validation.html#debug-catalog">XML validation</a>.
         </p>
 </div>
-<a name="N10470"></a><a name="skin"></a>
+<a name="N1046F"></a><a name="skin"></a>
 <h4 class="faq">3.15.  How to make the site look better and change its skin? </h4>
 <div align="right">
 <a href="#skin-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p> There are <a href="../docs_0_80/your-project.html#skins">default skins</a> provided, which are configurable
-          and so should meet the needs of most projects. The aim is to provide many capabilities so
-          that extra skins are not needed. </p>
-<p> See notes about <a href="../docs_0_80/your-project.html#skins">configuration</a> of the skins.
-          Some projects may have special needs and can define their <a href="../docs_0_80/your-project.html#new_skin">own skin</a>. </p>
+<p>
+          There are <a href="../docs_0_80/your-project.html#skins">default skins</a> provided, which
+          are configurable and so should meet the needs of most projects. The
+          aim is to provide many capabilities so that extra skins are not
+          needed.
+        </p>
+<p>
+          See notes about
+          <a href="../docs_0_80/your-project.html#skins">configuration</a> of the
+          skins. Some projects may have special needs and can define their
+          <a href="../docs_0_80/your-project.html#new_skin">own skin</a>.
+        </p>
 </div>
-<a name="N10487"></a><a name="xsp"></a>
+<a name="N10486"></a><a name="xsp"></a>
 <h4 class="faq">3.16. How do I enable XSP processing?</h4>
 <div align="right">
 <a href="#xsp-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p>First consider whether your needs would be better met by Cocoon itself, rather than
-          Forrest. </p>
-<p>That said, there are valid reasons for wanting programmatically generated content, so
-          here is how to enable XSP:</p>
+<p>
+          First consider whether your needs would be better met by Cocoon
+          itself, rather than Forrest.
+        </p>
+<p>
+          That said, there are valid reasons for wanting programmatically
+          generated content, so here is how to enable XSP:
+        </p>
 <ol>
           
 <li>Download <a href="http://svn.apache.org/repos/asf/cocoon/trunk/lib/optional/">jdtcore-*.jar</a> from Cocoons SVN tree, and copy it to the $FORREST_HOME/main/webapp/WEB-INF/lib
             directory (or lib/core/ directory in the source distribution).</li>
           
 <li>
-            
-<p> Add the following generator definition in the map:generators section of your <a href="../docs_0_80/project-sitemap.html">project sitemap</a>
+<p>
+              Add the following generator definition in the map:generators
+              section of your
+              <a href="../docs_0_80/project-sitemap.html">project
+              sitemap</a>
             
 </p>
             
 <pre class="code">
+
   &lt;map:generator name="serverpages"
      pool-grow="2" pool-max="32" pool-min="4"
-     src="org.apache.cocoon.generation.ServerPagesGenerator"/&gt;</pre>
-          
+     src="org.apache.cocoon.generation.ServerPagesGenerator"/&gt;
+            </pre>
 </li>
           
 <li>
-            
-<p>Decide how you want to use XSP. For single files, you could just define a *.xml
-              matcher:</p>
+<p>
+              Decide how you want to use XSP. For single files, you could just
+              define a *.xml matcher:
+            </p>
             
 <pre class="code">
+
 &lt;map:match pattern="dynamic.xml"&gt;
   &lt;map:generate src="content/xdocs/dynamic.xsp" type="serverpages"/&gt;
   ...
   &lt;map:serialize type="xml"/&gt;
-&lt;/map:match&gt;</pre>
+&lt;/map:match&gt;
+            </pre>
             
-<p>You may instead wish to override forrest.xmap to define a general mapping for
-            XSPs.</p>
-          
+<p>
+              You may instead wish to override forrest.xmap to define a general
+              mapping for XSPs.
+            </p>
 </li>
         
 </ol>
-<p>See also the <a href="http://wiki.apache.org/cocoon/AddingXSPToForrest">AddingXSPToForrest</a> Wiki page.</p>
+<p>
+          See also the
+          <a href="http://wiki.apache.org/cocoon/AddingXSPToForrest">AddingXSPToForrest</a>
+          Wiki page.
+        </p>
 </div>
-<a name="N104C2"></a><a name="breadcrumbs"></a>
+<a name="N104BD"></a><a name="breadcrumbs"></a>
 <h4 class="faq">3.17. How do breadcrumbs work? Why don't they work locally?</h4>
 <div align="right">
 <a href="#breadcrumbs-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p>Breadcrumbs begin with up to three URLs specified in <span class="codefrag">skinconf.xml</span>. Here is
-          what the Forrest site uses:</p>
+<p>
+          Breadcrumbs begin with up to three URLs specified in
+          <span class="codefrag">skinconf.xml</span>. Here is what the Forrest site uses:
+        </p>
 <pre class="code">
+
   &lt;trail&gt;
     &lt;link1 name="apache" href="http://www.apache.org/"/&gt;
     &lt;link2 name="xml.apache" href="http://xml.apache.org/"/&gt;
     &lt;link3 name="" href=""/&gt;
-  &lt;/trail&gt;</pre>
-<p>If any links are blank, they are not used. After these first links, JavaScript looks at
-          the URL for the current page and makes a link for each directory after the domain. If you
-          are viewing the site locally, there is no domain and so there will be no extra
-          breadcrumbs, only the ones that are specified in <span class="codefrag">skinconf.xml</span>. </p>
+  &lt;/trail&gt;
+        </pre>
+<p>
+          If any links are blank, they are not used. After these first links,
+          JavaScript looks at the URL for the current page and makes a link for
+          each directory after the domain. If you are viewing the site locally,
+          there is no domain and so there will be no extra breadcrumbs, only the
+          ones that are specified in <span class="codefrag">skinconf.xml</span>.
+        </p>
 </div>
-<a name="N104D7"></a><a name="run_port"></a>
+<a name="N104D2"></a><a name="run_port"></a>
 <h4 class="faq">3.18. How do I make forrest run listen on a different port?</h4>
 <div align="right">
 <a href="#run_port-menu">^</a>
@@ -1593,111 +1830,132 @@
 <span class="codefrag">forrest run -Dforrest.jvmargs="-Djetty.port=80"</span>
         
 </p>
-<p>Or copy Forrest's main/webapp/jettyconf.xml file to your project's src/documentation
-          directory and set the port number in that file. Then do <span class="codefrag">forrest run</span>
+<p>
+          Or copy Forrest's main/webapp/jettyconf.xml file to your project's
+          src/documentation directory and set the port number in that file. Then
+          do <span class="codefrag">forrest run</span>
         
 </p>
 </div>
-<a name="N104EB"></a><a name="debugging"></a>
+<a name="N104E6"></a><a name="debugging"></a>
 <h4 class="faq">3.19. Can I run Forrest with Java debugging turned on?</h4>
 <div align="right">
 <a href="#debugging-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p>If you use an IDE like Eclipse and want to debug java code in Forrest
-        you need to start Forrest with debugging mode turned on. To do this you need
-        to add <span class="codefrag">-Xdebug -Xrunjdwp:transport=dt_socket,address=8000,server=y,susp end=n</span>
-        to the <span class="codefrag">forrest.jvmargs</span> property in the <span class="codefrag">forrest.properties</span>
-        file. Don't forget to ensure the property is uncommented in that file.</p>
+<p>
+          If you use an IDE like Eclipse and want to debug java code in Forrest
+          you need to start Forrest with debugging mode turned on. To do this
+          you need to add <span class="codefrag">-Xdebug
+          -Xrunjdwp:transport=dt_socket,address=8000,server=y,susp end=n</span>
+          to the <span class="codefrag">forrest.jvmargs</span> property in the
+          <span class="codefrag">forrest.properties</span> file. Don't forget to ensure the
+          property is uncommented in that file.
+        </p>
 </div>
-<a name="N104FC"></a><a name="checksums"></a>
+<a name="N104F7"></a><a name="checksums"></a>
 <h4 class="faq">3.20. How do I enable Cocoon's document checksum feature?</h4>
 <div align="right">
 <a href="#checksums-menu">^</a>
 </div>
 <div style="margin-left: 15px">
 <p>
-        Why might you want to do this?  There is really no effect
-        on Cocoon processing, but a little time can be
-        saved on filesystem writes, which will accumulate
-        to a big savings for a site with thousands of files.
+          Why might you want to do this? There is really no effect on Cocoon
+          processing, but a little time can be saved on filesystem writes, which
+          will accumulate to a big savings for a site with thousands of files.
         </p>
 <p>
-          Some tools depend on the "date-last-modified" timestamp of the generated files.
-          For example, the Forrestbot will then deploy only the modified files.
+          Some tools depend on the "date-last-modified" timestamp of the
+          generated files. For example, the Forrestbot will then deploy only the
+          modified files.
         </p>
 <p>
-        There was some discussion about this on the Forrest developer mailing
-        list:
-        <a href="http://marc.theaimsgroup.com/?l=forrest-dev&s=cocoon+checksum">Cocoon Checksum</a> 
-        Specifically note that this feature only stops Cocoon from writing to 
-        disk if the new file is the same as the existing file.  Cocoon still spends
-        the same amount of time generating the content as it would if checksums
-        were not enabled.
+          There was some discussion about this on the Forrest developer mailing
+          list:
+          <a href="http://marc.theaimsgroup.com/?l=forrest-dev&s=cocoon+checksum">Cocoon
+          Checksum</a> Specifically note that this feature only stops Cocoon
+          from writing to disk if the new file is the same as the existing file.
+          Cocoon still spends the same amount of time generating the content as
+          it would if checksums were not enabled.
         </p>
 <p>
-        Locate the <span class="codefrag">checksums-uri</span> tag within cli.xconf and replace
-        the contents with an absolute path and filename for the checksums file.
-        Projects can supply their own (see FAQ:
-        <a href="#cli-xconf">Cocoon cli.xconf</a>) or use the default
-        installation-wide cli.xconf file.
+          Locate the <span class="codefrag">checksums-uri</span> tag within cli.xconf and replace
+          the contents with an absolute path and filename for the checksums
+          file. Projects can supply their own (see FAQ:
+          <a href="#cli-xconf">Cocoon cli.xconf</a>) or use the default
+          installation-wide cli.xconf file.
         </p>
 </div>
-<a name="N10518"></a><a name="old_faqs"></a>
+<a name="N10513"></a><a name="old_faqs"></a>
 <h3 class="underlined_5">4. Older version: 0.6</h3>
-<a name="N1051C"></a><a name="old_claimed_patterns"></a>
+<a name="N10517"></a><a name="old_claimed_patterns"></a>
 <h4 class="faq">4.1. Some of my files are not being processed because they use common filenames. </h4>
 <div align="right">
 <a href="#old_claimed_patterns-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p> Certain patterns are claimed by the default sitemaps for special processing. These
-          include: <span class="codefrag">site, changes, todo, faq, images, my-images, skinconf, community,
-          howto</span>
+<p>
+          Certain patterns are claimed by the default sitemaps for special
+          processing. These include: <span class="codefrag">site, changes, todo, faq, images,
+          my-images, skinconf, community, howto</span>
         
 </p>
-<p> Sometimes there are workarounds, e.g. faq.html or faq-interview.html would fail, but
-          interview-faq.html would be fine. In future versions of Forrest we will attempt to deal
-          with this issue (<a href="http://issues.apache.org/jira/browse/FOR-217">FOR-217</a>).
+<p>
+          Sometimes there are workarounds, e.g. faq.html or faq-interview.html
+          would fail, but interview-faq.html would be fine. In future versions
+          of Forrest we will attempt to deal with this issue
+          (<a href="http://issues.apache.org/jira/browse/FOR-217">FOR-217</a>).
         </p>
 </div>
-<a name="N1052E"></a><a name="general"></a>
+<a name="N10529"></a><a name="general"></a>
 <h3 class="underlined_5">5. General</h3>
-<a name="N10532"></a><a name="generating_menus"></a>
+<a name="N1052D"></a><a name="generating_menus"></a>
 <h4 class="faq">5.1. What is the relationship between site.xml and book.xml? </h4>
 <div align="right">
 <a href="#generating_menus-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p> One <span class="codefrag">site.xml</span> file in your project root can replace all the book.xml files (one per
-          directory) in your site. Internally, Forrest uses <span class="codefrag">site.xml</span> to dynamically generate book.xml
-          files. However, Forrest first checks for the existence of a book.xml file, so
-          backwards-compatibility is preserved. If a directory has a book.xml file, the book.xml
-          will be used to generate the menu. This supplement is useful in situations where
-          <span class="codefrag">site.xml</span>-generated menus aren't appropriate. See <a href="../docs_0_80/linking.html">Menus and
-            Linking</a>. </p>
+<p>
+          One <span class="codefrag">site.xml</span> file in your project root can replace all the book.xml files
+          (one per directory) in your site. Internally, Forrest uses <span class="codefrag">site.xml</span> to
+          dynamically generate book.xml files. However, Forrest first checks for
+          the existence of a book.xml file, so backwards-compatibility is
+          preserved. If a directory has a book.xml file, the book.xml will be
+          used to generate the menu. This supplement is useful in situations
+          where <span class="codefrag">site.xml</span>-generated menus aren't appropriate. See
+          <a href="../docs_0_80/linking.html">Menus and Linking</a>.
+        </p>
 </div>
-<a name="N1054D"></a><a name="docbook"></a>
+<a name="N10548"></a><a name="docbook"></a>
 <h4 class="faq">5.2.  How do I use DocBook as the XML documentation format? </h4>
 <div align="right">
 <a href="#docbook-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p> There are two ways. Forrest has a <span class="codefrag">simplifiedDocbook</span> plugin which can
-          transform the DocBook format into the Forrest "xdocs" format on-the-fly and then render
-          that as normal Forrest documents. Be aware that the stylesheet that does this
-          transformation is deliberately very limited and does not attempt to deal with all DocBook
-          elements. </p>
-<p> The other way is to use the full DocBook stylesheets directly. The DocBook DTDs are
-          shipped with Forrest and automatically handled. However, you will need to have the DocBook
-          stylesheets on your system (they are too massive to ship with Forrest) and configure
-          Forrest accordingly. You will need to create a <a href="../docs_0_80/project-sitemap.html">project
-            sitemap</a> as explained in <a href="../docs_0_80/your-project.html">Using Forrest</a> and
-          add matches to handle your DocBook documents. Here is an example. Note that you need to
-          change it to suit your situation. The match must be very specific so that only the DocBook
-          documents are matched. The rest of the documents will be handled by Forrest core. Powerful
-          regex capabilities are available. </p>
-<pre class="code">&lt;?xml version="1.0"?&gt;
+<p>
+          There are two ways. Forrest has a <span class="codefrag">simplifiedDocbook</span>
+          plugin which can transform the DocBook format into the Forrest "xdocs"
+          format on-the-fly and then render that as normal Forrest documents. Be
+          aware that the stylesheet that does this transformation is
+          deliberately very limited and does not attempt to deal with all
+          DocBook elements.
+        </p>
+<p>
+          The other way is to use the full DocBook stylesheets directly. The
+          DocBook DTDs are shipped with Forrest and automatically handled.
+          However, you will need to have the DocBook stylesheets on your system
+          (they are too massive to ship with Forrest) and configure Forrest
+          accordingly. You will need to create a
+          <a href="../docs_0_80/project-sitemap.html">project sitemap</a> as explained
+          in <a href="../docs_0_80/your-project.html">Using Forrest</a> and add matches
+          to handle your DocBook documents. Here is an example. Note that you
+          need to change it to suit your situation. The match must be very
+          specific so that only the DocBook documents are matched. The rest of
+          the documents will be handled by Forrest core. Powerful regex
+          capabilities are available.
+        </p>
+<pre class="code">
+&lt;?xml version="1.0"?&gt;
 &lt;map:sitemap xmlns:map="http://apache.org/cocoon/sitemap/1.0"&gt;
  &lt;map:pipelines&gt;
   &lt;map:pipeline&gt;
@@ -1709,27 +1967,31 @@
    &lt;/map:match&gt;
   &lt;/map:pipeline&gt;
  &lt;/map:pipelines&gt;
-&lt;/map:sitemap&gt;</pre>
-<p>You need to define the xhtml serializer used in &lt;map:serialize type="xhtml"/&gt;
-        in the components section of the sitemap. See the 
-        <a href="http://cocoon.apache.org/2.1/userdocs/serializers/xhtml-serializer.html">Cocoon
-        docs</a> for the elements you need to add to define this component. You can see examples 
-        of other components being added in the <span class="codefrag">FORREST_HOME/main/webapp/sitemap.xmap</span> file.
-        Alternatively use the "html" DocBook stylesheets and the default Cocoon serializer,
-        i.e. &lt;map:serialize type="html"/&gt;
-        </p>
-<p>
-          The output of the above sitemap will be plain html not adorned with
-          a Forrest theme and navigation. If instead you need the latter, then
-          use the following technique instead. This transforms DocBook xml to
-          html, then uses a Forrest core stylesheet to transform and serialize
-          to the internal xml format, then the normal machinery takes over and
-          does the output transformation. This use the Content Aware Pipelines
-          (<a href="../docs_0_80/cap.html">SourceTypeAction</a>)
-          to peek at the source xml. If it is DocBook-4.2
-          then this sitemap match is triggered, if not then it falls through to the core of Forrest.
+&lt;/map:sitemap&gt;
+        </pre>
+<p>
+          You need to define the xhtml serializer used in &lt;map:serialize
+          type="xhtml"/&gt; in the components section of the sitemap. See the
+          <a href="http://cocoon.apache.org/2.1/userdocs/serializers/xhtml-serializer.html">Cocoon
+          docs</a> for the elements you need to add to define this component.
+          You can see examples of other components being added in the
+          <span class="codefrag">FORREST_HOME/main/webapp/sitemap.xmap</span> file. Alternatively
+          use the "html" DocBook stylesheets and the default Cocoon serializer,
+          i.e. &lt;map:serialize type="html"/&gt;
+        </p>
+<p>
+          The output of the above sitemap will be plain html not adorned with a
+          Forrest theme and navigation. If instead you need the latter, then use
+          the following technique instead. This transforms DocBook xml to html,
+          then uses a Forrest core stylesheet to transform and serialize to the
+          internal xml format, then the normal machinery takes over and does the
+          output transformation. This use the Content Aware Pipelines
+          (<a href="../docs_0_80/cap.html">SourceTypeAction</a>) to peek at the source
+          xml. If it is DocBook-4.2 then this sitemap match is triggered, if not
+          then it falls through to the core of Forrest.
         </p>
-<pre class="code">&lt;?xml version="1.0"?&gt;
+<pre class="code">
+&lt;?xml version="1.0"?&gt;
 &lt;map:sitemap xmlns:map="http://apache.org/cocoon/sitemap/1.0"&gt;
  &lt;map:components&gt;
   &lt;map:actions&gt;
@@ -1764,91 +2026,120 @@
    &lt;/map:match&gt;
   &lt;/map:pipeline&gt;
  &lt;/map:pipelines&gt;
-&lt;/map:sitemap&gt;</pre>
-<p> You can also use a mixture of the methods, some handled automatically by Forrest and
-          some directly using DocBook stylesheets. You can also have a mixture of source files as
-          "document-v*" DTD and DocBook. </p>
-<p> Ensure that the document type declaration in your XML instance is well specified. Use a
-          public identifier. The DTD will then be properly resolved by Forrest. If you need to use
-          different DTDs, then see <a href="../docs_0_80/your-project.html#new_dtd">Using Forrest</a> for
-          configuration guidance. </p>
+&lt;/map:sitemap&gt;
+        </pre>
+<p>
+          You can also use a mixture of the methods, some handled automatically
+          by Forrest and some directly using DocBook stylesheets. You can also
+          have a mixture of source files as "document-v*" DTD and DocBook.
+        </p>
+<p>
+          Ensure that the document type declaration in your XML instance is well
+          specified. Use a public identifier. The DTD will then be properly
+          resolved by Forrest. If you need to use different DTDs, then see
+          <a href="../docs_0_80/your-project.html#new_dtd">Using Forrest</a> for
+          configuration guidance.
+        </p>
 </div>
-<a name="N10586"></a><a name="version"></a>
+<a name="N10581"></a><a name="version"></a>
 <h4 class="faq">5.3.  How to report which version of Forrest is being used and the properties that are
         set? </h4>
 <div align="right">
 <a href="#version-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p> Do <span class="codefrag">'forrest -projecthelp'</span> or <span class="codefrag">'./build.sh'</span> to find the version
-          number. </p>
-<p> To list the properties, add "forrest.echo=true" to your forrest.properties file and
-          watch the build messages. Doing <span class="codefrag">'forrest -v'</span> will provide verbose build
-          messages. </p>
+<p>
+          Do <span class="codefrag">'forrest -projecthelp'</span> or <span class="codefrag">'./build.sh'</span> to
+          find the version number.
+        </p>
+<p>
+          To list the properties, add "forrest.echo=true" to your
+          forrest.properties file and watch the build messages. Doing
+          <span class="codefrag">'forrest -v'</span> will provide verbose build messages.
+        </p>
 </div>
-<a name="N1059A"></a><a name="logs"></a>
+<a name="N10595"></a><a name="logs"></a>
 <h4 class="faq">5.4.  Where are the log files to find more infomation about errors? </h4>
 <div align="right">
 <a href="#logs-menu">^</a>
 </div>
 <div style="margin-left: 15px">
-<p> The logfiles are at <span class="codefrag">build/webapp/WEB-INF/logs/</span>
+<p>
+          The logfiles are at <span class="codefrag">build/webapp/WEB-INF/logs/</span>
         
 </p>
-<p> The log level can be raised with the <span class="codefrag">logkit.xconf</span> configuration. If you are
-          using Forrest in the interactive webapp mode (which is generally easiest for debugging

[... 102 lines stripped ...]


Mime
View raw message