prepare docs for 1.3.8 release (#184)

README.md

@@ -10,7 +10,7 @@ XOM is fairly unique in that it is a dual streaming/tree-based API. Individual n
 
 XOM is very memory efficient. If you read an entire document into memory, XOM uses as little memory as possible. More importantly, XOM allows you to filter documents as they're built so you don't have to build the parts of the tree you aren't interested in. For instance, you can skip building text nodes that only represent boundary white space, if such white space is not significant in your application. You can even process a document piece by piece and throw away each piece when you're done with it. XOM has been used to process documents that are gigabytes in size.
 
-The current version of XOM is 1.3.7 and is backwards compatible with 1.2, 1.1 and 1.0. You should not need to recompile any code to upgrade to 1.3.7. XOM is believed to be quite stable and robust. Future releases should be backwards compatible with the 1.0 API for the foreseeable future.
+The current version of XOM is 1.3.8 and is backwards compatible with 1.2, 1.1 and 1.0. You should not need to recompile any code to upgrade to 1.3.8. XOM is believed to be quite stable and robust. Future releases should be backwards compatible with the 1.0 API for the foreseeable future.
 
 ## Adding XOM to your build
 
@@ -20,15 +20,15 @@ XOM's Maven group ID is `xom` and its artifact ID is `xom`. To add a dependency
 <dependency>
   <groupId>xom</groupId>
   <artifactId>xom</artifactId>
-  <version>1.3.7</version>
+  <version>1.3.8</version>
 </dependency>
 ```
 
 To add a dependency using Gradle:
 
 ```gradle
 dependencies {
-  compile 'xom:xom:1.3.7'
+  compile 'xom:xom:1.3.8'
 }
 ```
 

README.txt

@@ -2,10 +2,10 @@ XOM is a library. By itself, it doesn't do much of anything. It exists
 only to be used by other programs. It requires Java 1.6 or later. 
 
 To install it you'll need to place the XOM JAR archive somewhere in your
-CLASSPATH. This archive is the file named something like xom-1.3.7.jar. 
+CLASSPATH. This archive is the file named something like xom-1.3.8.jar. 
 (The version number may have changed if I've forgotten
 to update this document.) You can either put it in your jre/lib/ext
-directory, add xom-1.3.7.jar to your CLASSPATH environment variable, or
+directory, add xom-1.3.8.jar to your CLASSPATH environment variable, or
 use the -classpath option when invoking javac and java.
 
 To check your download you can run one of the sample programs found in
@@ -14,16 +14,16 @@ class formats an XML document by inserting and removing white space
 around element boundaries. You can run it from the
 command line like this:
 
-$ java -classpath xom-samples.jar:xom-1.3.7.jar nu.xom.samples.PrettyPrinter filename.xml
+$ java -classpath xom-samples.jar:xom-1.3.8.jar nu.xom.samples.PrettyPrinter filename.xml
 
 XOM's supporting libraries including xalan.jar, xercesImpl.jar, and xml-apis.jar, 
 are found in the lib directory. The versions shipped with XOM 
 are quite a bit faster and less buggy than the ones bundled with the JDK, 
 so you may well want to use them. For example,
 
-$ java -classpath xom-samples.jar:xom-1.3.7.jar:lib/xml-apis.jar:lib/xercesImpl.jar:lib/xalan.jar nu.xom.samples.PrettyPrinter filename.xml
+$ java -classpath xom-samples.jar:xom-1.3.8.jar:lib/xml-apis.jar:lib/xercesImpl.jar:lib/xalan.jar nu.xom.samples.PrettyPrinter filename.xml
 
-You could leave out xalan.jar if you don't use any of the classes in
+You can leave out xalan.jar if you don't use any of the classes in
 nu.xom.xslt. junit.jar is only used for testing, and is
 not needed for normal operation of XOM.
 
@@ -33,7 +33,7 @@ should be as simple as typing "ant compile" or "ant jar" in the xom
 directory. Type "ant help" to see other possible options.
 
 =======================================================================
-XOM is Copyright 2004, 2005, 2009, 2018, 2019, 2020, 2021 Elliotte Rusty Harold
+XOM is Copyright 2004, 2005, 2009, 2018-2022 Elliotte Rusty Harold
 
    This library is free software; you can redistribute it and/or modify
    it under the terms of version 2.1 of the GNU Lesser General Public 

RELEASING.md

@@ -7,6 +7,7 @@ Add release notes to
 
 Update the version number in
 
+* RELEASING.md (this file)
 * README.md
 * README.txt
 * build.xml
@@ -25,13 +26,13 @@ Update the version number in
 7. Sign the files:
 
   ```
-  $ gpg -ab xom-1.3.6.pom
-  $ gpg -ab xom-1.3.6.jar
-  $ gpg -ab xom-1.3.6-javadoc.jar
-  $ gpg -ab xom-1.3.6-sources.jar
+  $ gpg -ab xom-1.3.8.pom
+  $ gpg -ab xom-1.3.8.jar
+  $ gpg -ab xom-1.3.8-javadoc.jar
+  $ gpg -ab xom-1.3.8-sources.jar
   ```
 
-8. `$ jar -cvf bundle.jar xom-1.3.6.pom xom-1.3.6.pom.asc xom-1.3.6.jar xom-1.3.6.jar.asc xom-1.3.6-javadoc.jar xom-1.3.6-javadoc.jar.asc xom-1.3.6-sources.jar xom-1.3.6-sources.jar.asc`
+8. `$ jar -cvf bundle.jar xom-1.3.8.pom xom-1.3.8.pom.asc xom-1.3.8.jar xom-1.3.8.jar.asc xom-1.3.8-javadoc.jar xom-1.3.8-javadoc.jar.asc xom-1.3.8-sources.jar xom-1.3.8-sources.jar.asc`
 
 9. Login to [oss.sonatype.org](https://oss.sonatype.org/#welcome).
 

build.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0"?>
-<!-- Copyright 2002-2007, 2009, 2010, 2011, 2012, 2013, 2018, 2019, 2020, 2021 Elliotte Rusty Harold
+<!-- Copyright 2002-2007, 2009-2013, 2018-2022 Elliotte Rusty Harold
 
 This library is free software; you can redistribute 
 it and/or modify it under the terms of version 2.1 of 
@@ -33,7 +33,7 @@ subject line. The XOM home page is http://www.xom.nu/
     <property name="name"    value="xom"/>
     <property name="majorversion" value="1"/>
     <property name="minorversion" value="3"/>
-    <property name="microversion" value="7"/>
+    <property name="microversion" value="8"/>
     <!-- put a1, b2 etc. here in non-releases -->
     <property name="versionqualifier" value=""/>
     <property name="version" value="${majorversion}.${minorversion}.${microversion}${versionqualifier}"/>
@@ -44,7 +44,7 @@ subject line. The XOM home page is http://www.xom.nu/
     <property name="bundleversion" value="${majorversion}.${minorversion}.${microversion}.osgi"/>
     <property name="jaxenversion" value="1.1.6"/>
     <!-- <property name="bundleversion" value="${majorversion}.${minorversion}.${microversion}.${versionqualifier}.osgi"/> -->
-    <property name="year"    value="2020"/>
+    <property name="year"    value="2022"/>
 
     <echo message="----------- ${Name} ${version} ------------"/>
 

website/history.html

@@ -43,6 +43,10 @@ <h1>XOM Release Notes</h1>
   that strives for correctness and simplicity.
   </p>
 
+<h2>1.3.8</h2>
+
+<p>Purely internal changes that improve compatibility with Java 17+</p>
+
 
 <h2>1.3.7</h2>
 
@@ -2096,7 +2100,7 @@ <h2 >1.0d2</h2>
 <hr />
 <p>Copyright 2002-2005, 2009, 2013, 2018, 2019, 2020, 2021 <a href="https://www.elharo.com/">Elliotte Rusty Harold</a><br />
 <a href="&#109;&#97;&#105;&#108;&#116;&#111;&#58;elharo%40ibiblio%2Eorg">elharo@ibiblio.org</a><br />
-Last Modified April 4, 2021
+Last Modified September 11, 2022
 </p>
 </div>
 <div id="Navbar">
@@ -2125,9 +2129,9 @@ <h3>Downloads</h3>
 
 	<ul>
 	  <li><a href="https://github.com/elharo/xom/">Source Repository</a></li>
-	  <li><a href="https://github.com/elharo/xom/releases/download/v1.3.7/xom-1.3.7.jar">Minimal JAR file</a></li>
-	  <li><a href="https://github.com/elharo/xom/releases/download/v1.3.7/xom-1.3.7.zip">Complete distribution, zip format</a> (source code, API documentation, unit tests, sample programs, third party jars)</li>
-	  <li><a href="https://github.com/elharo/xom/releases/download/v1.3.7/xom-1.3.7.tar.gz">Complete distribution, tar.gz format</a> (source code, API documentation, unit tests, sample programs, third party jars)</li>
+	  <li><a href="https://github.com/elharo/xom/releases/download/v1.3.8/xom-1.3.8.jar">Minimal JAR file</a></li>
+	  <li><a href="https://github.com/elharo/xom/releases/download/v1.3.8/xom-1.3.8.zip">Complete distribution, zip format</a> (source code, API documentation, unit tests, sample programs, third party jars)</li>
+	  <li><a href="https://github.com/elharo/xom/releases/download/v1.3.8/xom-1.3.8.tar.gz">Complete distribution, tar.gz format</a> (source code, API documentation, unit tests, sample programs, third party jars)</li>
 	</ul>
 
 

website/index.html

@@ -48,11 +48,11 @@ <h1>XOM</h1>
 	<li><a href="apidocs/">JavaDoc</a></li>
 	<li><a href="whatswrong/whatswrong.html">What's Wrong with XML APIs (and how to fix them)</a></li>
   <li><a href="faq.xhtml">FAQ</a></li>
-	<li><a href="https://github.com/elharo/xom/releases/download/v1.3.7/xom-1.3.7.jar">Jar file</a> (Core packages only)</li>
-	<li><a href="https://github.com/elharo/xom/releases/download/v1.3.7/xom-1.3.7.zip">Complete zip</a> (includes source code, prebuilt jars, API documentation, unit tests, sample programs, third party jars)</li>
-	<li><a href="https://github.com/elharo/xom/releases/download/v1.3.7/xom-1.3.7.tar.gz">Complete tar.gz</a> (includes source code, prebuilt jars, API documentation, unit tests, sample programs, third party jars)</li>
-	<li><a href="https://github.com/elharo/xom/releases/download/v1.3.7/xom-1.3.7-src.zip">Source code zip</a> (includes source code, unit tests, sample programs, third party jars)</li>
-	<li><a href="https://github.com/elharo/xom/releases/download/v1.3.7/xom-1.3.7-src.tar.gz">Source code tar.gz</a> (includes source code, API documentation, unit tests, sample programs, third party jars)</li>
+	<li><a href="https://github.com/elharo/xom/releases/download/v1.3.8/xom-1.3.8.jar">Jar file</a> (Core packages only)</li>
+	<li><a href="https://github.com/elharo/xom/releases/download/v1.3.8/xom-1.3.8.zip">Complete zip</a> (includes source code, prebuilt jars, API documentation, unit tests, sample programs, third party jars)</li>
+	<li><a href="https://github.com/elharo/xom/releases/download/v1.3.8/xom-1.3.8.tar.gz">Complete tar.gz</a> (includes source code, prebuilt jars, API documentation, unit tests, sample programs, third party jars)</li>
+	<li><a href="https://github.com/elharo/xom/releases/download/v1.3.8/xom-1.3.8-src.zip">Source code zip</a> (includes source code, unit tests, sample programs, third party jars)</li>
+	<li><a href="https://github.com/elharo/xom/releases/download/v1.3.8/xom-1.3.8-src.tar.gz">Source code tar.gz</a> (includes source code, API documentation, unit tests, sample programs, third party jars)</li>
     <li><a href="https://lists.ibiblio.org/mailman/listinfo/xom-interest">xom-interest mailing list</a></li>
     <li><a href="https://github.com/elharo/xom/">Source Repository</a></li>
 </ul>
@@ -87,7 +87,7 @@ <h1>XOM</h1>
 <pre><code>&lt;dependency&gt;
   &lt;groupId&gt;xom&lt;/groupId&gt;
   &lt;artifactId&gt;xom&lt;/artifactId&gt;
-  &lt;version&gt;1.3.7&lt;/version&gt;
+  &lt;version&gt;1.3.8&lt;/version&gt;
 &lt;/dependency&gt;</code></pre>
 
 <p>
@@ -96,7 +96,7 @@ <h1>XOM</h1>
 
 <pre><code>gradle
 dependencies {
-  compile 'xom:xom:1.3.7'
+  compile 'xom:xom:1.3.8'
 }</code></pre>
 
 <p>
@@ -125,8 +125,8 @@ <h1>XOM</h1>
 </p>
 
 <p>
-The current version of XOM is 1.3.7 and is backwards compatible with 1.2, 1.1 and 1.0.
-You should not need to recompile any code to upgrade to 1.3.7.
+The current version of XOM is 1.3.8 and is backwards compatible with 1.2, 1.1 and 1.0.
+You should not need to recompile any code to upgrade to 1.3.8.
 XOM is believed to be quite stable and robust.
 Future releases should be backwards compatible with the 1.0 API for the foreseeable future.
 </p>
@@ -152,9 +152,9 @@ <h1>XOM</h1>
 <div align="center">[ <a href="https://cafe.elharo.com/">The Cafes</a> | <a href="https://www.cafeconleche.org">Cafe con Leche</a> | 
 <a href="https://www.cafeaulait.org">Cafe au Lait</a> ]</div>
 <hr />
-<p>Copyright 2002-2021 <a href="https://www.elharo.com/">Elliotte Rusty Harold</a><br />
+<p>Copyright 2002-2022 <a href="https://www.elharo.com/">Elliotte Rusty Harold</a><br />
 <a href="&#109;&#97;&#105;&#108;&#116;&#111;&#58;elharo%40ibiblio%2Eorg">elharo@ibiblio.org</a><br />
-Last Modified April 4, 2021
+Last Modified September 22, 2021
 </p>
 </div>
 <div id="Navbar">
@@ -183,9 +183,9 @@ <h3>Downloads</h3>
 
 	<ul>
 	<li><a href="https://github.com/elharo/xom/">Source Repository</a></li>
-	<li><a href="https://github.com/elharo/xom/releases/download/v1.3.7/xom-1.3.7.jar">Minimal JAR file</a></li>
-	 <li><a href="https://github.com/elharo/xom/releases/download/v1.3.7/xom-1.3.7.zip">Complete distribution, zip format</a> (source code, API documentation, unit tests, sample programs, third party jars)</li>
-	 <li><a href="https://github.com/elharo/xom/releases/download/v1.3.7/xom-1.3.7.tar.gz">Complete distribution, tar.gz format</a> (source code, API documentation, unit tests, sample programs, third party jars)</li>
+	<li><a href="https://github.com/elharo/xom/releases/download/v1.3.8/xom-1.3.8.jar">Minimal JAR file</a></li>
+	 <li><a href="https://github.com/elharo/xom/releases/download/v1.3.8/xom-1.3.8.zip">Complete distribution, zip format</a> (source code, API documentation, unit tests, sample programs, third party jars)</li>
+	 <li><a href="https://github.com/elharo/xom/releases/download/v1.3.8/xom-1.3.8.tar.gz">Complete distribution, tar.gz format</a> (source code, API documentation, unit tests, sample programs, third party jars)</li>
 	 </ul>
 
 	<h3>For Contributors</h3>