crossley 2004/01/18 01:33:33
Modified: site/2.1/userdocs/concepts catalog.html catalog.pdf
Log:
Add section about "Debugging".
Revision Changes Path
1.10 +40 -9 cocoon-site/site/2.1/userdocs/concepts/catalog.html
Index: catalog.html
===================================================================
RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/concepts/catalog.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- catalog.html 7 Jan 2004 03:11:29 -0000 1.9
+++ catalog.html 18 Jan 2004 09:33:33 -0000 1.10
@@ -307,6 +307,9 @@
<a href="#Implementation+notes">Implementation notes</a>
</li>
<li>
+<a href="#Debugging+the+resolver+configuration">Debugging the resolver
configuration</a>
+</li>
+<li>
<a href="#Development+notes">Development notes</a>
</li>
<li>
@@ -454,7 +457,8 @@
<p>
(Note: The <a href="http://xml.apache.org/commons/";>Apache XML
Commons</a> project provides the Java package that has been added to
- Cocoon as the <span class="codefrag">lib/core/resolver.jar</span>
package. There are also
+ Cocoon as the <span
class="codefrag">lib/core/xml-commons-resolver.jar</span> package.
+ There are also
API javadocs for <span class="codefrag">resolver</span> that have further
information.
However, you do not need to know the gory details to understand catalogs
and configure them.)
@@ -892,7 +896,9 @@
</p>
<p>
- The XML Commons Apache project has <span
class="codefrag">org.apache.xml.resolver</span>
+ The
+ <a href="http://xml.apache.org/commons/";>Apache XML Commons</a>
+ project has <span class="codefrag">org.apache.xml.resolver</span>
which provides a <strong>CatalogResolver</strong>. This is incorporated
into Cocoon via <span
class="codefrag">org.apache.excalibur.xml.EntityResolver</span>
@@ -905,13 +911,31 @@
The <span class="codefrag">DefaultResolver.java</span> enables <a
href="#config">local
configuration</a> by applying properties from the
<span class="codefrag">CatalogManager.properties</span> file and then
further configuration
- from <span class="codefrag">cocoon.xconf</span> parameters.
+ from <span class="codefrag">WEB-INF/cocoon.xconf</span> parameters.
+ </p>
+</div>
+
+
+<a name="debug"></a>
+ <a name="N10238"></a><a name="Debugging+the+resolver+configuration"></a>
+<h3>Debugging the resolver configuration</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ Raise the verbosity level as described in cocoon.xconf and watch the
+ messages that go to standard output.
+ </p>
+<p>
+ The "Resolved public" messages should show that the Public Identifiers
+ are being used to find the local copies of the resources. If a "Resolved
+ public" message does not occur for a particular resource, then Cocoon
+ will be retrieving it from the specified location. Use a packet watching
+ tool like "ngrep" to see the HTTP request for the resource.
</p>
</div>
<a name="dev"></a>
- <a name="N10234"></a><a name="Development+notes"></a>
+ <a name="N10247"></a><a name="Development+notes"></a>
<h3>Development notes</h3>
<div style="margin-left: 0 ; border: 2px">
<ul>
@@ -926,7 +950,7 @@
<a name="notes"></a>
- <a name="N10247"></a><a name="Other+notes"></a>
+ <a name="N1025A"></a><a name="Other+notes"></a>
<h3>Other notes</h3>
<div style="margin-left: 0 ; border: 2px">
<ul>
@@ -957,7 +981,7 @@
<a name="summ"></a>
- <a name="N10260"></a><a name="Summary"></a>
+ <a name="N10273"></a><a name="Summary"></a>
<h3>Summary</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -983,7 +1007,7 @@
<a name="info"></a>
- <a name="N10272"></a><a name="Further+information"></a>
+ <a name="N10285"></a><a name="Further+information"></a>
<h3>Further information</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -1024,8 +1048,9 @@
</li>
<li>
- The Apache project
- <a href="http://xml.apache.org/commons/";>XML Commons</a> provides the
+ The
+ <a href="http://xml.apache.org/commons/";>Apache XML Commons</a>
+ project provides the
entity resolver Java classes (which are used in Cocoon) and evolution of
the Arbortext article into
<a href="http://xml.apache.org/commons/components/resolver/";>XML
@@ -1042,6 +1067,12 @@
<a href="http://www.docbook.org/";>The Definitive Guide</a>
- Section 2.3 Public Identifiers, System Identifiers, and Catalog Files
</li>
+
+<li>
+ FAQ <a href="http://www.dpawson.co.uk/docbook/catalogs.html";>Catalogs
+ and Docbook</a>
+
+</li>
<li>OASIS is the <a href="http://www.oasis-open.org/docbook/";>official
home</a> of the DocBook DTDs
1.6 +373 -331 cocoon-site/site/2.1/userdocs/concepts/catalog.pdf
<<Binary file>>
