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 606594534a09cdc9e2131edca8eb5f6244074416 Author: Piotr P. Karwasz <[email protected]> AuthorDate: Sun Dec 29 09:59:02 2024 +0100 Document `log4j-api` changes in version 2.17.2 --- .../org/apache/logging/log4j/simple/SimpleLoggerContextFactory.java | 2 ++ .../src/main/java/org/apache/logging/log4j/spi/LoggerContext.java | 1 + .../src/main/java/org/apache/logging/log4j/util/StackLocator.java | 3 +++ .../src/main/java/org/apache/logging/log4j/util/StackLocatorUtil.java | 4 ++++ log4j-api/src/main/java/org/apache/logging/log4j/util/Strings.java | 4 ++++ 5 files changed, 14 insertions(+) diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/simple/SimpleLoggerContextFactory.java b/log4j-api/src/main/java/org/apache/logging/log4j/simple/SimpleLoggerContextFactory.java index 962c7a7651..163259f251 100644 --- a/log4j-api/src/main/java/org/apache/logging/log4j/simple/SimpleLoggerContextFactory.java +++ b/log4j-api/src/main/java/org/apache/logging/log4j/simple/SimpleLoggerContextFactory.java @@ -27,6 +27,8 @@ public class SimpleLoggerContextFactory implements LoggerContextFactory { /** * Singleton instance. + * + * @since 2.17.2 */ public static final SimpleLoggerContextFactory INSTANCE = new SimpleLoggerContextFactory(); 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 27874bded0..d5a9119a1e 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 @@ -27,6 +27,7 @@ public interface LoggerContext { /** * Empty array. + * @since 2.17.2 */ LoggerContext[] EMPTY_ARRAY = {}; diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/util/StackLocator.java b/log4j-api/src/main/java/org/apache/logging/log4j/util/StackLocator.java index c514217c37..13cf6b39eb 100644 --- a/log4j-api/src/main/java/org/apache/logging/log4j/util/StackLocator.java +++ b/log4j-api/src/main/java/org/apache/logging/log4j/util/StackLocator.java @@ -208,6 +208,9 @@ public final class StackLocator { return Object.class; } + /** + * @since 2.17.2 + */ // migrated from ThrowableProxy @PerformanceSensitive public Deque<Class<?>> getCurrentStackTrace() { diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/util/StackLocatorUtil.java b/log4j-api/src/main/java/org/apache/logging/log4j/util/StackLocatorUtil.java index 197d567d30..89e35aa616 100644 --- a/log4j-api/src/main/java/org/apache/logging/log4j/util/StackLocatorUtil.java +++ b/log4j-api/src/main/java/org/apache/logging/log4j/util/StackLocatorUtil.java @@ -86,6 +86,7 @@ public final class StackLocatorUtil { * @param depth The stack frame count to walk. * @return A class or null. * @throws IndexOutOfBoundsException if depth is negative. + * @since 2.17.2 */ @PerformanceSensitive public static ClassLoader getCallerClassLoader(final int depth) { @@ -112,6 +113,9 @@ public final class StackLocatorUtil { return stackLocator.getCallerClass(anchor); } + /** + * @since 2.17.2 + */ // migrated from ThrowableProxy @PerformanceSensitive public static Deque<Class<?>> getCurrentStackTrace() { 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 304f08fdfb..b33de7dd02 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 @@ -214,6 +214,9 @@ public final class Strings { return buf.toString(); } + /** + * @since 2.17.2 + */ public static String[] splitList(final String string) { return string != null ? string.split(COMMA_DELIMITED_RE) : new String[0]; } @@ -305,6 +308,7 @@ public final class Strings { * @param str The string to upper case. * @return a new string * @see String#toLowerCase(Locale) + * @since 2.17.2 */ public static String toRootLowerCase(final String str) { return str.toLowerCase(Locale.ROOT);
