This is an automated email from the ASF dual-hosted git repository.
rgoers pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/logging-log4j2.git
The following commit(s) were added to refs/heads/master by this push:
new a4a2418 Javadoc fixes
a4a2418 is described below
commit a4a241816ee5a217b3ae64610594f6bb40d69e89
Author: Ralph Goers <[email protected]>
AuthorDate: Sun Mar 29 21:34:22 2020 -0700
Javadoc fixes
---
log4j-1.2-api/pom.xml | 1 +
log4j-api/pom.xml | 1 +
.../main/java/org/apache/logging/log4j/Logger.java | 8 +++++---
.../log4j/message/AbstractMessageFactory.java | 2 +-
.../log4j/message/FormattedMessageFactory.java | 3 ++-
.../logging/log4j/message/LocalizedMessage.java | 2 ++
.../log4j/message/LocalizedMessageFactory.java | 3 ++-
.../org/apache/logging/log4j/message/MapMessage.java | 20 ++++++++++++++++++++
.../log4j/message/MessageFormatMessageFactory.java | 3 ++-
.../logging/log4j/message/ParameterConsumer.java | 2 +-
.../log4j/message/ParameterizedMessageFactory.java | 3 ++-
.../ParameterizedNoReferenceMessageFactory.java | 1 +
.../logging/log4j/message/ReusableMessage.java | 2 +-
.../logging/log4j/message/SimpleMessageFactory.java | 3 ++-
.../log4j/message/StringFormattedMessage.java | 3 ++-
.../log4j/message/StringFormatterMessageFactory.java | 1 +
.../logging/log4j/message/StructuredDataId.java | 9 +++++----
.../logging/log4j/message/ThreadDumpMessage.java | 1 -
.../org/apache/logging/log4j/spi/AbstractLogger.java | 10 ++++++----
.../logging/log4j/spi/AbstractLoggerAdapter.java | 1 +
.../org/apache/logging/log4j/spi/LoggerContext.java | 1 +
.../logging/log4j/spi/MutableThreadContextStack.java | 2 +-
.../logging/log4j/spi/ObjectThreadContextMap.java | 3 +++
.../org/apache/logging/log4j/util/Constants.java | 2 +-
.../logging/log4j/util/IndexedReadOnlyStringMap.java | 1 +
.../org/apache/logging/log4j/util/LambdaUtil.java | 1 +
.../org/apache/logging/log4j/util/LoaderUtil.java | 2 ++
.../apache/logging/log4j/util/MessageSupplier.java | 2 +-
.../logging/log4j/util/PerformanceSensitive.java | 5 ++++-
.../apache/logging/log4j/util/ReadOnlyStringMap.java | 1 +
.../logging/log4j/util/SortedArrayStringMap.java | 6 ++++++
.../java/org/apache/logging/log4j/util/Strings.java | 2 ++
.../java/org/apache/logging/log4j/util/Timer.java | 2 ++
log4j-appserver/pom.xml | 1 +
log4j-cassandra/pom.xml | 1 +
log4j-core/pom.xml | 1 +
log4j-couchdb/pom.xml | 1 +
log4j-csv/pom.xml | 1 +
log4j-docker/pom.xml | 1 +
log4j-flume-ng/pom.xml | 1 +
log4j-iostreams/pom.xml | 1 +
log4j-jcl/pom.xml | 1 +
log4j-jdbc-dbcp2/pom.xml | 1 +
log4j-jdbc/pom.xml | 1 +
log4j-jeromq/pom.xml | 1 +
log4j-jms/pom.xml | 1 +
log4j-jmx-gui/pom.xml | 1 +
log4j-jpa/pom.xml | 1 +
log4j-jul/pom.xml | 1 +
log4j-kafka/pom.xml | 1 +
log4j-kubernetes/pom.xml | 1 +
log4j-layout-jackson-json/pom.xml | 1 +
.../log4j/jackson/json/Log4jJsonObjectMapper.java | 4 ++++
log4j-layout-jackson-xml/pom.xml | 1 +
log4j-layout-jackson-yaml/pom.xml | 1 +
log4j-layout-jackson/pom.xml | 1 +
log4j-liquibase/pom.xml | 1 +
log4j-mongodb2/pom.xml | 1 +
log4j-mongodb3/pom.xml | 1 +
log4j-osgi/pom.xml | 1 +
log4j-plugins/pom.xml | 1 +
.../org/apache/logging/log4j/plugins/Plugin.java | 9 +++++++--
.../apache/logging/log4j/plugins/PluginAliases.java | 1 +
.../logging/log4j/plugins/PluginAttribute.java | 12 ++++++++++++
.../log4j/plugins/PluginBuilderAttribute.java | 2 ++
.../apache/logging/log4j/plugins/PluginElement.java | 1 +
.../apache/logging/log4j/plugins/PluginValue.java | 1 +
.../logging/log4j/plugins/convert/HexConverter.java | 2 +-
.../log4j/plugins/convert/TypeConverters.java | 1 +
.../log4j/plugins/processor/package-info.java | 2 +-
.../apache/logging/log4j/plugins/util/Builder.java | 1 -
.../logging/log4j/plugins/util/PluginRegistry.java | 19 +++++++++++++++++++
.../logging/log4j/plugins/util/PluginType.java | 9 +++++++++
.../logging/log4j/plugins/util/package-info.java | 2 +-
.../logging/log4j/plugins/validation/Constraint.java | 1 +
.../plugins/validation/constraints/Required.java | 1 +
.../plugins/validation/constraints/ValidHost.java | 1 +
.../plugins/validation/constraints/ValidPort.java | 1 +
log4j-slf4j-impl/pom.xml | 1 +
log4j-slf4j18-impl/pom.xml | 1 +
log4j-smtp/pom.xml | 1 +
.../log4j-spring-cloud-config-client/pom.xml | 1 +
log4j-taglib/pom.xml | 1 +
log4j-to-slf4j/pom.xml | 1 +
log4j-web/pom.xml | 1 +
pom.xml | 2 +-
86 files changed, 183 insertions(+), 32 deletions(-)
diff --git a/log4j-1.2-api/pom.xml b/log4j-1.2-api/pom.xml
index 9c529d7..e0cb127 100644
--- a/log4j-1.2-api/pom.xml
+++ b/log4j-1.2-api/pom.xml
@@ -160,6 +160,7 @@
project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-api/pom.xml b/log4j-api/pom.xml
index 21f2b38..a7bd7ce 100644
--- a/log4j-api/pom.xml
+++ b/log4j-api/pom.xml
@@ -284,6 +284,7 @@
<links>
<link>http://www.osgi.org/javadoc/r4v43/core/</link>
</links>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/Logger.java
b/log4j-api/src/main/java/org/apache/logging/log4j/Logger.java
index b0b78e6..729e92f 100644
--- a/log4j-api/src/main/java/org/apache/logging/log4j/Logger.java
+++ b/log4j-api/src/main/java/org/apache/logging/log4j/Logger.java
@@ -68,7 +68,7 @@ import org.apache.logging.log4j.util.Supplier;
* </pre>
*
* <p>
- * Note that although {@link MessageSupplier} is provided, using {@link
Supplier {@code Supplier<Message>}} works just the
+ * Note that although {@link MessageSupplier} is provided, using {@link
Supplier {@code Supplier<Message>}} works just the
* same. MessageSupplier was deprecated in 2.6 and un-deprecated in 2.8.1.
Anonymous class usage of these APIs
* should prefer using Supplier instead.
* </p>
@@ -1681,6 +1681,7 @@ public interface Logger {
/**
* Gets the message factory used to convert message Objects and
Strings/CharSequences into actual log Messages.
*
+ * @param <MF> The type of the MessageFactory.
* @return the message factory, as an instance of {@link MessageFactory}
*/
<MF extends MessageFactory> MF getMessageFactory();
@@ -3524,7 +3525,7 @@ public interface Logger {
* <pre>
* <code>
* public void doSomething(Request foo) {
- * LOGGER.traceEntry(()->gson.toJson(foo));
+ * LOGGER.traceEntry(()->gson.toJson(foo));
* // do something
* }
* </code>
@@ -3543,7 +3544,7 @@ public interface Logger {
* <pre>
* <code>
* public void doSomething(String foo, int bar) {
- * LOGGER.traceEntry("Parameters: {} and {}", ()->gson.toJson(foo),
()-> bar);
+ * LOGGER.traceEntry("Parameters: {} and {}", ()->gson.toJson(foo),
()-> bar);
* // do something
* }
* </code>
@@ -4270,6 +4271,7 @@ public interface Logger {
}
/**
* Construct a log event.
+ * @param level The Logging Level.
* @return a LogBuilder.
* @since 2.13.0
*/
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/message/AbstractMessageFactory.java
b/log4j-api/src/main/java/org/apache/logging/log4j/message/AbstractMessageFactory.java
index cc4f328..9cd9b4d 100644
---
a/log4j-api/src/main/java/org/apache/logging/log4j/message/AbstractMessageFactory.java
+++
b/log4j-api/src/main/java/org/apache/logging/log4j/message/AbstractMessageFactory.java
@@ -21,7 +21,7 @@ import java.io.Serializable;
/**
* Provides an abstract superclass for {@link MessageFactory}. This class is
now unnecessary as all default
* methods are provided by the (@link MessageFactory) interface.
- * </p>
+ *
* @deprecated MessageFactory has default methods that implement all the
methods that were here.
*/
public abstract class AbstractMessageFactory implements MessageFactory,
Serializable {
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/message/FormattedMessageFactory.java
b/log4j-api/src/main/java/org/apache/logging/log4j/message/FormattedMessageFactory.java
index cf6ed3a..9e3a616 100644
---
a/log4j-api/src/main/java/org/apache/logging/log4j/message/FormattedMessageFactory.java
+++
b/log4j-api/src/main/java/org/apache/logging/log4j/message/FormattedMessageFactory.java
@@ -20,7 +20,8 @@ import java.io.Serializable;
/**
* Creates {@link FormattedMessage} instances for {@link MessageFactory}
methods.
- *
+ *
+ * <h3></h3>
* <h4>Note to implementors</h4>
* <p>
* This class implements all {@link MessageFactory} methods.
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/message/LocalizedMessage.java
b/log4j-api/src/main/java/org/apache/logging/log4j/message/LocalizedMessage.java
index caf04f7..b201020 100644
---
a/log4j-api/src/main/java/org/apache/logging/log4j/message/LocalizedMessage.java
+++
b/log4j-api/src/main/java/org/apache/logging/log4j/message/LocalizedMessage.java
@@ -103,6 +103,8 @@ public class LocalizedMessage implements Message,
LoggerNameAwareMessage {
}
/**
+ * @param bundle The ResourceBundle for this message.
+ * @param key The key of the message in the bundle.
* @since 2.8
*/
public LocalizedMessage(final ResourceBundle bundle, final String key) {
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/message/LocalizedMessageFactory.java
b/log4j-api/src/main/java/org/apache/logging/log4j/message/LocalizedMessageFactory.java
index d92878d..28379e7 100644
---
a/log4j-api/src/main/java/org/apache/logging/log4j/message/LocalizedMessageFactory.java
+++
b/log4j-api/src/main/java/org/apache/logging/log4j/message/LocalizedMessageFactory.java
@@ -21,7 +21,8 @@ import java.util.ResourceBundle;
/**
* Creates {@link FormattedMessage} instances for {@link MessageFactory}
methods.
- *
+ *
+ * <h3></h3>
* <h4>Note to implementors</h4>
* <p>
* This class does <em>not</em> implement any {@link MessageFactory} methods
and lets the superclass funnel those calls
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/message/MapMessage.java
b/log4j-api/src/main/java/org/apache/logging/log4j/message/MapMessage.java
index 2c4dc10..0199e67 100644
--- a/log4j-api/src/main/java/org/apache/logging/log4j/message/MapMessage.java
+++ b/log4j-api/src/main/java/org/apache/logging/log4j/message/MapMessage.java
@@ -509,6 +509,8 @@ public class MapMessage<M extends MapMessage<M, V>, V>
implements MultiFormatStr
/**
* Default implementation does nothing.
+ * @param key The key.
+ * @param value The boolean value.
*
* @since 2.9
*/
@@ -518,6 +520,8 @@ public class MapMessage<M extends MapMessage<M, V>, V>
implements MultiFormatStr
/**
* Default implementation does nothing.
+ * @param key The key.
+ * @param value The byte value.
*
* @since 2.9
*/
@@ -527,6 +531,8 @@ public class MapMessage<M extends MapMessage<M, V>, V>
implements MultiFormatStr
/**
* Default implementation does nothing.
+ * @param key The key.
+ * @param value The char value.
*
* @since 2.9
*/
@@ -536,6 +542,8 @@ public class MapMessage<M extends MapMessage<M, V>, V>
implements MultiFormatStr
/**
* Default implementation does nothing.
+ * @param key The key.
+ * @param value The double value.
*
* @since 2.9
*/
@@ -545,6 +553,8 @@ public class MapMessage<M extends MapMessage<M, V>, V>
implements MultiFormatStr
/**
* Default implementation does nothing.
+ * @param key The key.
+ * @param value The float value.
*
* @since 2.9
*/
@@ -554,6 +564,8 @@ public class MapMessage<M extends MapMessage<M, V>, V>
implements MultiFormatStr
/**
* Default implementation does nothing.
+ * @param key The key.
+ * @param value The integer value.
*
* @since 2.9
*/
@@ -563,6 +575,8 @@ public class MapMessage<M extends MapMessage<M, V>, V>
implements MultiFormatStr
/**
* Default implementation does nothing.
+ * @param key The key.
+ * @param value The long value.
*
* @since 2.9
*/
@@ -572,6 +586,8 @@ public class MapMessage<M extends MapMessage<M, V>, V>
implements MultiFormatStr
/**
* Default implementation does nothing.
+ * @param key The key.
+ * @param value The Object value.
*
* @since 2.9
*/
@@ -581,6 +597,8 @@ public class MapMessage<M extends MapMessage<M, V>, V>
implements MultiFormatStr
/**
* Default implementation does nothing.
+ * @param key The key.
+ * @param value The short value.
*
* @since 2.9
*/
@@ -590,6 +608,8 @@ public class MapMessage<M extends MapMessage<M, V>, V>
implements MultiFormatStr
/**
* Default implementation does nothing.
+ * @param key The key.
+ * @param value The string value.
*
* @since 2.9
*/
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/message/MessageFormatMessageFactory.java
b/log4j-api/src/main/java/org/apache/logging/log4j/message/MessageFormatMessageFactory.java
index bab3c89..1fae368 100644
---
a/log4j-api/src/main/java/org/apache/logging/log4j/message/MessageFormatMessageFactory.java
+++
b/log4j-api/src/main/java/org/apache/logging/log4j/message/MessageFormatMessageFactory.java
@@ -20,7 +20,8 @@ import java.io.Serializable;
/**
* Creates {@link FormattedMessage} instances for {@link MessageFactory}
methods.
- *
+ *
+ * <h3></h3>
* <h4>Note to implementors</h4>
* <p>
* This class implements all {@link MessageFactory} methods.
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/message/ParameterConsumer.java
b/log4j-api/src/main/java/org/apache/logging/log4j/message/ParameterConsumer.java
index 8b81e1a..7513e95 100644
---
a/log4j-api/src/main/java/org/apache/logging/log4j/message/ParameterConsumer.java
+++
b/log4j-api/src/main/java/org/apache/logging/log4j/message/ParameterConsumer.java
@@ -19,7 +19,7 @@ public interface ParameterConsumer<S> {
*
* @param parameter the parameter
* @param parameterIndex Index of the parameter
- * @param state
+ * @param state The state data.
*/
void accept(Object parameter, int parameterIndex, S state);
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/message/ParameterizedMessageFactory.java
b/log4j-api/src/main/java/org/apache/logging/log4j/message/ParameterizedMessageFactory.java
index 8716f18..bc9b16b 100644
---
a/log4j-api/src/main/java/org/apache/logging/log4j/message/ParameterizedMessageFactory.java
+++
b/log4j-api/src/main/java/org/apache/logging/log4j/message/ParameterizedMessageFactory.java
@@ -29,7 +29,8 @@ import java.io.Serializable;
* <p>
* This class is immutable.
* </p>
- *
+ *
+ * <h3></h3>
* <h4>Note to implementors</h4>
* <p>
* This class implements all {@link MessageFactory} methods.
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/message/ParameterizedNoReferenceMessageFactory.java
b/log4j-api/src/main/java/org/apache/logging/log4j/message/ParameterizedNoReferenceMessageFactory.java
index 3ad9e85..0d9375d 100644
---
a/log4j-api/src/main/java/org/apache/logging/log4j/message/ParameterizedNoReferenceMessageFactory.java
+++
b/log4j-api/src/main/java/org/apache/logging/log4j/message/ParameterizedNoReferenceMessageFactory.java
@@ -32,6 +32,7 @@ import java.io.Serializable;
* <p>
* This class is immutable.
* </p>
+ * <h3></h3>
* <h4>Note to implementors</h4>
* <p>
* This class does <em>not</em> implement any {@link MessageFactory} methods
and lets the superclass funnel those calls
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/message/ReusableMessage.java
b/log4j-api/src/main/java/org/apache/logging/log4j/message/ReusableMessage.java
index 82e40ac..f1ab320 100644
---
a/log4j-api/src/main/java/org/apache/logging/log4j/message/ReusableMessage.java
+++
b/log4j-api/src/main/java/org/apache/logging/log4j/message/ReusableMessage.java
@@ -35,7 +35,7 @@ public interface ReusableMessage extends Message,
StringBuilderFormattable {
* Returns the parameter array that was used to initialize this reusable
message and replaces it with the specified
* array. The returned parameter array will no longer be modified by this
reusable message. The specified array is
* now "owned" by this reusable message and can be modified if necessary
for the next log event.
- * </p><p>
+ * <p>
* ReusableMessages that have no parameters return the specified array.
* </p><p>
* This method is used by asynchronous loggers to pass the parameter array
to a background thread without
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/message/SimpleMessageFactory.java
b/log4j-api/src/main/java/org/apache/logging/log4j/message/SimpleMessageFactory.java
index 43a7259..aa1c5f5 100644
---
a/log4j-api/src/main/java/org/apache/logging/log4j/message/SimpleMessageFactory.java
+++
b/log4j-api/src/main/java/org/apache/logging/log4j/message/SimpleMessageFactory.java
@@ -30,7 +30,8 @@ import java.io.Serializable;
* <p>
* This class is immutable.
* </p>
- *
+ *
+ * <h3></h3>
* <h4>Note to implementors</h4>
* <p>
* This class implements all {@link MessageFactory} methods.
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/message/StringFormattedMessage.java
b/log4j-api/src/main/java/org/apache/logging/log4j/message/StringFormattedMessage.java
index a99e2ef..a366a24 100644
---
a/log4j-api/src/main/java/org/apache/logging/log4j/message/StringFormattedMessage.java
+++
b/log4j-api/src/main/java/org/apache/logging/log4j/message/StringFormattedMessage.java
@@ -28,7 +28,8 @@ import org.apache.logging.log4j.status.StatusLogger;
/**
* Handles messages that consist of a format string conforming to {@link
java.util.Formatter}.
- *
+ *
+ * <h3></h3>
* <h4>Note to implementors</h4>
* <p>
* This class implements the unrolled args API even though
StringFormattedMessage does not. This leaves the room for
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/message/StringFormatterMessageFactory.java
b/log4j-api/src/main/java/org/apache/logging/log4j/message/StringFormatterMessageFactory.java
index a2b0e96..00f4e09 100644
---
a/log4j-api/src/main/java/org/apache/logging/log4j/message/StringFormatterMessageFactory.java
+++
b/log4j-api/src/main/java/org/apache/logging/log4j/message/StringFormatterMessageFactory.java
@@ -29,6 +29,7 @@ import java.io.Serializable;
* <p>
* This class is immutable.
* </p>
+ * <h3></h3>
* <h4>Note to implementors</h4>
* <p>
* This class implements all {@link MessageFactory} methods.
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/message/StructuredDataId.java
b/log4j-api/src/main/java/org/apache/logging/log4j/message/StructuredDataId.java
index 674bd35..a5169aa 100644
---
a/log4j-api/src/main/java/org/apache/logging/log4j/message/StructuredDataId.java
+++
b/log4j-api/src/main/java/org/apache/logging/log4j/message/StructuredDataId.java
@@ -78,10 +78,10 @@ public class StructuredDataId implements Serializable,
StringBuilderFormattable
}
/**
- *
- * @param name
- * @param required
- * @param optional
+ * A Constructor that helps conformance to RFC 5424.
+ * @param name The name portion of the id.
+ * @param required The list of keys that are required for this id.
+ * @param optional The list of keys that are optional for this id.
*/
public StructuredDataId(final String name, final String[] required, final
String[] optional) {
this(name, required, optional, MAX_LENGTH);
@@ -93,6 +93,7 @@ public class StructuredDataId implements Serializable,
StringBuilderFormattable
* @param name The name portion of the id.
* @param required The list of keys that are required for this id.
* @param optional The list of keys that are optional for this id.
+ * @param maxLength The maximum length of the id.
* @since 2.9
*/
public StructuredDataId(final String name, final String[] required, final
String[] optional, int maxLength) {
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/message/ThreadDumpMessage.java
b/log4j-api/src/main/java/org/apache/logging/log4j/message/ThreadDumpMessage.java
index 2229948..db0bd05 100644
---
a/log4j-api/src/main/java/org/apache/logging/log4j/message/ThreadDumpMessage.java
+++
b/log4j-api/src/main/java/org/apache/logging/log4j/message/ThreadDumpMessage.java
@@ -171,7 +171,6 @@ public class ThreadDumpMessage implements Message,
StringBuilderFormattable {
* <p>
* Implementations of this class are loaded via the standard java Service
Provider interface.
* </p>
- * @see
/log4j-core/src/main/resources/META-INF/services/org.apache.logging.log4j.message.ThreadDumpMessage$ThreadInfoFactory
*/
public static interface ThreadInfoFactory {
Map<ThreadInformation, StackTraceElement[]> createThreadInfo();
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/spi/AbstractLogger.java
b/log4j-api/src/main/java/org/apache/logging/log4j/spi/AbstractLogger.java
index 7cdbcd5..fdf0f44 100644
--- a/log4j-api/src/main/java/org/apache/logging/log4j/spi/AbstractLogger.java
+++ b/log4j-api/src/main/java/org/apache/logging/log4j/spi/AbstractLogger.java
@@ -505,6 +505,7 @@ public abstract class AbstractLogger implements
ExtendedLogger, Serializable {
* @param fqcn The fully qualified class name of the <b>caller</b>.
* @param format Format String for the parameters.
* @param paramSuppliers The Suppliers of the parameters.
+ * @return The EntryMessage.
*/
protected EntryMessage enter(final String fqcn, final String format, final
Supplier<?>... paramSuppliers) {
EntryMessage entryMsg = null;
@@ -520,6 +521,7 @@ public abstract class AbstractLogger implements
ExtendedLogger, Serializable {
* @param fqcn The fully qualified class name of the <b>caller</b>.
* @param format The format String for the parameters.
* @param params The parameters to the method.
+ * @return The EntryMessage.
*/
protected EntryMessage enter(final String fqcn, final String format, final
Object... params) {
EntryMessage entryMsg = null;
@@ -532,10 +534,9 @@ public abstract class AbstractLogger implements
ExtendedLogger, Serializable {
/**
* Logs entry to a method with location information.
*
- * @param fqcn
- * The fully qualified class name of the <b>caller</b>.
- * @param message
- * the Message.
+ * @param fqcn The fully qualified class name of the <b>caller</b>.
+ * @param message the Message.
+ * @return The EntryMessage.
* @since 2.6
*/
protected EntryMessage enter(final String fqcn, final Message message) {
@@ -885,6 +886,7 @@ public abstract class AbstractLogger implements
ExtendedLogger, Serializable {
* Logs exiting from a method with the result and location information.
*
* @param fqcn The fully qualified class name of the <b>caller</b>.
+ * @param format The format string.
* @param <R> The type of the parameter and object being returned.
* @param result The result being returned from the method call.
* @return the return value passed to this method.
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/spi/AbstractLoggerAdapter.java
b/log4j-api/src/main/java/org/apache/logging/log4j/spi/AbstractLoggerAdapter.java
index 17defb4..55746e9 100644
---
a/log4j-api/src/main/java/org/apache/logging/log4j/spi/AbstractLoggerAdapter.java
+++
b/log4j-api/src/main/java/org/apache/logging/log4j/spi/AbstractLoggerAdapter.java
@@ -95,6 +95,7 @@ public abstract class AbstractLoggerAdapter<L> implements
LoggerAdapter<L>, Logg
/**
* For unit testing. Consider to be private.
+ * @return The Set of LoggerContexts.
*/
public Set<LoggerContext> getLoggerContexts() {
return new HashSet<>(registry.keySet());
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/spi/LoggerContext.java
b/log4j-api/src/main/java/org/apache/logging/log4j/spi/LoggerContext.java
index 25b0071..3cc540a 100644
--- a/log4j-api/src/main/java/org/apache/logging/log4j/spi/LoggerContext.java
+++ b/log4j-api/src/main/java/org/apache/logging/log4j/spi/LoggerContext.java
@@ -32,6 +32,7 @@ public interface LoggerContext {
/**
* Retrieve an object by its name.
* @param key The object's key.
+ * @return The Object that is associated with the key, if any.
* @since 2.13.0
*/
default Object getObject(String key) {
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/spi/MutableThreadContextStack.java
b/log4j-api/src/main/java/org/apache/logging/log4j/spi/MutableThreadContextStack.java
index 03c77da..be111e3 100644
---
a/log4j-api/src/main/java/org/apache/logging/log4j/spi/MutableThreadContextStack.java
+++
b/log4j-api/src/main/java/org/apache/logging/log4j/spi/MutableThreadContextStack.java
@@ -46,7 +46,7 @@ public class MutableThreadContextStack implements
ThreadContextStack, StringBuil
/**
* Constructs a new instance.
- * @param list
+ * @param list The list of items in the stack.
*/
public MutableThreadContextStack(final List<String> list) {
this.list = new ArrayList<>(list);
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/spi/ObjectThreadContextMap.java
b/log4j-api/src/main/java/org/apache/logging/log4j/spi/ObjectThreadContextMap.java
index 2148ddb..c4bc014 100644
---
a/log4j-api/src/main/java/org/apache/logging/log4j/spi/ObjectThreadContextMap.java
+++
b/log4j-api/src/main/java/org/apache/logging/log4j/spi/ObjectThreadContextMap.java
@@ -32,6 +32,7 @@ public interface ObjectThreadContextMap extends
CleanableThreadContextMap {
* collection.
*
* @param key the key whose value to return
+ * @param <V> The type of the returned value.
* @return the value for the specified key or {@code null}
*/
<V> V getValue(String key);
@@ -40,6 +41,7 @@ public interface ObjectThreadContextMap extends
CleanableThreadContextMap {
* Puts the specified key-value pair into the collection.
*
* @param key the key to add or remove. Keys may be {@code null}.
+ * @param <V> The type of the stored and returned value.
* @param value the value to add. Values may be {@code null}.
*/
<V> void putValue(String key, V value);
@@ -48,6 +50,7 @@ public interface ObjectThreadContextMap extends
CleanableThreadContextMap {
* Puts all given key-value pairs into the collection.
*
* @param values the map of key-value pairs to add
+ * @param <V> The type of the value being added.
*/
<V> void putAllValues(Map<String, V> values);
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/util/Constants.java
b/log4j-api/src/main/java/org/apache/logging/log4j/util/Constants.java
index 2fc67f4..61e299a 100644
--- a/log4j-api/src/main/java/org/apache/logging/log4j/util/Constants.java
+++ b/log4j-api/src/main/java/org/apache/logging/log4j/util/Constants.java
@@ -46,7 +46,7 @@ public final class Constants {
* Maximum size of the StringBuilders used in RingBuffer LogEvents to
store the contents of reusable Messages.
* After a large message has been delivered to the appenders, the
StringBuilder is trimmed to this size.
* <p>
- * The default value is {@value}, which allows the StringBuilder to resize
three times from its initial size.
+ * The default value is 518, which allows the StringBuilder to resize
three times from its initial size.
* Users can override with system property "log4j.maxReusableMsgSize".
* </p>
* @since 2.9
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/util/IndexedReadOnlyStringMap.java
b/log4j-api/src/main/java/org/apache/logging/log4j/util/IndexedReadOnlyStringMap.java
index 5c67b01..9209ded 100644
---
a/log4j-api/src/main/java/org/apache/logging/log4j/util/IndexedReadOnlyStringMap.java
+++
b/log4j-api/src/main/java/org/apache/logging/log4j/util/IndexedReadOnlyStringMap.java
@@ -44,6 +44,7 @@ public interface IndexedReadOnlyStringMap extends
ReadOnlyStringMap {
* or {@code null} if the specified index is less than zero or greater or
equal to the size of this collection.
*
* @param index the index of the value to return
+ * @param <V> The type of the returned value.
* @return the value at the specified index or {@code null}
*/
<V> V getValueAt(final int index);
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/util/LambdaUtil.java
b/log4j-api/src/main/java/org/apache/logging/log4j/util/LambdaUtil.java
index a9f1684..515e24f 100644
--- a/log4j-api/src/main/java/org/apache/logging/log4j/util/LambdaUtil.java
+++ b/log4j-api/src/main/java/org/apache/logging/log4j/util/LambdaUtil.java
@@ -81,6 +81,7 @@ public final class LambdaUtil {
* Returns a Message, either the value supplied by the specified function,
or a new Message created by the specified
* Factory.
* @param supplier a lambda expression or {@code null}
+ * @param messageFactory The MessageFactory.
* @return the Message resulting from evaluating the lambda expression or
the Message created by the factory for
* supplied values that are not of type Message
*/
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/util/LoaderUtil.java
b/log4j-api/src/main/java/org/apache/logging/log4j/util/LoaderUtil.java
index 3eccabd..12b60db 100644
--- a/log4j-api/src/main/java/org/apache/logging/log4j/util/LoaderUtil.java
+++ b/log4j-api/src/main/java/org/apache/logging/log4j/util/LoaderUtil.java
@@ -220,6 +220,7 @@ public final class LoaderUtil {
* Loads and instantiates a Class using the default constructor.
*
* @param clazz The class.
+ * @param <T> The Class's type.
* @return new instance of the class.
* @throws IllegalAccessException if the class can't be instantiated
through a public constructor
* @throws InstantiationException if there was an exception whilst
instantiating the class
@@ -240,6 +241,7 @@ public final class LoaderUtil {
* Loads and instantiates a Class using the default constructor.
*
* @param className The class name.
+ * @param <T> The class's type.
* @return new instance of the class.
* @throws ClassNotFoundException if the class isn't available to the
usual ClassLoaders
* @throws IllegalAccessException if the class can't be instantiated
through a public constructor
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/util/MessageSupplier.java
b/log4j-api/src/main/java/org/apache/logging/log4j/util/MessageSupplier.java
index f38f75c..70edb22 100644
--- a/log4j-api/src/main/java/org/apache/logging/log4j/util/MessageSupplier.java
+++ b/log4j-api/src/main/java/org/apache/logging/log4j/util/MessageSupplier.java
@@ -28,7 +28,7 @@ import org.apache.logging.log4j.message.Message;
* <p>Implementors are free to cache values or return a new or distinct value
each time the supplier is invoked.
*
* <p><strong>DEPRECATED:</strong> this class should not normally be used
outside a Java 8+ lambda syntax. Instead,
- * {@link Supplier Supplier<Message>} should be used as an anonymous class.
Both this and {@link Supplier} will be
+ * {@link Supplier Supplier<Message>} should be used as an anonymous
class. Both this and {@link Supplier} will be
* removed in 3.0.
* </p>
*
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/util/PerformanceSensitive.java
b/log4j-api/src/main/java/org/apache/logging/log4j/util/PerformanceSensitive.java
index 694175c..837347c 100644
---
a/log4j-api/src/main/java/org/apache/logging/log4j/util/PerformanceSensitive.java
+++
b/log4j-api/src/main/java/org/apache/logging/log4j/util/PerformanceSensitive.java
@@ -32,6 +32,9 @@ import java.lang.annotation.RetentionPolicy;
// No @Target: No restrictions yet on what code elements may be annotated or
not.
@Retention(RetentionPolicy.CLASS) // Currently no need to reflectively
discover this annotation at runtime.
public @interface PerformanceSensitive {
- /** Description of why this is written the way it is. */
+ /**
+ * Is this ever used?
+ * @return An array of strings.
+ */
String[] value() default "";
}
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/util/ReadOnlyStringMap.java
b/log4j-api/src/main/java/org/apache/logging/log4j/util/ReadOnlyStringMap.java
index df9a1c8..cd76c57 100644
---
a/log4j-api/src/main/java/org/apache/logging/log4j/util/ReadOnlyStringMap.java
+++
b/log4j-api/src/main/java/org/apache/logging/log4j/util/ReadOnlyStringMap.java
@@ -88,6 +88,7 @@ public interface ReadOnlyStringMap extends Serializable {
* Returns the value for the specified key, or {@code null} if the
specified key does not exist in this collection.
*
* @param key the key whose value to return.
+ * @param <V> The type of the value to be returned.
* @return the value for the specified key or {@code null}.
*/
<V> V getValue(final String key);
diff --git
a/log4j-api/src/main/java/org/apache/logging/log4j/util/SortedArrayStringMap.java
b/log4j-api/src/main/java/org/apache/logging/log4j/util/SortedArrayStringMap.java
index 6d3eadb..2404ac0 100644
---
a/log4j-api/src/main/java/org/apache/logging/log4j/util/SortedArrayStringMap.java
+++
b/log4j-api/src/main/java/org/apache/logging/log4j/util/SortedArrayStringMap.java
@@ -502,6 +502,9 @@ public class SortedArrayStringMap implements
IndexedStringMap {
* Save the state of the {@code SortedArrayStringMap} instance to a stream
(i.e.,
* serialize it).
*
+ * @param s The ObjectOutputStream.
+ * @throws IOException if there is an error serializing the object to the
stream.
+ *
* @serialData The <i>capacity</i> of the SortedArrayStringMap (the length
of the
* bucket array) is emitted (int), followed by the
* <i>size</i> (an int, the number of key-value
@@ -590,6 +593,9 @@ public class SortedArrayStringMap implements
IndexedStringMap {
/**
* Reconstitute the {@code SortedArrayStringMap} instance from a stream
(i.e.,
* deserialize it).
+ * @param s The ObjectInputStream.
+ * @throws IOException If there is an error reading the input stream.
+ * @throws ClassNotFoundException if the class to be instantiated could
not be found.
*/
private void readObject(final java.io.ObjectInputStream s) throws
IOException, ClassNotFoundException {
if (!(s instanceof FilteredObjectInputStream) && setObjectInputFilter
== null) {
diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/util/Strings.java
b/log4j-api/src/main/java/org/apache/logging/log4j/util/Strings.java
index f236b61..ea06dff 100644
--- a/log4j-api/src/main/java/org/apache/logging/log4j/util/Strings.java
+++ b/log4j-api/src/main/java/org/apache/logging/log4j/util/Strings.java
@@ -217,6 +217,8 @@ public final class Strings {
/**
* Removes control characters from both ends of this String returning
{@code Optional.empty()} if the String is
* empty ("") after the trim or if it is {@code null}.
+ * @param str The String to trim.
+ * @return An Optional containing the String.
*
* @see #trimToNull(String)
*/
diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/util/Timer.java
b/log4j-api/src/main/java/org/apache/logging/log4j/util/Timer.java
index 00d495c..a597aae 100644
--- a/log4j-api/src/main/java/org/apache/logging/log4j/util/Timer.java
+++ b/log4j-api/src/main/java/org/apache/logging/log4j/util/Timer.java
@@ -58,6 +58,7 @@ public class Timer implements Serializable,
StringBuilderFormattable
* Constructor.
*
* @param name the timer name.
+ * @param iterations the number of iterations that will take place.
*/
public Timer(final String name, final int iterations)
{
@@ -86,6 +87,7 @@ public class Timer implements Serializable,
StringBuilderFormattable
/**
* Stop the timer.
+ * @return the String result of the timer completing.
*/
public synchronized String stop()
{
diff --git a/log4j-appserver/pom.xml b/log4j-appserver/pom.xml
index 9c2f20b..88ba72a 100644
--- a/log4j-appserver/pom.xml
+++ b/log4j-appserver/pom.xml
@@ -164,6 +164,7 @@
<additionalparam>${javadoc.opts}</additionalparam>
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
<links>
<link>http://docs.oracle.com/javaee/6/api/</link>
</links>
diff --git a/log4j-cassandra/pom.xml b/log4j-cassandra/pom.xml
index 3455022..d035c4b 100644
--- a/log4j-cassandra/pom.xml
+++ b/log4j-cassandra/pom.xml
@@ -152,6 +152,7 @@
project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-core/pom.xml b/log4j-core/pom.xml
index 5f75511..aa0dff0 100644
--- a/log4j-core/pom.xml
+++ b/log4j-core/pom.xml
@@ -515,6 +515,7 @@
<version>${javadoc.plugin.version}</version>
<configuration>
<failOnError>false</failOnError>
+ <source>8</source>
<bottom><![CDATA[<p align="center">Copyright ©
{inceptionYear}-{currentYear} {organizationName}. All Rights Reserved.<br />
Apache Logging, Apache Log4j, Log4j, Apache, the Apache feather
logo, the Apache Logging project logo,
and the Apache Log4j logo are trademarks of The Apache Software
Foundation.</p>]]></bottom>
diff --git a/log4j-couchdb/pom.xml b/log4j-couchdb/pom.xml
index 72b0505..ebce220 100644
--- a/log4j-couchdb/pom.xml
+++ b/log4j-couchdb/pom.xml
@@ -129,6 +129,7 @@
project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-csv/pom.xml b/log4j-csv/pom.xml
index 69396cf..71dcacb 100644
--- a/log4j-csv/pom.xml
+++ b/log4j-csv/pom.xml
@@ -122,6 +122,7 @@
<!-- module link generation is completely broken in the javadoc
plugin for a multi-module non-aggregating project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-docker/pom.xml b/log4j-docker/pom.xml
index 3d929d3..f99340d 100644
--- a/log4j-docker/pom.xml
+++ b/log4j-docker/pom.xml
@@ -155,6 +155,7 @@
project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-flume-ng/pom.xml b/log4j-flume-ng/pom.xml
index 64eb0e9..ac331ee 100644
--- a/log4j-flume-ng/pom.xml
+++ b/log4j-flume-ng/pom.xml
@@ -200,6 +200,7 @@
project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-iostreams/pom.xml b/log4j-iostreams/pom.xml
index fc41791..45231fd 100644
--- a/log4j-iostreams/pom.xml
+++ b/log4j-iostreams/pom.xml
@@ -145,6 +145,7 @@
project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-jcl/pom.xml b/log4j-jcl/pom.xml
index 73c5d8d..3c167ca 100644
--- a/log4j-jcl/pom.xml
+++ b/log4j-jcl/pom.xml
@@ -135,6 +135,7 @@
project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-jdbc-dbcp2/pom.xml b/log4j-jdbc-dbcp2/pom.xml
index c5fc301..2fe3312 100644
--- a/log4j-jdbc-dbcp2/pom.xml
+++ b/log4j-jdbc-dbcp2/pom.xml
@@ -127,6 +127,7 @@
<!-- module link generation is completely broken in the javadoc
plugin for a multi-module non-aggregating project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-jdbc/pom.xml b/log4j-jdbc/pom.xml
index ba35186..9f06def 100644
--- a/log4j-jdbc/pom.xml
+++ b/log4j-jdbc/pom.xml
@@ -161,6 +161,7 @@
<!-- module link generation is completely broken in the javadoc
plugin for a multi-module non-aggregating project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-jeromq/pom.xml b/log4j-jeromq/pom.xml
index 6064add..a3f7814 100644
--- a/log4j-jeromq/pom.xml
+++ b/log4j-jeromq/pom.xml
@@ -111,6 +111,7 @@
<!-- module link generation is completely broken in the javadoc
plugin for a multi-module non-aggregating project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-jms/pom.xml b/log4j-jms/pom.xml
index 89b9c94..6a8a02d 100644
--- a/log4j-jms/pom.xml
+++ b/log4j-jms/pom.xml
@@ -125,6 +125,7 @@
<!-- module link generation is completely broken in the javadoc
plugin for a multi-module non-aggregating project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-jmx-gui/pom.xml b/log4j-jmx-gui/pom.xml
index 9e24276..a9177d8 100644
--- a/log4j-jmx-gui/pom.xml
+++ b/log4j-jmx-gui/pom.xml
@@ -129,6 +129,7 @@
project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-jpa/pom.xml b/log4j-jpa/pom.xml
index 2521032..07192ca 100644
--- a/log4j-jpa/pom.xml
+++ b/log4j-jpa/pom.xml
@@ -135,6 +135,7 @@
<!-- module link generation is completely broken in the javadoc
plugin for a multi-module non-aggregating project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-jul/pom.xml b/log4j-jul/pom.xml
index c9d7d9a..3fa00b9 100644
--- a/log4j-jul/pom.xml
+++ b/log4j-jul/pom.xml
@@ -180,6 +180,7 @@
project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-kafka/pom.xml b/log4j-kafka/pom.xml
index 2291085..abca119 100644
--- a/log4j-kafka/pom.xml
+++ b/log4j-kafka/pom.xml
@@ -116,6 +116,7 @@
<!-- module link generation is completely broken in the javadoc
plugin for a multi-module non-aggregating project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-kubernetes/pom.xml b/log4j-kubernetes/pom.xml
index a7c13e0..0283725 100644
--- a/log4j-kubernetes/pom.xml
+++ b/log4j-kubernetes/pom.xml
@@ -147,6 +147,7 @@
project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-layout-jackson-json/pom.xml
b/log4j-layout-jackson-json/pom.xml
index 6c97168..5d5c175 100644
--- a/log4j-layout-jackson-json/pom.xml
+++ b/log4j-layout-jackson-json/pom.xml
@@ -118,6 +118,7 @@
<!-- module link generation is completely broken in the javadoc
plugin for a multi-module non-aggregating project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git
a/log4j-layout-jackson-json/src/main/java/org/apache/logging/log4j/jackson/json/Log4jJsonObjectMapper.java
b/log4j-layout-jackson-json/src/main/java/org/apache/logging/log4j/jackson/json/Log4jJsonObjectMapper.java
index f0df03b..f72df75 100644
---
a/log4j-layout-jackson-json/src/main/java/org/apache/logging/log4j/jackson/json/Log4jJsonObjectMapper.java
+++
b/log4j-layout-jackson-json/src/main/java/org/apache/logging/log4j/jackson/json/Log4jJsonObjectMapper.java
@@ -38,6 +38,10 @@ public class Log4jJsonObjectMapper extends ObjectMapper {
/**
* Create a new instance using the {@link Log4jJsonModule}.
+ * @param encodeThreadContextAsList true if ThreadContext should be
rendered as a list.
+ * @param includeStacktrace true if the stack trace should be included.
+ * @param stacktraceAsString true if the stack trace should be printed as
a simple string.
+ * @param objectMessageAsJsonObject true if the ObjectMessage should be
converted to a JSON object.
*/
public Log4jJsonObjectMapper(final boolean encodeThreadContextAsList,
final boolean includeStacktrace, final boolean stacktraceAsString, final
boolean objectMessageAsJsonObject) {
this.registerModule(new Log4jJsonModule(encodeThreadContextAsList,
includeStacktrace, stacktraceAsString, objectMessageAsJsonObject));
diff --git a/log4j-layout-jackson-xml/pom.xml b/log4j-layout-jackson-xml/pom.xml
index 6b039b5..68a5ae8 100644
--- a/log4j-layout-jackson-xml/pom.xml
+++ b/log4j-layout-jackson-xml/pom.xml
@@ -122,6 +122,7 @@
<!-- module link generation is completely broken in the javadoc
plugin for a multi-module non-aggregating project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-layout-jackson-yaml/pom.xml
b/log4j-layout-jackson-yaml/pom.xml
index 90e1f82..ded423c 100644
--- a/log4j-layout-jackson-yaml/pom.xml
+++ b/log4j-layout-jackson-yaml/pom.xml
@@ -117,6 +117,7 @@
<!-- module link generation is completely broken in the javadoc
plugin for a multi-module non-aggregating project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-layout-jackson/pom.xml b/log4j-layout-jackson/pom.xml
index 5c8095d..928da2a 100644
--- a/log4j-layout-jackson/pom.xml
+++ b/log4j-layout-jackson/pom.xml
@@ -160,6 +160,7 @@
<!-- module link generation is completely broken in the javadoc
plugin for a multi-module non-aggregating project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-liquibase/pom.xml b/log4j-liquibase/pom.xml
index c748766..8fcfee8 100644
--- a/log4j-liquibase/pom.xml
+++ b/log4j-liquibase/pom.xml
@@ -206,6 +206,7 @@
project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-mongodb2/pom.xml b/log4j-mongodb2/pom.xml
index 0b33b74..b3b678b 100644
--- a/log4j-mongodb2/pom.xml
+++ b/log4j-mongodb2/pom.xml
@@ -142,6 +142,7 @@
project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-mongodb3/pom.xml b/log4j-mongodb3/pom.xml
index 0b6ef5c..e34cf61 100644
--- a/log4j-mongodb3/pom.xml
+++ b/log4j-mongodb3/pom.xml
@@ -146,6 +146,7 @@
project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-osgi/pom.xml b/log4j-osgi/pom.xml
index 3f57f7a..f05d0d4 100644
--- a/log4j-osgi/pom.xml
+++ b/log4j-osgi/pom.xml
@@ -151,6 +151,7 @@
project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
<links>
<link>http://www.osgi.org/javadoc/r4v43/core/</link>
</links>
diff --git a/log4j-plugins/pom.xml b/log4j-plugins/pom.xml
index c239a76..d349a5a 100644
--- a/log4j-plugins/pom.xml
+++ b/log4j-plugins/pom.xml
@@ -286,6 +286,7 @@
<version>${javadoc.plugin.version}</version>
<configuration>
<failOnError>false</failOnError>
+ <source>8</source>
<bottom><![CDATA[<p align="center">Copyright ©
{inceptionYear}-{currentYear} {organizationName}. All Rights Reserved.<br />
Apache Logging, Apache Log4j, Log4j, Apache, the Apache feather
logo, the Apache Logging project logo,
and the Apache Log4j logo are trademarks of The Apache Software
Foundation.</p>]]></bottom>
diff --git
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/Plugin.java
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/Plugin.java
index 5b778d0..18f04ee 100644
--- a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/Plugin.java
+++ b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/Plugin.java
@@ -39,28 +39,33 @@ public @interface Plugin {
/**
* Name of the plugin. Note that this name is case-insensitive.
+ * @return the name of the plugin.
*/
String name();
/**
* Category to place the plugin under. Category names are case-sensitive.
+ * @return the category
*/
String category();
/**
* Name of the corresponding category of elements this plugin belongs
under. For example, {@code appender} would
- * indicate an {@link org.apache.logging.log4j.core.Appender} plugin which
would be in the
- * {@code <Appenders/>} element of a {@link
org.apache.logging.log4j.core.config.Configuration}.
+ * indicate an Appender plugin which would be in the
+ * {@code <Appenders/>} element of a Configuration.
+ * @return the element's type.
*/
String elementType() default EMPTY;
/**
* Indicates if the plugin class implements a useful {@link
Object#toString()} method for use in log messages.
+ * @return true if the object should print nicely.
*/
boolean printObject() default false;
/**
* Indicates if construction and injection of child configuration nodes
should be deferred until first use.
+ * @return true if child elements should defer instantiation until they
are accessed.
*/
boolean deferChildren() default false;
}
diff --git
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/PluginAliases.java
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/PluginAliases.java
index bb3962a..a194798 100644
---
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/PluginAliases.java
+++
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/PluginAliases.java
@@ -33,6 +33,7 @@ public @interface PluginAliases {
/**
* Aliases the annotated element can also be referred to. These aliases
are case-insensitive.
+ * @return the aliases associated with the plugin.
*/
String[] value();
}
diff --git
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/PluginAttribute.java
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/PluginAttribute.java
index 30cccad..d844d02 100644
---
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/PluginAttribute.java
+++
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/PluginAttribute.java
@@ -51,51 +51,61 @@ public @interface PluginAttribute {
/**
* Specifies the default boolean value to use.
+ * @return the default boolean value.
*/
boolean defaultBoolean() default false;
/**
* Specifies the default byte value to use.
+ * @return the default byte value;
*/
byte defaultByte() default 0;
/**
* Specifies the default byte value to use.
+ * @return the default char value.
*/
char defaultChar() default 0;
/**
* Specifies the default {@link Class} value to use.
+ * @return the default class value.
*/
Class<?> defaultClass() default Object.class;
/**
* Specifies the default double floating point value to use.
+ * @return the default double value;
*/
double defaultDouble() default 0.0d;
/**
* Specifies the default floating point value to use.
+ * @return the default float value.
*/
float defaultFloat() default 0.0f;
/**
* Specifies the default integer value to use.
+ * @return the default integer value.
*/
int defaultInt() default 0;
/**
* Specifies the default long value to use.
+ * @return the default long value;
*/
long defaultLong() default 0L;
/**
* Specifies the default long value to use.
+ * @return the default short value.
*/
short defaultShort() default 0;
/**
* Specifies the default value this attribute should use if none is
provided or if the provided value is invalid.
+ * @return the default String value.
*/
String defaultString() default Strings.EMPTY;
@@ -109,12 +119,14 @@ public @interface PluginAttribute {
* (<var>XYZ</var>) of the method name. Otherwise, uses the name of
the first parameter.</li>
* <li>Parameter: uses the parameter name.</li>
* </ul>
+ * @return the value;
*/
String value() default Strings.EMPTY;
/**
* Indicates that this attribute is a sensitive one that shouldn't be
logged directly. Such attributes will instead
* be output as a hashed value.
+ * @return true if the attribute should be considered sensitive.
*/
boolean sensitive() default false;
diff --git
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/PluginBuilderAttribute.java
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/PluginBuilderAttribute.java
index 06cb8f0..a0a39b5 100644
---
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/PluginBuilderAttribute.java
+++
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/PluginBuilderAttribute.java
@@ -45,12 +45,14 @@ public @interface PluginBuilderAttribute {
/**
* Specifies the attribute name this corresponds to. If no attribute is
set (i.e., a blank string), then the name
* of the field (or member) this annotation is attached to will be used.
+ * @return the name of the attribute.
*/
String value() default Strings.EMPTY;
/**
* Indicates that this attribute is a sensitive one that shouldn't be
logged directly. Such attributes will instead
* be output as a hashed value.
+ * @return true if this attribute should be considered sensitive.
*/
boolean sensitive() default false;
}
diff --git
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/PluginElement.java
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/PluginElement.java
index 9b333d4..fa296ca 100644
---
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/PluginElement.java
+++
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/PluginElement.java
@@ -50,6 +50,7 @@ public @interface PluginElement {
* (<var>XYZ</var>) of the method name. Otherwise, uses the name of
the first parameter.</li>
* <li>Parameter: uses the parameter name.</li>
* </ul>
+ * @return the element name.
*/
String value() default Strings.EMPTY;
}
diff --git
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/PluginValue.java
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/PluginValue.java
index a08eaf0..5e7a3fe 100644
---
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/PluginValue.java
+++
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/PluginValue.java
@@ -47,6 +47,7 @@ public @interface PluginValue {
/**
* Specifies the case-insensitive attribute name to use in configuration
formats that don't distinguish between
* attributes and values. By default, this uses the attribute name {@code
value}.
+ * @return the value of the attribute.
*/
String value() default "value";
}
diff --git
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/convert/HexConverter.java
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/convert/HexConverter.java
index f9037b3..f70131d 100644
---
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/convert/HexConverter.java
+++
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/convert/HexConverter.java
@@ -20,7 +20,7 @@ package org.apache.logging.log4j.plugins.convert;
* Converts Strings to hex. This is used in place of
java.xml.bind.DataTypeConverter which is not available by
* default in Java 9.
*
- * @Since 2.9
+ * @since 2.9
*/
public class HexConverter {
diff --git
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/convert/TypeConverters.java
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/convert/TypeConverters.java
index 7a71b4a..ed387d7 100644
---
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/convert/TypeConverters.java
+++
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/convert/TypeConverters.java
@@ -378,6 +378,7 @@ public final class TypeConverters {
* the class to try to convert the string to
* @param defaultValue
* the fallback object to use if the conversion is unsuccessful
+ * @param <T> The type of the clazz parameter.
* @return the converted object which may be {@code null} if the string is
invalid for the given type
* @throws NullPointerException
* if {@code clazz} is {@code null}
diff --git
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/processor/package-info.java
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/processor/package-info.java
index 2c296f9..481d2eb 100644
---
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/processor/package-info.java
+++
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/processor/package-info.java
@@ -17,6 +17,6 @@
/**
* Java annotation processor for pre-scanning Log4j 2 plugins. This is
provided as an alternative to using the
- * executable {@link
org.apache.logging.log4j.core.config.plugins.util.PluginManager} class in your
build process.
+ * executable {@link org.apache.logging.log4j.plugins.util.PluginManager}
class in your build process.
*/
package org.apache.logging.log4j.plugins.processor;
diff --git
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/util/Builder.java
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/util/Builder.java
index ec8a07f..3ef6052 100644
---
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/util/Builder.java
+++
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/util/Builder.java
@@ -38,7 +38,6 @@ public interface Builder<T> {
* unspecified attributes for the object.
*
* @return the configured instance.
- * @throws org.apache.logging.log4j.core.config.ConfigurationException if
there was an error building the
* object.
*/
T build();
diff --git
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/util/PluginRegistry.java
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/util/PluginRegistry.java
index 8a266eb..bae5c8a 100644
---
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/util/PluginRegistry.java
+++
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/util/PluginRegistry.java
@@ -107,6 +107,8 @@ public class PluginRegistry {
}
/**
+ * Retrieve plugins by their category and bundle id.
+ * @return The Map of plugin maps.
* @since 2.1
*/
public Map<Long, Map<String, List<PluginType<?>>>>
getPluginsByCategoryByBundleId() {
@@ -114,6 +116,8 @@ public class PluginRegistry {
}
/**
+ * Retrieve plugins from the main classloader.
+ * @return Map of the List of PluginTypes by category.
* @since 2.1
*/
public Map<String, List<PluginType<?>>> loadFromMainClassLoader() {
@@ -135,6 +139,8 @@ public class PluginRegistry {
}
/**
+ * Remove the bundle plugins.
+ * @param bundleId The bundle id.
* @since 2.1
*/
public void clearBundlePlugins(final long bundleId) {
@@ -142,6 +148,10 @@ public class PluginRegistry {
}
/**
+ * Load plugins from a bundle.
+ * @param bundleId The bundle id.
+ * @param loader The ClassLoader.
+ * @return the Map of Lists of plugins organized by category.
* @since 2.1
*/
public Map<String, List<PluginType<?>>> loadFromBundle(final long
bundleId, final ClassLoader loader) {
@@ -166,6 +176,7 @@ public class PluginRegistry {
/**
* Loads all the plugins in a Bundle.
* @param categories All the categories in the bundle.
+ * @param bundleId The bundle Id.
* @since 3.0
*/
public void loadFromBundle(Map<String, List<PluginType<?>>> categories,
Long bundleId) {
@@ -180,6 +191,8 @@ public class PluginRegistry {
}
/**
+ * Load plugins across all ClassLoaders.
+ * @param map The Map of the lists of plugins organized by category.
* @since 3.0
*/
public void loadPlugins(Map<String, List<PluginType<?>>> map) {
@@ -193,6 +206,9 @@ public class PluginRegistry {
}
/**
+ * Load plugins from a specific ClassLoader.
+ * @param classLoader The ClassLoader.
+ * @param map The Map of the list of plugin types organized by category.
* @since 3.0
*/
public void loadPlugins(ClassLoader classLoader, Map<String,
List<PluginType<?>>> map) {
@@ -265,6 +281,9 @@ public class PluginRegistry {
}
/**
+ * Load plugin types from a package.
+ * @param pkg The package name.
+ * @return A Map of the lists of plugin types organized by category.
* @since 2.1
*/
public Map<String, List<PluginType<?>>> loadFromPackage(final String pkg) {
diff --git
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/util/PluginType.java
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/util/PluginType.java
index f2f5008..3e1a4b1 100644
---
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/util/PluginType.java
+++
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/util/PluginType.java
@@ -33,6 +33,10 @@ public class PluginType<T> {
private final String elementName;
/**
+ * Constructor.
+ * @param pluginEntry The PluginEntry.
+ * @param pluginClass The plugin Class.
+ * @param elementName The name of the element.
* @since 2.1
*/
public PluginType(final PluginEntry pluginEntry, final Class<T>
pluginClass, final String elementName) {
@@ -43,6 +47,7 @@ public class PluginType<T> {
}
/**
+ * The Constructor.
* @since 3.0
* @param pluginEntry The PluginEntry.
* @param classLoader The ClassLoader to use to load the Plugin.
@@ -77,6 +82,8 @@ public class PluginType<T> {
}
/**
+ * Return The plugin's key.
+ * @return The plugin key.
* @since 2.1
*/
public String getKey() {
@@ -92,6 +99,8 @@ public class PluginType<T> {
}
/**
+ * Return the plugin category.
+ * @return the Plugin category.
* @since 2.1
*/
public String getCategory() {
diff --git
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/util/package-info.java
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/util/package-info.java
index fae7580..ee1e584 100644
---
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/util/package-info.java
+++
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/util/package-info.java
@@ -17,6 +17,6 @@
/**
* Java annotation processor for pre-scanning Log4j 2 plugins. This is
provided as an alternative to using the
- * executable {@link
org.apache.logging.log4j.core.config.plugins.util.PluginManager} class in your
build process.
+ * executable {@link org.apache.logging.log4j.plugins.util.PluginManager}
class in your build process.
*/
package org.apache.logging.log4j.plugins.util;
diff --git
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/validation/Constraint.java
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/validation/Constraint.java
index 4586315..6c31f1c 100644
---
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/validation/Constraint.java
+++
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/validation/Constraint.java
@@ -31,6 +31,7 @@ public @interface Constraint {
/**
* {@link ConstraintValidator} class that implements the validation logic
for the annotated constraint annotation.
+ * @return the class that implements the validation logic.
*/
Class<? extends ConstraintValidator<? extends Annotation>> value();
}
diff --git
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/validation/constraints/Required.java
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/validation/constraints/Required.java
index dd0efa8..7901606 100644
---
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/validation/constraints/Required.java
+++
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/validation/constraints/Required.java
@@ -35,6 +35,7 @@ public @interface Required {
/**
* The message to be logged if this constraint is violated. This should
normally be overridden.
+ * @return the message to be logged if the constraint is violated.
*/
String message() default "The parameter is null";
}
diff --git
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/validation/constraints/ValidHost.java
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/validation/constraints/ValidHost.java
index 6a31ef4..484c879 100644
---
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/validation/constraints/ValidHost.java
+++
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/validation/constraints/ValidHost.java
@@ -36,6 +36,7 @@ public @interface ValidHost {
/**
* The message to be logged if this constraint is violated. This should
normally be overridden.
+ * @return The message to be logged if this constraint is violated.
*/
String message() default "The hostname is invalid";
}
diff --git
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/validation/constraints/ValidPort.java
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/validation/constraints/ValidPort.java
index edb7e72..a664a28 100644
---
a/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/validation/constraints/ValidPort.java
+++
b/log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/validation/constraints/ValidPort.java
@@ -35,6 +35,7 @@ public @interface ValidPort {
/**
* The message to be logged if this constraint is violated. This should
normally be overridden.
+ * @return The message to be logged if the constraint is violated.
*/
String message() default "The port number is invalid";
}
diff --git a/log4j-slf4j-impl/pom.xml b/log4j-slf4j-impl/pom.xml
index 97644d2..af0b355 100644
--- a/log4j-slf4j-impl/pom.xml
+++ b/log4j-slf4j-impl/pom.xml
@@ -250,6 +250,7 @@
project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-slf4j18-impl/pom.xml b/log4j-slf4j18-impl/pom.xml
index 7f1d983..f9353ef 100644
--- a/log4j-slf4j18-impl/pom.xml
+++ b/log4j-slf4j18-impl/pom.xml
@@ -205,6 +205,7 @@
project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-smtp/pom.xml b/log4j-smtp/pom.xml
index f53b662..33ed5c2 100644
--- a/log4j-smtp/pom.xml
+++ b/log4j-smtp/pom.xml
@@ -111,6 +111,7 @@
<!-- module link generation is completely broken in the javadoc
plugin for a multi-module non-aggregating project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-spring-cloud-config/log4j-spring-cloud-config-client/pom.xml
b/log4j-spring-cloud-config/log4j-spring-cloud-config-client/pom.xml
index 724d812..4325398 100644
--- a/log4j-spring-cloud-config/log4j-spring-cloud-config-client/pom.xml
+++ b/log4j-spring-cloud-config/log4j-spring-cloud-config-client/pom.xml
@@ -154,6 +154,7 @@
project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-taglib/pom.xml b/log4j-taglib/pom.xml
index ba309b7..1e1e36e 100644
--- a/log4j-taglib/pom.xml
+++ b/log4j-taglib/pom.xml
@@ -150,6 +150,7 @@
project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-to-slf4j/pom.xml b/log4j-to-slf4j/pom.xml
index e123b91..8db8853 100644
--- a/log4j-to-slf4j/pom.xml
+++ b/log4j-to-slf4j/pom.xml
@@ -140,6 +140,7 @@
project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
</configuration>
<reportSets>
<reportSet>
diff --git a/log4j-web/pom.xml b/log4j-web/pom.xml
index 69bc40a..361accb 100644
--- a/log4j-web/pom.xml
+++ b/log4j-web/pom.xml
@@ -135,6 +135,7 @@
project -->
<detectOfflineLinks>false</detectOfflineLinks>
<linksource>true</linksource>
+ <source>8</source>
<links>
<link>http://docs.oracle.com/javaee/6/api/</link>
</links>
diff --git a/pom.xml b/pom.xml
index cfa5d9d..8b99e05 100644
--- a/pom.xml
+++ b/pom.xml
@@ -204,7 +204,7 @@
<spotbugs.plugin.version>3.1.5</spotbugs.plugin.version>
<spotbugs.version>3.1.7</spotbugs.version>
<changes.plugin.version>2.12.1</changes.plugin.version>
- <javadoc.plugin.version>3.0.1</javadoc.plugin.version>
+ <javadoc.plugin.version>3.2.0</javadoc.plugin.version>
<!-- surefire.plugin.version 2.18 yields
http://jira.codehaus.org/browse/SUREFIRE-1121, which is fixed in 2.18.1 -->
<!-- surefire.plugin.version 2.19 yields
https://issues.apache.org/jira/browse/SUREFIRE-1193. -->
<!-- all versions after 2.13 yield
https://issues.apache.org/jira/browse/SUREFIRE-720 -->
