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

[elharo]

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 <pandeyanuka...@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));
     }