Advanced
Mailing List Archive

Mailing List Archive

  1. Home >
  2. Forrest>
  3. Site-SVN
svn commit: r525747 [1/2] - in /forrest/site: ./ docs_0_80/ docs_0_80/error_site_your-project/ docs_0_80/howto/ docs_0_80/howto/multi/ dtdx/ procedures/release/
crossley at apache
Apr 4, 2007, 11:40 PM
Post #1 of 1 (1016 views)
Permalink
Author: crossley
Date: Thu Apr 5 00:40:14 2007
New Revision: 525747

URL: http://svn.apache.org/viewvc?view=rev&rev=525747
Log:
Automatic publish from forrestbot

Added:
forrest/site/docs_0_80/error_site_your-project/
forrest/site/docs_0_80/error_site_your-project/catalog
Modified:
forrest/site/abs-linkmap
forrest/site/abs-menulinks
forrest/site/docs_0_80/body-index.html
forrest/site/docs_0_80/build.html
forrest/site/docs_0_80/cap.html
forrest/site/docs_0_80/catalog.html
forrest/site/docs_0_80/changes.html
forrest/site/docs_0_80/changes.pdf
forrest/site/docs_0_80/changes.rss
forrest/site/docs_0_80/changes.xml
forrest/site/docs_0_80/dreams.html
forrest/site/docs_0_80/faq.html
forrest/site/docs_0_80/faq.pdf
forrest/site/docs_0_80/faq.xml
forrest/site/docs_0_80/glossary.html
forrest/site/docs_0_80/howto/howto-asf-mirror.html
forrest/site/docs_0_80/howto/howto-buildPlugin.html
forrest/site/docs_0_80/howto/howto-corner-images.html
forrest/site/docs_0_80/howto/howto-custom-html-source.html
forrest/site/docs_0_80/howto/howto-editcss.html
forrest/site/docs_0_80/howto/howto-forrest-from-maven.html
forrest/site/docs_0_80/howto/howto-pdf-tab.html
forrest/site/docs_0_80/howto/index.html
forrest/site/docs_0_80/howto/multi/howto-multi.html
forrest/site/docs_0_80/howto/multi/step1.html
forrest/site/docs_0_80/howto/multi/step2.html
forrest/site/docs_0_80/howto/multi/step3.html
forrest/site/docs_0_80/index.html
forrest/site/docs_0_80/index.pdf
forrest/site/docs_0_80/index.xml
forrest/site/docs_0_80/libre-intro.html
forrest/site/docs_0_80/linking.html
forrest/site/docs_0_80/locationmap.html
forrest/site/docs_0_80/menu-index.html
forrest/site/docs_0_80/primer.html
forrest/site/docs_0_80/project-sitemap.html
forrest/site/docs_0_80/searching.html
forrest/site/docs_0_80/sitemap-ref.html
forrest/site/docs_0_80/skin-package.html
forrest/site/docs_0_80/skins.html
forrest/site/docs_0_80/status-themes.html
forrest/site/docs_0_80/upgrading_08.html
forrest/site/docs_0_80/validation.html
forrest/site/docs_0_80/validation.pdf
forrest/site/docs_0_80/your-project.html
forrest/site/dtdx/document-v12.html
forrest/site/dtdx/document-v13.dtdx.html
forrest/site/dtdx/document-v13.html
forrest/site/dtdx/document-v20.dtdx.html
forrest/site/dtdx/document-v20.html
forrest/site/dtdx/dtd-docs.html
forrest/site/dtdx/faq-v13.dtdx.html
forrest/site/dtdx/faq-v20.dtdx.html
forrest/site/dtdx/howto-v13.dtdx.html
forrest/site/dtdx/howto-v20.dtdx.html
forrest/site/forrest-issues.html
forrest/site/forrest-issues.pdf
forrest/site/index.html
forrest/site/index.pdf
forrest/site/linkmap.html
forrest/site/linkmap.pdf
forrest/site/mirrors.html
forrest/site/mirrors.pdf
forrest/site/procedures/release/How_to_release.html
forrest/site/procedures/release/How_to_release.pdf

Modified: forrest/site/abs-linkmap
URL: http://svn.apache.org/viewvc/forrest/site/abs-linkmap?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/abs-linkmap (original)
+++ forrest/site/abs-linkmap Thu Apr 5 00:40:14 2007
@@ -296,6 +296,7 @@
<faq label="FAQs" href="docs_0_80/faq.html">
<build_msg_a href="docs_0_80/faq.html#build_msg_a"/>
<docbook href="docs_0_80/faq.html#docbook"/>
+ <docs href="docs_0_80/faq.html#docs"/>
<checksums href="docs_0_80/faq.html#checksums"/>
<edit-content href="docs_0_80/faq.html#edit-content"/>
<ignoring_javadocs href="docs_0_80/faq.html#ignoring_javadocs"/>
@@ -333,7 +334,10 @@
<skins label="Skins" href="docs_0_80/skins.html" description="About default skins, their naming and features"/>
<status-themes label="Dispatcher versus Skins" href="docs_0_80/status-themes.html"/>
<cap label="Sourcetype Action" href="docs_0_80/cap.html"/>
- <validation label="XML Validation" href="docs_0_80/validation.html"/>
+ <validation label="XML validation and entity resolution" href="docs_0_80/validation.html">
+ <catalog href="docs_0_80/validation.html#catalog"/>
+ <debug-catalog href="docs_0_80/validation.html#debug-catalog"/>
+ </validation>
</whitepapers>



Modified: forrest/site/abs-menulinks
URL: http://svn.apache.org/viewvc/forrest/site/abs-menulinks?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/abs-menulinks (original)
+++ forrest/site/abs-menulinks Thu Apr 5 00:40:14 2007
@@ -296,6 +296,7 @@
<faq tab="v0_80" label="FAQs" href="docs_0_80/faq.html">
<build_msg_a tab="v0_80" href="docs_0_80/faq.html#build_msg_a"/>
<docbook tab="v0_80" href="docs_0_80/faq.html#docbook"/>
+ <docs tab="v0_80" href="docs_0_80/faq.html#docs"/>
<checksums tab="v0_80" href="docs_0_80/faq.html#checksums"/>
<edit-content tab="v0_80" href="docs_0_80/faq.html#edit-content"/>
<ignoring_javadocs tab="v0_80" href="docs_0_80/faq.html#ignoring_javadocs"/>
@@ -333,7 +334,10 @@
<skins tab="v0_80" label="Skins" href="docs_0_80/skins.html" description="About default skins, their naming and features"/>
<status-themes tab="v0_80" label="Dispatcher versus Skins" href="docs_0_80/status-themes.html"/>
<cap tab="v0_80" label="Sourcetype Action" href="docs_0_80/cap.html"/>
- <validation tab="v0_80" label="XML Validation" href="docs_0_80/validation.html"/>
+ <validation tab="v0_80" label="XML validation and entity resolution" href="docs_0_80/validation.html">
+ <catalog tab="v0_80" href="docs_0_80/validation.html#catalog"/>
+ <debug-catalog tab="v0_80" href="docs_0_80/validation.html#debug-catalog"/>
+ </validation>
</whitepapers>



Modified: forrest/site/docs_0_80/body-index.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/body-index.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/body-index.html (original)
+++ forrest/site/docs_0_80/body-index.html Thu Apr 5 00:40:14 2007
@@ -33,8 +33,15 @@
<p>In the <a href="howto/index.html">How-To</a> section you will find various
practical guides on how to achieve common objectives in Forrest.</p>

-<p>We also have a <a href="faq.html">FAQ</a> that you should consult before posting questions to
+<p>We also have a <a href="faq.html">FAQ</a> list that you should consult before posting questions to
our user list.</p>
+
+<p>
+ The documentation <a href="../linkmap.html">Table of Contents</a> provides a
+ useful overview of the main documentation. <a href="../docs_0_80/faq.html#docs">This FAQ</a>
+ explains that there is other documentation at the example forrest seed
+ site and that each plugin has its own documentation.
+ </p>

<p>
There are docs for

