Document all API changes in log4j-api (#3339)

Add missing `@since` and `@deprecated since` tags to `log4j-api`.

Author: ppkarwasz

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

@@ -20,6 +20,7 @@
  * Extended interface to allow bridges between logging systems to convey the
  * correct location information.
  *
+ * @since 2.19.0
  */
 public interface BridgeAware {
 

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

@@ -99,6 +99,9 @@ public static CloseableThreadContext.Instance putAll(final Map<String, String> v
         return new CloseableThreadContext.Instance().putAll(values);
     }
 
+    /**
+     * @since 2.6
+     */
     public static class Instance implements AutoCloseable {
 
         private int pushCount = 0;

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/LogBuilder.java

@@ -22,6 +22,8 @@
 /**
  * Interface for constructing log events before logging them. Instances of LogBuilders should only be created
  * by calling one of the Logger methods that return a LogBuilder.
+ *
+ * @since 2.13.0
  */
 public interface LogBuilder {
     /** NOOP Logbuilder */
@@ -110,7 +112,7 @@ default void log(final Supplier<Message> messageSupplier) {}
      *
      * @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;
@@ -128,6 +130,7 @@ default void log(final Object message) {}
      * @param message the message to log; the format depends on the message factory.
      * @param p0 parameter to the message.
      *
+     * @since 2.13.1
      * @see org.apache.logging.log4j.util.Unbox
      */
     default void log(final String message, final Object p0) {}
@@ -139,6 +142,7 @@ default void log(final String message, final Object p0) {}
      * @param p0 parameter to the message.
      * @param p1 parameter to the message.
      *
+     * @since 2.13.1
      * @see org.apache.logging.log4j.util.Unbox
      */
     default void log(final String message, final Object p0, final Object p1) {}
@@ -151,6 +155,7 @@ default void log(final String message, final Object p0, final Object p1) {}
      * @param p1 parameter to the message.
      * @param p2 parameter to the message.
      *
+     * @since 2.13.1
      * @see org.apache.logging.log4j.util.Unbox
      */
     default void log(final String message, final Object p0, final Object p1, final Object p2) {}
@@ -164,6 +169,7 @@ default void log(final String message, final Object p0, final Object p1, final O
      * @param p2 parameter to the message.
      * @param p3 parameter to the message.
      *
+     * @since 2.13.1
      * @see org.apache.logging.log4j.util.Unbox
      */
     default void log(final String message, final Object p0, final Object p1, final Object p2, final Object p3) {}
@@ -178,6 +184,7 @@ default void log(final String message, final Object p0, final Object p1, final O
      * @param p3 parameter to the message.
      * @param p4 parameter to the message.
      *
+     * @since 2.13.1
      * @see org.apache.logging.log4j.util.Unbox
      */
     default void log(
@@ -199,6 +206,7 @@ default void log(
      * @param p4 parameter to the message.
      * @param p5 parameter to the message.
      *
+     * @since 2.13.1
      * @see org.apache.logging.log4j.util.Unbox
      */
     default void log(
@@ -222,6 +230,7 @@ default void log(
      * @param p5 parameter to the message.
      * @param p6 parameter to the message.
      *
+     * @since 2.13.1
      * @see org.apache.logging.log4j.util.Unbox
      */
     default void log(
@@ -247,6 +256,7 @@ default void log(
      * @param p6 parameter to the message.
      * @param p7 parameter to the message.
      *
+     * @since 2.13.1
      * @see org.apache.logging.log4j.util.Unbox
      */
     default void log(
@@ -274,6 +284,7 @@ default void log(
      * @param p7 parameter to the message.
      * @param p8 parameter to the message.
      *
+     * @since 2.13.1
      * @see org.apache.logging.log4j.util.Unbox
      */
     default void log(
@@ -303,6 +314,7 @@ default void log(
      * @param p8 parameter to the message.
      * @param p9 parameter to the message.
      *
+     * @since 2.13.1
      * @see org.apache.logging.log4j.util.Unbox
      */
     default void log(
@@ -320,6 +332,8 @@ default void log(
 
     /**
      * Causes all the data collected to be logged. Default implementatoin does nothing.
+     *
+     * @since 2.14.1
      */
     default void log() {}
 }

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

@@ -43,6 +43,7 @@ public class LogManager {
     /**
      * Log4j's property to set to the fully qualified class name of a custom implementation of
      * {@link LoggerContextFactory}.
+     * @since 2.0.1
      * @deprecated Replaced since 2.24.0 with {@value org.apache.logging.log4j.spi.Provider#PROVIDER_PROPERTY_NAME}.
      */
     @Deprecated
@@ -297,6 +298,7 @@ protected static LoggerContext getContext(
      * @param configLocation The URI for the configuration to use.
      * @param name The LoggerContext name.
      * @return a LoggerContext.
+     * @since 2.9.1
      */
     protected static LoggerContext getContext(
             final String fqcn,