svn commit: r155764 - forrest/trunk/docs-author/content/xdocs/validation.xml

[rg...@apache.org]

Author: rgardler
Date: Tue Mar  1 02:13:35 2005
New Revision: 155764

URL: http://svn.apache.org/viewcvs?view=rev&rev=155764
Log:
document ability to use relative paths in catalog.xcat files

Modified:
    forrest/trunk/docs-author/content/xdocs/validation.xml

Modified: forrest/trunk/docs-author/content/xdocs/validation.xml
URL: http://svn.apache.org/viewcvs/forrest/trunk/docs-author/content/xdocs/validation.xml?view=diff&r1=155763&r2=155764
==============================================================================
--- forrest/trunk/docs-author/content/xdocs/validation.xml (original)
+++ forrest/trunk/docs-author/content/xdocs/validation.xml Tue Mar  1 02:13:35 2005
@@ -273,7 +273,19 @@
           for the document
           types that Forrest provides.  Projects can augment this with their
           own catalog file located in
-          <code>${project.schema-dir}/catalog.xcat</code>
+          <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>
+	    file. If you provide a relative path you must set the property 
+	    <code>relative-catalogs</code> to "yes".
+	  </p>
+        <p>
+          When Cocoon starts, it reads the <code>catalog.xcat</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
+          is placed in the site structure, you can use this as a template for your
+          own files.
         </p>
         <p>
           Forrest uses the XML Catalog syntax by default, although the older
@@ -292,14 +304,6 @@
           spec</link>, and is fairly simple and very powerful.
           The "<code>public</code>" elements map
           a public identifier to a DTD (relative to the catalog file).
-        </p>
-        <p>
-          Next specify the full path to your <code>catalog.xcat</code> in the
-          <code>CatalogManager.properties</code> file.
-          When Cocoon starts, it reads this file from your
-          <code>project.classes-dir</code> (usually src/documentation/classes/).
-          If you don't have such a file, then copy a default file from a
-          fresh 'forrest seed site'.
         </p>
         <p>
           We now have a custom DTD and a catalog mapping which lets both