Modified: forrest/site/docs_0_80/build.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/build.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/build.html (original)
+++ forrest/site/docs_0_80/build.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/cap.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/cap.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/cap.html (original)
+++ forrest/site/docs_0_80/cap.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<div class="menupagetitle">Sourcetype Action</div>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/catalog.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/catalog.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/catalog.html (original)
+++ forrest/site/docs_0_80/catalog.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/changes.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/changes.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/changes.html (original)
+++ forrest/site/docs_0_80/changes.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menupage">
@@ -343,13 +343,13 @@
<a href="#version_0.7.1-dev">Version 0.7.1-dev (not released)</a>
<ul class="minitoc">
<li>
-<a href="#Changes+to+the+Code+Base-N1052A">Changes to the Code Base</a>
+<a href="#Changes+to+the+Code+Base-N10545">Changes to the Code Base</a>
</li>
<li>
-<a href="#Changes+to+Documentation-N10550">Changes to Documentation</a>
+<a href="#Changes+to+Documentation-N1056B">Changes to Documentation</a>
</li>
<li>
-<a href="#Contributors+to+this+release-N10560">Contributors to this release</a>
+<a href="#Contributors+to+this+release-N1057B">Contributors to this release</a>
</li>
</ul>
</li>
@@ -360,16 +360,16 @@
<a href="#Changes+to+Project+Administration">Changes to Project Administration</a>
</li>
<li>
-<a href="#Changes+to+Build-N10585">Changes to Build</a>
+<a href="#Changes+to+Build-N105A0">Changes to Build</a>
</li>
<li>
-<a href="#Changes+to+the+Code+Base-N1058F">Changes to the Code Base</a>
+<a href="#Changes+to+the+Code+Base-N105AA">Changes to the Code Base</a>
</li>
<li>
-<a href="#Changes+to+Documentation-N10720">Changes to Documentation</a>
+<a href="#Changes+to+Documentation-N1073B">Changes to Documentation</a>
</li>
<li>
-<a href="#Contributors+to+this+release-N107C0">Contributors to this release</a>
+<a href="#Contributors+to+this+release-N107DB">Contributors to this release</a>
</li>
</ul>
</li>
@@ -377,19 +377,19 @@
<a href="#version_0.6">Version 0.6 (2004-10-15)</a>
<ul class="minitoc">
<li>
-<a href="#Changes+to+Project+Administration-N107D3">Changes to Project Administration</a>
+<a href="#Changes+to+Project+Administration-N107EE">Changes to Project Administration</a>
</li>
<li>
-<a href="#Changes+to+Build-N107DD">Changes to Build</a>
+<a href="#Changes+to+Build-N107F8">Changes to Build</a>
</li>
<li>
-<a href="#Changes+to+the+Code+Base-N1080B">Changes to the Code Base</a>
+<a href="#Changes+to+the+Code+Base-N10826">Changes to the Code Base</a>
</li>
<li>
-<a href="#Changes+to+Documentation-N10BB1">Changes to Documentation</a>
+<a href="#Changes+to+Documentation-N10BCC">Changes to Documentation</a>
</li>
<li>
-<a href="#Contributors+to+this+release-N10C0B">Contributors to this release</a>
+<a href="#Contributors+to+this+release-N10C26">Contributors to this release</a>
</li>
</ul>
</li>
@@ -397,13 +397,13 @@
<a href="#version_0.5.1">Version 0.5.1 (2003-10-06)</a>
<ul class="minitoc">
<li>
-<a href="#Changes+to+Build-N10C1E">Changes to Build</a>
+<a href="#Changes+to+Build-N10C39">Changes to Build</a>
</li>
<li>
-<a href="#Changes+to+the+Code+Base-N10C28">Changes to the Code Base</a>
+<a href="#Changes+to+the+Code+Base-N10C43">Changes to the Code Base</a>
</li>
<li>
-<a href="#Contributors+to+this+release-N10C68">Contributors to this release</a>
+<a href="#Contributors+to+this+release-N10C83">Contributors to this release</a>
</li>
</ul>
</li>
@@ -411,13 +411,13 @@
<a href="#version_0.5">Version 0.5 (2003-09-13)</a>
<ul class="minitoc">
<li>
-<a href="#Changes+to+the+Code+Base-N10C77">Changes to the Code Base</a>
+<a href="#Changes+to+the+Code+Base-N10C92">Changes to the Code Base</a>
</li>
<li>
-<a href="#Changes+to+Documentation-N10E78">Changes to Documentation</a>
+<a href="#Changes+to+Documentation-N10E93">Changes to Documentation</a>
</li>
<li>
-<a href="#Contributors+to+this+release-N10E82">Contributors to this release</a>
+<a href="#Contributors+to+this+release-N10E9D">Contributors to this release</a>
</li>
</ul>
</li>
@@ -425,13 +425,13 @@
<a href="#version_0.4">Version 0.4 (2003-02-12)</a>
<ul class="minitoc">
<li>
-<a href="#Changes+to+the+Code+Base-N10E95">Changes to the Code Base</a>
+<a href="#Changes+to+the+Code+Base-N10EB0">Changes to the Code Base</a>
</li>
<li>
-<a href="#Changes+to+Documentation-N10EFC">Changes to Documentation</a>
+<a href="#Changes+to+Documentation-N10F17">Changes to Documentation</a>
</li>
<li>
-<a href="#Contributors+to+this+release-N10F06">Contributors to this release</a>
+<a href="#Contributors+to+this+release-N10F21">Contributors to this release</a>
</li>
</ul>
</li>
@@ -439,16 +439,16 @@
<a href="#version_0.3">Version 0.3 (2003-01-30)</a>
<ul class="minitoc">
<li>
-<a href="#Changes+to+Build-N10F19">Changes to Build</a>
+<a href="#Changes+to+Build-N10F34">Changes to Build</a>
</li>
<li>
-<a href="#Changes+to+the+Code+Base-N10F28">Changes to the Code Base</a>
+<a href="#Changes+to+the+Code+Base-N10F43">Changes to the Code Base</a>
</li>
<li>
-<a href="#Changes+to+Documentation-N1103E">Changes to Documentation</a>
+<a href="#Changes+to+Documentation-N11059">Changes to Documentation</a>
</li>
<li>
-<a href="#Contributors+to+this+release-N11048">Contributors to this release</a>
+<a href="#Contributors+to+this+release-N11063">Contributors to this release</a>
</li>
</ul>
</li>
@@ -456,10 +456,10 @@
<a href="#version_0.2">Version 0.2 (2002-11-16)</a>
<ul class="minitoc">
<li>
-<a href="#Changes+to+the+Code+Base-N1105B">Changes to the Code Base</a>
+<a href="#Changes+to+the+Code+Base-N11076">Changes to the Code Base</a>
</li>
<li>
-<a href="#Contributors+to+this+release-N11072">Contributors to this release</a>
+<a href="#Contributors+to+this+release-N1108D">Contributors to this release</a>
</li>
</ul>
</li>
@@ -467,22 +467,22 @@
<a href="#version_0.2rc1">Version 0.2rc1 (2002-11-13)</a>
<ul class="minitoc">
<li>
-<a href="#Changes+to+Project+Administration-N11081">Changes to Project Administration</a>
+<a href="#Changes+to+Project+Administration-N1109C">Changes to Project Administration</a>
</li>
<li>
-<a href="#Changes+to+Build-N1108B">Changes to Build</a>
+<a href="#Changes+to+Build-N110A6">Changes to Build</a>
</li>
<li>
-<a href="#Changes+to+the+Code+Base-N110F9">Changes to the Code Base</a>
+<a href="#Changes+to+the+Code+Base-N11114">Changes to the Code Base</a>
</li>
<li>
<a href="#Changes+to+Design">Changes to Design</a>
</li>
<li>
-<a href="#Changes+to+Documentation-N111BE">Changes to Documentation</a>
+<a href="#Changes+to+Documentation-N111D9">Changes to Documentation</a>
</li>
<li>
-<a href="#Contributors+to+this+release-N11227">Contributors to this release</a>
+<a href="#Contributors+to+this+release-N11242">Contributors to this release</a>
</li>
</ul>
</li>
@@ -1123,6 +1123,22 @@
Committed by DC.</li>
<li>
<img class="icon" alt="add" src="../images/add.jpg">
+ Added <a href="../docs_0_80/faq.html#docs">notes</a> to explain the main documentation,
+ as well as documentation and examples in each plugins and documentation
+ and examples in the 'forrest seed-sample' site.
+ Committed by DC.</li>
+<li>
+<img class="icon" alt="add" src="../images/add.jpg">
+ Added notes about <a href="../docs_0_80/validation.html#catalog">configuring</a>
+ a system-wide XML Catalog Entity Resolver to share local DTDs between multiple projects.
+ Committed by DC.</li>
+<li>
+<img class="icon" alt="add" src="../images/add.jpg">
+ Added notes about <a href="../docs_0_80/validation.html#debug-catalog">debugging</a>
+ the XML Catalog Entity Resolver for local DTDs.
+ Committed by DC.</li>
+<li>
+<img class="icon" alt="add" src="../images/add.jpg">
Added doc to explain
<a href="../docs_0_80/status-themes.html">Skins and Dispatcher status</a>.
Committed by DC.</li>
@@ -1323,21 +1339,21 @@
how to debug forrest java classes to the faq <a href="http://svn.apache.org/viewcvs.cgi?rev=291361&view=rev">Diff</a>
Committed by TS.</li>
</ul>
-<a name="N1050F"></a><a name="Contributors+to+this+release"></a>
+<a name="N1052A"></a><a name="Contributors+to+this+release"></a>
<h3 class="underlined_5">Contributors to this release</h3>
<p>We thank the following people for their contributions to this release.</p>
<p>This is a list of all people who participated as committers:<br>Antonio Gallardo (AG), Bertrand Delacretaz (BD), Cyriaque Dupoirieux (CD), David Crossley (DC), Diwaker Gupta (DG), Ferdinand Soethe (FSO), Juan Jose Pablos (JJP), Johannes Schaefer (JS), Ross Gardler (RDG), Sjur N Moshagen (SNM), Thorsten Scherler (TS), Tim Williams (TWW).</p>
<p>This is a list of other contributors:<br>Addison Berry, Alan Chandler, Anil Ramnanan, Brian Dube, Clay Leeds, Community, Dave Brosius, David Crossley, Gavin, Gavin McDonald, Jan Materne, Jim Dixon, Joachim Breitsprecher, Josias Thoeny, kevin, Martin Stockhammer, Mathieu Champlon, Paul Devine, Paul Kronenwetter, Phillip Evens, Pier Fumagalli, Randy Metcalfe, Rasik Pandey, Richard Calmbach, Ross Gardler, Sjur N. Moshagen, Steve Masover, Tom HANAX, Torsten Stolpmann, Vadim Gritsenko, Vronk Duat.</p>
</div>

