From 3453072585b9bf5c9ecbed45da2b959eeadf6009 Mon Sep 17 00:00:00 2001 From: Anukalp Date: Mon, 26 Jan 2026 14:34:57 +0530 Subject: [PATCH 1/4] docs: document deprecation rationale for getPomFile/setPomFile --- api/maven-api-model/src/main/mdo/maven.mdo | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/api/maven-api-model/src/main/mdo/maven.mdo b/api/maven-api-model/src/main/mdo/maven.mdo index d551f378ca0e..657ebcd3aec7 100644 --- a/api/maven-api-model/src/main/mdo/maven.mdo +++ b/api/maven-api-model/src/main/mdo/maven.mdo @@ -400,12 +400,19 @@ * * @return The POM file from which this model originated or {@code null} if this model does not belong to a local * project (e.g. describes the metadata of some artifact from the repository). + * + * @deprecated since 4.0.0. + * Use {@link #getPomPath()} instead. */ @Deprecated public java.io.File getPomFile() { return (getDelegate().getPomFile() != null) ? getDelegate().getPomFile().toFile() : null; } + /** + * @deprecated since 4.0.0. + * Use {@link #setPomPath(java.nio.file.Path)} instead. + */ @Deprecated public void setPomFile(java.io.File pomFile) { update( getDelegate().withPomFile(pomFile != null ? pomFile.toPath() : null)); From f1cca3b5ed5e348bac9ec1a854f669963ed8f85c Mon Sep 17 00:00:00 2001 From: Anukalp Date: Wed, 28 Jan 2026 18:48:37 +0530 Subject: [PATCH 2/4] docs: clarify deprecation replacement for Language.SCRIPT --- .../src/main/java/org/apache/maven/api/Language.java | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/api/maven-api-core/src/main/java/org/apache/maven/api/Language.java b/api/maven-api-core/src/main/java/org/apache/maven/api/Language.java index 39a5c46e6ae6..f91dac6f6f5c 100644 --- a/api/maven-api-core/src/main/java/org/apache/maven/api/Language.java +++ b/api/maven-api-core/src/main/java/org/apache/maven/api/Language.java @@ -53,9 +53,10 @@ public interface Language extends ExtensibleEnum { /** * The "script" language. Provided for compatibility with Maven 3. * - * @deprecated Use {@link #RESOURCES} instead. + * @deprecated since 4.0.0. + * Use {@link #RESOURCES} instead. */ - @Deprecated + @Deprecated(since = "4.0.0") Language SCRIPT = language("script"); // TODO: this should be moved out from here to Java Support (builtin into core) From 9d875d61015d590219d41bd8418a646f635be542 Mon Sep 17 00:00:00 2001 From: Anukalp Date: Sun, 1 Feb 2026 06:47:42 +0530 Subject: [PATCH 3/4] docs: fix deprecation text format in maven.mdo --- api/maven-api-model/src/main/mdo/maven.mdo | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/api/maven-api-model/src/main/mdo/maven.mdo b/api/maven-api-model/src/main/mdo/maven.mdo index 657ebcd3aec7..4e82a92be8b8 100644 --- a/api/maven-api-model/src/main/mdo/maven.mdo +++ b/api/maven-api-model/src/main/mdo/maven.mdo @@ -401,8 +401,7 @@ * @return The POM file from which this model originated or {@code null} if this model does not belong to a local * project (e.g. describes the metadata of some artifact from the repository). * - * @deprecated since 4.0.0. - * Use {@link #getPomPath()} instead. + * @deprecated Use getPomPath() instead. */ @Deprecated public java.io.File getPomFile() { @@ -410,8 +409,7 @@ } /** - * @deprecated since 4.0.0. - * Use {@link #setPomPath(java.nio.file.Path)} instead. + * @deprecated Use setPomPath(Path) instead. */ @Deprecated public void setPomFile(java.io.File pomFile) { From f22b4c0095957154532ff0b8dfe8db4da236a127 Mon Sep 17 00:00:00 2001 From: Anukalp Date: Sun, 1 Feb 2026 20:26:30 +0530 Subject: [PATCH 4/4] docs: finalize Language.SCRIPT deprecation documentation --- .../src/main/java/org/apache/maven/api/Language.java | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/api/maven-api-core/src/main/java/org/apache/maven/api/Language.java b/api/maven-api-core/src/main/java/org/apache/maven/api/Language.java index f91dac6f6f5c..9b07f7757c63 100644 --- a/api/maven-api-core/src/main/java/org/apache/maven/api/Language.java +++ b/api/maven-api-core/src/main/java/org/apache/maven/api/Language.java @@ -51,10 +51,9 @@ public interface Language extends ExtensibleEnum { Language RESOURCES = language("resources"); /** - * The "script" language. Provided for compatibility with Maven 3. + * The {@code "script"} language. This constant is retained for backward compatibility with Maven 3. * - * @deprecated since 4.0.0. - * Use {@link #RESOURCES} instead. + * @deprecated Use {@link #RESOURCES} instead. */ @Deprecated(since = "4.0.0") Language SCRIPT = language("script");