From 21b3b82f9d74cd329258a1b137048a2205d169e6 Mon Sep 17 00:00:00 2001
From: Michael Osipov <michaelo@apache.org>
Date: Sat, 27 Nov 2021 17:02:00 +0100
Subject: [PATCH] [DOXIA-620] Deprecate Doxia Logging API in favor of SLF4J

---
 .../org/apache/maven/doxia/logging/Log.java   |  1 +
 .../maven/doxia/logging/LogEnabled.java       |  1 +
 .../doxia/logging/PlexusLoggerWrapper.java    |  1 +
 .../maven/doxia/logging/SystemStreamLog.java  |  1 +
 doxia-logging-api/src/site/apt/index.apt      | 27 +++++++++++++++++++
 5 files changed, 31 insertions(+)
 create mode 100644 doxia-logging-api/src/site/apt/index.apt

diff --git a/doxia-logging-api/src/main/java/org/apache/maven/doxia/logging/Log.java b/doxia-logging-api/src/main/java/org/apache/maven/doxia/logging/Log.java
index e4bd32f94..8b5ad286c 100644
--- a/doxia-logging-api/src/main/java/org/apache/maven/doxia/logging/Log.java
+++ b/doxia-logging-api/src/main/java/org/apache/maven/doxia/logging/Log.java
@@ -34,6 +34,7 @@
  * @author ltheussl
  * @since 1.1
  */
+@Deprecated
 public interface Log
 {
     /** Typecode for debugging messages. */
diff --git a/doxia-logging-api/src/main/java/org/apache/maven/doxia/logging/LogEnabled.java b/doxia-logging-api/src/main/java/org/apache/maven/doxia/logging/LogEnabled.java
index a435a98c9..6bc9922ac 100644
--- a/doxia-logging-api/src/main/java/org/apache/maven/doxia/logging/LogEnabled.java
+++ b/doxia-logging-api/src/main/java/org/apache/maven/doxia/logging/LogEnabled.java
@@ -28,6 +28,7 @@
  * @author ltheussl
  * @since 1.1
  */
+@Deprecated
 public interface LogEnabled
 {
     /**
diff --git a/doxia-logging-api/src/main/java/org/apache/maven/doxia/logging/PlexusLoggerWrapper.java b/doxia-logging-api/src/main/java/org/apache/maven/doxia/logging/PlexusLoggerWrapper.java
index 708b5aaf7..3c7fe4571 100644
--- a/doxia-logging-api/src/main/java/org/apache/maven/doxia/logging/PlexusLoggerWrapper.java
+++ b/doxia-logging-api/src/main/java/org/apache/maven/doxia/logging/PlexusLoggerWrapper.java
@@ -28,6 +28,7 @@
  * @author <a href="mailto:vincent.siveton@gmail.com">Vincent Siveton</a>
  * @since 1.1
  */
+@Deprecated
 public class PlexusLoggerWrapper
     implements Log
 {
diff --git a/doxia-logging-api/src/main/java/org/apache/maven/doxia/logging/SystemStreamLog.java b/doxia-logging-api/src/main/java/org/apache/maven/doxia/logging/SystemStreamLog.java
index 70bcb1494..8ec510ad4 100644
--- a/doxia-logging-api/src/main/java/org/apache/maven/doxia/logging/SystemStreamLog.java
+++ b/doxia-logging-api/src/main/java/org/apache/maven/doxia/logging/SystemStreamLog.java
@@ -31,6 +31,7 @@
  * @author ltheussl
  * @since 1.1
  */
+@Deprecated
 public class SystemStreamLog
     implements Log
 {
diff --git a/doxia-logging-api/src/site/apt/index.apt b/doxia-logging-api/src/site/apt/index.apt
new file mode 100644
index 000000000..fd75b4899
--- /dev/null
+++ b/doxia-logging-api/src/site/apt/index.apt
@@ -0,0 +1,27 @@
+ --------------
+ Maven Doxia Logging API
+ --------------
+
+ ~~ Licensed to the Apache Software Foundation (ASF) under one
+ ~~ or more contributor license agreements.  See the NOTICE file
+ ~~ distributed with this work for additional information
+ ~~ regarding copyright ownership.  The ASF licenses this file
+ ~~ to you under the Apache License, Version 2.0 (the
+ ~~ "License"); you may not use this file except in compliance
+ ~~ with the License.  You may obtain a copy of the License at
+ ~~
+ ~~   http://www.apache.org/licenses/LICENSE-2.0
+ ~~
+ ~~ Unless required by applicable law or agreed to in writing,
+ ~~ software distributed under the License is distributed on an
+ ~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ ~~ KIND, either express or implied.  See the License for the
+ ~~ specific language governing permissions and limitations
+ ~~ under the License.
+
+ ~~ NOTE: For help with the syntax of this file, see:
+ ~~ http://maven.apache.org/doxia/references/apt-format.html
+
+Deprecation Notice
+
+  This Doxia module is deprecated and will be removed in version 2.0.0.