-<a name="N1051E"></a><a name="version_0.7.1-dev"></a>
+<a name="N10539"></a><a name="version_0.7.1-dev"></a>
<h2 class="underlined_10">Version 0.7.1-dev (not released)</h2>
<div class="section">
<p>See each
<a href="../pluginDocs/plugins_0_70/index.html">plugin</a>
for its detailed changes.
</p>
-<a name="N1052A"></a><a name="Changes+to+the+Code+Base-N1052A"></a>
+<a name="N10545"></a><a name="Changes+to+the+Code+Base-N10545"></a>
<h3 class="underlined_5">Changes to the Code Base</h3>
<ul>
<li>
@@ -1373,7 +1389,7 @@
Doing 'forrest clean' will remove both sections.
Committed by DC.</li>
</ul>
-<a name="N10550"></a><a name="Changes+to+Documentation-N10550"></a>
+<a name="N1056B"></a><a name="Changes+to+Documentation-N1056B"></a>
<h3 class="underlined_5">Changes to Documentation</h3>
<ul>
<li>
@@ -1383,21 +1399,21 @@
<a href="../docs_0_70/upgrading_07.html">upgrading to v0.7</a>
Committed by DC.</li>
</ul>
-<a name="N10560"></a><a name="Contributors+to+this+release-N10560"></a>
+<a name="N1057B"></a><a name="Contributors+to+this+release-N1057B"></a>
<h3 class="underlined_5">Contributors to this release</h3>
<p>We thank the following people for their contributions to this release.</p>
<p>This is a list of all people who participated as committers:<br>David Crossley (DC), Ferdinand Soethe (FSO).</p>
<p>This is a list of other contributors:<br>Steve Masover.</p>
</div>

-<a name="N1056F"></a><a name="version_0.7"></a>
+<a name="N1058A"></a><a name="version_0.7"></a>
<h2 class="underlined_10">Version 0.7 (2005-06-23)</h2>
<div class="section">
<p>See each
<a href="../pluginDocs/plugins_0_70/index.html">plugin</a>
for its detailed changes.
</p>
-<a name="N1057B"></a><a name="Changes+to+Project+Administration"></a>
+<a name="N10596"></a><a name="Changes+to+Project+Administration"></a>
<h3 class="underlined_5">Changes to Project Administration</h3>
<ul>
<li>
@@ -1405,7 +1421,7 @@
Added testing facilities to plugins to facilitate integration testing.
Committed by RDG.</li>
</ul>
-<a name="N10585"></a><a name="Changes+to+Build-N10585"></a>
+<a name="N105A0"></a><a name="Changes+to+Build-N105A0"></a>
<h3 class="underlined_5">Changes to Build</h3>
<ul>
<li>
@@ -1415,7 +1431,7 @@
Ant "import" task.
Committed by DC.</li>
</ul>
-<a name="N1058F"></a><a name="Changes+to+the+Code+Base-N1058F"></a>
+<a name="N105AA"></a><a name="Changes+to+the+Code+Base-N105AA"></a>
<h3 class="underlined_5">Changes to the Code Base</h3>
<ul>
<li>
@@ -1704,7 +1720,7 @@
starting with Forrest-0.7-dev
Committed by DC.</li>
</ul>
-<a name="N10720"></a><a name="Changes+to+Documentation-N10720"></a>
+<a name="N1073B"></a><a name="Changes+to+Documentation-N1073B"></a>
<h3 class="underlined_5">Changes to Documentation</h3>
<ul>
<li>
@@ -1794,17 +1810,17 @@
tab</a> to create subject-specific aggregated documents.
Committed by TS.</li>
</ul>
-<a name="N107C0"></a><a name="Contributors+to+this+release-N107C0"></a>
+<a name="N107DB"></a><a name="Contributors+to+this+release-N107DB"></a>
<h3 class="underlined_5">Contributors to this release</h3>
<p>We thank the following people for their contributions to this release.</p>
<p>This is a list of all people who participated as committers:<br>Antonio Gallardo (AG), Dave Brondsema (DB), David Crossley (DC), Juan Jose Pablos (JJP), Ross Gardler (RDG), Rick Tessner (RFT), Thorsten Scherler (TS).</p>
<p>This is a list of other contributors:<br>Cyriaque Dupoirieux, Ferdinand Soethe, Florian G. Haas, Gary Feldman, Ian P. Springer, Joao Ferreira, Johannes Schaefer, J&ouml;rg Werner, Kevin, Mark Eggers, Ron Blaschke, Sjur N. Moshagen, Stephan E. Schlierf, Tamara Harpster, Upayavira.</p>
</div>

-<a name="N107CF"></a><a name="version_0.6"></a>
+<a name="N107EA"></a><a name="version_0.6"></a>
<h2 class="underlined_10">Version 0.6 (2004-10-15)</h2>
<div class="section">
-<a name="N107D3"></a><a name="Changes+to+Project+Administration-N107D3"></a>
+<a name="N107EE"></a><a name="Changes+to+Project+Administration-N107EE"></a>
<h3 class="underlined_5">Changes to Project Administration</h3>
<ul>
<li>
@@ -1815,7 +1831,7 @@
OpenSymphony's OSUser for flexible authentication.
Committed by DB.</li>
</ul>
-<a name="N107DD"></a><a name="Changes+to+Build-N107DD"></a>
+<a name="N107F8"></a><a name="Changes+to+Build-N107F8"></a>
<h3 class="underlined_5">Changes to Build</h3>
<ul>
<li>
@@ -1839,7 +1855,7 @@
Add more descriptions to forrest targets. Highlight the most common ones.
Committed by DB. See Issue <a href="http://issues.apache.org/jira/browse/FOR-216">FOR-216</a>.</li>
</ul>
-<a name="N1080B"></a><a name="Changes+to+the+Code+Base-N1080B"></a>
+<a name="N10826"></a><a name="Changes+to+the+Code+Base-N10826"></a>
<h3 class="underlined_5">Changes to the Code Base</h3>
<ul>
<li>
@@ -2574,7 +2590,7 @@
Sort action types order to "add","remove","update","fix".
Committed by JJP.</li>
</ul>
-<a name="N10BB1"></a><a name="Changes+to+Documentation-N10BB1"></a>
+<a name="N10BCC"></a><a name="Changes+to+Documentation-N10BCC"></a>
<h3 class="underlined_5">Changes to Documentation</h3>
<ul>
<li>
@@ -2631,7 +2647,7 @@
<a href="http://forrest.apache.org/">http://forrest.apache.org/</a>
Committed by DC.</li>
</ul>
-<a name="N10C0B"></a><a name="Contributors+to+this+release-N10C0B"></a>
+<a name="N10C26"></a><a name="Contributors+to+this+release-N10C26"></a>
<h3 class="underlined_5">Contributors to this release</h3>
<p>We thank the following people for their contributions to this release.</p>
<p>This is a list of all people who participated as committers:<br>Antonio Gallardo (AG), Dave Brondsema (DB), David Crossley (DC), Juan Jose Pablos (JJP), Nicola Ken Barozzi (NKB), Ross Gardler (RDG), Reinhard P&ouml;tz (RP), Thorsten Scherler (TS).</p>
@@ -2639,10 +2655,10 @@
</div>


-<a name="N10C1A"></a><a name="version_0.5.1"></a>
+<a name="N10C35"></a><a name="version_0.5.1"></a>
<h2 class="underlined_10">Version 0.5.1 (2003-10-06)</h2>
<div class="section">
-<a name="N10C1E"></a><a name="Changes+to+Build-N10C1E"></a>
+<a name="N10C39"></a><a name="Changes+to+Build-N10C39"></a>
<h3 class="underlined_5">Changes to Build</h3>
<ul>
<li>
@@ -2650,7 +2666,7 @@
forrest.antproxy.xml script now properly fails when Cocoon fails
Committed by JT.</li>
</ul>
-<a name="N10C28"></a><a name="Changes+to+the+Code+Base-N10C28"></a>
+<a name="N10C43"></a><a name="Changes+to+the+Code+Base-N10C43"></a>
<h3 class="underlined_5">Changes to the Code Base</h3>
<ul>
<li>
@@ -2687,17 +2703,17 @@
~/.antrc, which solves problems on some *nix distributions.
Committed by JT.</li>
</ul>
-<a name="N10C68"></a><a name="Contributors+to+this+release-N10C68"></a>
+<a name="N10C83"></a><a name="Contributors+to+this+release-N10C83"></a>
<h3 class="underlined_5">Contributors to this release</h3>
<p>We thank the following people for their contributions to this release.</p>
<p>This is a list of all people who participated as committers:<br>Jeff Turner (JT).</p>
</div>


