[MNG-8522] Deprecate maven-builder-support artifact and its classes

compat/maven-builder-support/pom.xml

@@ -30,10 +30,15 @@ under the License.
 
   <artifactId>maven-builder-support</artifactId>
 
-  <name>Maven Builder Support</name>
+  <name>Maven Builder Support (deprecated)</name>
   <description>Support for descriptor builders (model, setting, toolchains)</description>
 
   <dependencies>
+    <dependency>
+      <groupId>org.apache.maven</groupId>
+      <artifactId>maven-api-core</artifactId>
+      <scope>provided</scope>
+    </dependency>
     <dependency>
       <groupId>org.junit.jupiter</groupId>
       <artifactId>junit-jupiter-api</artifactId>

compat/maven-builder-support/src/main/java/org/apache/maven/building/DefaultProblem.java

@@ -23,7 +23,9 @@
  * thrown or a simple string message. In addition, a problem carries a hint about its source, e.g. the settings file
  * that exhibits the problem.
  *
+ * @deprecated since 4.0.0, use {@link org.apache.maven.api.services} instead
  */
+@Deprecated(since = "4.0.0")
 class DefaultProblem implements Problem {
 
     private final String source;

compat/maven-builder-support/src/main/java/org/apache/maven/building/DefaultProblemCollector.java

@@ -24,7 +24,9 @@
 /**
  * Collects problems that are encountered during settings building.
  *
+ * @deprecated since 4.0.0, use {@link org.apache.maven.api.services} instead
  */
+@Deprecated(since = "4.0.0")
 class DefaultProblemCollector implements ProblemCollector {
 
     private final List<Problem> problems;

compat/maven-builder-support/src/main/java/org/apache/maven/building/FileSource.java

@@ -28,7 +28,9 @@
 /**
  * Wraps an ordinary {@link File} as a source.
  *
+ * @deprecated since 4.0.0, use {@link org.apache.maven.api.services} instead
  */
+@Deprecated(since = "4.0.0")
 public class FileSource implements Source {
     private final Path path;
 

compat/maven-builder-support/src/main/java/org/apache/maven/building/Problem.java

@@ -23,7 +23,9 @@
  * thrown or a simple string message. In addition, a problem carries a hint about its source, e.g. the settings file
  * that exhibits the problem.
  *
+ * @deprecated since 4.0.0, use {@link org.apache.maven.api.services} instead
  */
+@Deprecated(since = "4.0.0")
 public interface Problem {
 
     /**

compat/maven-builder-support/src/main/java/org/apache/maven/building/ProblemCollector.java

@@ -23,7 +23,9 @@
 /**
  * Collects problems that are encountered during settings building.
  *
+ * @deprecated since 4.0.0, use {@link org.apache.maven.api.services} instead
  */
+@Deprecated(since = "4.0.0")
 public interface ProblemCollector {
 
     /**

compat/maven-builder-support/src/main/java/org/apache/maven/building/ProblemCollectorFactory.java

@@ -23,7 +23,9 @@
 /**
  *
  * @since 3.3.0
+ * @deprecated since 4.0.0, use {@link org.apache.maven.api.services} instead
  */
+@Deprecated(since = "4.0.0")
 public class ProblemCollectorFactory {
 
     /**

compat/maven-builder-support/src/main/java/org/apache/maven/building/Source.java

@@ -24,7 +24,9 @@
 /**
  * Provides access to the contents of a source independently of the backing store (e.g. file system, database, memory).
  *
+ * @deprecated since 4.0.0, use {@link org.apache.maven.api.services} instead
  */
+@Deprecated(since = "4.0.0")
 public interface Source {
 
     /**

compat/maven-builder-support/src/main/java/org/apache/maven/building/StringSource.java

@@ -26,7 +26,9 @@
 /**
  * Wraps an ordinary {@link CharSequence} as a source.
  *
+ * @deprecated since 4.0.0, use {@link org.apache.maven.api.services} instead
  */
+@Deprecated(since = "4.0.0")
 public class StringSource implements Source {
     private final String content;
 

compat/maven-builder-support/src/main/java/org/apache/maven/building/UrlSource.java

@@ -26,7 +26,9 @@
 /**
  * Wraps an ordinary {@link URL} as a source.
  *
+ * @deprecated since 4.0.0, use {@link org.apache.maven.api.services} instead
  */
+@Deprecated(since = "4.0.0")
 public class UrlSource implements Source {
 
     private final URL url;