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

michael-o · michael-o · commit 21b3b82f9d74 · 2021-11-27T17:02:00.000+01:00
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: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
@@ -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.

Original file line number	Diff line number	Diff line change
`@@ -34,6 +34,7 @@`
`34`	`34`	`* @author ltheussl`
`35`	`35`	`* @since 1.1`
`36`	`36`	`*/`
	`37`	`+@Deprecated`
`37`	`38`	`public interface Log`
`38`	`39`	`{`
`39`	`40`	`/** Typecode for debugging messages. */`
Original file line number	Diff line number	Diff line change
`@@ -28,6 +28,7 @@`
`28`	`28`	`* @author ltheussl`
`29`	`29`	`* @since 1.1`
`30`	`30`	`*/`
	`31`	`+@Deprecated`
`31`	`32`	`public interface LogEnabled`
`32`	`33`	`{`
`33`	`34`	`/**`
Original file line number	Diff line number	Diff line change
`@@ -31,6 +31,7 @@`
`31`	`31`	`* @author ltheussl`
`32`	`32`	`* @since 1.1`
`33`	`33`	`*/`
	`34`	`+@Deprecated`
`34`	`35`	`public class SystemStreamLog`
`35`	`36`	`implements Log`
`36`	`37`	`{`