-<a name="N10C73"></a><a name="version_0.5"></a>
+<a name="N10C8E"></a><a name="version_0.5"></a>
<h2 class="underlined_10">Version 0.5 (2003-09-13)</h2>
<div class="section">
-<a name="N10C77"></a><a name="Changes+to+the+Code+Base-N10C77"></a>
+<a name="N10C92"></a><a name="Changes+to+the+Code+Base-N10C92"></a>
<h3 class="underlined_5">Changes to the Code Base</h3>
<ul>
<li>
@@ -3075,7 +3091,7 @@
the xinclude, linkrewriter, and idgen steps.
Committed by NKB.</li>
</ul>
-<a name="N10E78"></a><a name="Changes+to+Documentation-N10E78"></a>
+<a name="N10E93"></a><a name="Changes+to+Documentation-N10E93"></a>
<h3 class="underlined_5">Changes to Documentation</h3>
<ul>
<li>
@@ -3084,17 +3100,17 @@
upgrading to v0.5
Committed by JT.</li>
</ul>
-<a name="N10E82"></a><a name="Contributors+to+this+release-N10E82"></a>
+<a name="N10E9D"></a><a name="Contributors+to+this+release-N10E9D"></a>
<h3 class="underlined_5">Contributors to this release</h3>
<p>We thank the following people for their contributions to this release.</p>
<p>This is a list of all people who participated as committers:<br>David Crossley (DC), Juan Jose Pablos (JJP), Jeff Turner (JT), Nicola Ken Barozzi (NKB), Steven Noels (SN).</p>
<p>This is a list of other contributors:<br>Dave Brondsema, Eirik Bj&oslash;rsn&oslash;s, Frederic Robesyn, J.Pietschmann, Joerg Heinicke, Juan Jose Pablos, Ralf Hauser, Ram&oacute;n Prades, Ringo de Smet, Ross Gardler, Stefan Bodewig.</p>
</div>

-<a name="N10E91"></a><a name="version_0.4"></a>
+<a name="N10EAC"></a><a name="version_0.4"></a>
<h2 class="underlined_10">Version 0.4 (2003-02-12)</h2>
<div class="section">
-<a name="N10E95"></a><a name="Changes+to+the+Code+Base-N10E95"></a>
+<a name="N10EB0"></a><a name="Changes+to+the+Code+Base-N10EB0"></a>
<h3 class="underlined_5">Changes to the Code Base</h3>
<ul>
<li>
@@ -3171,7 +3187,7 @@
Switched all loglevels to ERROR.
Committed by NKB.</li>
</ul>
-<a name="N10EFC"></a><a name="Changes+to+Documentation-N10EFC"></a>
+<a name="N10F17"></a><a name="Changes+to+Documentation-N10F17"></a>
<h3 class="underlined_5">Changes to Documentation</h3>
<ul>
<li>
@@ -3180,7 +3196,7 @@
to the forrestbar.xpi generated by Gump every day.
Committed by NKB.</li>
</ul>
-<a name="N10F06"></a><a name="Contributors+to+this+release-N10F06"></a>
+<a name="N10F21"></a><a name="Contributors+to+this+release-N10F21"></a>
<h3 class="underlined_5">Contributors to this release</h3>
<p>We thank the following people for their contributions to this release.</p>
<p>This is a list of all people who participated as committers:<br>Jeff Turner (JT), Marc Portier (MP), Nicola Ken Barozzi (NKB).</p>
@@ -3188,10 +3204,10 @@
</div>


-<a name="N10F15"></a><a name="version_0.3"></a>
+<a name="N10F30"></a><a name="version_0.3"></a>
<h2 class="underlined_10">Version 0.3 (2003-01-30)</h2>
<div class="section">
-<a name="N10F19"></a><a name="Changes+to+Build-N10F19"></a>
+<a name="N10F34"></a><a name="Changes+to+Build-N10F34"></a>
<h3 class="underlined_5">Changes to Build</h3>
<ul>
<li>
@@ -3206,7 +3222,7 @@
instead of Cocoon + Centipede logos.
Committed by JT.</li>
</ul>
-<a name="N10F28"></a><a name="Changes+to+the+Code+Base-N10F28"></a>
+<a name="N10F43"></a><a name="Changes+to+the+Code+Base-N10F43"></a>
<h3 class="underlined_5">Changes to the Code Base</h3>
<ul>
<li>
@@ -3437,7 +3453,7 @@
We need icons for the new buttons.
Committed by NKB.</li>
</ul>
-<a name="N1103E"></a><a name="Changes+to+Documentation-N1103E"></a>
+<a name="N11059"></a><a name="Changes+to+Documentation-N11059"></a>
<h3 class="underlined_5">Changes to Documentation</h3>
<ul>
<li>
@@ -3447,17 +3463,17 @@
Stylesheets not yet done.
Committed by NKB.</li>
</ul>
-<a name="N11048"></a><a name="Contributors+to+this+release-N11048"></a>
+<a name="N11063"></a><a name="Contributors+to+this+release-N11063"></a>
<h3 class="underlined_5">Contributors to this release</h3>
<p>We thank the following people for their contributions to this release.</p>
<p>This is a list of all people who participated as committers:<br>David Crossley (DC), Jeff Turner (JT), Nicola Ken Barozzi (NKB).</p>
<p>This is a list of other contributors:<br>Nick Chalko, Omar Belhaj, Stefan Michels.</p>
</div>

