Author: crossley
Date: Wed Apr  4 23:49:10 2007
New Revision: 525731

URL: http://svn.apache.org/viewvc?view=rev&rev=525731
Log:
Add notes about using a system-wide catalog to share DTDs between multiple projects.

Modified:
    forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml
    forrest/trunk/site-author/content/xdocs/docs_0_80/validation.xml
    forrest/trunk/site-author/content/xdocs/site.xml
    forrest/trunk/site-author/status.xml

Modified: forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml?view=diff&rev=525731&r1=525730&r2=525731
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml Wed Apr  4 23:49:10 2007
@@ -822,10 +822,19 @@
       </answer>
     </faq>
     <faq id="project-dtd">
-      <question>How to configure the Catalog Entity Resolver to use my own local DTDs?</question>
+      <question>How to configure the Catalog Entity Resolver to use my own local project DTDs?</question>
       <answer>
         <p>
           See <link href="site:your-project/new_dtd">Using Forrest</link> for
+          configuration guidance.
+        </p>
+      </answer>
+    </faq>
+    <faq id="local-catalog">
+      <question>We need an additional system-wide catalog to share DTDs between projects</question>
+      <answer>
+        <p>
+          See <link href="site:your-project/catalog">Using Forrest</link> for
           configuration guidance.
         </p>
       </answer>

Modified: forrest/trunk/site-author/content/xdocs/docs_0_80/validation.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/docs_0_80/validation.xml?view=diff&rev=525731&r1=525730&r2=525731
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_80/validation.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_80/validation.xml Wed Apr  4 23:49:10 2007
@@ -254,9 +254,16 @@
         <p>
           Forrest provides a standard catalog file at
           <code>forrest/main/webapp/resources/schema/catalog.xcat</code>
-          for the document
-          types that Forrest provides.  Projects can augment this with their
-          own catalog file located in
+          for the document types that Forrest supplies.
+        </p>
+
+        <p>
+          An additional system-wide catalog can be configured for use by multiple forrest-based projects.
+          See the "local-catalog" parameter in <code>main/webapp/WEB-INF/xconf/forrest-core.xconf</code>
+        </p>
+
+        <p>
+          Projects can augment this with their own catalog file located in
           <code>${project.schema-dir}/catalog.xcat</code> to use it you must
 	    specify either the path (full or relative) to your 
 	    <code>catalog.xcat</code> in the <code>CatalogManager.properties</code>
@@ -267,7 +274,7 @@
           When Cocoon starts, it reads the <code>CatalogManager.properties</code> file from your
           <code>project.classes-dir</code>. This is usually src/documentation/classes/
           but you can change this in <code>forrest.properties</code>. When you seed 
-          a new site using <code>forrest seed-site</code> a sample catalog file
+          a new site using <code>forrest seed</code> a sample catalog file
           is placed in the site structure, you can use this as a template for your
           own files.
         </p>

Modified: forrest/trunk/site-author/content/xdocs/site.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/site.xml?view=diff&rev=525731&r1=525730&r2=525731
==============================================================================
--- forrest/trunk/site-author/content/xdocs/site.xml (original)
+++ forrest/trunk/site-author/content/xdocs/site.xml Wed Apr  4 23:49:10 2007
@@ -370,6 +370,7 @@
               <status-themes label="Dispatcher versus Skins" href="status-themes.html"/>
               <cap label="Sourcetype Action" href="cap.html"/>
               <validation label="XML Validation" href="validation.html">
+                <catalog href="#catalog"/>
                 <debug-catalog href="#debug-catalog"/>
               </validation>
          </whitepapers>

Modified: forrest/trunk/site-author/status.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/status.xml?view=diff&rev=525731&r1=525730&r2=525731
==============================================================================
--- forrest/trunk/site-author/status.xml (original)
+++ forrest/trunk/site-author/status.xml Wed Apr  4 23:49:10 2007
@@ -148,6 +148,10 @@
         and examples in the 'forrest seed-sample' site.
       </action>
       <action dev="DC" type="add" context="docs">
+        Added notes about <link href="site:validation/catalog">configuring</link>
+        a system-wide XML Catalog Entity Resolver to share local DTDs between multiple projects.
+      </action>
+      <action dev="DC" type="add" context="docs">
         Added notes about <link href="site:validation/debug-catalog">debugging</link>
         the XML Catalog Entity Resolver for local DTDs.
       </action>