cocoon-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject cvs commit: cocoon-site/site/2.1/userdocs/concepts catalog.html catalog.pdf
Date Sun, 18 Jan 2004 09:33:33 GMT
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>>
  
  

Mime
View raw message