You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@cocoon.apache.org by cr...@apache.org on 2004/01/30 07:32:55 UTC
cvs commit: cocoon-2.0/src/webapp/resources/entities book-v01.rng roles-v01.rng sitemap-v06.rng
crossley 2004/01/29 22:32:55
Modified: src/documentation/xdocs/userdocs/concepts catalog.xml
sitemap-examples.xml validation.xml
src/java/org/apache/cocoon/components/resolver Resolver.java
src/webapp/resources/entities book-v01.rng roles-v01.rng
sitemap-v06.rng
Log:
Use my apache.org email address instead.
Revision Changes Path
1.5 +34 -12 cocoon-2.0/src/documentation/xdocs/userdocs/concepts/catalog.xml
Index: catalog.xml
===================================================================
RCS file: /home/cvs/cocoon-2.0/src/documentation/xdocs/userdocs/concepts/catalog.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- catalog.xml 26 Jun 2003 08:32:49 -0000 1.4
+++ catalog.xml 30 Jan 2004 06:32:54 -0000 1.5
@@ -8,7 +8,7 @@
<version>1.5</version>
<type>Technical document</type>
<authors>
- <person name="David Crossley" email="crossley@indexgeo.com.au"/>
+ <person name="David Crossley" email="crossley@apache.org"/>
</authors>
</header>
@@ -112,16 +112,17 @@
<p>
The following article eloquently describes the need for all parsers and
XML frameworks to be capable of utilising entity resolvers.
- "<link href="http://www.arbortext.com/Think_Tank/XML_Resources/Issue_Three/issue_three.html">If You Can Name It, You Can Claim It!</link>"
- by Norman Walsh. Please read that document, then return here to apply
- entity catalogs to Cocoon.
+ "<link href="http://xml.apache.org/commons/components/resolver/">XML Entity
+ and URI Resolvers</link>" by Norman Walsh. Please read that document,
+ then return here to apply entity catalogs to Cocoon.
</p>
<p>
- (Note: That article (and Java classes) evolved to become the
- <code>resolver.zip</code> Java package that has been added to Cocoon
- - a more recent version of the article is available at the XML Commons site
- (see below). The API javadocs for <code>resolver</code> have further information.
+ (Note: The <link href="http://xml.apache.org/commons/">Apache XML
+ Commons</link> project provides the Java package that has been added to
+ Cocoon as the <code>lib/core/resolver.jar</code> package.
+ There are also
+ API javadocs for <code>resolver</code> that have further information.
However, you do not need to know the gory details to understand catalogs
and configure them.)
</p>
@@ -531,7 +532,9 @@
</p>
<p>
- The XML Commons Apache project has <code>org.apache.xml.resolver</code>
+ The
+ <link href="http://xml.apache.org/commons/">Apache XML Commons</link>
+ project has <code>org.apache.xml.resolver</code>
which provides a <strong>CatalogResolver</strong>. This is incorporated
into Cocoon via <code>org.apache.cocoon.components.resolver</code>
</p>
@@ -543,7 +546,25 @@
The <code>ResolverImpl.java</code> enables <link href="#config">local
configuration</link> by applying properties from the
<code>CatalogManager.properties</code> file and then further configuration
- from <code>cocoon.xconf</code> parameters.
+ from <code>cocoon.xconf</code> parameters (which are specified prior to
+ the build in
+ <code>src/java/org/apache/cocoon/components/resolver/resolver.xconf</code>).
+ </p>
+ </s1>
+
+ <anchor id="debug"/>
+ <s1 title="Debugging the resolver configuration">
+ <p>
+ Raise the verbosity level as described in cocoon.xconf and watch the
+ messages that go to standard output. For example, with Tomcat-4.0 they
+ will be in the <code>$CATALINA_HOME/logs/catalina.out</code> logfile.
+ </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>
</s1>
@@ -634,8 +655,9 @@
<br/> - Issue Three:
<link href="http://www.arbortext.com/Think_Tank/XML_Resources/Issue_Three/issue_three.html">If You Can Name It, You Can Claim It!</link></li>
<li>
- The Apache project
- <link href="http://xml.apache.org/commons/">XML Commons</link> provides the
+ The
+ <link href="http://xml.apache.org/commons/">Apache XML Commons</link>
+ project provides the
"XML Entity and URI Resolvers Java classes" and evolution
of the Arbortext article.
</li>
1.2 +1 -1 cocoon-2.0/src/documentation/xdocs/userdocs/concepts/sitemap-examples.xml
Index: sitemap-examples.xml
===================================================================
RCS file: /home/cvs/cocoon-2.0/src/documentation/xdocs/userdocs/concepts/sitemap-examples.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- sitemap-examples.xml 9 Mar 2003 00:01:11 -0000 1.1
+++ sitemap-examples.xml 30 Jan 2004 06:32:54 -0000 1.2
@@ -8,7 +8,7 @@
<version>0.1</version>
<type>Technical document</type>
<authors>
- <person name="David Crossley" email="crossley@indexgeo.com.au"/>
+ <person name="David Crossley" email="crossley@apache.org"/>
</authors>
</header>
1.3 +1 -1 cocoon-2.0/src/documentation/xdocs/userdocs/concepts/validation.xml
Index: validation.xml
===================================================================
RCS file: /home/cvs/cocoon-2.0/src/documentation/xdocs/userdocs/concepts/validation.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- validation.xml 31 May 2003 05:21:48 -0000 1.2
+++ validation.xml 30 Jan 2004 06:32:54 -0000 1.3
@@ -8,7 +8,7 @@
<version>0.2</version>
<type>Technical document</type>
<authors>
- <person name="David Crossley" email="crossley@indexgeo.com.au"/>
+ <person name="David Crossley" email="crossley@apache.org"/>
<person name="Colin Adams" email="colin@colina.demon.co.uk"/>
</authors>
</header>
1.2 +2 -2 cocoon-2.0/src/java/org/apache/cocoon/components/resolver/Resolver.java
Index: Resolver.java
===================================================================
RCS file: /home/cvs/cocoon-2.0/src/java/org/apache/cocoon/components/resolver/Resolver.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- Resolver.java 9 Mar 2003 00:02:26 -0000 1.1
+++ Resolver.java 30 Jan 2004 06:32:54 -0000 1.2
@@ -61,7 +61,7 @@
* @deprecated Use the Avalon Excalibur EntityResolver instead
*
* @author <a href="mailto:dims@yahoo.com">Davanum Srinivas</a>
- * @author <a href="mailto:crossley@indexgeo.com.au">David Crossley</a>
+ * @author <a href="mailto:crossley@apache.org">David Crossley</a>
* @version CVS $Id$
*/
public interface Resolver extends Component, EntityResolver {
1.2 +1 -1 cocoon-2.0/src/webapp/resources/entities/book-v01.rng
Index: book-v01.rng
===================================================================
RCS file: /home/cvs/cocoon-2.0/src/webapp/resources/entities/book-v01.rng,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- book-v01.rng 9 Mar 2003 00:06:09 -0000 1.1
+++ book-v01.rng 30 Jan 2004 06:32:54 -0000 1.2
@@ -12,7 +12,7 @@
NOTES:
AUTHORS:
- David Crossley <cr...@indexgeo.com.au>
+ David Crossley <cr...@apache.org>
FIXME:
-
1.2 +1 -1 cocoon-2.0/src/webapp/resources/entities/roles-v01.rng
Index: roles-v01.rng
===================================================================
RCS file: /home/cvs/cocoon-2.0/src/webapp/resources/entities/roles-v01.rng,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- roles-v01.rng 9 Mar 2003 00:06:10 -0000 1.1
+++ roles-v01.rng 30 Jan 2004 06:32:54 -0000 1.2
@@ -12,7 +12,7 @@
NOTES:
AUTHORS:
- David Crossley <cr...@indexgeo.com.au>
+ David Crossley <cr...@apache.org>
FIXME:
-
1.2 +1 -1 cocoon-2.0/src/webapp/resources/entities/sitemap-v06.rng
Index: sitemap-v06.rng
===================================================================
RCS file: /home/cvs/cocoon-2.0/src/webapp/resources/entities/sitemap-v06.rng,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- sitemap-v06.rng 9 Mar 2003 00:06:10 -0000 1.1
+++ sitemap-v06.rng 30 Jan 2004 06:32:54 -0000 1.2
@@ -32,7 +32,7 @@
AUTHORS:
Jeffrey Ricker NG (Usonia Holdings) <ri...@usonia.net>
- David Crossley <cr...@indexgeo.com.au>
+ David Crossley <cr...@apache.org>
Colin Paul Adams <co...@colina.demon.co.uk>
Bruno Dumon <br...@outerthought.org>