You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-svn@forrest.apache.org by cr...@apache.org on 2008/01/23 07:14:22 UTC

svn commit: r614430 - in /forrest/site: docs_0_90/faq.html docs_0_90/faq.pdf docs_0_90/faq.xml mirrors.html mirrors.pdf

Author: crossley
Date: Tue Jan 22 22:14:21 2008
New Revision: 614430

URL: http://svn.apache.org/viewvc?rev=614430&view=rev
Log:
Publish from forrestbot

Modified:
    forrest/site/docs_0_90/faq.html
    forrest/site/docs_0_90/faq.pdf
    forrest/site/docs_0_90/faq.xml
    forrest/site/mirrors.html
    forrest/site/mirrors.pdf

Modified: forrest/site/docs_0_90/faq.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_90/faq.html?rev=614430&r1=614429&r2=614430&view=diff
==============================================================================
--- forrest/site/docs_0_90/faq.html (original)
+++ forrest/site/docs_0_90/faq.html Tue Jan 22 22:14:21 2008
@@ -837,7 +837,9 @@
 <a name="N10154"></a><a name="PDF-output"></a>
 <h3 class="underlined_5">2.5. How can I generate one pdf-file out of the whole site or selected pages of the site?</h3>
 <p>
-          Add the following entries to your site.xml file:
+          Add the following entries to your site.xml file.
+          Note that the href must be exactly "wholesite" or "site" which triggers
+          a special match in the sitemap to aggregate all documents.
         </p>
 <pre class="code">
 
@@ -850,15 +852,25 @@
         </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_90/howto/howto-pdf-tab.html">How to
-          create a PDF document for each tab</a>.)
+          PDF" and "Full HTML".
+        </p>
+<p>
+          See also <a href="../docs_0_90/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_90/linking.html">site.xml</a> method for your site
           structure and navigation, rather than the old book.xml method.
         </p>
-<a name="N1016E"></a><a name="pageBreaks"></a>
+<div class="warning">
+<div class="label">Warning</div>
+<div class="content">
+          There are many issues with the "wholesite" aggregation. Search the
+          issue tracker and mail lists.
+        </div>
+</div>
+<a name="N10174"></a><a name="pageBreaks"></a>
 <h3 class="underlined_5">2.6. How do I insert page breaks into documents?</h3>
 <p>
           Page breaks do not make a great deal of sense in HTML documents
@@ -887,7 +899,7 @@
             margin-bottom: 0; 
             page-break-after: always; 
             } </pre>
-<a name="N1018C"></a><a name="clickable-email-address"></a>
+<a name="N10192"></a><a name="clickable-email-address"></a>
 <h3 class="underlined_5">2.7. How can I generate html-pages to show a 'clickable' email-address (of the
         author-element)?</h3>
 <p>
@@ -895,14 +907,14 @@
           $FORREST_HOME/main/webapp/skins/common/xslt/html/document-to-html.xsl</span>
           and edit the "headers/authors" template.
         </p>
-<a name="N10197"></a><a name="link_raw"></a>
+<a name="N1019D"></a><a name="link_raw"></a>
 <h3 class="underlined_5">2.8. How do I link to raw files such as config.txt and brochure.pdf? </h3>
 <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>
-<a name="N101A3"></a><a name="pdf_images"></a>
+<a name="N101A9"></a><a name="pdf_images"></a>
 <h3 class="underlined_5">2.9. Images don't display in PDFs. How do I fix this?</h3>
 <p>
           Forrest uses <a href="http://xml.apache.org/fop/">Apache FOP</a>
@@ -941,7 +953,7 @@
           Forrest.
         </div>
 </div>
-<a name="N101D2"></a><a name="tab-index"></a>
+<a name="N101D8"></a><a name="tab-index"></a>
 <h3 class="underlined_5">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? </h3>
 <p>
@@ -964,12 +976,12 @@
     &lt;map:redirect-to uri="manual/Introduction.html"/&gt;
   &lt;/map:match&gt;
         </pre>
