diff --git a/user/src/com/google/gwt/core/client/JavaScriptObject.java b/user/src/com/google/gwt/core/client/JavaScriptObject.java
index c4e2538..a084c20 100644
--- a/user/src/com/google/gwt/core/client/JavaScriptObject.java
+++ b/user/src/com/google/gwt/core/client/JavaScriptObject.java
@@ -127,7 +127,8 @@
   }
 
   /**
-   * Returns <code>true</code> if the objects are JavaScript identical
+   * Calls a native JS <code>equals</code> method if any, otherwise
+   * returns <code>true</code> if the objects are JavaScript identical
    * (triple-equals).
    */
   @Override
@@ -139,7 +140,8 @@
   }
 
   /**
-   * Uses a monotonically increasing counter to assign a hash code to the
+   * Calls a native JS <code>hashCode</code> method if any, otherwise
+   * uses a monotonically increasing counter to assign a hash code to the
    * underlying JavaScript object. Do not call this method on non-modifiable
    * JavaScript objects.
    *