[MSHARED-1289] Deprecate library
diff --git a/src/main/java/org/apache/maven/shared/utils/PathTool.java b/src/main/java/org/apache/maven/shared/utils/PathTool.java
index bf0fd49..4ac055d 100644
--- a/src/main/java/org/apache/maven/shared/utils/PathTool.java
+++ b/src/main/java/org/apache/maven/shared/utils/PathTool.java
@@ -32,7 +32,9 @@
* in maven-utils of Apache Maven-1.
* Some external fixes by Apache Committers have been applied later.
* </p>
+ * @deprecated Use {@code org.codehaus.plexus.util.PathTool} instead.
*/
+@Deprecated
public class PathTool {
/**
diff --git a/src/main/java/org/apache/maven/shared/utils/PropertyUtils.java b/src/main/java/org/apache/maven/shared/utils/PropertyUtils.java
index 0730828..6100960 100644
--- a/src/main/java/org/apache/maven/shared/utils/PropertyUtils.java
+++ b/src/main/java/org/apache/maven/shared/utils/PropertyUtils.java
@@ -30,7 +30,9 @@
/**
* Static utility methods for loading properties.
+ * @deprecated Use {@code org.codehaus.plexus.util.PropertyUtils} instead.
*/
+@Deprecated
public class PropertyUtils {
/**
diff --git a/src/main/java/org/apache/maven/shared/utils/StringUtils.java b/src/main/java/org/apache/maven/shared/utils/StringUtils.java
index dff90cb..96de104 100644
--- a/src/main/java/org/apache/maven/shared/utils/StringUtils.java
+++ b/src/main/java/org/apache/maven/shared/utils/StringUtils.java
@@ -47,8 +47,10 @@
* @author <a href="mailto:fredrik@westermarck.com">Fredrik Westermarck</a>
* @author Holger Krauth
* @author <a href="mailto:alex@purpletech.com">Alexander Day Chaffee</a>
+ * @deprecated Use {@code org.codehaus.plexus.util.StringUtils} instead.
*
*/
+@Deprecated
public class StringUtils {
/**
* <p><code>StringUtils</code> instances should NOT be constructed in
diff --git a/src/main/java/org/apache/maven/shared/utils/WriterFactory.java b/src/main/java/org/apache/maven/shared/utils/WriterFactory.java
index a982cc0..3fb0e63 100644
--- a/src/main/java/org/apache/maven/shared/utils/WriterFactory.java
+++ b/src/main/java/org/apache/maven/shared/utils/WriterFactory.java
@@ -39,6 +39,7 @@
* @author Hervé Boutemy
* @see java.nio.charset.Charset
* @see <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/intl/encoding.doc.html">Supported encodings</a>
+ * @deprecated Use default constructors from JDK
*/
@Deprecated
public class WriterFactory {
diff --git a/src/main/java/org/apache/maven/shared/utils/cli/AbstractStreamHandler.java b/src/main/java/org/apache/maven/shared/utils/cli/AbstractStreamHandler.java
index 97ffb47..b92ea9a 100644
--- a/src/main/java/org/apache/maven/shared/utils/cli/AbstractStreamHandler.java
+++ b/src/main/java/org/apache/maven/shared/utils/cli/AbstractStreamHandler.java
@@ -20,7 +20,9 @@
/**
* @author <a href="mailto:kristian.rosenvold@gmail.com">Kristian Rosenvold</a>
+ * @deprecated Use {@code org.codehaus.plexus.util.cli.AbstractStreamHandler} instead.
*/
+@Deprecated
class AbstractStreamHandler extends Thread {
private volatile boolean done;
diff --git a/src/main/java/org/apache/maven/shared/utils/cli/Arg.java b/src/main/java/org/apache/maven/shared/utils/cli/Arg.java
index df7be1f..6e8649c 100644
--- a/src/main/java/org/apache/maven/shared/utils/cli/Arg.java
+++ b/src/main/java/org/apache/maven/shared/utils/cli/Arg.java
@@ -21,8 +21,9 @@
import java.io.File;
/**
- *
+ * @deprecated Use {@code org.codehaus.plexus.util.cli.Arg} instead.
*/
+@Deprecated
public interface Arg {
/**
* @param value the value to be set
diff --git a/src/main/java/org/apache/maven/shared/utils/cli/CommandLineCallable.java b/src/main/java/org/apache/maven/shared/utils/cli/CommandLineCallable.java
index ae806f0..d306faf 100644
--- a/src/main/java/org/apache/maven/shared/utils/cli/CommandLineCallable.java
+++ b/src/main/java/org/apache/maven/shared/utils/cli/CommandLineCallable.java
@@ -24,7 +24,9 @@
* Callable wrapper that exposes the proper exception type to the client.
*
* @author Kristian Rosenvold
+ * @deprecated Use {@code org.codehaus.plexus.util.cli.CommandLineCallable} instead.
*/
+@Deprecated
public interface CommandLineCallable extends Callable<Integer> {
/**
* {@inheritDoc}
diff --git a/src/main/java/org/apache/maven/shared/utils/cli/CommandLineException.java b/src/main/java/org/apache/maven/shared/utils/cli/CommandLineException.java
index cb32678..910ee38 100644
--- a/src/main/java/org/apache/maven/shared/utils/cli/CommandLineException.java
+++ b/src/main/java/org/apache/maven/shared/utils/cli/CommandLineException.java
@@ -20,7 +20,9 @@
/**
* @author <a href="mailto:trygvis@inamo.no">Trygve Laugstøl</a>
+ * @deprecated Use {@code org.codehaus.plexus.util.cli.CommandLineException} instead.
*/
+@Deprecated
public class CommandLineException extends Exception {
/**
*
diff --git a/src/main/java/org/apache/maven/shared/utils/cli/CommandLineTimeOutException.java b/src/main/java/org/apache/maven/shared/utils/cli/CommandLineTimeOutException.java
index 88edb65..61e8c1f 100644
--- a/src/main/java/org/apache/maven/shared/utils/cli/CommandLineTimeOutException.java
+++ b/src/main/java/org/apache/maven/shared/utils/cli/CommandLineTimeOutException.java
@@ -23,7 +23,9 @@
*
* @author Olivier Lamy
*
+ * @deprecated Use {@code org.codehaus.plexus.util.cli.CommandLineTimeOutException} instead.
*/
+@Deprecated
public class CommandLineTimeOutException extends CommandLineException {
private static final long serialVersionUID = 7322428741683224481L;
diff --git a/src/main/java/org/apache/maven/shared/utils/cli/CommandLineUtils.java b/src/main/java/org/apache/maven/shared/utils/cli/CommandLineUtils.java
index 96714b4..ba0b335 100644
--- a/src/main/java/org/apache/maven/shared/utils/cli/CommandLineUtils.java
+++ b/src/main/java/org/apache/maven/shared/utils/cli/CommandLineUtils.java
@@ -36,7 +36,9 @@
/**
* @author <a href="mailto:trygvis@inamo.no">Trygve Laugstøl </a>
+ * @deprecated Use {@code org.codehaus.plexus.util.cli.CommandLineUtils} instead.
*/
+@Deprecated
public abstract class CommandLineUtils {
/**
diff --git a/src/main/java/org/apache/maven/shared/utils/cli/Commandline.java b/src/main/java/org/apache/maven/shared/utils/cli/Commandline.java
index 4452796..e25c24b 100644
--- a/src/main/java/org/apache/maven/shared/utils/cli/Commandline.java
+++ b/src/main/java/org/apache/maven/shared/utils/cli/Commandline.java
@@ -60,7 +60,9 @@
*
* @author thomas.haas@softwired-inc.com
* @author <a href="mailto:stefan.bodewig@epost.de">Stefan Bodewig</a>
+ * @deprecated Use {@code org.codehaus.plexus.util.cli.Commandline} instead.
*/
+@Deprecated
public class Commandline implements Cloneable {
private final List<Arg> arguments = new Vector<>();
diff --git a/src/main/java/org/apache/maven/shared/utils/cli/DefaultConsumer.java b/src/main/java/org/apache/maven/shared/utils/cli/DefaultConsumer.java
index f264046..7b42054 100644
--- a/src/main/java/org/apache/maven/shared/utils/cli/DefaultConsumer.java
+++ b/src/main/java/org/apache/maven/shared/utils/cli/DefaultConsumer.java
@@ -22,7 +22,9 @@
/**
* @author <a href="mailto:evenisse@apache.org">Emmanuel Venisse</a>
+ * @deprecated Use {@code org.codehaus.plexus.util.cli.DefaultConsumer} instead.
*/
+@Deprecated
public class DefaultConsumer implements StreamConsumer {
/**
diff --git a/src/main/java/org/apache/maven/shared/utils/cli/ShutdownHookUtils.java b/src/main/java/org/apache/maven/shared/utils/cli/ShutdownHookUtils.java
index 5ec3bbc..4176761 100644
--- a/src/main/java/org/apache/maven/shared/utils/cli/ShutdownHookUtils.java
+++ b/src/main/java/org/apache/maven/shared/utils/cli/ShutdownHookUtils.java
@@ -27,7 +27,9 @@
* Incorrect usage of the hook itself may still throw an exception.
*
* @author Kristian Rosenvold
+ * @deprecated Use {@code org.codehaus.plexus.util.cli.ShutdownHookUtils} instead.
*/
+@Deprecated
public class ShutdownHookUtils {
/**
diff --git a/src/main/java/org/apache/maven/shared/utils/cli/StreamConsumer.java b/src/main/java/org/apache/maven/shared/utils/cli/StreamConsumer.java
index 9279aca..7a6b6d5 100644
--- a/src/main/java/org/apache/maven/shared/utils/cli/StreamConsumer.java
+++ b/src/main/java/org/apache/maven/shared/utils/cli/StreamConsumer.java
@@ -29,7 +29,9 @@
*
* @author <a href="mailto:fvancea@maxiq.com">Florin Vancea</a>
* @author <a href="mailto:pj@thoughtworks.com">Paul Julius</a>
+ * @deprecated Use {@code org.codehaus.plexus.util.cli.StreamConsumer} instead.
*/
+@Deprecated
public interface StreamConsumer {
/**
* Called when the StreamPumper pumps a line from the Stream.
diff --git a/src/main/java/org/apache/maven/shared/utils/cli/StreamPollFeeder.java b/src/main/java/org/apache/maven/shared/utils/cli/StreamPollFeeder.java
index 27d75bb..49e84dc 100644
--- a/src/main/java/org/apache/maven/shared/utils/cli/StreamPollFeeder.java
+++ b/src/main/java/org/apache/maven/shared/utils/cli/StreamPollFeeder.java
@@ -27,7 +27,9 @@
* Poll InputStream for available data and write the output to an OutputStream.
*
* @author <a href="mailto:trygvis@inamo.no">Trygve Laugstøl</a>
+ * @deprecated Use {@code org.codehaus.plexus.util.cli.StreamPollFeeder} instead.
*/
+@Deprecated
class StreamPollFeeder extends Thread {
public static final int BUF_LEN = 80;
diff --git a/src/main/java/org/apache/maven/shared/utils/cli/StreamPumper.java b/src/main/java/org/apache/maven/shared/utils/cli/StreamPumper.java
index 03a79ca..978af29 100644
--- a/src/main/java/org/apache/maven/shared/utils/cli/StreamPumper.java
+++ b/src/main/java/org/apache/maven/shared/utils/cli/StreamPumper.java
@@ -32,7 +32,9 @@
*
* @author <a href="mailto:fvancea@maxiq.com">Florin Vancea </a>
* @author <a href="mailto:pj@thoughtworks.com">Paul Julius </a>
+ * @deprecated Use {@code org.codehaus.plexus.util.cli.StreamPumper} instead.
*/
+@Deprecated
public class StreamPumper extends AbstractStreamHandler {
private final BufferedReader in;
diff --git a/src/main/java/org/apache/maven/shared/utils/cli/WriterStreamConsumer.java b/src/main/java/org/apache/maven/shared/utils/cli/WriterStreamConsumer.java
index d3dbbbe..694f574 100644
--- a/src/main/java/org/apache/maven/shared/utils/cli/WriterStreamConsumer.java
+++ b/src/main/java/org/apache/maven/shared/utils/cli/WriterStreamConsumer.java
@@ -25,7 +25,9 @@
/**
* @author <a href="mailto:jason@maven.org">Jason van Zyl</a>
*
+ * @deprecated Use {@code org.codehaus.plexus.util.cli.WriterStreamConsumer} instead.
*/
+@Deprecated
public class WriterStreamConsumer implements StreamConsumer {
private final BufferedWriter writer;
diff --git a/src/main/java/org/apache/maven/shared/utils/cli/shell/BourneShell.java b/src/main/java/org/apache/maven/shared/utils/cli/shell/BourneShell.java
index 5ba6e3f..7211ba0 100644
--- a/src/main/java/org/apache/maven/shared/utils/cli/shell/BourneShell.java
+++ b/src/main/java/org/apache/maven/shared/utils/cli/shell/BourneShell.java
@@ -25,7 +25,9 @@
/**
* @author Jason van Zyl
+ * @deprecated Use {@code org.codehaus.plexus.util.cli.shell.BourneShell} instead.
*/
+@Deprecated
public class BourneShell extends Shell {
/**
diff --git a/src/main/java/org/apache/maven/shared/utils/cli/shell/CmdShell.java b/src/main/java/org/apache/maven/shared/utils/cli/shell/CmdShell.java
index 3d72e32..0d8ff37 100644
--- a/src/main/java/org/apache/maven/shared/utils/cli/shell/CmdShell.java
+++ b/src/main/java/org/apache/maven/shared/utils/cli/shell/CmdShell.java
@@ -26,7 +26,9 @@
*
* @author <a href="mailto:carlos@apache.org">Carlos Sanchez</a>
*
+ * @deprecated Use {@code org.codehaus.plexus.util.cli.shell.CmdShell} instead.
*/
+@Deprecated
public class CmdShell extends Shell {
/**
* Create an instance of CmdShell.
diff --git a/src/main/java/org/apache/maven/shared/utils/cli/shell/Shell.java b/src/main/java/org/apache/maven/shared/utils/cli/shell/Shell.java
index ff92c7a..98e05bb 100644
--- a/src/main/java/org/apache/maven/shared/utils/cli/shell/Shell.java
+++ b/src/main/java/org/apache/maven/shared/utils/cli/shell/Shell.java
@@ -36,7 +36,9 @@
*
* @author <a href="mailto:carlos@apache.org">Carlos Sanchez</a>
*
+ * @deprecated Use {@code org.codehaus.plexus.util.cli.shell.Shell} instead.
*/
+@Deprecated
public class Shell implements Cloneable {
private static final char[] DEFAULT_QUOTING_TRIGGER_CHARS = {' '};
diff --git a/src/main/java/org/apache/maven/shared/utils/introspection/ClassMap.java b/src/main/java/org/apache/maven/shared/utils/introspection/ClassMap.java
index 071398c..83d8daf 100644
--- a/src/main/java/org/apache/maven/shared/utils/introspection/ClassMap.java
+++ b/src/main/java/org/apache/maven/shared/utils/introspection/ClassMap.java
@@ -33,7 +33,9 @@
* @author <a href="mailto:szegedia@freemail.hu">Attila Szegedi</a>
* @author <a href="mailto:geirm@optonline.net">Geir Magnusson Jr.</a>
*
+ * @deprecated Use {@code org.codehaus.plexus.util.introspection.ClassMap} instead.
*/
+@Deprecated
public class ClassMap {
private static final class CacheMiss {}
diff --git a/src/main/java/org/apache/maven/shared/utils/introspection/IntrospectionException.java b/src/main/java/org/apache/maven/shared/utils/introspection/IntrospectionException.java
index bf751cc..477650c 100644
--- a/src/main/java/org/apache/maven/shared/utils/introspection/IntrospectionException.java
+++ b/src/main/java/org/apache/maven/shared/utils/introspection/IntrospectionException.java
@@ -18,6 +18,7 @@
*/
package org.apache.maven.shared.utils.introspection;
+@Deprecated
class IntrospectionException extends Exception {
/**
diff --git a/src/main/java/org/apache/maven/shared/utils/introspection/MethodMap.java b/src/main/java/org/apache/maven/shared/utils/introspection/MethodMap.java
index b8460d4..b032153 100644
--- a/src/main/java/org/apache/maven/shared/utils/introspection/MethodMap.java
+++ b/src/main/java/org/apache/maven/shared/utils/introspection/MethodMap.java
@@ -33,7 +33,9 @@
* @author <a href="mailto:geirm@optonline.net">Geir Magnusson Jr.</a>
* @author <a href="mailto:szegedia@freemail.hu">Attila Szegedi</a>
*
+ * @deprecated Use {@code org.codehaus.plexus.util.introspection.MethodMap} instead.
*/
+@Deprecated
class MethodMap {
private static final int MORE_SPECIFIC = 0;
diff --git a/src/main/java/org/apache/maven/shared/utils/introspection/ReflectionValueExtractor.java b/src/main/java/org/apache/maven/shared/utils/introspection/ReflectionValueExtractor.java
index 1c6965e..71fdddd 100644
--- a/src/main/java/org/apache/maven/shared/utils/introspection/ReflectionValueExtractor.java
+++ b/src/main/java/org/apache/maven/shared/utils/introspection/ReflectionValueExtractor.java
@@ -41,7 +41,9 @@
*
* @see <a href="http://struts.apache.org/1.x/struts-taglib/indexedprops.html">
* http://struts.apache.org/1.x/struts-taglib/indexedprops.html</a>
+ * @deprecated Use {@code org.codehaus.plexus.util.introspection.ReflectionValueExtractor} instead.
*/
+@Deprecated
public class ReflectionValueExtractor {
private static final Class<?>[] CLASS_ARGS = new Class[0];
diff --git a/src/main/java/org/apache/maven/shared/utils/io/FileUtils.java b/src/main/java/org/apache/maven/shared/utils/io/FileUtils.java
index 62c5bcb..5264d94 100644
--- a/src/main/java/org/apache/maven/shared/utils/io/FileUtils.java
+++ b/src/main/java/org/apache/maven/shared/utils/io/FileUtils.java
@@ -89,7 +89,9 @@
* @author <a href="mailto:Christoph.Reck@dlr.de">Christoph.Reck</a>
* @author <a href="mailto:peter@apache.org">Peter Donald</a>
* @author <a href="mailto:jefft@apache.org">Jeff Turner</a>
+ * @deprecated Use {@code org.codehaus.plexus.util.io.FileUtils} instead.
*/
+@Deprecated
public class FileUtils {
/**
* protected constructor.
diff --git a/src/main/java/org/apache/maven/shared/utils/io/IOUtil.java b/src/main/java/org/apache/maven/shared/utils/io/IOUtil.java
index bb90a27..5a72762 100644
--- a/src/main/java/org/apache/maven/shared/utils/io/IOUtil.java
+++ b/src/main/java/org/apache/maven/shared/utils/io/IOUtil.java
@@ -78,8 +78,9 @@
* @author <a href="mailto:peter@apache.org">Peter Donald</a>
* @author <a href="mailto:jefft@apache.org">Jeff Turner</a>
* @version CVS $Revision$ $Date$
- *
+ * @deprecated Use {@code org.codehaus.plexus.util.io.IOUtil} instead.
*/
+@Deprecated
public final class IOUtil
/*
* Behold, intrepid explorers; a map of this class:
diff --git a/src/main/java/org/apache/maven/shared/utils/xml/PrettyPrintXMLWriter.java b/src/main/java/org/apache/maven/shared/utils/xml/PrettyPrintXMLWriter.java
index 7c6ba77..ce49071 100644
--- a/src/main/java/org/apache/maven/shared/utils/xml/PrettyPrintXMLWriter.java
+++ b/src/main/java/org/apache/maven/shared/utils/xml/PrettyPrintXMLWriter.java
@@ -29,6 +29,7 @@
* @deprecated this class swallows and ignores IOExceptions. It is dangerous to use when writing
* to anything other than a StringWriter.
* @author kama
+ * @deprecated Use {@code org.codehaus.plexus.util.xml.PrettyPrintXMLWriter} instead.
*/
@Deprecated
public class PrettyPrintXMLWriter implements XMLWriter {
diff --git a/src/main/java/org/apache/maven/shared/utils/xml/XMLEncode.java b/src/main/java/org/apache/maven/shared/utils/xml/XMLEncode.java
index 44b6dd9..0811e6a 100644
--- a/src/main/java/org/apache/maven/shared/utils/xml/XMLEncode.java
+++ b/src/main/java/org/apache/maven/shared/utils/xml/XMLEncode.java
@@ -25,7 +25,9 @@
* Collection of XML encoding/decoding helpers. <br>
* This is all about the special characters & and <, and for attributes
* " and '. These must be encoded/decoded from/to XML.
+ * @deprecated Use {@code org.codehaus.plexus.util.xml.XMLEncode} instead.
*/
+@Deprecated
final class XMLEncode {
private static final int CDATA_BLOCK_THRESHOLD_LENGTH = 12;
diff --git a/src/main/java/org/apache/maven/shared/utils/xml/XMLWriter.java b/src/main/java/org/apache/maven/shared/utils/xml/XMLWriter.java
index 19a1901..940eab1 100644
--- a/src/main/java/org/apache/maven/shared/utils/xml/XMLWriter.java
+++ b/src/main/java/org/apache/maven/shared/utils/xml/XMLWriter.java
@@ -23,6 +23,7 @@
/**
* Interface for tools writing XML files.
* XMLWriters are not thread safe and must not be accessed concurrently.
+ * @deprecated Use {@code org.codehaus.plexus.util.xml.XMLWriter} instead.
*/
@Deprecated
public interface XMLWriter {
diff --git a/src/main/java/org/apache/maven/shared/utils/xml/XmlWriterUtil.java b/src/main/java/org/apache/maven/shared/utils/xml/XmlWriterUtil.java
index e321772..c0c4971 100644
--- a/src/main/java/org/apache/maven/shared/utils/xml/XmlWriterUtil.java
+++ b/src/main/java/org/apache/maven/shared/utils/xml/XmlWriterUtil.java
@@ -26,7 +26,7 @@
* Utility class for the <code>XmlWriter</code> class.
*
* @author <a href="mailto:vincent.siveton@gmail.com">Vincent Siveton</a>
- *
+ * @deprecated Use {@code org.codehaus.plexus.util.xml.XmlWriterUtil} instead.
*/
@Deprecated
public class XmlWriterUtil {
diff --git a/src/main/java/org/apache/maven/shared/utils/xml/Xpp3Dom.java b/src/main/java/org/apache/maven/shared/utils/xml/Xpp3Dom.java
index 2ba422d..a3d3e30 100644
--- a/src/main/java/org/apache/maven/shared/utils/xml/Xpp3Dom.java
+++ b/src/main/java/org/apache/maven/shared/utils/xml/Xpp3Dom.java
@@ -33,7 +33,7 @@
* A reimplementation of Plexus Xpp3Dom based on the public interface of Plexus Xpp3Dom.
*
* @author Kristian Rosenvold
- * @deprecated use org.w3c.dom, JDOM, XOM, or SAX
+ * @deprecated Use {@code org.codehaus.plexus.util.xml.Xpp3Dom} instead.
*/
@Deprecated
public class Xpp3Dom implements Iterable<Xpp3Dom> {
diff --git a/src/main/java/org/apache/maven/shared/utils/xml/Xpp3DomBuilder.java b/src/main/java/org/apache/maven/shared/utils/xml/Xpp3DomBuilder.java
index 0936218..a87f8d0 100644
--- a/src/main/java/org/apache/maven/shared/utils/xml/Xpp3DomBuilder.java
+++ b/src/main/java/org/apache/maven/shared/utils/xml/Xpp3DomBuilder.java
@@ -38,7 +38,7 @@
/**
* @author Kristian Rosenvold
- * @deprecated use org.w3c.dom, JDOM, XOM, or SAX
+ * @deprecated Use {@code org.codehaus.plexus.util.xml.Xpp3DomBuilder} instead.
*/
@Deprecated
public class Xpp3DomBuilder {
diff --git a/src/main/java/org/apache/maven/shared/utils/xml/Xpp3DomUtils.java b/src/main/java/org/apache/maven/shared/utils/xml/Xpp3DomUtils.java
index a9c8faa..64af1a4 100644
--- a/src/main/java/org/apache/maven/shared/utils/xml/Xpp3DomUtils.java
+++ b/src/main/java/org/apache/maven/shared/utils/xml/Xpp3DomUtils.java
@@ -24,7 +24,7 @@
import java.util.Map;
/**
- * @deprecated use org.w3c.dom, JDOM, XOM, or SAX
+ * @deprecated Use {@code org.codehaus.plexus.util.xml.Xpp3DomUtils} instead.
*/
@Deprecated
public class Xpp3DomUtils {
diff --git a/src/main/java/org/apache/maven/shared/utils/xml/Xpp3DomWriter.java b/src/main/java/org/apache/maven/shared/utils/xml/Xpp3DomWriter.java
index 0ae0174..bd1c93c 100644
--- a/src/main/java/org/apache/maven/shared/utils/xml/Xpp3DomWriter.java
+++ b/src/main/java/org/apache/maven/shared/utils/xml/Xpp3DomWriter.java
@@ -24,7 +24,7 @@
/**
* @author Brett Porter
- * @deprecated use org.w3c.dom, JDOM, XOM, or SAX
+ * @deprecated Use {@code org.codehaus.plexus.util.xml.Xpp3DomWriter} instead.
*/
@Deprecated
public class Xpp3DomWriter {
diff --git a/src/main/java/org/apache/maven/shared/utils/xml/pull/XmlPullParserException.java b/src/main/java/org/apache/maven/shared/utils/xml/pull/XmlPullParserException.java
index 3c44a23..3dca3d3 100644
--- a/src/main/java/org/apache/maven/shared/utils/xml/pull/XmlPullParserException.java
+++ b/src/main/java/org/apache/maven/shared/utils/xml/pull/XmlPullParserException.java
@@ -23,7 +23,7 @@
import org.xml.sax.SAXException;
/**
- * @deprecated use org.w3c.dom, JDOM, XOM, or SAX
+ * @deprecated Use {@code org.codehaus.plexus.util.xml.pull.XmlPullParserException} instead.
*/
@Deprecated
public class XmlPullParserException extends RuntimeException {
diff --git a/src/site/apt/index.apt.vm b/src/site/apt/index.apt.vm
index 419146d..c1281db 100644
--- a/src/site/apt/index.apt.vm
+++ b/src/site/apt/index.apt.vm
@@ -29,6 +29,11 @@
${project.name}
+ <<This project is deprecated now and consumers should look into viable alternatives like {{{http://codehaus-plexus.github.io/plexus-utils/}plexus-utils}}
+ {{{http://codehaus-plexus.github.io/plexus-xml/}plexus-xml}} or native JDK API (where possible).
+ The original intent is stated below, but in fact it was never adopted widely and plexus-utils received more maintenance.>>
+
+
This project aims to be a functional replacement for
{{{http://codehaus-plexus.github.io/plexus-utils/}plexus-utils}} in Maven.