-<a name="N11057"></a><a name="version_0.2"></a>
+<a name="N11072"></a><a name="version_0.2"></a>
<h2 class="underlined_10">Version 0.2 (2002-11-16)</h2>
<div class="section">
-<a name="N1105B"></a><a name="Changes+to+the+Code+Base-N1105B"></a>
+<a name="N11076"></a><a name="Changes+to+the+Code+Base-N11076"></a>
<h3 class="underlined_5">Changes to the Code Base</h3>
<ul>
<li>
@@ -3476,16 +3492,16 @@
Webapp now works under JDK 1.3 (parsers weren't being copied)
Committed by JT.</li>
</ul>
-<a name="N11072"></a><a name="Contributors+to+this+release-N11072"></a>
+<a name="N1108D"></a><a name="Contributors+to+this+release-N1108D"></a>
<h3 class="underlined_5">Contributors to this release</h3>
<p>We thank the following people for their contributions to this release.</p>
<p>This is a list of all people who participated as committers:<br>David Crossley (DC), Jeff Turner (JT).</p>
</div>

-<a name="N1107D"></a><a name="version_0.2rc1"></a>
+<a name="N11098"></a><a name="version_0.2rc1"></a>
<h2 class="underlined_10">Version 0.2rc1 (2002-11-13)</h2>
<div class="section">
-<a name="N11081"></a><a name="Changes+to+Project+Administration-N11081"></a>
+<a name="N1109C"></a><a name="Changes+to+Project+Administration-N1109C"></a>
<h3 class="underlined_5">Changes to Project Administration</h3>
<ul>
<li>
@@ -3493,7 +3509,7 @@
Initial Import
Committed by SM.</li>
</ul>
-<a name="N1108B"></a><a name="Changes+to+Build-N1108B"></a>
+<a name="N110A6"></a><a name="Changes+to+Build-N110A6"></a>
<h3 class="underlined_5">Changes to Build</h3>
<ul>
<li>
@@ -3593,7 +3609,7 @@
Added basic Forrest descriptor.
Committed by NKB.</li>
</ul>
-<a name="N110F9"></a><a name="Changes+to+the+Code+Base-N110F9"></a>
+<a name="N11114"></a><a name="Changes+to+the+Code+Base-N11114"></a>
<h3 class="underlined_5">Changes to the Code Base</h3>
<ul>
<li>
@@ -3741,7 +3757,7 @@
Put the internal matches in a separate pipeline with internal-only="true".
Committed by NKB.</li>
</ul>
-<a name="N111B4"></a><a name="Changes+to+Design"></a>
+<a name="N111CF"></a><a name="Changes+to+Design"></a>
<h3 class="underlined_5">Changes to Design</h3>
<ul>
<li>
@@ -3750,7 +3766,7 @@
cross-browser issues.
Committed by BK.</li>
</ul>
-<a name="N111BE"></a><a name="Changes+to+Documentation-N111BE"></a>
+<a name="N111D9"></a><a name="Changes+to+Documentation-N111D9"></a>
<h3 class="underlined_5">Changes to Documentation</h3>
<ul>
<li>
@@ -3838,14 +3854,14 @@
validated using these DTDs and OASIS Catalogs.
Committed by DC. Thanks to <a href="mailto:stevenn.at.outerthought.org">Steven Noels</a>.</li>
</ul>
-<a name="N11227"></a><a name="Contributors+to+this+release-N11227"></a>
+<a name="N11242"></a><a name="Contributors+to+this+release-N11242"></a>
<h3 class="underlined_5">Contributors to this release</h3>
<p>We thank the following people for their contributions to this release.</p>
<p>This is a list of all people who participated as committers:<br>Bert Van Kets (BK), David Crossley (DC), Jeff Turner (JT), Nicola Ken Barozzi (NKB), Stefano Mazzocchi (SM), Steven Noels (SN).</p>
<p>This is a list of other contributors:<br>Bert Van Kets, Bruno Dumon, Kevin Ross, Leo Simons, Marc Portier, Peter Donald, Steven Noels.</p>
</div>

-<a name="N11236"></a><a name="all-committers"></a>
+<a name="N11251"></a><a name="all-committers"></a>
<h2 class="underlined_10">All Committers</h2>
<div class="section">
<p>This is a list of all people who have ever participated

Modified: forrest/site/docs_0_80/changes.pdf
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/changes.pdf?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
Binary files - no diff available.

Modified: forrest/site/docs_0_80/changes.rss
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/changes.rss?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/changes.rss (original)
+++ forrest/site/docs_0_80/changes.rss Thu Apr 5 00:40:14 2007
@@ -62,6 +62,32 @@
upgrading to v0.8
</description></item>

+ <item><title>docs add</title><link>changes.html</link><description>docs add
+ by
+ DC
+ :
+
+ Added notes to explain the main documentation,
+ as well as documentation and examples in each plugins and documentation
+ and examples in the 'forrest seed-sample' site.
+ </description></item>
+ <item><title>docs add</title><link>changes.html</link><description>docs add
+ by
+ DC
+ :
+
+ Added notes about configuring
+ a system-wide XML Catalog Entity Resolver to share local DTDs between multiple projects.
+ </description></item>
+ <item><title>docs add</title><link>changes.html</link><description>docs add
+ by
+ DC
+ :
+
+ Added notes about debugging
+ the XML Catalog Entity Resolver for local DTDs.
+ </description></item>
+
<item><title>code fix
(bug FOR-973)
</title><link>changes.html</link><description>code fix
@@ -5658,6 +5684,28 @@

Added document to facilitate
upgrading to v0.8
+ </description></item><item><title>docs add</title><link>changes.html</link><description>docs add
+ by
+ DC
+ :
+
+ Added notes to explain the main documentation,
+ as well as documentation and examples in each plugins and documentation
+ and examples in the 'forrest seed-sample' site.
+ </description></item><item><title>docs add</title><link>changes.html</link><description>docs add
+ by
+ DC
+ :
+
+ Added notes about configuring
+ a system-wide XML Catalog Entity Resolver to share local DTDs between multiple projects.
+ </description></item><item><title>docs add</title><link>changes.html</link><description>docs add
+ by
+ DC
+ :
+
+ Added notes about debugging
+ the XML Catalog Entity Resolver for local DTDs.
</description></item><item><title>code fix
(bug FOR-973)
</title><link>changes.html</link><description>code fix

Modified: forrest/site/docs_0_80/changes.xml
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/changes.xml?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/changes.xml (original)
+++ forrest/site/docs_0_80/changes.xml Thu Apr 5 00:40:14 2007
@@ -385,6 +385,16 @@
Added document to facilitate
<link href="site:upgrading_08">upgrading to v0.8</link>
Committed by DC.</li><li><icon alt="add" src="../images/add.jpg"/>
+ Added <link href="site:faq/docs">notes</link> to explain the main documentation,
+ as well as documentation and examples in each plugins and documentation
+ and examples in the 'forrest seed-sample' site.
+ Committed by DC.</li><li><icon alt="add" src="../images/add.jpg"/>
+ Added notes about <link href="site:validation/catalog">configuring</link>
+ a system-wide XML Catalog Entity Resolver to share local DTDs between multiple projects.
+ Committed by DC.</li><li><icon alt="add" src="../images/add.jpg"/>
+ Added notes about <link href="site:validation/debug-catalog">debugging</link>
+ the XML Catalog Entity Resolver for local DTDs.
+ Committed by DC.</li><li><icon alt="add" src="../images/add.jpg"/>
Added doc to explain
<link href="site:status-themes">Skins and Dispatcher status</link>.
Committed by DC.</li><li><icon alt="add" src="../images/add.jpg"/>

Modified: forrest/site/docs_0_80/dreams.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/dreams.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/dreams.html (original)
+++ forrest/site/docs_0_80/dreams.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Added: forrest/site/docs_0_80/error_site_your-project/catalog
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/error_site_your-project/catalog?view=auto&rev=525747
==============================================================================
--- forrest/site/docs_0_80/error_site_your-project/catalog (added)
+++ forrest/site/docs_0_80/error_site_your-project/catalog Thu Apr 5 00:40:14 2007
@@ -0,0 +1,12 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html xmlns:ex="http://apache.org/cocoon/exception/1.0">
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Exception</title>
+</head>
+<body>
+<h1>An Error Occurred</h1>
+<p>No pipeline matched request: docs_0_80/error:site:your-project/catalog</p>
+<p>More information can be found in the logs.</p>
+</body>
+</html>

Modified: forrest/site/docs_0_80/faq.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/faq.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/faq.html (original)
+++ forrest/site/docs_0_80/faq.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">
@@ -332,29 +332,32 @@
<a href="#overview">1.2. Where can I read an overview about how to work with Forrest? </a>
</li>
<li>
-<a href="#requirements">1.3. What are the system requirements for Forrest? </a>
+<a href="#docs">1.3. Where is all of the documentation?</a>
</li>
<li>
-<a href="#cvs">1.4. The old xml-forrest CVS code repository seems to be stale. What happened? </a>
+<a href="#requirements">1.4. What are the system requirements for Forrest? </a>
</li>
<li>
-<a href="#svn">1.5. How can I use SVN to keep up to date with the latest codebase? </a>
+<a href="#cvs">1.5. The old xml-forrest CVS code repository seems to be stale. What happened? </a>
</li>
<li>
-<a href="#older-plugins">1.6. How to use older versions of specific plugins? </a>
+<a href="#svn">1.6. How can I use SVN to keep up to date with the latest codebase? </a>
</li>
<li>
-<a href="#single-document">1.7. What is the best way to generate "standalone documents" using Forrest? </a>
+<a href="#older-plugins">1.7. How to use older versions of specific plugins? </a>
</li>
<li>
-<a href="#cygwin_mutex_error">1.8. When running ./build.sh in cygwin, I get an error: cygpath.exe:
+<a href="#single-document">1.8. What is the best way to generate "standalone documents" using Forrest? </a>
+</li>
+<li>
+<a href="#cygwin_mutex_error">1.9. When running ./build.sh in cygwin, I get an error: cygpath.exe:
*** can't create title mutex, Win32 error 6. </a>
</li>
<li>
-<a href="#maxmemory">1.9. How can I specify the amount of memory to be used by Java? </a>
+<a href="#maxmemory">1.10. How can I specify the amount of memory to be used by Java? </a>
</li>
<li>
-<a href="#debug">1.10. How can I start forrest in Java debug mode? </a>
+<a href="#debug">1.11. How can I start forrest in Java debug mode? </a>
</li>
</ul>
</li>
@@ -481,22 +484,31 @@
DTDs? </a>
</li>
<li>
-<a href="#skin">3.12. How to make the site look better and change its skin? </a>
+<a href="#project-dtd">3.12. How to configure the Catalog Entity Resolver to use my own local project DTDs?</a>
</li>
<li>
-<a href="#xsp">3.13. How do I enable XSP processing?</a>
+<a href="#local-catalog">3.13. We need an additional system-wide catalog to share DTDs between projects</a>
</li>
<li>
-<a href="#breadcrumbs">3.14. How do breadcrumbs work? Why don't they work locally?</a>
+<a href="#debug-catalog">3.14. How to debug the Catalog Entity Resolver and local DTDs?</a>
</li>
<li>
-<a href="#run_port">3.15. How do I make forrest run listen on a different port?</a>
+<a href="#skin">3.15. How to make the site look better and change its skin? </a>
</li>
<li>
-<a href="#debugging">3.16. Can I run Forrest with Java debugging turned on?</a>
+<a href="#xsp">3.16. How do I enable XSP processing?</a>
</li>
<li>
-<a href="#checksums">3.17. How do I enable Cocoon's document checksum feature?</a>
+<a href="#breadcrumbs">3.17. How do breadcrumbs work? Why don't they work locally?</a>
+</li>
+<li>
+<a href="#run_port">3.18. How do I make forrest run listen on a different port?</a>
+</li>
+<li>
+<a href="#debugging">3.19. Can I run Forrest with Java debugging turned on?</a>
+</li>
+<li>
+<a href="#checksums">3.20. How do I enable Cocoon's document checksum feature?</a>
</li>
</ul>
</li>
@@ -563,8 +575,30 @@
<div style="margin-left: 15px">
<p> See the <a href="../docs_0_80/your-project.html">Using Forrest</a> guide. </p>
</div>
-<a name="N10024"></a><a name="requirements"></a>
-<h4 class="faq">1.3. What are the system requirements for Forrest? </h4>
+<a name="N10024"></a><a name="docs"></a>
+<h4 class="faq">1.3. Where is all of the documentation?</h4>
+<div align="right">
+<a href="#docs-menu">^</a>
+</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.
+ </p>
+<p>
+ 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>.
+ </p>
+</div>
+<a name="N1003A"></a><a name="requirements"></a>
+<h4 class="faq">1.4. What are the system requirements for Forrest? </h4>
<div align="right">
<a href="#requirements-menu">^</a>
</div>
@@ -579,8 +613,8 @@
with Subversion or use a source snapshot) then you need the full JDK.
</p>
</div>
-<a name="N1002F"></a><a name="cvs"></a>
-<h4 class="faq">1.4. The old xml-forrest CVS code repository seems to be stale. What happened? </h4>
+<a name="N10045"></a><a name="cvs"></a>
+<h4 class="faq">1.5. The old xml-forrest CVS code repository seems to be stale. What happened? </h4>
<div align="right">
<a href="#cvs-menu">^</a>
</div>
@@ -588,8 +622,8 @@
<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="N10037"></a><a name="svn"></a>
-<h4 class="faq">1.5. How can I use SVN to keep up to date with the latest codebase? </h4>
+<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>
<div align="right">
<a href="#svn-menu">^</a>
</div>
@@ -598,8 +632,8 @@
<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="N1004A"></a><a name="older-plugins"></a>
-<h4 class="faq">1.6. How to use older versions of specific plugins? </h4>
+<a name="N10060"></a><a name="older-plugins"></a>
+<h4 class="faq">1.7. How to use older versions of specific plugins? </h4>
<div align="right">
<a href="#older-plugins-menu">^</a>
</div>
@@ -628,8 +662,8 @@
</p>
<pre class="code">project.required.plugins=org.apache.forrest.plugin.input.projectInfo-0.1,...</pre>
</div>
-<a name="N1006B"></a><a name="single-document"></a>
-<h4 class="faq">1.7. What is the best way to generate "standalone documents" using Forrest? </h4>
+<a name="N10081"></a><a name="single-document"></a>
+<h4 class="faq">1.8. What is the best way to generate "standalone documents" using Forrest? </h4>
<div align="right">
<a href="#single-document-menu">^</a>
</div>
@@ -678,8 +712,8 @@
Do 'forrest run' and then 'wget http://localhost:8888/index.pdf'.
</p>
</div>
-<a name="N10091"></a><a name="cygwin_mutex_error"></a>
-<h4 class="faq">1.8. When running ./build.sh in cygwin, I get an error: cygpath.exe:
+<a name="N100A7"></a><a name="cygwin_mutex_error"></a>
+<h4 class="faq">1.9. When running ./build.sh in cygwin, I get an error: cygpath.exe:
*** can't create title mutex, Win32 error 6. </h4>
<div align="right">
<a href="#cygwin_mutex_error-menu">^</a>
@@ -688,8 +722,8 @@
<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="N100A3"></a><a name="maxmemory"></a>
-<h4 class="faq">1.9. How can I specify the amount of memory to be used by Java? </h4>
+<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>
<div align="right">
<a href="#maxmemory-menu">^</a>
</div>
@@ -706,8 +740,8 @@
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="N100C0"></a><a name="debug"></a>
-<h4 class="faq">1.10. How can I start forrest in Java debug mode? </h4>
+<a name="N100D6"></a><a name="debug"></a>
+<h4 class="faq">1.11. How can I start forrest in Java debug mode? </h4>
<div align="right">
<a href="#debug-menu">^</a>
</div>
@@ -718,9 +752,9 @@

