Author: fanningpj
Date: Sat Mar 11 11:03:00 2023
New Revision: 1908271
URL: http://svn.apache.org/viewvc?rev=1908271&view=rev
Log:
update Java 11/17 FAQ entry
Modified:
poi/site/src/documentation/content/xdocs/help/faq.xml
Modified: poi/site/src/documentation/content/xdocs/help/faq.xml
URL:
http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/help/faq.xml?rev=1908271&r1=1908270&r2=1908271&view=diff
==============================================================================
--- poi/site/src/documentation/content/xdocs/help/faq.xml (original)
+++ poi/site/src/documentation/content/xdocs/help/faq.xml Sat Mar 11 11:03:00
2023
@@ -602,23 +602,22 @@ and
</faq>
<faq id="faq-N102B0">
<question>
- Can Apache POI be compiled/used with Java 11?
+ Can Apache POI be compiled/used with Java 11 and 17?
</question>
<answer>
- <p>Including the existing binaries on Java 11 as normal jar-files
+ <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 and 17).
+ </p>
+ <p>Including the existing binaries as normal jar-files
should work when using recent versions of Apache POI. You may
see
some warnings about illegal reflective access, but it should
work fine
despite those. We are working on getting the code changed so
we avoid
discouraged accesses in the future.
</p>
- <p>We also did some work to verify that compilation with Java 11
is working and
- that all unit-tests pass. So Apache POI should be ready to be
used with
- current Java 11 releases.
- </p>
- <p>NOTE: Apache POI does not yet fully support the Java module
system as
- Apache POI is still supporting previous Java versions and the
module system
+ <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.
- We are working on adding support for automatic modules.
</p>
<p>
FYI, jaxb in current versions also causes some warnings about
reflective access,
@@ -631,19 +630,10 @@ and
or a recent trunk checkout until then.
</p>
<p>
- Also make sure to use at least Ant 1.9.5 or newer.
+ If you are building POI yourself from source files, use an up to
date version of Gradle
+ (ideally via the gradlew scripts that we bundle). If you use
Ant, again check the Ant version
+ supports the version of Java you are using.
</p>
- <source><![CDATA[
- # requires Ant >= 1.9.5 due to
https://bz.apache.org/bugzilla/show_bug.cgi?id=58271
- export ANT_HOME=/opt/apache/apache-ant/apache-ant-1.9.7
- export PATH=$ANT_HOME/bin:$PATH
-
- ant \
- -Duser.language=en \
- -Duser.country=US \
- test-all
- ]]>
- </source>
</answer>
</faq>
<faq id="faq-java10">
@@ -653,7 +643,7 @@ and
<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 11.
+ Java 11 and 17.
</p>
</answer>
</faq>
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
