This is an automated email from the ASF dual-hosted git repository.

pjfanning pushed a commit to branch trunk
in repository https://gitbox.apache.org/repos/asf/poi.git


The following commit(s) were added to refs/heads/trunk by this push:
     new 323b55161a Update documentation for the 6.0.0 release (#1462)
323b55161a is described below

commit 323b55161a02b51e20f851df35eb806063809fc9
Author: PJ Fanning <[email protected]>
AuthorDate: Thu Oct 22 23:31:44 2026 +0100

    Update documentation for the 6.0.0 release (#1462)
    
    * release 6.0.0
    
    * docs: update dependency versions and Java requirement for 6.0.0
    
    Co-Authored-By: Claude Opus 5.5 <[email protected]>
    
    * docs: update Java version FAQ entries for 6.0.0
    
    Co-Authored-By: Claude Opus 5.5 <[email protected]>
    
    ---------
    
    Co-authored-by: Claude Opus 5.5 <[email protected]>
---
 src/documentation/RELEASE-NOTES.txt                |  2 +-
 src/documentation/content/xdocs/changes.xml        |  2 +-
 .../content/xdocs/components/hmef/index.xml        |  2 +-
 .../content/xdocs/components/index.xml             | 26 ++++++++++----------
 .../content/xdocs/components/poi-jvm-languages.xml | 12 +++++-----
 .../components/slideshow/ppt-wmf-emf-renderer.xml  |  4 ++--
 src/documentation/content/xdocs/download.xml       | 18 +++++++-------
 src/documentation/content/xdocs/encryption.xml     |  5 ++--
 src/documentation/content/xdocs/help/faq.xml       | 28 +++++++---------------
 src/documentation/content/xdocs/index.xml          | 11 ++++-----
 10 files changed, 51 insertions(+), 59 deletions(-)

diff --git a/src/documentation/RELEASE-NOTES.txt 
b/src/documentation/RELEASE-NOTES.txt
index b43e4a82e9..1d9caf9ee0 100644
--- a/src/documentation/RELEASE-NOTES.txt
+++ b/src/documentation/RELEASE-NOTES.txt
@@ -19,7 +19,7 @@ Release Contents
 
 This release comes in source form:
  - source archive you can build POI from 
(apache-poi-src-@VERSION@-@[email protected])
-  Unpack the archive and use the following command to build all POI components 
with JDK 11 or higher:
+  Unpack the archive and use the following command to build all POI components 
with JDK 17 or higher:
 
   gradle jar
 
diff --git a/src/documentation/content/xdocs/changes.xml 
b/src/documentation/content/xdocs/changes.xml
index f12079d7e1..a7a4df991d 100644
--- a/src/documentation/content/xdocs/changes.xml
+++ b/src/documentation/content/xdocs/changes.xml
@@ -70,7 +70,7 @@
         </p>
     </section>
 
-    <release version="6.0.0" date="TBD">
+    <release version="6.0.0" date="2026-10-22">
         <summary>
             <summary-item>Minimum Java version is now JDK 17 (was JDK 8 in POI 
5.x)</summary-item>
             <summary-item>DataFormatter now uses cached values for formula 
cells by default (see setUseCachedValuesForFormulaCells)</summary-item>
diff --git a/src/documentation/content/xdocs/components/hmef/index.xml 
b/src/documentation/content/xdocs/components/hmef/index.xml
index 4de721ade9..45f541f446 100644
--- a/src/documentation/content/xdocs/components/hmef/index.xml
+++ b/src/documentation/content/xdocs/components/hmef/index.xml
@@ -76,7 +76,7 @@
              TNEF file to extract, and the directory to place the extracted
              files into, eg:</p>
            <source>
-              java -classpath poi-5.5.1.jar:poi-scratchpad-5.5.1.jar 
org.apache.poi.hmef.extractor.HMEFContentsExtractor winmail.dat /tmp/extracted/
+              java -classpath poi-6.0.0.jar:poi-scratchpad-6.0.0.jar 
org.apache.poi.hmef.extractor.HMEFContentsExtractor winmail.dat /tmp/extracted/
            </source>
 
            <p>From Java, there are two method calls on the class, one to
diff --git a/src/documentation/content/xdocs/components/index.xml 
b/src/documentation/content/xdocs/components/index.xml
index 1d62512a0c..3187f309d3 100644
--- a/src/documentation/content/xdocs/components/index.xml
+++ b/src/documentation/content/xdocs/components/index.xml
@@ -291,11 +291,11 @@
         </tr>
         <tr>
           <td>poi</td>
-          <td><a 
href="https://search.maven.org/#artifactdetails|org.apache.logging.log4j|log4j-api|2.26.0|jar">log4j
 2.x</a>,
-              <a 
href="https://search.maven.org/#artifactdetails|commons-codec|commons-codec|1.17.1|jar">commons-codec</a>,
-              <a 
href="https://search.maven.org/#artifactdetails|org.apache.commons|commons-collections4|4.4|jar">commons-collections</a>,
+          <td><a 
href="https://search.maven.org/#artifactdetails|org.apache.logging.log4j|log4j-api|2.26.1|jar">log4j
 2.x</a>,
+              <a 
href="https://search.maven.org/#artifactdetails|commons-codec|commons-codec|1.23.0|jar">commons-codec</a>,
+              <a 
href="https://search.maven.org/#artifactdetails|org.apache.commons|commons-collections4|4.6.0|jar">commons-collections</a>,
               <a 
href="https://search.maven.org/#artifactdetails|org.apache.commons|commons-math3|3.6.1|jar">commons-math3</a>
-              <a 
href="https://search.maven.org/#artifactdetails|commons-io|commons-io|2.20.0|jar">commons-io</a>
+              <a 
href="https://search.maven.org/#artifactdetails|commons-io|commons-io|2.22.0|jar">commons-io</a>
           </td>
           <td>poi-version-yyyymmdd.jar</td>
         </tr>
@@ -309,7 +309,7 @@
           <td><a href="https://search.maven.org/#search|gav|1|g:org.apache.poi 
AND a:poi">poi</a>,
               <a href="https://search.maven.org/#search|gav|1|g:org.apache.poi 
AND a:poi-ooxml-lite">poi-ooxml-lite</a>,
               <a 
href="https://search.maven.org/#artifactdetails|org.apache.commons|commons-compress|1.28.0|jar">commons-compress</a>,
-              <a 
href="https://search.maven.org/#artifactdetails|com.zaxxer|SparseBitSet|1.2|jar">SparseBitSet</a><br/>
+              <a 
href="https://search.maven.org/#artifactdetails|com.zaxxer|SparseBitSet|1.3|jar">SparseBitSet</a><br/>
               For SVG support:
               <a 
href="https://search.maven.org/#search|gav|1|g:org.apache.xmlgraphics AND 
a:batik-all">batik-all</a>,
               <a href="https://search.maven.org/#search|gav|1|g:xml-apis AND 
a:xml-apis-ext">xml-apis-ext</a>,
@@ -323,7 +323,7 @@
         </tr>
         <tr>
           <td>poi-ooxml-lite</td>
-          <td><a 
href="https://search.maven.org/#artifactdetails|org.apache.xmlbeans|xmlbeans|5.3.0|jar">xmlbeans</a></td>
+          <td><a 
href="https://search.maven.org/#artifactdetails|org.apache.xmlbeans|xmlbeans|5.4.1|jar">xmlbeans</a></td>
           <td>poi-ooxml-lite-version-yyyymmdd.jar</td>
         </tr>
         <tr>
@@ -336,12 +336,14 @@
         </tr>
         <tr>
           <td>poi-ooxml-full (known as ooxml-schemas)</td>
-          <td><a 
href="https://search.maven.org/#artifactdetails|org.apache.xmlbeans|xmlbeans|5.3.0|jar">xmlbeans</a><br/>
+          <td><a 
href="https://search.maven.org/#artifactdetails|org.apache.xmlbeans|xmlbeans|5.4.1|jar">xmlbeans</a><br/>
             For signing:
-            <a 
href="https://search.maven.org/#artifactdetails|org.bouncycastle|bcpkix-jdk18on|1.84|jar">bcpkix-jdk18on</a>,
-            <a 
href="https://search.maven.org/#artifactdetails|org.bouncycastle|bcutil-jdk18on|1.84|jar">bcprov-jdk18on</a>,
-            <a 
href="https://search.maven.org/#artifactdetails|org.apache.santuario|xmlsec|3.0.6|bundle">xmlsec</a>,
-            <a 
href="https://search.maven.org/#artifactdetails|org.slf4j|slf4j-api|2.0.17|jar">slf4j-api</a>
+            <a 
href="https://search.maven.org/#artifactdetails|org.bouncycastle|bcpkix-jdk18on|1.86|jar">bcpkix-jdk18on</a>,
+            <a 
href="https://search.maven.org/#artifactdetails|org.bouncycastle|bcutil-jdk18on|1.86|jar">bcutil-jdk18on</a>,
+            <a 
href="https://search.maven.org/#artifactdetails|org.apache.santuario|xmlsec|4.0.4|jar">xmlsec</a>,
+            <a 
href="https://search.maven.org/#artifactdetails|jakarta.xml.bind|jakarta.xml.bind-api|4.0.5|jar">jakarta.xml.bind-api</a>,
+            <a 
href="https://search.maven.org/#artifactdetails|jakarta.activation|jakarta.activation-api|2.1.4|jar">jakarta.activation-api</a>,
+            <a 
href="https://search.maven.org/#artifactdetails|org.slf4j|slf4j-api|2.0.20|jar">slf4j-api</a>
           </td>
           <td>poi-ooxml-full-version-yyyymmdd.jar</td>
         </tr>
@@ -369,7 +371,7 @@
       </p>
       <p>
         The OOXML jars require a stax implementation, but now that Apache
-        POI requires Java 8, that dependency is provided by the JRE and no 
additional
+        POI requires Java 17, that dependency is provided by the JRE and no 
additional
         stax jars are required. The OOXML jars used to require DOM4J, but
         the code has now been changed to use JAXP and no additional dom4j
         jars are required. By the way, look at this <a 
href="../help/index.html#faq-N1017E">FAQ</a>
diff --git a/src/documentation/content/xdocs/components/poi-jvm-languages.xml 
b/src/documentation/content/xdocs/components/poi-jvm-languages.xml
index 241c478c69..3b81a4613e 100644
--- a/src/documentation/content/xdocs/components/poi-jvm-languages.xml
+++ b/src/documentation/content/xdocs/components/poi-jvm-languages.xml
@@ -109,7 +109,7 @@
     # Add <a href="site:components">poi jars</a> onto the python classpath or 
add them at run time
     import sys
     for jar in ('poi', 'poi-ooxml', 'poi-ooxml-lite'):
-        sys.path.append('/path/to/%s-5.5.1.jar')
+        sys.path.append('/path/to/%s-6.0.0.jar')
 
     from java.io import File, FileOutputStream
     from contextlib import closing
@@ -150,9 +150,9 @@
       <source> <!-- lang="scala" -->
     // Add the POI core and OOXML support dependencies into your build.sbt
     libraryDependencies ++= Seq(
-      "org.apache.poi" % "poi" % "5.5.1",
-      "org.apache.poi" % "poi-ooxml" % "5.5.1",
-      "org.apache.poi" % "poi-ooxml-lite" % "5.5.1"
+      "org.apache.poi" % "poi" % "6.0.0",
+      "org.apache.poi" % "poi-ooxml" % "6.0.0",
+      "org.apache.poi" % "poi-ooxml-lite" % "6.0.0"
     )
       </source>
     </section>
@@ -211,8 +211,8 @@ repositories {
 }
 dependencies {
     runtime 'org.codehaus.groovy:groovy-all:2.5.15'
-    runtime 'org.apache.poi:poi:5.5.1'
-    runtime 'org.apache.poi:poi-ooxml:5.5.1'
+    runtime 'org.apache.poi:poi:6.0.0'
+    runtime 'org.apache.poi:poi-ooxml:6.0.0'
 }
       </source>
     </section>
diff --git 
a/src/documentation/content/xdocs/components/slideshow/ppt-wmf-emf-renderer.xml 
b/src/documentation/content/xdocs/components/slideshow/ppt-wmf-emf-renderer.xml
index 9bdf534fd1..51ed0d9100 100644
--- 
a/src/documentation/content/xdocs/components/slideshow/ppt-wmf-emf-renderer.xml
+++ 
b/src/documentation/content/xdocs/components/slideshow/ppt-wmf-emf-renderer.xml
@@ -72,7 +72,7 @@
                     and for SVG/PDF the <a 
href="site:components/index/batikpdf">additional dependencies</a>.</p>
                 <p>Execute the java command (Unix-paths needs to be replaced 
for Windows - use "-charset" for non-western WMF/EMFs):</p>
                 <source>
-                    java -cp 
poi-5.5.1.jar:poi-ooxml-5.5.1.jar:poi-ooxml-lite-5.5.1.jar:poi-scratchpad-5.5.1.jar:lib/*:ooxml-lib/*:auxiliary/*
 org.apache.poi.xslf.util.PPTX2PNG -format png -fixside long -scale 1000 
-charset GBK file.pptx
+                    java -cp 
poi-6.0.0.jar:poi-ooxml-6.0.0.jar:poi-ooxml-lite-6.0.0.jar:poi-scratchpad-6.0.0.jar:lib/*:ooxml-lib/*:auxiliary/*
 org.apache.poi.xslf.util.PPTX2PNG -format png -fixside long -scale 1000 
-charset GBK file.pptx
                 </source>
                 <p>
                     If you want to use the renderer on the module path (JPMS) 
there a currently a few more steps necessary:
@@ -80,7 +80,7 @@
                 <ul>
                     <li>Create a build project using Maven, Gradle or your 
favorite build tool.</li>
                     <li>Alternatively, download the jars from 
https://repo1.maven.org/maven2/org/apache/poi/</li>
-                    <li>Exclude poi-ooxml-full-5.5.1.jar,poi-javadoc-5.5.1.jar 
and auxiliary/xml-apis-1.4.01.jar (Java 11+) into new subdirectory "unused"</li>
+                    <li>Exclude poi-ooxml-full-6.0.0.jar,poi-javadoc-6.0.0.jar 
and auxiliary/xml-apis-1.4.01.jar (Java 11+) into new subdirectory "unused"</li>
                     <li>Move all other jars in current directory into a new 
subdirectory "poi"</li>
                     <li>Invoke PPTX2PNG:
                         <source>
diff --git a/src/documentation/content/xdocs/download.xml 
b/src/documentation/content/xdocs/download.xml
index 88950a9d02..19d4e31b0e 100644
--- a/src/documentation/content/xdocs/download.xml
+++ b/src/documentation/content/xdocs/download.xml
@@ -33,7 +33,7 @@
             </p>
             <ul>
                 <li>
-                    <a href="#POI-5.5.1">The latest stable release is Apache 
POI 5.5.1</a>
+                    <a href="#POI-6.0.0">The latest stable release is Apache 
POI 6.0.0</a>
                 </li>
                 <li>
                     <a href="#archive">Archives of all prior releases</a>
@@ -53,11 +53,11 @@
 
         <!-- latest final release -->
 
-        <section id="POI-5.5.1"><title>30 November 2025 - POI 5.5.1 
available</title>
-            <p>The Apache POI team is pleased to announce the release of 5.5.1.
+        <section id="POI-6.0.0"><title>22 October 2026 - POI 6.0.0 
available</title>
+            <p>The Apache POI team is pleased to announce the release of 6.0.0.
                 Featured are a handful of new areas of functionality and 
numerous bug fixes.</p>
             <p>A summary of changes is available in the
-                <a 
href="https://www.apache.org/dyn/closer.lua/poi/dev/RELEASE-NOTES-5.5.1.txt";>Release
 Notes</a>.
+                <a 
href="https://www.apache.org/dyn/closer.lua/poi/dev/RELEASE-NOTES-6.0.0.txt";>Release
 Notes</a>.
                 A full list of changes is available in the <a 
href="site:changes">change log</a>.
                 People interested should also follow the <a 
href="site:mailinglists">dev list</a>
                 to track progress.</p>
@@ -65,14 +65,14 @@
                 The POI source release is listed below.
                 Pre-built versions of all <a href="site:components">POI 
components</a>
                 are available in the central Maven repository under Group ID 
"org.apache.poi" and Version
-                "5.5.1".
+                "6.0.0".
             </p>
-            <section id="POI-5.5.1-src"><title>Source Distribution</title>
+            <section id="POI-6.0.0-src"><title>Source Distribution</title>
                 <ul>
                     <li>
-                        <a 
href="https://www.apache.org/dyn/closer.lua/poi/release/src/apache-poi-src-5.5.1-20251126.tgz";>apache-poi-src-5.5.1-20251126.tgz</a>
-                        (117 MB, <a 
href="https://downloads.apache.org/poi/release/src/apache-poi-src-5.5.1-20251126.tgz.asc";>signature
 (.asc)</a>,
-                        checksum: <a 
href="https://downloads.apache.org/poi/release/src/apache-poi-src-5.5.1-20251126.tgz.sha512";>SHA-512</a>)
+                        <a 
href="https://www.apache.org/dyn/closer.lua/poi/release/src/apache-poi-src-6.0.0-20261019.tgz";>apache-poi-src-6.0.0-20261019.tgz</a>
+                        (117 MB, <a 
href="https://downloads.apache.org/poi/release/src/apache-poi-src-6.0.0-20261019.tgz.asc";>signature
 (.asc)</a>,
+                        checksum: <a 
href="https://downloads.apache.org/poi/release/src/apache-poi-src-6.0.0-20261019.tgz.sha512";>SHA-512</a>)
                     </li>
                 </ul>
             </section>
diff --git a/src/documentation/content/xdocs/encryption.xml 
b/src/documentation/content/xdocs/encryption.xml
index 0eda1576fb..ca0b827241 100644
--- a/src/documentation/content/xdocs/encryption.xml
+++ b/src/documentation/content/xdocs/encryption.xml
@@ -253,8 +253,9 @@
         <p>The classes have been tested against the following libraries, which 
need to be included additionally to the
         <a href="site:components">default dependencies</a>:</p>
         <ul>
-            <li>BouncyCastle bcpkix, bcprov and bcutil (tested against 
1.84)</li>
-            <li>Apache Santuario "xmlsec" (tested against 3.0.5)</li>
+            <li>BouncyCastle bcpkix, bcprov and bcutil (tested against 
1.86)</li>
+            <li>Apache Santuario "xmlsec" (tested against 4.0.4)</li>
+            <li>jakarta.xml.bind-api and jakarta.activation-api (tested 
against 4.0.5 and 2.1.4)</li>
             <li>and slf4j-api (tested against 2.0.x)</li>
         </ul>
         <p>Depending on the <a 
href="apidocs/dev/org/apache/poi/poifs/crypt/dsig/SignatureConfig.html">configuration</a>
diff --git a/src/documentation/content/xdocs/help/faq.xml 
b/src/documentation/content/xdocs/help/faq.xml
index e82902b5fb..b433940643 100644
--- a/src/documentation/content/xdocs/help/faq.xml
+++ b/src/documentation/content/xdocs/help/faq.xml
@@ -602,12 +602,13 @@ and
   </faq>
     <faq id="faq-N102B0">
         <question>
-            Can Apache POI be compiled/used with Java 11, 17 and 21?
+            Can Apache POI be compiled/used with Java 17, 21 and 25?
         </question>
         <answer>
             <p>
               POI is successfully tested with many different versions of Java. 
It is
-              recommended that you use Java versions that have Long Term 
Support (Java 11, 17 and 21).
+              recommended that you use Java versions that have Long Term 
Support (Java 17, 21 and 25).
+              POI 6.0.0 and newer require Java 17 or newer; POI 5.x supports 
Java 8 or newer.
             </p>
             <p>Including the existing binaries as normal jar-files
                 should work when using recent versions of Apache POI. You may 
see
@@ -615,19 +616,8 @@ and
                 despite those. We are working on getting the code changed so 
we avoid
                 discouraged accesses in the future.
             </p>
-            <p>NOTE: Apache POI tries to support the Java module system but it 
is more complicated
-                because Apache POI is still supporting Java 8 and the module 
system
-                cannot be fully supported while maintaining such support.
-            </p>
-            <p>
-                FYI, jaxb in current versions also causes some warnings about 
reflective access,
-                we cannot fix those until jaxb >= 2.4.0 is available, see
-                https://stackoverflow.com/a/50251510/411846 for details, you 
can set a system
-                property "com.sun.xml.bind.v2.bytecode.ClassTailor.noOptimize" 
to avoid this warning.
-            </p>
-            <p>
-                For compiling Apache POI, you should use at least version 
4.1.0 when it becomes available
-                or a recent trunk checkout until then.
+            <p>NOTE: The POI jars include module-info descriptors so they can 
be used on the
+                module path (JPMS).
             </p>
             <p>
               If you are building POI yourself from source files, use an up to 
date version of Gradle.
@@ -637,12 +627,12 @@ and
     </faq>
     <faq id="faq-java10">
         <question>
-            Can Apache POI be compiled/used with Java 9 or Java 10?
+            Can Apache POI be compiled/used with Java versions older than Java 
17?
         </question>
         <answer>
-            <p>Apache POI does not actively support Java 9 or Java 10 any 
longer as those versions were
-                obsoleted by Oracle already. See the previous FAQ entry for 
information about support for
-                Java LTS versions.
+            <p>No, Apache POI 6.0.0 and newer require Java 17 or newer. If you 
need to stay on an older
+                Java version, use POI 5.x, which supports Java 8 or newer. See 
the previous FAQ entry for
+                information about support for Java LTS versions.
             </p>
         </answer>
     </faq>
diff --git a/src/documentation/content/xdocs/index.xml 
b/src/documentation/content/xdocs/index.xml
index a209d75596..028f0d568c 100644
--- a/src/documentation/content/xdocs/index.xml
+++ b/src/documentation/content/xdocs/index.xml
@@ -28,15 +28,14 @@
     <section><title>Project News</title>
 
       <!-- latest final release -->
-      <section><title>30 November 2025 - POI 5.5.1 available</title>
-        <p>The Apache POI team is pleased to announce the release of 5.5.1.
-          Several dependencies were updated to their latest versions to pick 
up security fixes and other improvements.</p>
+      <section><title>22 October 2026 - POI 6.0.0 available</title>
+        <p>The Apache POI team is pleased to announce the release of 6.0.0.</p>
         <p>A summary of changes is available in the
           <a 
href="https://www.apache.org/dyn/closer.lua/poi/release/RELEASE-NOTES.txt";>Release
 Notes</a>.
-          A full list of changes is available in the <a 
href="changes.html#5.5.1">change log</a>.
+          A full list of changes is available in the <a 
href="changes.html#6.0.0">change log</a>.
           People interested should also follow the <a 
href="site:mailinglists">dev list</a> to track progress.</p>
-        <p>See the <a href="download.html#POI-5.5.1">downloads</a> page for 
more details.</p>
-        <p>POI requires Java 8 or newer since version 4.0.1.</p>
+        <p>See the <a href="download.html#POI-6.0.0">downloads</a> page for 
more details.</p>
+        <p>POI requires Java 17 or newer since version 6.0.0.</p>
       </section>
 
       <section><title>7 July 2025 - Source repository switched from Subversion 
to Git</title>


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to