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 8f5df036d94e3a39e6d668af1e54135ecb3e9213 Author: Piotr P. Karwasz <[email protected]> AuthorDate: Sun Dec 29 10:16:59 2024 +0100 Document `log4j-api` changes in version 2.20.0 --- log4j-api/src/main/java/org/apache/logging/log4j/LogBuilder.java | 2 +- log4j-api/src/main/java/org/apache/logging/log4j/Logger.java | 2 +- log4j-api/src/main/java/org/apache/logging/log4j/ThreadContext.java | 2 ++ .../java/org/apache/logging/log4j/message/FlowMessageFactory.java | 6 +++--- .../apache/logging/log4j/util/SystemPropertiesPropertySource.java | 3 +++ 5 files changed, 10 insertions(+), 5 deletions(-) diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/LogBuilder.java b/log4j-api/src/main/java/org/apache/logging/log4j/LogBuilder.java index c5a113fa5b..2d5c18023b 100644 --- a/log4j-api/src/main/java/org/apache/logging/log4j/LogBuilder.java +++ b/log4j-api/src/main/java/org/apache/logging/log4j/LogBuilder.java @@ -112,7 +112,7 @@ public interface LogBuilder { * * @param messageSupplier The supplier of the message to log. * @return the message logger or {@code null} if no logging occurred. - * @since 2.20 + * @since 2.20.0 */ default Message logAndGet(final Supplier<Message> messageSupplier) { return null; 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 0e64e3a38c..fb3a5712bf 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 @@ -1971,7 +1971,7 @@ public interface Logger { * Gets the flow message factory used to convert messages into flow messages. * * @return the flow message factory, as an instance of {@link FlowMessageFactory}. - * @since 2.20 + * @since 2.20.0 */ FlowMessageFactory getFlowMessageFactory(); diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/ThreadContext.java b/log4j-api/src/main/java/org/apache/logging/log4j/ThreadContext.java index d919b3130a..46dba0dd7d 100644 --- a/log4j-api/src/main/java/org/apache/logging/log4j/ThreadContext.java +++ b/log4j-api/src/main/java/org/apache/logging/log4j/ThreadContext.java @@ -214,6 +214,8 @@ public final class ThreadContext { /** * <em>Consider private, used for testing.</em> + * + * @since 2.20.0 */ public static void init() { final PropertiesUtil properties = PropertiesUtil.getProperties(); diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/message/FlowMessageFactory.java b/log4j-api/src/main/java/org/apache/logging/log4j/message/FlowMessageFactory.java index e2c7f26053..d53dc872d4 100644 --- a/log4j-api/src/main/java/org/apache/logging/log4j/message/FlowMessageFactory.java +++ b/log4j-api/src/main/java/org/apache/logging/log4j/message/FlowMessageFactory.java @@ -28,7 +28,7 @@ public interface FlowMessageFactory { * @param message format string * @param params parameters * @return the new entry message - * @since 2.20 + * @since 2.20.0 */ EntryMessage newEntryMessage(String message, Object... params); @@ -46,7 +46,7 @@ public interface FlowMessageFactory { * @param format a format string * @param result the return value * @return the new exit message - * @since 2.20 + * @since 2.20.0 */ ExitMessage newExitMessage(String format, Object result); @@ -55,7 +55,7 @@ public interface FlowMessageFactory { * * @param message the original entry message * @return the new exit message - * @since 2.20 + * @since 2.20.0 */ ExitMessage newExitMessage(Message message); diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/util/SystemPropertiesPropertySource.java b/log4j-api/src/main/java/org/apache/logging/log4j/util/SystemPropertiesPropertySource.java index e49dad0dd5..3471f1db8e 100644 --- a/log4j-api/src/main/java/org/apache/logging/log4j/util/SystemPropertiesPropertySource.java +++ b/log4j-api/src/main/java/org/apache/logging/log4j/util/SystemPropertiesPropertySource.java @@ -49,6 +49,9 @@ public class SystemPropertiesPropertySource implements PropertySource { return INSTANCE; } + /** + * @since 2.20.0 + */ public static String getSystemProperty(final String key, final String defaultValue) { final String value = INSTANCE.getProperty(key); return value != null ? value : defaultValue;