-<a name="N101EE"></a><a name="tab-site"></a>
+<a name="N101F4"></a><a name="tab-site"></a>
 <h3 class="underlined_5">2.11. I need help with the interaction between tabs.xml and site.xml </h3>
 <p>
           See the <a href="../docs_0_90/linking.html#tab-site">tips</a>.
         </p>
-<a name="N101FA"></a><a name="defaultFileName"></a>
+<a name="N10200"></a><a name="defaultFileName"></a>
 <h3 class="underlined_5">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/ ? </h3>
 <p>
@@ -998,7 +1010,7 @@
 </li>
         
 </ol>
-<a name="N10222"></a><a name="defaultStartPage"></a>
+<a name="N10228"></a><a name="defaultStartPage"></a>
 <h3 class="underlined_5">2.13.  How can I use a start-up-page other than index.html? </h3>
 <p>
           Forrest by default assumes that the first page (home page) of your
@@ -1034,7 +1046,7 @@
 <li>Don't forget to create that page and refer to it in your site.xml</li>
         
 </ol>
-<a name="N10246"></a><a name="output-filename-extension"></a>
+<a name="N1024C"></a><a name="output-filename-extension"></a>
 <h3 class="underlined_5">2.14. How to use a different filename extension for output, e.g. *.php? </h3>
 <p>
           Use the power of the Cocoon sitemaps. There is default handling for *.php (see main/webapp/sitemap.xmap) to map the 'php' extension to an internal request for "html". See more about <a href="#php">PHP</a> below.
@@ -1042,7 +1054,7 @@
 <p>
           Use the same internal re-direction technique for your special needs, e.g. copy that php match to your project sitemap and use ".htm" instead.
         </p>
-<a name="N10255"></a><a name="php"></a>
+<a name="N1025B"></a><a name="php"></a>
 <h3 class="underlined_5">2.15.  How to generate pages ready for serving via PHP? </h3>
 <p>
           Use the *.php filename extension (see <a href="#output-filename-extension">above</a>)
@@ -1053,7 +1065,7 @@
           "processing-instruction nodes in source are not always passed through to html output"
           whereby only PIs in certain body elements are handled.
         </p>
-<a name="N10268"></a><a name="label-entity"></a>
+<a name="N1026E"></a><a name="label-entity"></a>
 <h3 class="underlined_5">2.16.  How to use special characters in the labels of the site.xml file? </h3>
 <p>
           Use the numeric values for character entities. For example, rather
@@ -1071,7 +1083,7 @@
           <a href="http://issues.apache.org/jira/browse/FOR-244">Issue
           FOR-244</a>.
         </p>
-<a name="N10281"></a><a name="encoding"></a>
+<a name="N10287"></a><a name="encoding"></a>
 <h3 class="underlined_5">2.17. Does Forrest handle accents for non-English languages?</h3>
 <p>
           Yes, Forrest can process text in any language, so you can include:
@@ -1145,7 +1157,7 @@
           <a href="http://www.alanwood.net/unicode/">Alan Wood's Unicode
           resources</a>.
         </p>
-<a name="N102D3"></a><a name="xml-entities"></a>
+<a name="N102D9"></a><a name="xml-entities"></a>
 <h3 class="underlined_5">2.18. How to use XML entities, for example string
         replacement?</h3>
 <p>
@@ -1155,7 +1167,7 @@
           trademark symbol "My Project Name&trade;". Avoid lengthy typing and
           potential spelling errors.
         </p>
-<a name="N102DE"></a><a name="cleanSite"></a>
+<a name="N102E4"></a><a name="cleanSite"></a>
 <h3 class="underlined_5">2.19.  How to make Forrest clean up the project build directories? </h3>
 <p>
           By default Forrest does not clean its build directories in the project
@@ -1169,7 +1181,7 @@
           which include the Cocoon cache and the Cocoon logs). Doing 'forrest
           clean' will remove both sections.
         </p>
