Improve JavaDoc for saved form data

Change-Id: I962df5678081920c30f8a2b1fe79389f702ef3fb

Author: Steve Block

core/java/android/webkit/WebView.java

@@ -1258,8 +1258,10 @@ public void clearCache(boolean includeDiskFiles) {
     }
 
     /**
-     * Makes sure that clearing the form data removes the adapter from the
-     * currently focused textfield if there is one.
+     * Removes the autocomplete popup from the currently focused form field, if
+     * present. Note this only affects the display of the autocomplete popup,
+     * it does not remove any saved form data from this WebView's store. To do
+     * that, use {@link WebViewDatabase#clearFormData}.
      */
     public void clearFormData() {
         checkThread();

core/java/android/webkit/WebViewDatabase.java

@@ -82,16 +82,19 @@ public void clearHttpAuthUsernamePassword() {
     }
 
     /**
-     * Gets whether there is any previously-entered form data saved.
+     * Gets whether there is any saved data for web forms.
      *
-     * @return true if there is form data saved
+     * @return whether there is any saved data for web forms
+     * @see clearFormData
      */
     public boolean hasFormData() {
         throw new MustOverrideException();
     }
 
     /**
-     * Clears any stored previously-entered form data.
+     * Clears any saved data for web forms.
+     *
+     * @see hasFormData
      */
     public void clearFormData() {
         throw new MustOverrideException();