[DOXIA-620] Deprecate Doxia Logging API in favor of SLF4J

apache · Nov 27, 2021 · 21b3b82 · 21b3b82
1 parent 05d719a
commit 21b3b82
Show file tree

Hide file tree

Showing 5 changed files with 31 additions and 0 deletions.
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
@@ -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
@@ -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
@@ -28,6 +28,7 @@
  * @author <a href="mailto:[email protected]">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
@@ -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
@@ -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.