Document log4j-api changes in version 2.24.0

Author: ppkarwasz

log4j-api/src/main/java/org/apache/logging/log4j/EventLogger.java

@@ -22,7 +22,8 @@
 /**
  * Convenience to log {@link StructuredDataMessage}s.
  *
- * @deprecated {@link Logger} accepts {@link StructuredDataMessage}s, users should use to that instead.
+ * @deprecated Deprecated since 2.24.0.
+ * {@link Logger} accepts {@link StructuredDataMessage}s, users should use to that instead.
  */
 @Deprecated
 public final class EventLogger {

log4j-api/src/main/java/org/apache/logging/log4j/message/DefaultFlowMessageFactory.java

@@ -32,6 +32,9 @@ public class DefaultFlowMessageFactory implements FlowMessageFactory, Serializab
     private static final String ENTRY_DEFAULT_PREFIX = "Enter";
     private static final long serialVersionUID = 8578655591131397576L;
 
+    /**
+     * @since 2.24.0
+     */
     public static final FlowMessageFactory INSTANCE = new DefaultFlowMessageFactory();
 
     private final String entryText;

log4j-api/src/main/java/org/apache/logging/log4j/message/ReusableParameterizedMessage.java

@@ -135,25 +135,37 @@ private static Throwable determineThrowable(final Object[] args, final int argCo
         return null;
     }
 
+    /**
+     * @since 2.24.0
+     */
     public ReusableParameterizedMessage set(final String messagePattern, final Object... arguments) {
         init(messagePattern, arguments == null ? 0 : arguments.length, arguments);
         varargs = arguments;
         return this;
     }
 
+    /**
+     * @since 2.24.0
+     */
     public ReusableParameterizedMessage set(final String messagePattern, final Object p0) {
         params[0] = p0;
         init(messagePattern, 1, params);
         return this;
     }
 
+    /**
+     * @since 2.24.0
+     */
     public ReusableParameterizedMessage set(final String messagePattern, final Object p0, final Object p1) {
         params[0] = p0;
         params[1] = p1;
         init(messagePattern, 2, params);
         return this;
     }
 
+    /**
+     * @since 2.24.0
+     */
     public ReusableParameterizedMessage set(
             final String messagePattern, final Object p0, final Object p1, final Object p2) {
         params[0] = p0;
@@ -163,6 +175,9 @@ public ReusableParameterizedMessage set(
         return this;
     }
 
+    /**
+     * @since 2.24.0
+     */
     public ReusableParameterizedMessage set(
             final String messagePattern, final Object p0, final Object p1, final Object p2, final Object p3) {
         params[0] = p0;
@@ -173,6 +188,9 @@ public ReusableParameterizedMessage set(
         return this;
     }
 
+    /**
+     * @since 2.24.0
+     */
     public ReusableParameterizedMessage set(
             final String messagePattern,
             final Object p0,
@@ -189,6 +207,9 @@ public ReusableParameterizedMessage set(
         return this;
     }
 
+    /**
+     * @since 2.24.0
+     */
     public ReusableParameterizedMessage set(
             final String messagePattern,
             final Object p0,
@@ -207,6 +228,9 @@ public ReusableParameterizedMessage set(
         return this;
     }
 
+    /**
+     * @since 2.24.0
+     */
     public ReusableParameterizedMessage set(
             final String messagePattern,
             final Object p0,
@@ -227,6 +251,9 @@ public ReusableParameterizedMessage set(
         return this;
     }
 
+    /**
+     * @since 2.24.0
+     */
     public ReusableParameterizedMessage set(
             final String messagePattern,
             final Object p0,
@@ -249,6 +276,9 @@ public ReusableParameterizedMessage set(
         return this;
     }
 
+    /**
+     * @since 2.24.0
+     */
     public ReusableParameterizedMessage set(
             final String messagePattern,
             final Object p0,
@@ -273,6 +303,9 @@ public ReusableParameterizedMessage set(
         return this;
     }
 
+    /**
+     * @since 2.24.0
+     */
     public ReusableParameterizedMessage set(
             final String messagePattern,
             final Object p0,

log4j-api/src/main/java/org/apache/logging/log4j/spi/AbstractLogger.java

@@ -138,6 +138,7 @@ public AbstractLogger(final String name, final MessageFactory messageFactory) {
      * @param name the logger name (if null, will be derived from this class)
      * @param messageFactory the {@link Message} factory (if null, {@link ParameterizedMessageFactory} will be used)
      * @param flowMessageFactory the {@link org.apache.logging.log4j.message.FlowMessage} factory (if null, {@link DefaultFlowMessageFactory} will be used)
+     * @since 2.24.0
      */
     protected AbstractLogger(
             final String name, final MessageFactory messageFactory, final FlowMessageFactory flowMessageFactory) {

log4j-api/src/main/java/org/apache/logging/log4j/spi/Provider.java

@@ -43,6 +43,7 @@
 public class Provider {
     /**
      * Constant inlined by the compiler
+     * @since 2.24.0
      */
     protected static final String CURRENT_VERSION = "2.6.0";
 
@@ -317,7 +318,7 @@ public ThreadContextMap getThreadContextMapInstance() {
      *
      * @return the URL corresponding to the Provider {@code META-INF/log4j-provider.properties} file or {@code null}
      * for a provider class.
-     * @deprecated since 2.24.0, without replacement.
+     * @deprecated since 2.24.0, without a replacement.
      */
     @Deprecated
     public @Nullable URL getUrl() {