This is an automated email from the ASF dual-hosted git repository. pkarwasz pushed a commit to branch doc/2.x/since-tag in repository https://gitbox.apache.org/repos/asf/logging-log4j2.git
commit 6dfb86d6cd428068155a021e460c52aba0726e83 Author: Piotr P. Karwasz <[email protected]> AuthorDate: Sun Dec 29 09:37:49 2024 +0100 Document `log4j-api` changes in version 2.12.1 --- .../src/main/java/org/apache/logging/log4j/spi/AbstractLogger.java | 6 ++++++ .../java/org/apache/logging/log4j/spi/AbstractLoggerAdapter.java | 2 ++ .../main/java/org/apache/logging/log4j/spi/LocationAwareLogger.java | 2 ++ .../org/apache/logging/log4j/spi/LoggerContextShutdownAware.java | 2 ++ .../org/apache/logging/log4j/spi/LoggerContextShutdownEnabled.java | 2 ++ 5 files changed, 14 insertions(+) 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 3d965dd91f..261fe2a25f 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 @@ -2870,6 +2870,9 @@ public abstract class AbstractLogger implements ExtendedLogger, LocationAwareLog } } + /** + * @since 2.12.1 + */ protected void log( final Level level, final Marker marker, @@ -3813,6 +3816,9 @@ public abstract class AbstractLogger implements ExtendedLogger, LocationAwareLog logIfEnabled(FQCN, Level.WARN, null, message, p0, p1, p2, p3, p4, p5, p6, p7, p8, p9); } + /** + * @since 2.12.1 + */ protected boolean requiresLocation() { return false; } 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 4fb5cdb49e..bd38b48420 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 @@ -94,6 +94,8 @@ public abstract class AbstractLoggerAdapter<L> implements LoggerAdapter<L>, Logg /** * For unit testing. Consider to be private. + * + * @since 2.12.1 */ public Set<LoggerContext> getLoggerContexts() { return new HashSet<>(registry.keySet()); diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/spi/LocationAwareLogger.java b/log4j-api/src/main/java/org/apache/logging/log4j/spi/LocationAwareLogger.java index dd6950eed1..c23a5610be 100644 --- a/log4j-api/src/main/java/org/apache/logging/log4j/spi/LocationAwareLogger.java +++ b/log4j-api/src/main/java/org/apache/logging/log4j/spi/LocationAwareLogger.java @@ -22,6 +22,8 @@ import org.apache.logging.log4j.message.Message; /** * Logger that accepts the location of the caller. + * + * @since 2.12.1 */ public interface LocationAwareLogger { void logMessage( diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/spi/LoggerContextShutdownAware.java b/log4j-api/src/main/java/org/apache/logging/log4j/spi/LoggerContextShutdownAware.java index 5ea88122db..426629dc94 100644 --- a/log4j-api/src/main/java/org/apache/logging/log4j/spi/LoggerContextShutdownAware.java +++ b/log4j-api/src/main/java/org/apache/logging/log4j/spi/LoggerContextShutdownAware.java @@ -19,6 +19,8 @@ package org.apache.logging.log4j.spi; /** * Interface allowing interested classes to know when a LoggerContext has shutdown - if the LoggerContext * implementation provides a way to register listeners. + * + * @since 2.12.1 */ public interface LoggerContextShutdownAware { diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/spi/LoggerContextShutdownEnabled.java b/log4j-api/src/main/java/org/apache/logging/log4j/spi/LoggerContextShutdownEnabled.java index 0add801259..9c9fdc12d7 100644 --- a/log4j-api/src/main/java/org/apache/logging/log4j/spi/LoggerContextShutdownEnabled.java +++ b/log4j-api/src/main/java/org/apache/logging/log4j/spi/LoggerContextShutdownEnabled.java @@ -20,6 +20,8 @@ import java.util.List; /** * LoggerContexts implementing this are able register LoggerContextShutdownAware classes. + * + * @since 2.12.1 */ public interface LoggerContextShutdownEnabled {
