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]