</p>
</div>
-<a name="N100D1"></a><a name="content_faqs"></a>
+<a name="N100E7"></a><a name="content_faqs"></a>
<h3 class="underlined_5">2. Content Creation</h3>
-<a name="N100D5"></a><a name="edit-content"></a>
+<a name="N100EB"></a><a name="edit-content"></a>
<h4 class="faq">2.1. What tools can be used to edit the content?</h4>
<div align="right">
<a href="#edit-content-menu">^</a>
@@ -736,7 +770,7 @@
you can use text editors or "html editors" such as the one provided with the Mozilla web
browser. </p>
</div>
-<a name="N100EF"></a><a name="site-xml"></a>
+<a name="N10105"></a><a name="site-xml"></a>
<h4 class="faq">2.2.
How to use the site.xml configuration file for menus and linking.
</h4>
@@ -778,7 +812,7 @@
</p>
<pre class="code">&lt;a href="site:docbook"&gt; link to the DocBook FAQ in the Tech FAQs</pre>
</div>
-<a name="N1011D"></a><a name="examples"></a>
+<a name="N10133"></a><a name="examples"></a>
<h4 class="faq">2.3.
Where are examples of documents and site.xml and tabs.xml files?
</h4>
@@ -792,7 +826,7 @@
forrest run</span>).
</p>
</div>
-<a name="N10128"></a><a name="crawler"></a>
+<a name="N1013E"></a><a name="crawler"></a>
<h4 class="faq">2.4.
Help, one of my documents is not being rendered.
</h4>
@@ -817,7 +851,7 @@

</p>
</div>
-<a name="N10136"></a><a name="PDF-output"></a>
+<a name="N1014C"></a><a name="PDF-output"></a>
<h4 class="faq">2.5. How can I generate one pdf-file out of the whole site or selected pages of the site?</h4>
<div align="right">
<a href="#PDF-output-menu">^</a>
@@ -837,7 +871,7 @@
<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="N10150"></a><a name="pageBreaks"></a>
+<a name="N10166"></a><a name="pageBreaks"></a>
<h4 class="faq">2.6. How do I insert page breaks into documents?</h4>
<div align="right">
<a href="#pageBreaks-menu">^</a>
@@ -865,7 +899,7 @@
page-break-after: always;
} </pre>
</div>
-<a name="N1016E"></a><a name="clickable-email-address"></a>
+<a name="N10184"></a><a name="clickable-email-address"></a>
<h4 class="faq">2.7. How can I generate html-pages to show a 'clickable' email-address (of the
author-element)?</h4>
<div align="right">
@@ -876,7 +910,7 @@
$FORREST_HOME/main/webapp/skins/common/xslt/html/document-to-html.xsl</span> and edit the
"headers/authors" template. </p>
</div>
-<a name="N10179"></a><a name="link_raw"></a>
+<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>
<div align="right">
<a href="#link_raw-menu">^</a>
@@ -886,7 +920,7 @@
<a href="../docs_0_70/upgrading_07.html#raw">Upgrading to Apache Forrest 0.7</a> for
all the details.</p>
</div>
-<a name="N10185"></a><a name="pdf_images"></a>
+<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>
<div align="right">
<a href="#pdf_images-menu">^</a>
@@ -918,7 +952,7 @@
<div class="content">Due to Sun's licensing, we cannot redistribute Jimi or JAI with Forrest.</div>
</div>
</div>
-<a name="N101B5"></a><a name="tab-index"></a>
+<a name="N101CB"></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">
@@ -937,7 +971,7 @@
&lt;map:redirect-to uri="manual/Introduction.html"/&gt;
&lt;/map:match&gt;</pre>
</div>
-<a name="N101D1"></a><a name="tab-site"></a>
+<a name="N101E7"></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>
@@ -947,7 +981,7 @@
See the <a href="../docs_0_80/linking.html#tab-site">tips</a>.
</p>
</div>
-<a name="N101DD"></a><a name="defaultFileName"></a>
+<a name="N101F3"></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">
@@ -977,7 +1011,7 @@

</ol>
</div>
-<a name="N10205"></a><a name="defaultStartPage"></a>
+<a name="N1021B"></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>
@@ -1008,7 +1042,7 @@

</ol>
</div>
-<a name="N10229"></a><a name="label-entity"></a>
+<a name="N1023F"></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>
@@ -1020,7 +1054,7 @@
</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="N10242"></a><a name="encoding"></a>
+<a name="N10258"></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>
@@ -1067,7 +1101,7 @@
Schlabach</a> and <a href="http://www.alanwood.net/unicode/">Alan Wood's Unicode
resources</a>. </p>
</div>
-<a name="N10294"></a><a name="xml-entities"></a>
+<a name="N102AA"></a><a name="xml-entities"></a>
<h4 class="faq">2.16. How to use XML entities, for example string
replacement?</h4>
<div align="right">
@@ -1083,7 +1117,7 @@
Avoid lengthy typing and potential spelling errors.
</p>
</div>
-<a name="N1029F"></a><a name="cleanSite"></a>
+<a name="N102B5"></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>
@@ -1102,7 +1136,7 @@
Doing 'forrest clean' will remove both sections.
</p>
</div>
-<a name="N102AA"></a><a name="i18n"></a>
+<a name="N102C0"></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>
@@ -1116,7 +1150,7 @@
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="N102BD"></a><a name="rawHTML"></a>
+<a name="N102D3"></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>
@@ -1161,7 +1195,7 @@

