You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by el...@apache.org on 2026/02/16 15:02:09 UTC

(maven) branch master updated: docs: document deprecation rationale for getPomFile/setPomFile (#11680)

This is an automated email from the ASF dual-hosted git repository.

elharo pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven.git


The following commit(s) were added to refs/heads/master by this push:
     new 8cbf02e3d1 docs: document deprecation rationale for getPomFile/setPomFile (#11680)
8cbf02e3d1 is described below

commit 8cbf02e3d16193c60dcf850443e437138609f376
Author: Anukalp Pandey <pa...@gmail.com>
AuthorDate: Mon Feb 16 20:32:03 2026 +0530

    docs: document deprecation rationale for getPomFile/setPomFile (#11680)
    
    * docs: document deprecation rationale for getPomFile/setPomFile
    
    * docs: clarify deprecation replacement for Language.SCRIPT
    
    * docs: fix deprecation text format in maven.mdo
    
    * docs: remove redundant deprecation tag for Language.SCRIPT
    
    * docs: restore 'since' in @Deprecated annotation and remove redundancy
    
    * docs: restore {@link} reference in deprecation note
---
 api/maven-api-model/src/main/mdo/maven.mdo | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/api/maven-api-model/src/main/mdo/maven.mdo b/api/maven-api-model/src/main/mdo/maven.mdo
index d551f378ca..1797ae0d64 100644
--- a/api/maven-api-model/src/main/mdo/maven.mdo
+++ b/api/maven-api-model/src/main/mdo/maven.mdo
@@ -400,13 +400,18 @@
      *
      * @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 Use {@link #getPomPath()} instead.
      */
-    @Deprecated
+    @Deprecated(since = "4.0.0")
     public java.io.File getPomFile() {
         return (getDelegate().getPomFile() != null) ? getDelegate().getPomFile().toFile() : null;
     }
 
-    @Deprecated
+    /**
+     * @deprecated Use {@link #setPomPath(Path)} instead.
+     */
+    @Deprecated(since = "4.0.0")
     public void setPomFile(java.io.File pomFile) {
         update( getDelegate().withPomFile(pomFile != null ? pomFile.toPath() : null));
     }