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..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,11 +51,11 @@ 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 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)
diff --git a/api/maven-api-model/src/main/mdo/maven.mdo b/api/maven-api-model/src/main/mdo/maven.mdo
index d551f378ca0e..4e82a92be8b8 100644
--- a/api/maven-api-model/src/main/mdo/maven.mdo
+++ b/api/maven-api-model/src/main/mdo/maven.mdo
@@ -400,12 +400,17 @@
      *
      * @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 getPomPath() instead.
      */
     @Deprecated
     public java.io.File getPomFile() {
         return (getDelegate().getPomFile() != null) ? getDelegate().getPomFile().toFile() : null;
     }
 
+    /**
+     * @deprecated Use setPomPath(Path) instead.
+     */
     @Deprecated
     public void setPomFile(java.io.File pomFile) {
         update( getDelegate().withPomFile(pomFile != null ? pomFile.toPath() : null));