-<a name="N102E9"></a><a name="i18n"></a>
+<a name="N102EF"></a><a name="i18n"></a>
 <h3 class="underlined_5">2.20. How can I internationalise (i18n) my content?</h3>
 <p>
           The i18n features of Forrest are still under development (as of 0.7)
@@ -1185,7 +1197,7 @@
           i18n Transformer</a>. You can see an example of how it works in the
           above linked issue.
         </p>
-<a name="N102FC"></a><a name="rawHTML"></a>
+<a name="N10302"></a><a name="rawHTML"></a>
 <h3 class="underlined_5">2.21. How can I include HTML content that is not to be skinned by Forrest?</h3>
 <p>
           To serve, for example a legacy HTML site, add something like the
@@ -1231,7 +1243,7 @@
 </li>
         
 </ol>
-<a name="N10328"></a><a name="javascript"></a>
+<a name="N1032E"></a><a name="javascript"></a>
 <h3 class="underlined_5">2.22. How to include additional Javascript and CSS files?</h3>
 <p>
           Place various resources (e.g. javascript, css) into the "project
@@ -1248,7 +1260,7 @@
           forrest/main/webapp/resources.xmap Search for "javascript" then follow
           to the &lt;map:resource name="skin-read"&gt; section.
         </p>
-<a name="N10336"></a><a name="linkmap"></a>
+<a name="N1033C"></a><a name="linkmap"></a>
 <h3 class="underlined_5">2.23. How to show a Table Of Contents for the whole site?</h3>
 <p>
           Every site has an automatically generated document at
@@ -1272,10 +1284,10 @@
           project.start-uri in the forrest.properties file.
         </p>
 </div>
-<a name="N10354"></a><a name="technical"></a>
+<a name="N1035A"></a><a name="technical"></a>
 <h2 class="underlined_10">3. Technical</h2>
 <div class="section">
-<a name="N10358"></a><a name="java-code"></a>
+<a name="N1035E"></a><a name="java-code"></a>
 <h3 class="underlined_5">3.1. Where is the Java code?</h3>
 <p>
           Because we are based on Apache Cocoon, a lot of the functionality is
@@ -1294,7 +1306,7 @@
           Locationmap and Dispatcher. There is also Java code for some plugins
           with specialised purpose, e.g. PhotoGallery.
         </p>
-<a name="N10366"></a><a name="populate-cache"></a>
+<a name="N1036C"></a><a name="populate-cache"></a>
 <h3 class="underlined_5">3.2. How to enhance the responsiveness of the cache?</h3>
 <p>
           Apache Cocoon has a sophisticated cache. When running Forrest in
@@ -1319,7 +1331,7 @@
           proxy server, e.g. Apache HTTP Server as a frontend. See
           <a href="http://wiki.apache.org/cocoon/ApacheModProxy">CocoonAndApacheModProxy</a>.
         </p>
-<a name="N10380"></a><a name="proxy_config"></a>
+<a name="N10386"></a><a name="proxy_config"></a>
 <h3 class="underlined_5">3.3. I'm behind a proxy and it's preventing Plugins from being downloaded, what should I
         do?</h3>
 <p>
@@ -1340,7 +1352,7 @@
           <span class="codefrag">${user.home}/forrest.properties</span> !
         </div>
 </div>
-<a name="N103A4"></a><a name="CVS_revison_tags"></a>
+<a name="N103AA"></a><a name="CVS_revison_tags"></a>
 <h3 class="underlined_5">3.4. How can I generate html-pages to show the Revision tag of CVS or SVN?</h3>
 <p>
           If you have:<span class="codefrag">&lt;version&gt;$Revision: 1.30
@@ -1357,7 +1369,7 @@
           When using Subversion, remember to set the relevant svn:keywords
           properties.
         </p>
-<a name="N103B9"></a><a name="cli-xconf"></a>
+<a name="N103BF"></a><a name="cli-xconf"></a>
 <h3 class="underlined_5">3.5.  How to control the processing of URIs by Cocoon, e.g. exclude certain URIs, include
         other additional ones. </h3>
 <p>
@@ -1416,7 +1428,7 @@
           which explains how to include non-linked extra documents to the processing
           using the Cocoon CLI.
         </p>
