diff --git a/src/java.desktop/share/classes/javax/swing/JComponent.java b/src/java.desktop/share/classes/javax/swing/JComponent.java
index b34c9094d59..f9e0481e9da 100644
--- a/src/java.desktop/share/classes/javax/swing/JComponent.java
+++ b/src/java.desktop/share/classes/javax/swing/JComponent.java
@@ -656,8 +656,9 @@ public abstract class JComponent extends Container implements Serializable,
 
 
     /**
-     * Resets the UI property to a value from the current look and feel.
-     * <code>JComponent</code> subclasses must override this method
+     * This method is called to update the UI property to a value from the
+     * current look and feel.
+     * {@code JComponent} subclasses must override this method
      * like this:
      * <pre>
      *   public void updateUI() {
@@ -665,6 +666,8 @@ public abstract class JComponent extends Container implements Serializable,
      *   }
      *  </pre>
      *
+     * @implSpec The default implementation of this method does nothing.
+     *
      * @see #setUI
      * @see UIManager#getLookAndFeel
      * @see UIManager#getUI