diff --git a/src/java.base/share/classes/java/lang/Process.java b/src/java.base/share/classes/java/lang/Process.java
index 3c4a40df1aafe..02188dad6d665 100644
--- a/src/java.base/share/classes/java/lang/Process.java
+++ b/src/java.base/share/classes/java/lang/Process.java
@@ -444,9 +444,10 @@ public final BufferedWriter outputWriter(Charset charset) {
      *
      * @implSpec
      * The default implementation of this method polls the {@code exitValue}
-     * to check if the process has terminated. Concrete implementations of this
-     * class are strongly encouraged to override this method with a more
-     * efficient implementation.
+     * to check if the process has terminated.
+     * @apiNote
+     * Concrete implementations of this class are strongly encouraged to
+     * override this method with a more efficient implementation.
      *
      * @param timeout the maximum time to wait
      * @param unit the time unit of the {@code timeout} argument
@@ -489,9 +490,10 @@ public boolean waitFor(long timeout, TimeUnit unit)
      *
      * @implSpec
      * The default implementation of this method polls the {@code exitValue}
-     * to check if the process has terminated. Concrete implementations of this
-     * class are strongly encouraged to override this method with a more
-     * efficient implementation.
+     * to check if the process has terminated.
+     * @apiNote
+     * Concrete implementations of this class are strongly encouraged to
+     * override this method with a more efficient implementation.
      *
      * @param duration the maximum duration to wait; if not positive,
      *                this method returns immediately.