-<a name="N103FD"></a><a name="ignoring_javadocs"></a>
+<a name="N10403"></a><a name="ignoring_javadocs"></a>
 <h3 class="underlined_5">3.6.  How do I stop Forrest breaking on links to external files that may not exist, like
         javadocs? </h3>
 <p>
@@ -1424,11 +1436,11 @@
           <span class="codefrag">cli.xconf</span> </a> Cocoon config file, and defining
           patterns for URLs to exclude.
         </p>
-<a name="N1040C"></a><a name="claimed_patterns"></a>
+<a name="N10412"></a><a name="claimed_patterns"></a>
 <h3 class="underlined_5">3.7. Some of my files are not being processed because they use common filenames. </h3>
 <p>
           Certain patterns are claimed by the default sitemaps for special
-          processing. These reserved words include: <span class="codefrag">site, changes, todo,
+          processing. These reserved words include: <span class="codefrag">site, wholesite, changes, todo,
           faq, images, my-images, skinconf, community, howto</span>
         
 </p>
@@ -1438,7 +1450,7 @@
           of Forrest we will attempt to deal with this issue
           (<a href="http://issues.apache.org/jira/browse/FOR-217">FOR-217</a>).
         </p>
-<a name="N1041E"></a><a name="build_msg_a"></a>
+<a name="N10424"></a><a name="build_msg_a"></a>
 <h3 class="underlined_5">3.8. What do the symbols and numbers mean when Forrest lists each document that it has
         built? </h3>
 <p>
@@ -1467,7 +1479,7 @@
 <li>Column 5 is the page size.</li>
         
 </ul>
-<a name="N1043C"></a><a name="headless_operation"></a>
+<a name="N10442"></a><a name="headless_operation"></a>
 <h3 class="underlined_5">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. </h3>
 <p>
@@ -1481,7 +1493,7 @@
           <a href="http://cocoon.apache.org/2.1/faq/faq-configure-environment.html">Cocoon
           FAQ</a>.
         </p>
-<a name="N10458"></a><a name="project-logo-svg"></a>
+<a name="N1045E"></a><a name="project-logo-svg"></a>
 <h3 class="underlined_5">3.10.  
         The project logo that is generated from SVG is truncating my project name.
       </h3>
@@ -1497,7 +1509,7 @@
           details see <a href="http://www.w3.org/Graphics/SVG/">SVG</a>
           resources.
         </p>
-<a name="N10470"></a><a name="catalog"></a>
+<a name="N10476"></a><a name="catalog"></a>
 <h3 class="underlined_5">3.11.  How do i configure my favourite XML editor or parser to find the local Forrest
         DTDs? </h3>
 <p>
@@ -1505,24 +1517,24 @@
           <a href="../docs_0_90/catalog.html">Using Catalog Entity Resolver for local
           DTDs</a>.
         </p>
-<a name="N1047C"></a><a name="project-dtd"></a>
+<a name="N10482"></a><a name="project-dtd"></a>
 <h3 class="underlined_5">3.12. How to configure the Catalog Entity Resolver to use my own local project DTDs?</h3>
 <p>
           See <a href="../docs_0_90/your-project.html#new_dtd">Using Forrest</a> for
           configuration guidance.
         </p>
-<a name="N10488"></a><a name="local-catalog"></a>
+<a name="N1048E"></a><a name="local-catalog"></a>
 <h3 class="underlined_5">3.13. We need an additional system-wide catalog to share DTDs between projects</h3>
 <p>
           See <a href="../docs_0_90/validation.html#catalog">Using Forrest</a> for
           configuration guidance.
         </p>
-<a name="N10494"></a><a name="debug-catalog"></a>
+<a name="N1049A"></a><a name="debug-catalog"></a>
 <h3 class="underlined_5">3.14. How to debug the Catalog Entity Resolver and local DTDs?</h3>
 <p>
           See <a href="../docs_0_90/validation.html#debug-catalog">XML validation</a>.
         </p>
