diff --git a/src/java.desktop/share/classes/java/awt/Taskbar.java b/src/java.desktop/share/classes/java/awt/Taskbar.java
index 82a64d0f3807..9858944ade9e 100644
--- a/src/java.desktop/share/classes/java/awt/Taskbar.java
+++ b/src/java.desktop/share/classes/java/awt/Taskbar.java
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2016, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -322,7 +322,7 @@ public PopupMenu getMenu() {
     }
 
     /**
-     * Changes this application's icon to the provided image.
+     * Requests the system to change this application's icon to the provided {@code image}.
      *
      * @param image to change
      * @throws SecurityException if a security manager exists and it denies the
@@ -339,6 +339,10 @@ public void setIconImage(final Image image) {
     /**
      * Obtains an image of this application's icon.
      *
+     * @apiNote The returned icon image may not be equal
+     * to an image set by {@link java.awt.Taskbar#setIconImage},
+     * but should be visually similar.
+     *
      * @return an image of this application's icon
      * @throws SecurityException if a security manager exists and it denies the
      * {@code RuntimePermission("canProcessApplicationEvents")} permission.