Document log4j-api changes in version 2.23.0

Author: ppkarwasz

log4j-api/src/main/java/org/apache/logging/log4j/status/StatusConsoleListener.java

@@ -142,7 +142,7 @@ public void log(final StatusData data) {
      * Adds package name filters to exclude.
      *
      * @param filters An array of package names to exclude.
-     * @deprecated This method is ineffective and only kept for binary backward compatibility.
+     * @deprecated since 2.23.0, this method is ineffective and only kept for binary backward compatibility.
      */
     @Deprecated
     public void setFilters(final String... filters) {}

log4j-api/src/main/java/org/apache/logging/log4j/status/StatusData.java

@@ -94,6 +94,7 @@ public StatusData(
      * Returns the instant of the event.
      *
      * @return the event's instant
+     * @since 2.23.0
      */
     public Instant getInstant() {
         return instant;
@@ -103,7 +104,7 @@ public Instant getInstant() {
      * Returns the instant of the event.
      *
      * @return the event's instant
-     * @deprecated Use {@link #getInstant()} instead.
+     * @deprecated since 2.23.0, use {@link #getInstant()} instead.
      */
     @Deprecated
     public long getTimestamp() {

log4j-api/src/main/java/org/apache/logging/log4j/status/StatusLogger.java

@@ -581,6 +581,7 @@ public static void setLogger(final StatusLogger logger) {
      * Returns the fallback listener.
      *
      * @return the fallback listener
+     * @since 2.23.0
      */
     public StatusConsoleListener getFallbackListener() {
         return fallbackListener;
@@ -590,7 +591,8 @@ public StatusConsoleListener getFallbackListener() {
      * Sets the level of the fallback listener.
      *
      * @param level a level
-     * @deprecated Instead use the {@link StatusConsoleListener#setLevel(Level) setLevel(Level)} method on the fallback listener returned by {@link #getFallbackListener()}.
+     * @deprecated Since 2.23.0, instead use the {@link StatusConsoleListener#setLevel(Level) setLevel(Level)} method
+     * on the fallback listener returned by {@link #getFallbackListener()}.
      */
     @Deprecated
     public void setLevel(final Level level) {
@@ -634,7 +636,8 @@ public void removeListener(final StatusListener listener) {
      *
      * @param level a level
      * @since 2.6
-     * @deprecated Instead use the {@link StatusConsoleListener#setLevel(Level) setLevel(Level)} method on the fallback listener returned by {@link #getFallbackListener()}.
+     * @deprecated Since 2.23.0, instead use the {@link StatusConsoleListener#setLevel(Level) setLevel(Level)} method
+     * on the fallback listener returned by {@link #getFallbackListener()}.
      */
     @Deprecated
     public void updateListenerLevel(final Level level) {
@@ -690,7 +693,8 @@ private static void closeListenerSafely(final StatusListener listener) {
     /**
      * Returns buffered events.
      *
-     * @deprecated Instead of relying on the buffering provided by {@code StatusLogger}, users should register their own listeners to access to logged events.
+     * @deprecated Since 2.23.0, instead of relying on the buffering provided by {@code StatusLogger},
+     * users should register their own listeners to access to logged events.
      * @return a thread-safe read-only collection of buffered events
      */
     @Deprecated
@@ -704,7 +708,8 @@ public List<StatusData> getStatusData() {
     /**
      * Clears the event buffer.
      *
-     * @deprecated Instead of relying on the buffering provided by {@code StatusLogger}, users should register their own listeners to access to logged events.
+     * @deprecated Since 2.23.0, instead of relying on the buffering provided by {@code StatusLogger},
+     * users should register their own listeners to access to logged events.
      */
     @Deprecated
     public void clear() {