-<a name="N104A0"></a><a name="skin"></a>
+<a name="N104A6"></a><a name="skin"></a>
 <h3 class="underlined_5">3.15.  How to make the site look better and change its skin? </h3>
 <p>
           There are <a href="../docs_0_90/your-project.html#skins">default skins</a> provided, which
@@ -1536,7 +1548,7 @@
           skins. Some projects may have special needs and can define their
           <a href="../docs_0_90/your-project.html#new_skin">own skin</a>.
         </p>
-<a name="N104B7"></a><a name="xsp"></a>
+<a name="N104BD"></a><a name="xsp"></a>
 <h3 class="underlined_5">3.16. How do I enable XSP processing?</h3>
 <p>
           First consider whether your needs would be better met by Cocoon
@@ -1595,7 +1607,7 @@
           <a href="http://wiki.apache.org/cocoon/AddingXSPToForrest">AddingXSPToForrest</a>
           Wiki page.
         </p>
-<a name="N104EE"></a><a name="breadcrumbs"></a>
+<a name="N104F4"></a><a name="breadcrumbs"></a>
 <h3 class="underlined_5">3.17. How do breadcrumbs work? Why don't they work locally?</h3>
 <p>
           Breadcrumbs begin with up to three URLs specified in
@@ -1616,7 +1628,7 @@
           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>
-<a name="N10503"></a><a name="run_port"></a>
+<a name="N10509"></a><a name="run_port"></a>
 <h3 class="underlined_5">3.18. How do I make forrest run listen on a different port?</h3>
 <p>
           
@@ -1629,7 +1641,7 @@
           do <span class="codefrag">forrest run</span>
         
 </p>
-<a name="N10517"></a><a name="debugging"></a>
+<a name="N1051D"></a><a name="debugging"></a>
 <h3 class="underlined_5">3.19. Can I run Forrest with Java debugging turned on?</h3>
 <p>
           If you use an IDE like Eclipse and want to debug java code in Forrest
@@ -1640,7 +1652,7 @@
           <span class="codefrag">forrest.properties</span> file. Don't forget to ensure the
           property is uncommented in that file.
         </p>
-<a name="N10528"></a><a name="checksums"></a>
+<a name="N1052E"></a><a name="checksums"></a>
 <h3 class="underlined_5">3.20. How do I enable Cocoon's document checksum feature?</h3>
 <p>
           Why might you want to do this? There is really no effect on Cocoon
@@ -1669,10 +1681,10 @@
           installation-wide cli.xconf file.
         </p>
 </div>
-<a name="N10544"></a><a name="old_faqs"></a>
+<a name="N1054A"></a><a name="old_faqs"></a>
 <h2 class="underlined_10">4. Older version: 0.6</h2>
 <div class="section">
-<a name="N10548"></a><a name="old_claimed_patterns"></a>
+<a name="N1054E"></a><a name="old_claimed_patterns"></a>
 <h3 class="underlined_5">4.1. Some of my files are not being processed because they use common filenames. </h3>
 <p>
           Certain patterns are claimed by the default sitemaps for special
@@ -1687,10 +1699,10 @@
           (<a href="http://issues.apache.org/jira/browse/FOR-217">FOR-217</a>).
         </p>
 </div>
-<a name="N1055A"></a><a name="general"></a>
+<a name="N10560"></a><a name="general"></a>
 <h2 class="underlined_10">5. General</h2>
 <div class="section">
-<a name="N1055E"></a><a name="generating_menus"></a>
+<a name="N10564"></a><a name="generating_menus"></a>
 <h3 class="underlined_5">5.1. What is the relationship between site.xml and book.xml? </h3>
 <p>
           One <span class="codefrag">site.xml</span> file in your project root can replace all the book.xml files
@@ -1702,7 +1714,7 @@
           where <span class="codefrag">site.xml</span>-generated menus aren't appropriate. See
           <a href="../docs_0_90/linking.html">Menus and Linking</a>.
         </p>
