removeData: Note .removeData() doesn't cause .data() to re-fetch data-attrs

Closes gh-1296
Ref jquery/jquery#5751

Author: mgol

entries/removeData.xml

@@ -19,10 +19,11 @@
   <longdesc>
     <p>The <code>.removeData()</code> method allows us to remove values that were previously set using <code>.data()</code>. When called with the name of a key, <code>.removeData()</code> deletes that particular value. When called with no arguments, <code>.removeData()</code> removes all values.</p>
     <p>
-      Note that <code>.removeData()</code> will only remove data from jQuery's internal <code>.data()</code> cache, and any corresponding <code>data-</code> attributes on the element will not be removed. A later call to <code>data()</code>
-      will therefore re-retrieve the value from the <code>data-</code> attribute. To prevent this, use <code>.removeAttr()</code> alongside <code>.removeData()</code> to remove the <code>data-</code> attribute as well. Prior to jQuery 1.4.3,
-      as <code>data()</code> did not use <code>data-</code> attributes, this was not an issue.
+      Note that <code>.removeData()</code> will only remove data from jQuery's internal <code>.data()</code> cache, and any corresponding <code>data-</code> attributes on the element will not be removed. A later call to <code>.data( "key" )</code>
+      will therefore re-retrieve the value from the <code>data-key</code> attribute. To prevent this, use <code>.removeAttr()</code> alongside <code>.removeData()</code> to remove the <code>data-</code> attribute as well. Prior to jQuery 1.4.3,
+      as <code>.data()</code> did not use <code>data-</code> attributes, this was not an issue.
     </p>
+    <p>The bulk <code>.data()</code> getter will only fetch <code>data-</code> attributes once, even if <code>.removeData()</code> is called in between <code>.data()</code> calls.</p>
     <p><strong>As of jQuery 1.7</strong>, when called with an array of keys or a string of space-separated keys, <code>.removeData()</code> deletes the value of each key in that array or string.</p>
   </longdesc>
   <example>