forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r525737 - in /forrest/trunk/site-author/content/xdocs: docs_0_80/validation.xml site.xml
Date Thu, 05 Apr 2007 07:20:10 GMT
Author: crossley
Date: Thu Apr  5 00:20:09 2007
New Revision: 525737

Give this document a better title "XML validation and entity resolution" to reflect its content.
Add introduction about various aspects of the xml framework.


Modified: forrest/trunk/site-author/content/xdocs/docs_0_80/validation.xml
--- forrest/trunk/site-author/content/xdocs/docs_0_80/validation.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_80/validation.xml Thu Apr  5 00:20:09 2007
@@ -25,11 +25,33 @@
-    <title>XML Validation</title>
+    <title>XML validation and entity resolution</title>
     <subtitle>DTDs, catalogs and whatnot</subtitle>
+    <section id="intro">
+      <title>Introduction</title>
+      <p>
+        When a source document uses a DTD to define its structure, then various abilities
are enabled. Forrest handles the annoying side of this and takes advantage of the benefits.
+      </p>
+      <p>
+        The xml parser must locate the DTDs and other entities. Forrest uses the XML
+        Catalog Entity Resolver to associate DTD references with local copies.
+      </p>
+      <p>
+        Forrest also uses the XML Document Type Declaration to effect the
+        <link href="site:cap">Content Aware Pipelines</link>. Remember that you
+        not required to use DTDs (for example Forrest can also respond to a namespace)
+        so RELAX NG or W3c XML Schema can be used.
+      </p>
+      <p>
+        If you do use DTDs, then forrest is automatically configured to do XML validation.
+      </p>
+      <p>
+        This document explains both the validation and entity resolution aspects of the Forrest
XML framework.
+      </p>
+    </section>
     <section id="xml_validation">
       <title>XML validation</title>

Modified: forrest/trunk/site-author/content/xdocs/site.xml
--- forrest/trunk/site-author/content/xdocs/site.xml (original)
+++ forrest/trunk/site-author/content/xdocs/site.xml Thu Apr  5 00:20:09 2007
@@ -369,7 +369,7 @@
               <skins label="Skins" href="skins.html" description="About default skins,
their naming and features"/>
               <status-themes label="Dispatcher versus Skins" href="status-themes.html"/>
               <cap label="Sourcetype Action" href="cap.html"/>
-              <validation label="XML Validation" href="validation.html">
+              <validation label="XML validation and entity resolution" href="validation.html">
                 <catalog href="#catalog"/>
                 <debug-catalog href="#debug-catalog"/>

View raw message