-<a name="N10579"></a><a name="docbook"></a>
+<a name="N1057F"></a><a name="docbook"></a>
 <h3 class="underlined_5">5.2.  How do I use DocBook as the XML documentation format? </h3>
 <p>
           There are two ways. Forrest has a <span class="codefrag">simplifiedDocbook</span>
@@ -1812,7 +1824,7 @@
           <a href="../docs_0_90/your-project.html#new_dtd">Using Forrest</a> for
           configuration guidance.
         </p>
-<a name="N105B2"></a><a name="version"></a>
+<a name="N105B8"></a><a name="version"></a>
 <h3 class="underlined_5">5.3.  How to report which version of Forrest is being used and the properties that are
         set? </h3>
 <p>
@@ -1824,7 +1836,7 @@
           forrest.properties file and watch the build messages. Doing
           <span class="codefrag">'forrest -v'</span> will provide verbose build messages.
         </p>
-<a name="N105C6"></a><a name="logs"></a>
+<a name="N105CC"></a><a name="logs"></a>
 <h3 class="underlined_5">5.4.  Where are the log files to find more infomation about errors? </h3>
 <p>
           The logfiles are at <span class="codefrag">build/webapp/WEB-INF/logs/</span>
@@ -1846,7 +1858,7 @@
           Doing <span class="codefrag">'forrest -v'</span> will provide verbose build messages to
           the standard output.
         </p>
-<a name="N105EA"></a><a name="how_can_I_help"></a>
+<a name="N105F0"></a><a name="how_can_I_help"></a>
 <h3 class="underlined_5">5.5.  How to help? </h3>
 <p>
           Join one of the Forrest project <a href="../mail-lists.html">mailing
@@ -1855,7 +1867,7 @@
           newcomers&mdash;often, close proximity blinds software developers to
           faults that are obvious to everyone else. Don't be shy!
         </p>
-<a name="N105F6"></a><a name="patch"></a>
+<a name="N105FC"></a><a name="patch"></a>
 <h3 class="underlined_5">5.6.  How to contribute a patch? </h3>
 <p>
           Please send all contributions via our <a href="../issues.html">issue
@@ -1869,7 +1881,7 @@
           <a href="../issues.html">issue tracker</a> before diving
           in.
         </p>
-<a name="N10611"></a><a name="jobs"></a>
+<a name="N10617"></a><a name="jobs"></a>
 <h3 class="underlined_5">5.7.  How can job positions be advertised? </h3>
 <p>
           Employers can send notices about employment opportunities. There is a
@@ -1888,7 +1900,7 @@
           (<a href="http://www.apache.org/licenses/">CCLA</a>) with The
           Apache Software Foundation.
         </p>
-<a name="N10624"></a><a name="press"></a>
+<a name="N1062A"></a><a name="press"></a>
 <h3 class="underlined_5">5.8. Is there a press kit? Who can journalists contact?</h3>
 <p>
          Press enquiries should be co-ordinated through the ASF Public Relations Committee (PRC).
@@ -1904,7 +1916,7 @@
           are available.
           Unfortunately the logo is only available as PNG.
         </p>
-<a name="N10643"></a><a name="security"></a>
+<a name="N10649"></a><a name="security"></a>
 <h3 class="underlined_5">5.9. How to report a security issue?</h3>
 <p>
          Security and vulnerability issues are co-ordinated through ASF Security.

Modified: forrest/site/docs_0_90/faq.pdf
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_90/faq.pdf?rev=614430&r1=614429&r2=614430&view=diff
==============================================================================
Binary files - no diff available.

Modified: forrest/site/docs_0_90/faq.xml
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_90/faq.xml?rev=614430&r1=614429&r2=614430&view=diff
==============================================================================
--- forrest/site/docs_0_90/faq.xml (original)
+++ forrest/site/docs_0_90/faq.xml Tue Jan 22 22:14:21 2008
@@ -261,7 +261,9 @@
         </p>
       </section><section id="PDF-output"><title>2.5. How can I generate one pdf-file out of the whole site or selected pages of the site?</title>
         <p>
