You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@poi.apache.org by ce...@apache.org on 2022/03/25 06:37:34 UTC
svn commit: r1899191 - in /poi/site: publish/components/logging.html src/documentation/content/xdocs/components/logging.xml
Author: centic
Date: Fri Mar 25 06:37:34 2022
New Revision: 1899191
URL: http://svn.apache.org/viewvc?rev=1899191&view=rev
Log:
Update description of logging some more
Modified:
poi/site/publish/components/logging.html
poi/site/src/documentation/content/xdocs/components/logging.xml
Modified: poi/site/publish/components/logging.html
URL: http://svn.apache.org/viewvc/poi/site/publish/components/logging.html?rev=1899191&r1=1899190&r2=1899191&view=diff
==============================================================================
--- poi/site/publish/components/logging.html (original)
+++ poi/site/publish/components/logging.html Fri Mar 25 06:37:34 2022
@@ -300,18 +300,14 @@ document.write("Last Published: " + docu
</p>
</div>
-<a name="POI+5.0.0+and+above"></a>
-<h2 class="boxed">POI 5.0.0 and above</h2>
+<a name="POI+5.1.0+and+above"></a>
+<h2 class="boxed">POI 5.1.0 and above</h2>
<div class="section">
<p>
- POI 5.0.0 switched to using <a href="https://www.slf4j.org/">SLF4J</a> for logging. If you want
- to enable logging, please read up on the various SLF4J compatible logging frameworks.
- <a href="https://logging.apache.org/log4j/2.x/">Apache Log4j v2</a> is a good choice.
- <a href="https://logback.qos.ch/">Logback</a> is also widely used.
+ Since version 5.1.0 Apache POI uses <a href="https://logging.apache.org/log4j/2.x/">Apache Log4j v2</a> directly.
</p>
<p>
- POI 5.1.0 goes further and specifically uses <a href="https://logging.apache.org/log4j/2.x/">Apache Log4j v2</a> directly.
- POI only depends on log4j-api and we leave it to you to choose which logging framework to use. log4j-core is
+ Apache POI only depends on log4j-api and allows choosing which logging framework to use. log4j-core is
just one of many options.
If you want to continue to use another SLF4J compatible logging framework, you can deploy the
<a href="https://logging.apache.org/log4j/log4j-2.2/log4j-to-slf4j/index.html">log4j-to-slf4j</a> jar to
@@ -454,6 +450,19 @@ document.write("Last Published: " + docu
</div>
</div>
+<a name="Logging+with+SLF4J"></a>
+<h2 class="boxed">Logging with SLF4J</h2>
+<div class="section">
+<p>
+ If you want to continue to use another SLF4J compatible logging framework, you can deploy the
+ <a href="https://logging.apache.org/log4j/log4j-2.2/log4j-to-slf4j/index.html">log4j-to-slf4j</a> jar
+ and the intended slf4j-bridges to facilitate this.
+ </p>
+<p>
+ See <a href="https://www.slf4j.org/">https://www.slf4j.org/</a> for more details about using SLF4J.
+ </p>
+</div>
+
<a name="Logging+with+Logback"></a>
<h2 class="boxed">Logging with Logback</h2>
<div class="section">
@@ -560,6 +569,17 @@ document.write("Last Published: " + docu
</div>
</div>
+<a name="POI+5.0.0"></a>
+<h2 class="boxed">POI 5.0.0</h2>
+<div class="section">
+<p>
+ POI 5.0.0 switched to using <a href="https://www.slf4j.org/">SLF4J</a> for logging. If you want
+ to enable logging, please read up on the various SLF4J compatible logging frameworks.
+ <a href="https://logging.apache.org/log4j/2.x/">Apache Log4j v2</a> is a good choice.
+ <a href="https://logback.qos.ch/">Logback</a> is also widely used.
+ </p>
+</div>
+
<a name="Legacy+POI+Logging+Framework+%28no+longer+supported+in+POI+5.0.0+and+above%29"></a>
<h2 class="boxed">Legacy POI Logging Framework (no longer supported in POI 5.0.0 and above)</h2>
<div class="section">
Modified: poi/site/src/documentation/content/xdocs/components/logging.xml
URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/components/logging.xml?rev=1899191&r1=1899190&r2=1899191&view=diff
==============================================================================
--- poi/site/src/documentation/content/xdocs/components/logging.xml (original)
+++ poi/site/src/documentation/content/xdocs/components/logging.xml Fri Mar 25 06:37:34 2022
@@ -38,16 +38,12 @@
</p>
</section>
<section>
- <title>POI 5.0.0 and above</title>
+ <title>POI 5.1.0 and above</title>
<p>
- POI 5.0.0 switched to using <a href="https://www.slf4j.org/">SLF4J</a> for logging. If you want
- to enable logging, please read up on the various SLF4J compatible logging frameworks.
- <a href="https://logging.apache.org/log4j/2.x/">Apache Log4j v2</a> is a good choice.
- <a href="https://logback.qos.ch/">Logback</a> is also widely used.
+ Since version 5.1.0 Apache POI uses <a href="https://logging.apache.org/log4j/2.x/">Apache Log4j v2</a> directly.
</p>
<p>
- POI 5.1.0 goes further and specifically uses <a href="https://logging.apache.org/log4j/2.x/">Apache Log4j v2</a> directly.
- POI only depends on log4j-api and we leave it to you to choose which logging framework to use. log4j-core is
+ Apache POI only depends on log4j-api and allows choosing which logging framework to use. log4j-core is
just one of many options.
If you want to continue to use another SLF4J compatible logging framework, you can deploy the
<a href="https://logging.apache.org/log4j/log4j-2.2/log4j-to-slf4j/index.html">log4j-to-slf4j</a> jar to
@@ -74,7 +70,6 @@
the <a href="https://logging.apache.org/log4j/2.x/log4j-slf4j-impl/index.html">SLF4J Binding</a> to your
project.
</p>
-
<p>
The simplest configuration is to capture all POI logs at the same level as your application. You might
want to collect all messages <code>INFO</code> and higher, and are OK with capturing POI messages as well.
@@ -121,6 +116,17 @@
</source>
</section>
<section>
+ <title>Logging with SLF4J</title>
+ <p>
+ If you want to continue to use another SLF4J compatible logging framework, you can deploy the
+ <a href="https://logging.apache.org/log4j/log4j-2.2/log4j-to-slf4j/index.html">log4j-to-slf4j</a> jar
+ and the intended slf4j-bridges to facilitate this.
+ </p>
+ <p>
+ See <a href="https://www.slf4j.org/">https://www.slf4j.org/</a> for more details about using SLF4J.
+ </p>
+ </section>
+ <section>
<title>Logging with Logback</title>
<p>
Capturing POI logs using Logback requires adding the
@@ -170,6 +176,15 @@
</source>
</section>
<section>
+ <title>POI 5.0.0</title>
+ <p>
+ POI 5.0.0 switched to using <a href="https://www.slf4j.org/">SLF4J</a> for logging. If you want
+ to enable logging, please read up on the various SLF4J compatible logging frameworks.
+ <a href="https://logging.apache.org/log4j/2.x/">Apache Log4j v2</a> is a good choice.
+ <a href="https://logback.qos.ch/">Logback</a> is also widely used.
+ </p>
+ </section>
+ <section>
<title>Legacy POI Logging Framework (no longer supported in POI 5.0.0 and above)</title>
<p>
Prior to POI 5.0.0, POI used a custom logging framework which allows to configure where logs are sent to.
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@poi.apache.org
For additional commands, e-mail: commits-help@poi.apache.org