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)
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));