Document log4j-api changes in version 2.22.0

Author: ppkarwasz

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

@@ -687,6 +687,9 @@ public void entry() {
         entry(FQCN, (Object[]) null);
     }
 
+    /**
+     * @deprecated since 2.22.0, use {@link #traceEntry(String, Object...)} instead.
+     */
     @Deprecated
     @Override
     public void entry(final Object... params) {

log4j-api/src/main/java/org/apache/logging/log4j/util/Base64Util.java

@@ -56,6 +56,7 @@ private Base64Util() {}
 
     /**
      * This method does not specify an encoding for the {@code str} parameter and should not be used.
+     * @deprecated since 2.22.0, use {@link java.util.Base64} instead.
      */
     @Deprecated
     public static String encode(final String str) {

log4j-api/src/main/java/org/apache/logging/log4j/util/Cast.java

@@ -16,6 +16,9 @@
  */
 package org.apache.logging.log4j.util;
 
+/**
+ * @since 2.22.0
+ */
 @InternalApi
 public final class Cast {
 

log4j-api/src/main/java/org/apache/logging/log4j/util/InternalException.java

@@ -19,6 +19,8 @@
 /**
  * Exception thrown when an error occurs while accessing internal resources. This is generally used to
  * convert checked exceptions to runtime exceptions.
+ *
+ * @since 2.22.0
  */
 public class InternalException extends RuntimeException {
 

log4j-api/src/main/java/org/apache/logging/log4j/util/Lazy.java

@@ -24,6 +24,7 @@
  * Provides a lazily-initialized value from a {@code Supplier<T>}.
  *
  * @param <T> type of value
+ * @since 2.22.0
  */
 public interface Lazy<T> extends Supplier<T> {
     /**

log4j-api/src/main/java/org/apache/logging/log4j/util/LazyBoolean.java

@@ -20,6 +20,9 @@
 import java.util.concurrent.locks.ReentrantLock;
 import java.util.function.BooleanSupplier;
 
+/**
+ * @since 2.22.0
+ */
 public class LazyBoolean implements BooleanSupplier {
     private final BooleanSupplier supplier;
     private final Lock lock = new ReentrantLock();

log4j-api/src/main/java/org/apache/logging/log4j/util/LoaderUtil.java

@@ -87,11 +87,15 @@ private LoaderUtil() {}
      * Returns the ClassLoader to use.
      *
      * @return the ClassLoader.
+     * @since 2.22.0
      */
     public static ClassLoader getClassLoader() {
         return getClassLoader(LoaderUtil.class, null);
     }
 
+    /**
+     * @since 2.22.0
+     */
     // TODO: this method could use some explanation
     public static ClassLoader getClassLoader(final Class<?> class1, final Class<?> class2) {
         PrivilegedAction<ClassLoader> action = () -> {
@@ -350,7 +354,7 @@ public static <T> T newCheckedInstanceOfProperty(final String propertyName, fina
      * @throws IllegalAccessException      if the class can't be instantiated through a public constructor
      * @throws InstantiationException      if the provided class is abstract or an interface
      * @throws InvocationTargetException   if an exception is thrown by the constructor
-     * @since 2.22
+     * @since 2.22.0
      */
     public static <T> T newCheckedInstanceOfProperty(
             final String propertyName, final Class<T> clazz, final Supplier<T> defaultSupplier)