-          Add the following entries to your site.xml file:
+          Add the following entries to your site.xml file.
+          Note that the href must be exactly "wholesite" or "site" which triggers
+          a special match in the sitemap to aggregate all documents.
         </p>
         <source xml:space="preserve">
 
@@ -274,14 +276,21 @@
         </source>
         <p>
           In this case the menu labeled "About" will have 2 new items: "Full
-          PDF" and "Full HTML". (See also <link href="site:pdf-tab">How to
-          create a PDF document for each tab</link>.)
+          PDF" and "Full HTML".
+        </p>
+        <p>
+          See also <link href="site:pdf-tab">How to
+          create a PDF document for each tab</link>.
         </p>
         <p>
           This assumes that you use the
           <link href="site:linking">site.xml</link> method for your site
           structure and navigation, rather than the old book.xml method.
         </p>
+        <warning>
+          There are many issues with the "wholesite" aggregation. Search the
+          issue tracker and mail lists.
+        </warning>
       </section><section id="pageBreaks"><title>2.6. How do I insert page breaks into documents?</title>
         <p>
           Page breaks do not make a great deal of sense in HTML documents
@@ -781,7 +790,7 @@
       </section><section id="claimed_patterns"><title>3.7. Some of my files are not being processed because they use common filenames. </title>
         <p>
           Certain patterns are claimed by the default sitemaps for special
-          processing. These reserved words include: <code>site, changes, todo,
+          processing. These reserved words include: <code>site, wholesite, changes, todo,
           faq, images, my-images, skinconf, community, howto</code>
         </p>
         <p>

Modified: forrest/site/mirrors.html
URL: http://svn.apache.org/viewvc/forrest/site/mirrors.html?rev=614430&r1=614429&r2=614430&view=diff
==============================================================================
--- forrest/site/mirrors.html (original)
+++ forrest/site/mirrors.html Tue Jan 22 22:14:21 2008
@@ -202,9 +202,6 @@
 <a href="#closest">Current official release (closest mirror site selected automatically)</a>
 </li>
 <li>
-<a href="#svn">Current development and head SVN repository</a>
-</li>
-<li>
 <a href="#archive">Archive of old releases</a>
 </li>
 <li>
@@ -241,17 +238,12 @@
 <li>For Windows operating systems: <a href="[preferred]/forrest/apache-forrest-0.8.zip">apache-forrest-0.8.zip</a> [<a href="http://www.apache.org/dist/forrest/apache-forrest-0.8.zip.asc">PGP</a>] [<a href="http://www.apache.org/dist/forrest/apache-forrest-0.8.zip.md5">MD5</a>]</li>
 </ul>
 </div>
-<a name="N10072"></a><a name="svn"></a>
-<h2 class="underlined_10">Current development and head SVN repository</h2>
-<div class="section">
-<p>Developers can use the latest Apache Forrest features, the source code is under version control with Subversion (read how to <a href="docs_0_70/build.html">obtain</a> your working copy).</p>
-</div>
-<a name="N1007E"></a><a name="archive"></a>
+<a name="N10072"></a><a name="archive"></a>
 <h2 class="underlined_10">Archive of old releases</h2>
 <div class="section">
 <p>Older releases are available in the <a href="http://archive.apache.org/dist/forrest/">archive</a>. Those releases are only provided as historical artefacts. We strongly recommend to not use those releases, but upgrade to the most recent release.</p>
 </div>
-<a name="N1008A"></a><a name="verify"></a>
+<a name="N1007E"></a><a name="verify"></a>
 <h2 class="underlined_10">Verify releases</h2>
 <div class="section">
 <p>It is essential that you verify the integrity of the downloaded files using the PGP and MD5 signatures. MD5 verification ensures the file was not corrupted or tampered with. PGP verification ensures that the file came from a certain person.</p>

Modified: forrest/site/mirrors.pdf
URL: http://svn.apache.org/viewvc/forrest/site/mirrors.pdf?rev=614430&r1=614429&r2=614430&view=diff
==============================================================================
Binary files - no diff available.