Published release notes; tweaked resolver documentation

git-svn-id: https://svn.apache.org/repos/asf/xml/commons/trunk@226013 13f79535-47bb-0310-9956-ffa450edef68

java/docs/release-notes.xml

@@ -0,0 +1,74 @@
+<!DOCTYPE article
+  PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
+<article>
+<articleinfo>
+<title>org.apache.xml.resolver Release Notes</title>
+<subtitle>Version 1.1 CVS</subtitle>
+<pubdate>13 Nov 2002</pubdate>
+<releaseinfo role="meta">$Id$
+</releaseinfo>
+
+<author><firstname>Norman</firstname><surname>Walsh</surname>
+<affiliation>
+<jobtitle>Staff Engineer</jobtitle>
+<orgname>Sun Microsystems, XML Technology Center</orgname>
+</affiliation>
+<authorblurb>
+<para>Sun Microsystems supports Norm's active participation in a
+number of standards efforts worldwide, including the Technical
+Architecture Group, XML Core, and XSL Working Groups of the World Wide
+Web Consortium, the OASIS RELAX NG Committee,
+the Entity Resolution Committee, for which he is the editor, and
+the DocBook Technical Committee, which he chairs.</para>
+</authorblurb>
+</author>
+
+<copyright>
+  <year>2002</year>
+  <holder>Sun Microsystems, Inc.</holder>
+</copyright>
+</articleinfo>
+
+<para>This document offers a brief summary of what has changed in the
+Resolver package since the 1.0 release. I expect it'll be updated a few times
+before the next release.</para>
+
+<section>
+<title>The <classname>CatalogManager</classname> Is No Longer Static</title>
+
+<para>The most pervasive change is that the <classname>CatalogManager</classname>
+class is no longer static. It's now possible to instantiate several catalog
+managers and each manager can manage several catalogs.</para>
+
+<para>There is still a single static instance of the
+<classname>CatalogManager</classname>, available via
+<methodname>getStaticManager()</methodname>. This is used by default
+if no other catalog manager is instantiated and used. It behaves as
+the old static one used to.</para>
+
+</section>
+
+<section>
+<title>System Catalogs Are Always Loaded</title>
+
+<para>In the previous version, the system catalogs were not loaded if
+a private catalog was requested. That has changed; the system catalogs are now
+always loaded.</para>
+
+<para>If you want to avoid loading any system catalogs, establish your own
+<classname>CatalogManager</classname> and use the
+<methodname>setCatalogsFiles()</methodname> method to assure that no system
+catalogs are available.</para>
+
+</section>
+
+<section>
+<title>Tests/Examples Available</title>
+
+<para>There are several tests in the <filename>tests/resolver</filename> directory
+that demonstrate how different instantiations can be used.</para>
+
+</section>
+
+</article>

java/docs/resolver.xml

@@ -4,13 +4,22 @@
 <article>
 <articleinfo>
 <title>XML Entity and URI Resolvers</title>
-<subtitle>Version 1.2</subtitle>
+<subtitle>Version 1.3</subtitle>
-<pubdate>14 Jun 2001</pubdate>
+<pubdate>13 Nov 2002</pubdate>
 <releaseinfo role="meta">$Id$
 </releaseinfo>
 
+<!--
 <revhistory>
 <revision>
+<revnumber>1.3</revnumber>
+<date>13 Nov 2002</date>
+<authorinitials>ndw</authorinitials>
+<revremark>New notes.
+</revremark>
+</revision>
+<revision>
+<revision>
 <revnumber>1.2</revnumber>
 <date>14 Jun 2001</date>
 <authorinitials>ndw</authorinitials>
@@ -55,6 +64,7 @@ source code license.</revremark>
 <revremark>Initial draft.</revremark>
 </revision>
 </revhistory>
+-->
 
 <author><firstname>Norman</firstname><surname>Walsh</surname>
 <affiliation>
@@ -63,11 +73,11 @@ source code license.</revremark>
 </affiliation>
 <authorblurb>
 <para>Sun Microsystems supports Norm's active participation in a
-number of standards efforts worldwide, including the XML Core, XSL and
+number of standards efforts worldwide, including the Technical
-XML Schema Working Groups of the World Wide Web Consortium, the OASIS
+Architecture Group, XML Core, and XSL Working Groups of the World Wide
-XSLT Conformance and RELAX NG Committees, the OASIS Entity Resolution
+Web Consortium, the OASIS RELAX NG Committee,
-Committee, for which he is the editor, and the OASIS DocBook Technical
+the Entity Resolution Committee, for which he is the editor, and
-Committee, which he chairs.</para>
+the DocBook Technical Committee, which he chairs.</para>
 </authorblurb>
 </author>
 
@@ -821,7 +831,6 @@ Result: file:/share/documents/articles/sun/2001/01-resolver/example/example.dtd
 </screen>
 </example>
 
-
 </section>
 <section>
 <title>Using <command>xparse</command></title>