Author: crossley
Date: Thu Apr 5 00:20:09 2007
New Revision: 525737
URL: http://svn.apache.org/viewvc?view=rev&rev=525737
Log:
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/site.xml
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=525737&r1=525736&r2=525737
==============================================================================
--- 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 @@
<document>
<header>
- <title>XML Validation</title>
+ <title>XML validation and entity resolution</title>
<subtitle>DTDs, catalogs and whatnot</subtitle>
</header>
<body>
+ <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 are
+ 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>
<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=525737&r1=525736&r2=525737
==============================================================================
--- 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"/>
</validation>
