javadoc fixes

This commit is contained in:
Ceki Gulcu 2019-06-12 22:13:22 +02:00
parent e52fb5ae15
commit abad55509a
38 changed files with 220 additions and 213 deletions

View File

@ -7,7 +7,7 @@
<parent>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-parent</artifactId>
<version>2.0.0-alpha0-SNAPSHOT</version>
<version>2.0.0-alpha0</version>
</parent>
<artifactId>integration</artifactId>

View File

@ -5,7 +5,7 @@
<parent>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-parent</artifactId>
<version>2.0.0-alpha0-SNAPSHOT</version>
<version>2.0.0-alpha0</version>
</parent>
<modelVersion>4.0.0</modelVersion>

View File

@ -20,7 +20,7 @@ package org.apache.commons.logging;
* <p>A simple logging interface abstracting logging APIs. In order to be
* instantiated successfully by {@link LogFactory}, classes that implement
* this interface must have a constructor that takes a single String
* parameter representing the "name" of this Log.</p>
* parameter representing the "name" of this Log.
*
* <p> The six logging levels used by <code>Log</code> are (in order):
* <ol>
@ -34,27 +34,27 @@ package org.apache.commons.logging;
* The mapping of these log levels to the concepts used by the underlying
* logging system is implementation dependent.
* The implementation should ensure, though, that this ordering behaves
* as expected.</p>
* as expected.
*
* <p>Performance is often a logging concern.
* By examining the appropriate property,
* a component can avoid expensive operations (producing information
* to be logged).</p>
* to be logged).
*
* <p> For example,
* <code><pre>
* <pre>
* if (log.isDebugEnabled()) {
* ... do something expensive ...
* log.debug(theResult);
* }
* </pre></code>
* </p>
* </pre>
*
*
* <p>Configuration of the underlying logging system will generally be done
* external to the Logging APIs, through whatever mechanism is supported by
* that system.</p>
* that system.
*
* <p style="color: #E40; font-weight: bold;">Please note that this interface is identical to that found in JCL 1.1.1.</p>
* <p style="color: #E40; font-weight: bold;">Please note that this interface is identical to that found in JCL 1.1.1.
*
* @author <a href="mailto:sanders@apache.org">Scott Sanders</a>
* @author Rod Waldhoff
@ -65,74 +65,74 @@ public interface Log {
// ----------------------------------------------------- Logging Properties
/**
* <p> Is debug logging currently enabled? </p>
* <p> Is debug logging currently enabled?
*
* <p> Call this method to prevent having to perform expensive operations
* (for example, <code>String</code> concatenation)
* when the log level is more than debug. </p>
* when the log level is more than debug.
*/
public boolean isDebugEnabled();
/**
* <p> Is error logging currently enabled? </p>
* <p> Is error logging currently enabled?
*
* <p> Call this method to prevent having to perform expensive operations
* (for example, <code>String</code> concatenation)
* when the log level is more than error. </p>
* when the log level is more than error.
*/
public boolean isErrorEnabled();
/**
* <p> Is fatal logging currently enabled? </p>
* <p> Is fatal logging currently enabled?
*
* <p> Call this method to prevent having to perform expensive operations
* (for example, <code>String</code> concatenation)
* when the log level is more than fatal. </p>
* when the log level is more than fatal.
*/
public boolean isFatalEnabled();
/**
* <p> Is info logging currently enabled? </p>
* <p> Is info logging currently enabled?
*
* <p> Call this method to prevent having to perform expensive operations
* (for example, <code>String</code> concatenation)
* when the log level is more than info. </p>
* when the log level is more than info.
*
* @return true if info enabled, false otherwise
*/
public boolean isInfoEnabled();
/**
* <p> Is trace logging currently enabled? </p>
* <p> Is trace logging currently enabled?
*
* <p> Call this method to prevent having to perform expensive operations
* (for example, <code>String</code> concatenation)
* when the log level is more than trace. </p>
* when the log level is more than trace.
*
* @return true if trace enabled, false otherwise
*/
public boolean isTraceEnabled();
/**
* <p> Is warn logging currently enabled? </p>
* <p> Is warn logging currently enabled?
*
* <p> Call this method to prevent having to perform expensive operations
* (for example, <code>String</code> concatenation)
* when the log level is more than warn. </p>
* when the log level is more than warn.
*/
public boolean isWarnEnabled();
// -------------------------------------------------------- Logging Methods
/**
* <p> Log a message with trace log level. </p>
* <p> Log a message with trace log level.
*
* @param message log this message
*/
public void trace(Object message);
/**
* <p> Log an error with trace log level. </p>
* <p> Log an error with trace log level.
*
* @param message log this message
* @param t log this cause
@ -140,14 +140,14 @@ public interface Log {
public void trace(Object message, Throwable t);
/**
* <p> Log a message with debug log level. </p>
* <p> Log a message with debug log level.
*
* @param message log this message
*/
public void debug(Object message);
/**
* <p> Log an error with debug log level. </p>
* <p> Log an error with debug log level.
*
* @param message log this message
* @param t log this cause
@ -155,14 +155,14 @@ public interface Log {
public void debug(Object message, Throwable t);
/**
* <p> Log a message with info log level. </p>
* <p> Log a message with info log level.
*
* @param message log this message
*/
public void info(Object message);
/**
* <p> Log an error with info log level. </p>
* <p> Log an error with info log level.
*
* @param message log this message
* @param t log this cause
@ -170,14 +170,14 @@ public interface Log {
public void info(Object message, Throwable t);
/**
* <p> Log a message with warn log level. </p>
* <p> Log a message with warn log level.
*
* @param message log this message
*/
public void warn(Object message);
/**
* <p> Log an error with warn log level. </p>
* <p> Log an error with warn log level.
*
* @param message log this message
* @param t log this cause
@ -185,14 +185,14 @@ public interface Log {
public void warn(Object message, Throwable t);
/**
* <p> Log a message with error log level. </p>
* <p> Log a message with error log level.
*
* @param message log this message
*/
public void error(Object message);
/**
* <p> Log an error with error log level. </p>
* <p> Log an error with error log level.
*
* @param message log this message
* @param t log this cause
@ -200,14 +200,14 @@ public interface Log {
public void error(Object message, Throwable t);
/**
* <p> Log a message with fatal log level. </p>
* <p> Log a message with fatal log level.
*
* @param message log this message
*/
public void fatal(Object message);
/**
* <p> Log an error with fatal log level. </p>
* <p> Log an error with fatal log level.
*
* @param message log this message
* @param t log this cause

View File

@ -21,7 +21,7 @@ package org.apache.commons.logging;
* An exception that is thrown only if a suitable <code>LogFactory</code> or
* <code>Log</code> instance cannot be created by the corresponding factory
* methods.
* </p>
*
*
* <p>
* In this version of JCL, this exception will never be thrown in practice.

View File

@ -25,7 +25,7 @@ import org.apache.commons.logging.impl.SLF4JLogFactory;
* Factory for creating {@link Log} instances, which always delegates to an
* instance of {@link SLF4JLogFactory}.
*
* </p>
*
*
* @author Craig R. McClanahan
* @author Costin Manolache
@ -170,7 +170,7 @@ public abstract class LogFactory {
* <p>
* Construct (if necessary) and return a <code>Log</code> instance, using
* the factory's current set of configuration attributes.
* </p>
*
*
* <p>
* <strong>NOTE </strong>- Depending upon the implementation of the
@ -178,7 +178,7 @@ public abstract class LogFactory {
* you are returned may or may not be local to the current application, and
* may or may not be returned again on a subsequent call with the same name
* argument.
* </p>
*
*
* @param name
* Logical name of the <code>Log</code> instance to be
@ -229,7 +229,7 @@ public abstract class LogFactory {
* Construct (if necessary) and return a <code>LogFactory</code> instance,
* using the following ordered lookup procedure to determine the name of the
* implementation class to be loaded.
* </p>
*
* <ul>
* <li>The <code>org.apache.commons.logging.LogFactory</code> system
* property.</li>
@ -248,7 +248,7 @@ public abstract class LogFactory {
* <code>LogFactory</code> implementation class is utilized, all of the
* properties defined in this file will be set as configuration attributes on
* the corresponding <code>LogFactory</code> instance.
* </p>
*
*
* @exception LogConfigurationException
* if the implementation class is not available or cannot

View File

@ -23,7 +23,7 @@ import org.apache.commons.logging.Log;
* <p>
* Trivial implementation of Log that throws away all messages. No configurable
* system properties are supported.
* </p>
*
*
* @author <a href="mailto:sanders@apache.org">Scott Sanders</a>
* @author Rod Waldhoff

View File

@ -42,7 +42,7 @@ import java.util.concurrent.ConcurrentMap;
*
* <p>
* This implementation ignores any configured attributes.
* </p>
*
*
* @author Rod Waldhoff
* @author Craig R. McClanahan
@ -136,7 +136,7 @@ public class SLF4JLogFactory extends LogFactory {
* <p>
* Construct (if necessary) and return a <code>Log</code> instance, using
* the factory's current set of configuration attributes.
* </p>
*
*
* @param name
* Logical name of the <code>Log</code> instance to be returned

View File

@ -35,7 +35,7 @@ import org.apache.commons.logging.LogConfigurationException;
* Simple implementation of Log that sends all enabled log messages, for all
* defined loggers, to System.err. The following system properties are supported
* to configure the behavior of this logger:
* </p>
*
* <ul>
* <li><code>org.apache.commons.logging.simplelog.defaultlog</code> - Default
* logging detail level for all instances of SimpleLog. Must be one of ("trace",
@ -67,7 +67,7 @@ import org.apache.commons.logging.LogConfigurationException;
* this implementation also checks for a class loader resource named
* <code>"simplelog.properties"</code>, and includes any matching definitions
* from this resource (if it exists).
* </p>
*
*
* @author <a href="mailto:sanders@apache.org">Scott Sanders</a>
* @author Rod Waldhoff
@ -248,7 +248,7 @@ public class SimpleLog implements Log, Serializable {
/**
* <p>
* Set logging level.
* </p>
*
*
* @param currentLogLevel
* new logging level
@ -262,7 +262,7 @@ public class SimpleLog implements Log, Serializable {
/**
* <p>
* Get logging level.
* </p>
*
*/
public int getLevel() {
@ -275,7 +275,7 @@ public class SimpleLog implements Log, Serializable {
* <p>
* Do the actual logging. This method assembles the message and then calls
* <code>write()</code> to cause it to be written.
* </p>
*
*
* @param type
* One of the LOG_LEVEL_XXX constants defining the log level
@ -354,7 +354,7 @@ public class SimpleLog implements Log, Serializable {
* Write the content of the message accumulated in the specified
* <code>StringBuffer</code> to the appropriate output destination. The
* default implementation writes to <code>System.err</code>.
* </p>
*
*
* @param buffer
* A <code>StringBuffer</code> containing the accumulated text to be
@ -383,7 +383,7 @@ public class SimpleLog implements Log, Serializable {
/**
* <p>
* Log a message with debug log level.
* </p>
*
*/
public final void debug(Object message) {
@ -395,7 +395,7 @@ public class SimpleLog implements Log, Serializable {
/**
* <p>
* Log an error with debug log level.
* </p>
*
*/
public final void debug(Object message, Throwable t) {
@ -407,7 +407,7 @@ public class SimpleLog implements Log, Serializable {
/**
* <p>
* Log a message with trace log level.
* </p>
*
*/
public final void trace(Object message) {
@ -419,7 +419,7 @@ public class SimpleLog implements Log, Serializable {
/**
* <p>
* Log an error with trace log level.
* </p>
*
*/
public final void trace(Object message, Throwable t) {
@ -431,7 +431,7 @@ public class SimpleLog implements Log, Serializable {
/**
* <p>
* Log a message with info log level.
* </p>
*
*/
public final void info(Object message) {
@ -443,7 +443,7 @@ public class SimpleLog implements Log, Serializable {
/**
* <p>
* Log an error with info log level.
* </p>
*
*/
public final void info(Object message, Throwable t) {
@ -455,7 +455,7 @@ public class SimpleLog implements Log, Serializable {
/**
* <p>
* Log a message with warn log level.
* </p>
*
*/
public final void warn(Object message) {
@ -467,7 +467,7 @@ public class SimpleLog implements Log, Serializable {
/**
* <p>
* Log an error with warn log level.
* </p>
*
*/
public final void warn(Object message, Throwable t) {
@ -479,7 +479,7 @@ public class SimpleLog implements Log, Serializable {
/**
* <p>
* Log a message with error log level.
* </p>
*
*/
public final void error(Object message) {
@ -491,7 +491,7 @@ public class SimpleLog implements Log, Serializable {
/**
* <p>
* Log an error with error log level.
* </p>
*
*/
public final void error(Object message, Throwable t) {
@ -503,7 +503,7 @@ public class SimpleLog implements Log, Serializable {
/**
* <p>
* Log a message with fatal log level.
* </p>
*
*/
public final void fatal(Object message) {
@ -515,7 +515,7 @@ public class SimpleLog implements Log, Serializable {
/**
* <p>
* Log an error with fatal log level.
* </p>
*
*/
public final void fatal(Object message, Throwable t) {
@ -527,12 +527,12 @@ public class SimpleLog implements Log, Serializable {
/**
* <p>
* Are debug messages currently enabled?
* </p>
*
*
* <p>
* This allows expensive operations such as <code>String</code> concatenation
* to be avoided when the message will be ignored by the logger.
* </p>
*
*/
public final boolean isDebugEnabled() {
@ -542,12 +542,12 @@ public class SimpleLog implements Log, Serializable {
/**
* <p>
* Are error messages currently enabled?
* </p>
*
*
* <p>
* This allows expensive operations such as <code>String</code> concatenation
* to be avoided when the message will be ignored by the logger.
* </p>
*
*/
public final boolean isErrorEnabled() {
@ -557,12 +557,12 @@ public class SimpleLog implements Log, Serializable {
/**
* <p>
* Are fatal messages currently enabled?
* </p>
*
*
* <p>
* This allows expensive operations such as <code>String</code> concatenation
* to be avoided when the message will be ignored by the logger.
* </p>
*
*/
public final boolean isFatalEnabled() {
@ -572,12 +572,12 @@ public class SimpleLog implements Log, Serializable {
/**
* <p>
* Are info messages currently enabled?
* </p>
*
*
* <p>
* This allows expensive operations such as <code>String</code> concatenation
* to be avoided when the message will be ignored by the logger.
* </p>
*
*/
public final boolean isInfoEnabled() {
@ -587,12 +587,12 @@ public class SimpleLog implements Log, Serializable {
/**
* <p>
* Are trace messages currently enabled?
* </p>
*
*
* <p>
* This allows expensive operations such as <code>String</code> concatenation
* to be avoided when the message will be ignored by the logger.
* </p>
*
*/
public final boolean isTraceEnabled() {
@ -602,12 +602,12 @@ public class SimpleLog implements Log, Serializable {
/**
* <p>
* Are warn messages currently enabled?
* </p>
*
*
* <p>
* This allows expensive operations such as <code>String</code> concatenation
* to be avoided when the message will be ignored by the logger.
* </p>
*
*/
public final boolean isWarnEnabled() {

View File

@ -7,7 +7,7 @@
<parent>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-parent</artifactId>
<version>2.0.0-alpha0-SNAPSHOT</version>
<version>2.0.0-alpha0</version>
</parent>
<artifactId>jul-to-slf4j</artifactId>

View File

@ -39,12 +39,12 @@ import org.slf4j.spi.LocationAwareLogger;
// Based on http://jira.qos.ch/browse/SLF4J-30
/**
* <p>Bridge/route all JUL log records to the SLF4J API.</p>
* <p>Bridge/route all JUL log records to the SLF4J API.
* <p>Essentially, the idea is to install on the root logger an instance of
* <code>SLF4JBridgeHandler</code> as the sole JUL handler in the system. Subsequently, the
* SLF4JBridgeHandler instance will redirect all JUL log records are redirected
* to the SLF4J API based on the following mapping of levels:
* </p>
*
* <pre>
* FINEST -&gt; TRACE
* FINER -&gt; DEBUG
@ -52,7 +52,7 @@ import org.slf4j.spi.LocationAwareLogger;
* INFO -&gt; INFO
* WARNING -&gt; WARN
* SEVERE -&gt; ERROR</pre>
* <p><b>Programmatic installation:</b></p>
* <p><b>Programmatic installation:</b>
* <pre>
* // Optionally remove existing handlers attached to j.u.l root logger
* SLF4JBridgeHandler.removeHandlersForRootLogger(); // (since SLF4J 1.6.5)
@ -60,12 +60,12 @@ import org.slf4j.spi.LocationAwareLogger;
* // add SLF4JBridgeHandler to j.u.l's root logger, should be done once during
* // the initialization phase of your application
* SLF4JBridgeHandler.install();</pre>
* <p><b>Installation via <em>logging.properties</em> configuration file:</b></p>
* <p><b>Installation via <em>logging.properties</em> configuration file:</b>
* <pre>
* // register SLF4JBridgeHandler as handler for the j.u.l. root logger
* handlers = org.slf4j.bridge.SLF4JBridgeHandler</pre>
* <p>Once SLF4JBridgeHandler is installed, logging by j.u.l. loggers will be directed to
* SLF4J. Example: </p>
* SLF4J. Example:
* <pre>
* import java.util.logging.Logger;
* ...
@ -81,10 +81,10 @@ import org.slf4j.spi.LocationAwareLogger;
* statements (20% overall increase).</b> Please note that as of logback-version 0.9.25,
* it is possible to completely eliminate the 60 fold translation overhead for disabled
* log statements with the help of <a href="http://logback.qos.ch/manual/configuration.html#LevelChangePropagator">LevelChangePropagator</a>.
* </p>
*
*
* <p>If you are concerned about application performance, then use of <code>SLF4JBridgeHandler</code>
* is appropriate only if any one the following two conditions is true:</p>
* is appropriate only if any one the following two conditions is true:
* <ol>
* <li>few j.u.l. logging statements are in play</li>
* <li>LevelChangePropagator has been installed</li>
@ -118,9 +118,8 @@ public class SLF4JBridgeHandler extends Handler {
/**
* Adds a SLF4JBridgeHandler instance to jul's root logger.
* <p/>
* <p/>
* This handler will redirect j.u.l. logging to SLF4J. However, only logs enabled
*
* <p>This handler will redirect j.u.l. logging to SLF4J. However, only logs enabled
* in j.u.l. will be redirected. For example, if a log statement invoking a
* j.u.l. logger is disabled, then the corresponding non-event will <em>not</em>
* reach SLF4JBridgeHandler and cannot be redirected.
@ -283,10 +282,10 @@ public class SLF4JBridgeHandler extends Handler {
/**
* Publish a LogRecord.
* <p/>
* <p>
* The logging request was made initially to a Logger object, which
* initialized the LogRecord and forwarded it here.
* <p/>
* <p>
* This handler ignores the Level attached to the LogRecord, as SLF4J cares
* about discarding log statements.
*

View File

@ -7,7 +7,7 @@
<parent>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-parent</artifactId>
<version>2.0.0-alpha0-SNAPSHOT</version>
<version>2.0.0-alpha0</version>
</parent>

View File

@ -54,7 +54,7 @@ public interface Appender {
/**
* Release any resources allocated within the appender such as file
* handles, network connections, etc.
* <p/>
*
* <p>It is a programming error to append to a closed appender.
*
* @since 0.8.4
@ -119,7 +119,7 @@ public interface Appender {
* a layout is not required, then layout configuration will be
* skipped even if there is available layout configuration
* information at the disposal of the configurator.
* <p/>
*
* <p>In the rather exceptional case, where the appender
* implementation admits a layout but can also work without it, then
* the appender should return <code>true</code>.

View File

@ -29,7 +29,7 @@ import java.util.Enumeration;
* This class is a minimal implementation of the original
* <code>org.apache.log4j.Category</code> class (as found in log4j 1.2) by
* delegation of all calls to a {@link org.slf4j.Logger} instance.
* </p>
*
*
* <p>
* Log4j's <code>trace</code>, <code>debug()</code>, <code>info()</code>,

View File

@ -20,7 +20,7 @@ package org.apache.log4j;
/**
* This class is a minimal implementation of the original Log4J class.
*
* @author Christian Trutz <christian.trutz@belaso.de>
* @author Christian Trutz
* */
public class Layout {

View File

@ -22,12 +22,11 @@ import java.util.Enumeration;
import java.util.Vector;
/**
* <p/>
* <p>
* This class is a minimal implementation of the original
* <code>org.apache.log4j.LogManager</code> class (as found in log4j 1.2)
* delegating all calls to SLF4J.
* <p/>
* <p/>
* <p>
* This implementation does <b>NOT</b> implement the setRepositorySelector(),
* getLoggerRepository(), exists(), getCurrentLoggers(), shutdown() and
* resetConfiguration() methods which do not have SLF4J equivalents.

View File

@ -24,7 +24,7 @@ import org.slf4j.spi.LocationAwareLogger;
* This class is a minimal implementation of the original
* <code>org.apache.log4j.Logger</code> class (as found in log4j 1.2)
* delegating all calls to a {@link org.slf4j.Logger} instance.
* </p>
*
*
* @author Ceki G&uuml;lc&uuml;
* */

View File

@ -21,8 +21,8 @@ package org.apache.log4j;
// Contributors: Kitching Simon <Simon.Kitching@OOOrange.ch>
/**
<font color="#AA4444">Refrain from using this class directly, use
the {@link Level} class instead</font>.
<b>Refrain from using this class directly, use
the {@link Level} class instead</b>.
@author Ceki G&uuml;lc&uuml; */
public class Priority {

View File

@ -7,7 +7,7 @@
<parent>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-parent</artifactId>
<version>2.0.0-alpha0-SNAPSHOT</version>
<version>2.0.0-alpha0</version>
</parent>
<artifactId>osgi-over-slf4j</artifactId>

23
pom.xml
View File

@ -6,7 +6,7 @@
<groupId>org.slf4j</groupId>
<artifactId>slf4j-parent</artifactId>
<version>2.0.0-alpha0-SNAPSHOT</version>
<version>2.0.0-alpha0</version>
<packaging>pom</packaging>
<name>SLF4J</name>
@ -47,9 +47,9 @@
<log4j.version>1.2.17</log4j.version>
<logback.version>1.0.13</logback.version>
<junit.version>4.12</junit.version>
<maven-site-plugin.version>3.6</maven-site-plugin.version>
<maven-site-plugin.version>3.7.1</maven-site-plugin.version>
<compiler-plugin.version>3.8.0</compiler-plugin.version>
<javadoc.plugin.version>2.10.4</javadoc.plugin.version>
<maven-javadoc-plugin.version>3.1.0</maven-javadoc-plugin.version>
<maven-source-plugin.version>3.0.1</maven-source-plugin.version>
</properties>
@ -218,7 +218,7 @@
<artifactId>maven-surefire-plugin</artifactId>
<version>2.19.1</version>
<configuration>
<forkCount>2C</forkCount>
<forkCount>1</forkCount>
<reuseForks>false</reuseForks>
<reportFormat>plain</reportFormat>
<trimStackTrace>false</trimStackTrace>
@ -272,7 +272,17 @@
</executions>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-site-plugin</artifactId>
<version>${maven-site-plugin.version}</version>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-project-info-reports-plugin</artifactId>
<version>3.0.0</version>
</plugin>
</plugins>
</build>
@ -292,11 +302,12 @@
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>${javadoc-plugin.version}</version>
<version>${maven-javadoc-plugin.version}</version>
<configuration>
<linkJavadoc>true</linkJavadoc>
<linksource>true</linksource>
<aggregate>true</aggregate>
<additionalparam>-Xdoclint:none</additionalparam>
<excludePackageNames>org.slf4j.migrator:org.slf4j.migrator.*</excludePackageNames>
<sourceFileExcludes>
<sourceFileExclude>**/module-info.java</sourceFileExclude>

View File

@ -7,7 +7,7 @@
<parent>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-parent</artifactId>
<version>2.0.0-alpha0-SNAPSHOT</version>
<version>2.0.0-alpha0</version>
</parent>
<artifactId>slf4j-api</artifactId>

View File

@ -39,7 +39,7 @@ import org.slf4j.spi.NOPLoggingEventBuilder;
* The org.slf4j.Logger interface is the main user entry point of SLF4J API.
* It is expected that logging takes place through concrete implementations
* of this interface.
* <p/>
*
* <h3>Typical usage pattern:</h3>
* <pre>
* import org.slf4j.Logger;
@ -55,7 +55,7 @@ import org.slf4j.spi.NOPLoggingEventBuilder;
* oldT = t;
* t = temperature;
* <span style="color:green">logger.debug("Temperature set to {}. Old temperature was {}.", t, oldT);</span>
* if(temperature.intValue() > 50) {
* if(temperature.intValue() &gt; 50) {
* <span style="color:green">logger.info("Temperature has risen above 50 degrees.");</span>
* }
* }
@ -67,7 +67,7 @@ import org.slf4j.spi.NOPLoggingEventBuilder;
* <a href="../../../faq.html#paramException">presence of an exception/throwable</a>.
*
* <p>Once you are comfortable using loggers, i.e. instances of this interface, consider using
* <a href="MDC.html">MDC</a> as well as <a href="Marker.html">Markers</a>.</p>
* <a href="MDC.html">MDC</a> as well as <a href="Marker.html">Markers</a>.
*
* @author Ceki G&uuml;lc&uuml;
*/
@ -106,9 +106,9 @@ public interface Logger {
/**
* Log a message at the TRACE level according to the specified format
* and argument.
* <p/>
*
* <p>This form avoids superfluous object creation when the logger
* is disabled for the TRACE level. </p>
* is disabled for the TRACE level.
*
* @param format the format string
* @param arg the argument
@ -119,9 +119,9 @@ public interface Logger {
/**
* Log a message at the TRACE level according to the specified format
* and arguments.
* <p/>
*
* <p>This form avoids superfluous object creation when the logger
* is disabled for the TRACE level. </p>
* is disabled for the TRACE level.
*
* @param format the format string
* @param arg1 the first argument
@ -133,12 +133,12 @@ public interface Logger {
/**
* Log a message at the TRACE level according to the specified format
* and arguments.
* <p/>
*
* <p>This form avoids superfluous string concatenation when the logger
* is disabled for the TRACE level. However, this variant incurs the hidden
* (and relatively small) cost of creating an <code>Object[]</code> before invoking the method,
* even if this logger is disabled for TRACE. The variants taking {@link #trace(String, Object) one} and
* {@link #trace(String, Object, Object) two} arguments exist solely in order to avoid this hidden cost.</p>
* {@link #trace(String, Object, Object) two} arguments exist solely in order to avoid this hidden cost.
*
* @param format the format string
* @param arguments a list of 3 or more arguments
@ -255,9 +255,9 @@ public interface Logger {
/**
* Log a message at the DEBUG level according to the specified format
* and argument.
* <p/>
*
* <p>This form avoids superfluous object creation when the logger
* is disabled for the DEBUG level. </p>
* is disabled for the DEBUG level.
*
* @param format the format string
* @param arg the argument
@ -267,9 +267,9 @@ public interface Logger {
/**
* Log a message at the DEBUG level according to the specified format
* and arguments.
* <p/>
*
* <p>This form avoids superfluous object creation when the logger
* is disabled for the DEBUG level. </p>
* is disabled for the DEBUG level.
*
* @param format the format string
* @param arg1 the first argument
@ -280,13 +280,13 @@ public interface Logger {
/**
* Log a message at the DEBUG level according to the specified format
* and arguments.
* <p/>
*
* <p>This form avoids superfluous string concatenation when the logger
* is disabled for the DEBUG level. However, this variant incurs the hidden
* (and relatively small) cost of creating an <code>Object[]</code> before invoking the method,
* even if this logger is disabled for DEBUG. The variants taking
* {@link #debug(String, Object) one} and {@link #debug(String, Object, Object) two}
* arguments exist solely in order to avoid this hidden cost.</p>
* arguments exist solely in order to avoid this hidden cost.
*
* @param format the format string
* @param arguments a list of 3 or more arguments
@ -395,9 +395,9 @@ public interface Logger {
/**
* Log a message at the INFO level according to the specified format
* and argument.
* <p/>
*
* <p>This form avoids superfluous object creation when the logger
* is disabled for the INFO level. </p>
* is disabled for the INFO level.
*
* @param format the format string
* @param arg the argument
@ -407,9 +407,9 @@ public interface Logger {
/**
* Log a message at the INFO level according to the specified format
* and arguments.
* <p/>
*
* <p>This form avoids superfluous object creation when the logger
* is disabled for the INFO level. </p>
* is disabled for the INFO level.
*
* @param format the format string
* @param arg1 the first argument
@ -420,13 +420,13 @@ public interface Logger {
/**
* Log a message at the INFO level according to the specified format
* and arguments.
* <p/>
*
* <p>This form avoids superfluous string concatenation when the logger
* is disabled for the INFO level. However, this variant incurs the hidden
* (and relatively small) cost of creating an <code>Object[]</code> before invoking the method,
* even if this logger is disabled for INFO. The variants taking
* {@link #info(String, Object) one} and {@link #info(String, Object, Object) two}
* arguments exist solely in order to avoid this hidden cost.</p>
* arguments exist solely in order to avoid this hidden cost.
*
* @param format the format string
* @param arguments a list of 3 or more arguments
@ -534,9 +534,9 @@ public interface Logger {
/**
* Log a message at the WARN level according to the specified format
* and argument.
* <p/>
*
* <p>This form avoids superfluous object creation when the logger
* is disabled for the WARN level. </p>
* is disabled for the WARN level.
*
* @param format the format string
* @param arg the argument
@ -546,13 +546,13 @@ public interface Logger {
/**
* Log a message at the WARN level according to the specified format
* and arguments.
* <p/>
*
* <p>This form avoids superfluous string concatenation when the logger
* is disabled for the WARN level. However, this variant incurs the hidden
* (and relatively small) cost of creating an <code>Object[]</code> before invoking the method,
* even if this logger is disabled for WARN. The variants taking
* {@link #warn(String, Object) one} and {@link #warn(String, Object, Object) two}
* arguments exist solely in order to avoid this hidden cost.</p>
* arguments exist solely in order to avoid this hidden cost.
*
* @param format the format string
* @param arguments a list of 3 or more arguments
@ -562,9 +562,9 @@ public interface Logger {
/**
* Log a message at the WARN level according to the specified format
* and arguments.
* <p/>
*
* <p>This form avoids superfluous object creation when the logger
* is disabled for the WARN level. </p>
* is disabled for the WARN level.
*
* @param format the format string
* @param arg1 the first argument
@ -675,9 +675,9 @@ public interface Logger {
/**
* Log a message at the ERROR level according to the specified format
* and argument.
* <p/>
*
* <p>This form avoids superfluous object creation when the logger
* is disabled for the ERROR level. </p>
* is disabled for the ERROR level.
*
* @param format the format string
* @param arg the argument
@ -687,9 +687,9 @@ public interface Logger {
/**
* Log a message at the ERROR level according to the specified format
* and arguments.
* <p/>
*
* <p>This form avoids superfluous object creation when the logger
* is disabled for the ERROR level. </p>
* is disabled for the ERROR level.
*
* @param format the format string
* @param arg1 the first argument
@ -700,13 +700,13 @@ public interface Logger {
/**
* Log a message at the ERROR level according to the specified format
* and arguments.
* <p/>
*
* <p>This form avoids superfluous string concatenation when the logger
* is disabled for the ERROR level. However, this variant incurs the hidden
* (and relatively small) cost of creating an <code>Object[]</code> before invoking the method,
* even if this logger is disabled for ERROR. The variants taking
* {@link #error(String, Object) one} and {@link #error(String, Object, Object) two}
* arguments exist solely in order to avoid this hidden cost.</p>
* arguments exist solely in order to avoid this hidden cost.
*
* @param format the format string
* @param arguments a list of 3 or more arguments

View File

@ -46,17 +46,15 @@ import org.slf4j.spi.SLF4JServiceProvider;
/**
* The <code>LoggerFactory</code> is a utility class producing Loggers for
* various logging APIs, most notably for log4j, logback and JDK 1.4 logging.
* Other implementations such as {@link org.slf4j.impl.NOPLogger NOPLogger} and
* {@link org.slf4j.impl.SimpleLogger SimpleLogger} are also supported.
* <p/>
* <p/>
* <code>LoggerFactory</code> is essentially a wrapper around an
* Other implementations such as {@link org.slf4j.nop.NOPLogger NOPLogger} and
* {@link org.slf4j.simple.SimpleLogger SimpleLogger} are also supported.
*
* <p><code>LoggerFactory</code> is essentially a wrapper around an
* {@link ILoggerFactory} instance bound with <code>LoggerFactory</code> at
* compile time.
* <p/>
* <p/>
* Please note that all methods in <code>LoggerFactory</code> are static.
*
* <p>
* Please note that all methods in <code>LoggerFactory</code> are static.
*
* @author Alexander Dorokhine
* @author Robert Elliot
@ -112,8 +110,8 @@ public final class LoggerFactory {
/**
* It is LoggerFactory's responsibility to track version changes and manage
* the compatibility list.
* <p/>
* <p/>
* <p>
* <p>
* It is assumed that all versions in the 1.6 are mutually compatible.
*/
static private final String[] API_COMPATIBILITY_LIST = new String[] { "1.8", "1.7" };
@ -124,13 +122,13 @@ public final class LoggerFactory {
/**
* Force LoggerFactory to consider itself uninitialized.
* <p/>
* <p/>
* <p>
* <p>
* This method is intended to be called by classes (in the same package) for
* testing purposes. This method is internal. It can be modified, renamed or
* removed at any time without notice.
* <p/>
* <p/>
* <p>
* <p>
* You are strongly discouraged from calling this method in production code.
*/
static void reset() {
@ -395,8 +393,8 @@ public final class LoggerFactory {
/**
* Return the {@link ILoggerFactory} instance in use.
* <p/>
* <p/>
* <p>
* <p>
* ILoggerFactory instance is bound with this class at compile time.
*
* @return the ILoggerFactory instance in use

View File

@ -2,10 +2,10 @@ package org.slf4j;
/**
* All methods in this class are reserved for internal use, for testing purposes.
* <p/>
* <p/>They can can be modified, renamed or removed at any time without notice.
* <p/>
* You are strongly discouraged calling any of the methods of this class.
*
* <p>They can can be modified, renamed or removed at any time without notice.
*
* <p>You are strongly discouraged calling any of the methods of this class.
*
* @since 1.8.0
*
@ -14,7 +14,7 @@ package org.slf4j;
public class LoggerFactoryFriend {
/*
* Force LoggerFactory to consider itself uninitialized. <p/>
* Force LoggerFactory to consider itself uninitialized.
*/
static public void reset() {
LoggerFactory.reset();

View File

@ -37,8 +37,8 @@ import org.slf4j.event.SubstituteLoggingEvent;
/**
* A logger implementation which logs via a delegate logger. By default, the delegate is a
* {@link NOPLogger}. However, a different delegate can be set at any time.
* <p/>
* See also the <a href="http://www.slf4j.org/codes.html#substituteLogger">relevant
*
* <p>See also the <a href="http://www.slf4j.org/codes.html#substituteLogger">relevant
* error code</a> documentation.
*
* @author Chetan Mehrotra

View File

@ -7,7 +7,7 @@
<parent>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-parent</artifactId>
<version>2.0.0-alpha0-SNAPSHOT</version>
<version>2.0.0-alpha0</version>
</parent>
<artifactId>slf4j-ext</artifactId>

View File

@ -28,12 +28,12 @@ package org.slf4j.agent;
* <p>
* All recognized options in the string passed to the java agent. For
* "java -javaagent:foo.jar=OPTIONS HelloWorld" this would be "OPTIONS".
* </p>
*
* <p>
* It is considered to be a list of options separated by (currently) ";", on the
* form "option=value". The interpretation of "value" is specific to each
* option.
* </p>
*
*/
public class AgentOptions {

View File

@ -35,7 +35,7 @@ import ch.qos.cal10n.MessageParameterObj;
/**
* A logger specialized in localized logging. Localization is based in the <a
* href="http://cal10n.qos.ch">CAL10N project</p>.
* href="http://cal10n.qos.ch">CAL10N project</a>.
*
* @author Ceki G&uuml;lc&uuml;
*/

View File

@ -46,11 +46,11 @@ import org.slf4j.helpers.MessageFormatter;
* <p>
* LogTransformer does the work of analyzing each class, and if appropriate add
* log statements to each method to allow logging entry/exit.
* </p>
*
* <p>
* This class is based on the article <a href="http://today.java.net/pub/a/today/2008/04/24/add-logging-at-class-load-time-with-instrumentation.html"
* >Add Logging at Class Load Time with Java Instrumentation</a>.
* </p>
*
*/
public class LogTransformer implements ClassFileTransformer {

View File

@ -7,7 +7,7 @@
<parent>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-parent</artifactId>
<version>2.0.0-alpha0-SNAPSHOT</version>
<version>2.0.0-alpha0</version>
</parent>
<artifactId>slf4j-jdk14</artifactId>

View File

@ -87,7 +87,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for level FINEST.
* </p>
*
*
* @param format
* the format string
@ -108,7 +108,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the FINEST level.
* </p>
*
*
* @param format
* the format string
@ -131,7 +131,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the FINEST level.
* </p>
*
*
* @param format
* the format string
@ -186,7 +186,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for level FINE.
* </p>
*
*
* @param format
* the format string
@ -207,7 +207,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the FINE level.
* </p>
*
*
* @param format
* the format string
@ -230,7 +230,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the FINE level.
* </p>
*
*
* @param format
* the format string
@ -285,7 +285,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the INFO level.
* </p>
*
*
* @param format
* the format string
@ -306,7 +306,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the INFO level.
* </p>
*
*
* @param format
* the format string
@ -329,7 +329,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the INFO level.
* </p>
*
*
* @param format
* the format string
@ -387,7 +387,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the WARNING level.
* </p>
*
*
* @param format
* the format string
@ -408,7 +408,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the WARNING level.
* </p>
*
*
* @param format
* the format string
@ -431,7 +431,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the WARNING level.
* </p>
*
*
* @param format
* the format string
@ -488,7 +488,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the SEVERE level.
* </p>
*
*
* @param format
* the format string
@ -509,7 +509,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the SEVERE level.
* </p>
*
*
* @param format
* the format string
@ -532,7 +532,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the SEVERE level.
* </p>
*
*
* @param format
* the format string

View File

@ -7,7 +7,7 @@
<parent>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-parent</artifactId>
<version>2.0.0-alpha0-SNAPSHOT</version>
<version>2.0.0-alpha0</version>
</parent>
<artifactId>slf4j-log4j12</artifactId>

View File

@ -121,7 +121,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for level TRACE.
* </p>
*
*
* @param format
* the format string
@ -142,7 +142,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the TRACE level.
* </p>
*
*
* @param format
* the format string
@ -165,7 +165,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the TRACE level.
* </p>
*
*
* @param format
* the format string
@ -217,7 +217,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for level DEBUG.
* </p>
*
*
* @param format
* the format string
@ -238,7 +238,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the DEBUG level.
* </p>
*
*
* @param format
* the format string
@ -261,7 +261,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the DEBUG level.
* </p>
*
*
* @param format
* the format string
@ -311,7 +311,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the INFO level.
* </p>
*
*
* @param format
* the format string
@ -332,7 +332,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the INFO level.
* </p>
*
*
* @param format
* the format string
@ -355,7 +355,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the INFO level.
* </p>
*
*
* @param format
* the format string
@ -408,7 +408,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the WARN level.
* </p>
*
*
* @param format
* the format string
@ -429,7 +429,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the WARN level.
* </p>
*
*
* @param format
* the format string
@ -452,7 +452,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the WARN level.
* </p>
*
*
* @param format
* the format string
@ -505,7 +505,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the ERROR level.
* </p>
*
*
* @param format
* the format string
@ -526,7 +526,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the ERROR level.
* </p>
*
*
* @param format
* the format string
@ -549,7 +549,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
* <p>
* This form avoids superfluous object creation when the logger is disabled
* for the ERROR level.
* </p>
*
*
* @param format
* the format string

View File

@ -7,7 +7,7 @@
<parent>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-parent</artifactId>
<version>2.0.0-alpha0-SNAPSHOT</version>
<version>2.0.0-alpha0</version>
</parent>
<artifactId>slf4j-migrator</artifactId>

View File

@ -229,14 +229,14 @@ public class MigratorFrame extends JFrame implements ActionListener {
private void createAwareLabel() {
awareLabel = new JLabel();
awareLabel.setText("<html>" + "<p>I am aware that this tool will directly modify all Java source files</p>"
+ "<p>in the selected folder without creating backup files.</p>" + "</html>");
awareLabel.setText("<html>" + "<p>I am aware that this tool will directly modify all Java source files"
+ "<p>in the selected folder without creating backup files." + "</html>");
}
private void createWarningLabel() {
warningLabel = new JLabel();
warningLabel.setText("<html>" + "<p><span color=\"red\">WARNING:</span> This SLF4J migration tool will directly modify all Java source files</p>"
+ "<p>in the selected project folder without creating a backup of the original files.</p>" + "</html>");
warningLabel.setText("<html>" + "<p><span color=\"red\">WARNING:</span> This SLF4J migration tool will directly modify all Java source files"
+ "<p>in the selected project folder without creating a backup of the original files." + "</html>");
}
private void createMigrateButton() {
@ -341,7 +341,7 @@ public class MigratorFrame extends JFrame implements ActionListener {
buf.append(i);
buf.append(". ");
buf.append(msg);
buf.append("</p>");
buf.append("");
i++;
}
buf.append("</html>");

View File

@ -7,7 +7,7 @@
<parent>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-parent</artifactId>
<version>2.0.0-alpha0-SNAPSHOT</version>
<version>2.0.0-alpha0</version>
</parent>
<artifactId>slf4j-nop</artifactId>

View File

@ -7,7 +7,7 @@
<parent>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-parent</artifactId>
<version>2.0.0-alpha0-SNAPSHOT</version>
<version>2.0.0-alpha0</version>
</parent>
<artifactId>slf4j-simple</artifactId>

View File

@ -39,7 +39,7 @@ import org.slf4j.spi.LocationAwareLogger;
* Simple implementation of {@link Logger} that sends all enabled log messages,
* for all defined loggers, to the console ({@code System.err}). The following
* system properties are supported to configure the behavior of this logger:
* </p>
*
*
* <ul>
* <li><code>org.slf4j.simpleLogger.logFile</code> - The output target which can
@ -103,17 +103,17 @@ import org.slf4j.spi.LocationAwareLogger;
* this implementation also checks for a class loader resource named
* <code>"simplelogger.properties"</code>, and includes any matching definitions
* from this resource (if it exists).
* </p>
*
*
* <p>
* With no configuration, the default output includes the relative time in
* milliseconds, thread name, the level, logger name, and the message followed
* by the line separator for the host. In log4j terms it amounts to the "%r [%t]
* %level %logger - %m%n" pattern.
* </p>
*
* <p>
* Sample output follows.
* </p>
*
*
* <pre>
* 176 [main] INFO examples.Sort - Populating an array of 2 elements in reverse order.
@ -132,7 +132,7 @@ import org.slf4j.spi.LocationAwareLogger;
* This implementation is heavily inspired by
* <a href="http://commons.apache.org/logging/">Apache Commons Logging</a>'s
* SimpleLog.
* </p>
*
*
* @author Ceki G&uuml;lc&uuml;
* @author Scott Sanders

View File

@ -7,7 +7,7 @@
<parent>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-parent</artifactId>
<version>2.0.0-alpha0-SNAPSHOT</version>
<version>2.0.0-alpha0</version>
</parent>
<artifactId>slf4j-site</artifactId>