</ol>
</div>
-<a name="N102E9"></a><a name="javascript"></a>
+<a name="N102FF"></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>
@@ -1185,7 +1219,7 @@
&lt;map:resource name="skin-read"&gt; section.
</p>
</div>
-<a name="N102F7"></a><a name="linkmap"></a>
+<a name="N1030D"></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>
@@ -1212,9 +1246,9 @@
project.start-uri in the forrest.properties file.
</p>
</div>
-<a name="N10315"></a><a name="technical"></a>
+<a name="N1032B"></a><a name="technical"></a>
<h3 class="underlined_5">3. Technical</h3>
-<a name="N10319"></a><a name="java-code"></a>
+<a name="N1032F"></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>
@@ -1237,7 +1271,7 @@
with specialised purpose, e.g. PhotoGallery.
</p>
</div>
-<a name="N10327"></a><a name="populate-cache"></a>
+<a name="N1033D"></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>
@@ -1263,7 +1297,7 @@
<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="N10341"></a><a name="proxy_config"></a>
+<a name="N10357"></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">
@@ -1279,7 +1313,7 @@
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="N10365"></a><a name="CVS_revison_tags"></a>
+<a name="N1037B"></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>
@@ -1295,7 +1329,7 @@
When using Subversion, remember to set the relevant svn:keywords properties.
</p>
</div>
-<a name="N1037A"></a><a name="cli-xconf"></a>
+<a name="N10390"></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">
@@ -1333,7 +1367,7 @@
<strong>foo/**</strong> to match that. </div>
</div>
</div>
-<a name="N103B7"></a><a name="ignoring_javadocs"></a>
+<a name="N103CD"></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">
@@ -1344,7 +1378,7 @@
<span class="codefrag">cli.xconf</span>
</a> Cocoon config file, and defining patterns for URLs to exclude. </p>
</div>
-<a name="N103C6"></a><a name="claimed_patterns"></a>
+<a name="N103DC"></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>
@@ -1360,7 +1394,7 @@
with this issue (<a href="http://issues.apache.org/jira/browse/FOR-217">FOR-217</a>).
</p>
</div>
-<a name="N103D8"></a><a name="build_msg_a"></a>
+<a name="N103EE"></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">
@@ -1391,7 +1425,7 @@

</ul>
</div>
-<a name="N103F6"></a><a name="headless_operation"></a>
+<a name="N1040C"></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">
@@ -1404,7 +1438,7 @@
<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>
</div>
-<a name="N10412"></a><a name="project-logo-svg"></a>
+<a name="N10428"></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>
@@ -1424,7 +1458,7 @@
<a href="http://www.w3.org/Graphics/SVG/">SVG</a> resources.
</p>
</div>
-<a name="N1042A"></a><a name="catalog"></a>
+<a name="N10440"></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">
@@ -1434,8 +1468,40 @@
<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="N10436"></a><a name="skin"></a>
-<h4 class="faq">3.12. How to make the site look better and change its skin? </h4>
+<a name="N1044C"></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>
+</div>
+<div style="margin-left: 15px">
+<p>
+ See <a href="../docs_0_80/your-project.html#new_dtd">Using Forrest</a> for
+ configuration guidance.
+ </p>
+</div>
+<a name="N10458"></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>
+</div>
+<div style="margin-left: 15px">
+<p>
+ See <a href="error:site:your-project/catalog">Using Forrest</a> for
+ configuration guidance.
+ </p>
+</div>
+<a name="N10464"></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>
+</div>
+<div style="margin-left: 15px">
+<p>
+ See <a href="../docs_0_80/validation.html#debug-catalog">XML validation</a>.
+ </p>
+</div>
+<a name="N10470"></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>
@@ -1446,8 +1512,8 @@
<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="N1044D"></a><a name="xsp"></a>
-<h4 class="faq">3.13. How do I enable XSP processing?</h4>
+<a name="N10487"></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>
@@ -1494,8 +1560,8 @@
</ol>
<p>See also the <a href="http://wiki.apache.org/cocoon/AddingXSPToForrest">AddingXSPToForrest</a> Wiki page.</p>
</div>
-<a name="N10488"></a><a name="breadcrumbs"></a>
-<h4 class="faq">3.14. How do breadcrumbs work? Why don't they work locally?</h4>
+<a name="N104C2"></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>
@@ -1513,8 +1579,8 @@
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="N1049D"></a><a name="run_port"></a>
-<h4 class="faq">3.15. How do I make forrest run listen on a different port?</h4>
+<a name="N104D7"></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>
</div>
@@ -1529,8 +1595,8 @@

</p>
</div>
-<a name="N104B1"></a><a name="debugging"></a>
-<h4 class="faq">3.16. Can I run Forrest with Java debugging turned on?</h4>
+<a name="N104EB"></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>
@@ -1541,8 +1607,8 @@
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="N104C2"></a><a name="checksums"></a>
-<h4 class="faq">3.17. How do I enable Cocoon's document checksum feature?</h4>
+<a name="N104FC"></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>
@@ -1574,9 +1640,9 @@
installation-wide cli.xconf file.
</p>
</div>
-<a name="N104DE"></a><a name="old_faqs"></a>
+<a name="N10518"></a><a name="old_faqs"></a>
<h3 class="underlined_5">4. Older version: 0.6</h3>
-<a name="N104E2"></a><a name="old_claimed_patterns"></a>
+<a name="N1051C"></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>
@@ -1592,9 +1658,9 @@
with this issue (<a href="http://issues.apache.org/jira/browse/FOR-217">FOR-217</a>).
</p>
</div>
-<a name="N104F4"></a><a name="general"></a>
+<a name="N1052E"></a><a name="general"></a>
<h3 class="underlined_5">5. General</h3>
-<a name="N104F8"></a><a name="generating_menus"></a>
+<a name="N10532"></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>
@@ -1608,7 +1674,7 @@
<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="N10513"></a><a name="docbook"></a>
+<a name="N1054D"></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>
@@ -1704,7 +1770,7 @@
different DTDs, then see <a href="../docs_0_80/your-project.html#new_dtd">Using Forrest</a> for
configuration guidance. </p>
</div>
-<a name="N1054C"></a><a name="version"></a>
+<a name="N10586"></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">
@@ -1717,7 +1783,7 @@
watch the build messages. Doing <span class="codefrag">'forrest -v'</span> will provide verbose build
messages. </p>
</div>
-<a name="N10560"></a><a name="logs"></a>
+<a name="N1059A"></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>
@@ -1736,7 +1802,7 @@
<p> Doing <span class="codefrag">'forrest -v'</span> will provide verbose build messages to the standard
output. </p>
</div>
-<a name="N10584"></a><a name="how_can_I_help"></a>
+<a name="N105BE"></a><a name="how_can_I_help"></a>
<h4 class="faq">5.5. How to help? </h4>
<div align="right">
<a href="#how_can_I_help-menu">^</a>
@@ -1747,7 +1813,7 @@
particularly from newcomers&mdash;often, close proximity blinds software developers to
faults that are obvious to everyone else. Don't be shy! </p>
</div>
-<a name="N10590"></a><a name="patch"></a>
+<a name="N105CA"></a><a name="patch"></a>
<h4 class="faq">5.6. How to contribute a patch? </h4>
<div align="right">
<a href="#patch-menu">^</a>
@@ -1758,7 +1824,7 @@
<p>More info about contributing can be found at the <a href="../contrib.html">Contributing
to Forrest</a> page. It is always a good idea to check the Forrest <a href="../issues.html">issue tracker</a> before diving in. </p>
</div>
-<a name="N105AB"></a><a name="jobs"></a>
+<a name="N105E5"></a><a name="jobs"></a>
<h4 class="faq">5.7. How can job positions be advertised? </h4>
<div align="right">
<a href="#jobs-menu">^</a>

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

Modified: forrest/site/docs_0_80/faq.xml
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/faq.xml?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/faq.xml (original)
+++ forrest/site/docs_0_80/faq.xml Thu Apr 5 00:40:14 2007
@@ -20,7 +20,23 @@
</p>
</section><section id="overview"><title>1.2. Where can I read an overview about how to work with Forrest? </title>
<p> See the <link href="site:your-project">Using Forrest</link> guide. </p>
- </section><section id="requirements"><title>1.3. What are the system requirements for Forrest? </title>
+ </section><section id="docs"><title>1.3. Where is all of the documentation?</title>
+ <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.
+ </p>
+ <p>
+ Each <link href="site:plugins/index">plugin</link> 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
+ <link href="site:zone">testing zone</link>.
+ </p>
+ </section><section id="requirements"><title>1.4. What are the system requirements for Forrest? </title>
<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>
@@ -30,14 +46,14 @@
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>
- </section><section id="cvs"><title>1.4. The old xml-forrest CVS code repository seems to be stale. What happened? </title>
+ </section><section id="cvs"><title>1.5. The old xml-forrest CVS code repository seems to be stale. What happened? </title>
<p> Forrest switched from a CVS code repository to SVN (Subversion) code repository. The old
CVS repository is closed and not kept current. </p>
- </section><section id="svn"><title>1.5. How can I use SVN to keep up to date with the latest codebase? </title>
+ </section><section id="svn"><title>1.6. How can I use SVN to keep up to date with the latest codebase? </title>
<p> Follow these <link href="site:build">Building Forrest</link> notes. </p>
<p> The <link href="site:your-project">Using Forrest</link> guide provides further
step-by-step assistance in getting started with Forrest for your project. </p>
- </section><section id="older-plugins"><title>1.6. How to use older versions of specific plugins? </title>
+ </section><section id="older-plugins"><title>1.7. How to use older versions of specific plugins? </title>
<p>
Sometimes one does not want to use the most recent functionality
of a plugin and instead need to use an older version.
@@ -61,7 +77,7 @@
(due in version 0.8). So do this ...
</p>
<source xml:space="preserve">project.required.plugins=org.apache.forrest.plugin.input.projectInfo-0.1,...</source>
- </section><section id="single-document"><title>1.7. What is the best way to generate "standalone documents" using Forrest? </title>
+ </section><section id="single-document"><title>1.8. What is the best way to generate "standalone documents" using Forrest? </title>
<p>
There is a trick that can cut down your turnaround time
with building. In forrest.properties ...
@@ -111,11 +127,11 @@
to retrieve individual files, e.g.
Do 'forrest run' and then 'wget http://localhost:8888/index.pdf'.
</p>
- </section><section id="cygwin_mutex_error"><title>1.8. When running <code>./build.sh</code> in cygwin, I get an error: <code>cygpath.exe:
+ </section><section id="cygwin_mutex_error"><title>1.9. When running <code>./build.sh</code> in cygwin, I get an error: <code>cygpath.exe:
*** can't create title mutex, Win32 error 6</code>. </title>
<p> This <link href="http://issues.apache.org/jira/secure/ViewIssue.jspa?key=FOR-10">appears
to be a bug in cygwin</link>. Please use the .bat script instead. </p>
- </section><section id="maxmemory"><title>1.9. How can I specify the amount of memory to be used by Java? </title>
+ </section><section id="maxmemory"><title>1.10. How can I specify the amount of memory to be used by Java? </title>
<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>
@@ -126,7 +142,7 @@
<p> Set the <code>ANT_OPTS</code> environment variable before you run forrest. The exact
value you set it to is dependant on your JVM, but something like
<code>ANT_OPTS=-Xmx500M</code> will probably work. </p>
- </section><section id="debug"><title>1.10. How can I start forrest in Java debug mode? </title>
+ </section><section id="debug"><title>1.11. How can I start forrest in Java debug mode? </title>
<p> The <code>forrest.jvmargs</code> property in the <code>forrest.properties</code> file
can be used to start forrest in debug mode on a specific port.
<code>forrest.jvmargs=-Xdebug -Xrunjdwp:transport=dt_socket,address=8000,server=y,suspend=n</code>
@@ -607,13 +623,27 @@
DTDs? </title>
<p> Notes are provided for various tools at <link href="site:catalog">Using Catalog Entity
Resolver for local DTDs</link>. </p>
- </section><section id="skin"><title>3.12. How to make the site look better and change its skin? </title>
+ </section><section id="project-dtd"><title>3.12. How to configure the Catalog Entity Resolver to use my own local project DTDs?</title>
+ <p>
+ See <link href="site:your-project/new_dtd">Using Forrest</link> for
+ configuration guidance.
+ </p>
+ </section><section id="local-catalog"><title>3.13. We need an additional system-wide catalog to share DTDs between projects</title>
+ <p>
+ See <link href="site:your-project/catalog">Using Forrest</link> for
+ configuration guidance.
+ </p>
+ </section><section id="debug-catalog"><title>3.14. How to debug the Catalog Entity Resolver and local DTDs?</title>
+ <p>
+ See <link href="site:validation/debug-catalog">XML validation</link>.
+ </p>
+ </section><section id="skin"><title>3.15. How to make the site look better and change its skin? </title>
<p> There are <link href="site:skins">default skins</link> 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 <link href="site:your-project/skins">configuration</link> of the skins.
Some projects may have special needs and can define their <link href="site:your-project/new-skin">own skin</link>. </p>
- </section><section id="xsp"><title>3.13. How do I enable <acronym title="eXtensible Server Pages">XSP</acronym> processing?</title>
+ </section><section id="xsp"><title>3.16. How do I enable <acronym title="eXtensible Server Pages">XSP</acronym> processing?</title>
<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
@@ -643,7 +673,7 @@
</li>
</ol>
<p>See also the <link href="http://wiki.apache.org/cocoon/AddingXSPToForrest">AddingXSPToForrest</link> Wiki page.</p>
- </section><section id="breadcrumbs"><title>3.14. How do breadcrumbs work? Why don't they work locally?</title>
+ </section><section id="breadcrumbs"><title>3.17. How do breadcrumbs work? Why don't they work locally?</title>
<p>Breadcrumbs begin with up to three URLs specified in <code>skinconf.xml</code>. Here is
what the Forrest site uses:</p>
<source xml:space="preserve">
@@ -656,20 +686,20 @@
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 <code>skinconf.xml</code>. </p>
- </section><section id="run_port"><title>3.15. How do I make <code>forrest run</code> listen on a different port?</title>
+ </section><section id="run_port"><title>3.18. How do I make <code>forrest run</code> listen on a different port?</title>
<p>
<code>forrest run -Dforrest.jvmargs="-Djetty.port=80"</code>
</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 <code>forrest run</code>
</p>
- </section><section id="debugging"><title>3.16. Can I run Forrest with Java debugging turned on?</title>
+ </section><section id="debugging"><title>3.19. Can I run Forrest with Java debugging turned on?</title>
<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 <code>-Xdebug -Xrunjdwp:transport=dt_socket,address=8000,server=y,susp end=n</code>
to the <code>forrest.jvmargs</code> property in the <code>forrest.properties</code>
file. Don't forget to ensure the property is uncommented in that file.</p>
- </section><section id="checksums"><title>3.17. How do I enable Cocoon's document checksum feature?</title>
+ </section><section id="checksums"><title>3.20. How do I enable Cocoon's document checksum feature?</title>
<p>
Why might you want to do this? There is really no effect
on Cocoon processing, but a little time can be

Modified: forrest/site/docs_0_80/glossary.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/glossary.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/glossary.html (original)
+++ forrest/site/docs_0_80/glossary.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/howto/howto-asf-mirror.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/howto/howto-asf-mirror.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/howto/howto-asf-mirror.html (original)
+++ forrest/site/docs_0_80/howto/howto-asf-mirror.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../../docs_0_80/validation.html">XML Validation</a>
+<a href="../../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/howto/howto-buildPlugin.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/howto/howto-buildPlugin.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/howto/howto-buildPlugin.html (original)
+++ forrest/site/docs_0_80/howto/howto-buildPlugin.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../../docs_0_80/validation.html">XML Validation</a>
+<a href="../../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/howto/howto-corner-images.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/howto/howto-corner-images.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/howto/howto-corner-images.html (original)
+++ forrest/site/docs_0_80/howto/howto-corner-images.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../../docs_0_80/validation.html">XML Validation</a>
+<a href="../../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/howto/howto-custom-html-source.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/howto/howto-custom-html-source.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/howto/howto-custom-html-source.html (original)
+++ forrest/site/docs_0_80/howto/howto-custom-html-source.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../../docs_0_80/validation.html">XML Validation</a>
+<a href="../../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/howto/howto-editcss.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/howto/howto-editcss.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/howto/howto-editcss.html (original)
+++ forrest/site/docs_0_80/howto/howto-editcss.html Thu Apr 5 00:40:14 2007
@@ -224,7 +224,7 @@
<a href="../../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../../docs_0_80/validation.html">XML Validation</a>
+<a href="../../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/howto/howto-forrest-from-maven.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/howto/howto-forrest-from-maven.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/howto/howto-forrest-from-maven.html (original)
+++ forrest/site/docs_0_80/howto/howto-forrest-from-maven.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../../docs_0_80/validation.html">XML Validation</a>
+<a href="../../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/howto/howto-pdf-tab.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/howto/howto-pdf-tab.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/howto/howto-pdf-tab.html (original)
+++ forrest/site/docs_0_80/howto/howto-pdf-tab.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../../docs_0_80/validation.html">XML Validation</a>
+<a href="../../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/howto/index.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/howto/index.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/howto/index.html (original)
+++ forrest/site/docs_0_80/howto/index.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../../docs_0_80/validation.html">XML Validation</a>
+<a href="../../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/howto/multi/howto-multi.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/howto/multi/howto-multi.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/howto/multi/howto-multi.html (original)
+++ forrest/site/docs_0_80/howto/multi/howto-multi.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../../../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../../../docs_0_80/validation.html">XML Validation</a>
+<a href="../../../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/howto/multi/step1.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/howto/multi/step1.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/howto/multi/step1.html (original)
+++ forrest/site/docs_0_80/howto/multi/step1.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../../../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../../../docs_0_80/validation.html">XML Validation</a>
+<a href="../../../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/howto/multi/step2.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/howto/multi/step2.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/howto/multi/step2.html (original)
+++ forrest/site/docs_0_80/howto/multi/step2.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../../../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../../../docs_0_80/validation.html">XML Validation</a>
+<a href="../../../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/howto/multi/step3.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/howto/multi/step3.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/howto/multi/step3.html (original)
+++ forrest/site/docs_0_80/howto/multi/step3.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../../../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../../../docs_0_80/validation.html">XML Validation</a>
+<a href="../../../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/index.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/index.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/index.html (original)
+++ forrest/site/docs_0_80/index.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">
@@ -326,8 +326,15 @@
<p>In the <a href="howto/index.html">How-To</a> section you will find various
practical guides on how to achieve common objectives in Forrest.</p>

-<p>We also have a <a href="faq.html">FAQ</a> that you should consult before posting questions to
+<p>We also have a <a href="faq.html">FAQ</a> list that you should consult before posting questions to
our user list.</p>
+
+<p>
+ The documentation <a href="../linkmap.html">Table of Contents</a> provides a
+ useful overview of the main documentation. <a href="../docs_0_80/faq.html#docs">This FAQ</a>
+ explains that there is other documentation at the example forrest seed
+ site and that each plugin has its own documentation.
+ </p>

<p>
There are docs for

©2024 GT.net. A Gossamer Threads company.
5th Floor, 455 Granville St., Vancouver, BC V6C 1T1, Canada | Legal