Note that html('content') removes previous data/events.

Fixes jquery#69

Author: kswedberg

entries/html.xml

@@ -57,13 +57,22 @@ $("p").click(function () {
     <signature>
       <added>1.4</added>
       <argument name="function(index, oldhtml)" type="Function">
-        <desc>A function returning the HTML content to set. Receives the index position of the element in the set and the old HTML value as arguments. jQuery empties the element before calling the function; use the oldhtml argument to reference the previous content. Within the function, <code>this</code> refers to the current element in the set.</desc>
+        <desc>A function returning the HTML content to set. Receives the
+          index position of the element in the set and the old HTML value as arguments.
+          jQuery empties the element before calling the function;
+          use the oldhtml argument to reference the previous content.
+          Within the function, <code>this</code> refers to the current element in the set.</desc>
       </argument>
     </signature>
     <desc>Set the HTML contents of each element in the set of matched elements.</desc>
     <longdesc>
       <p>The <code>.html()</code> method is not available in XML documents. </p>
-      <p>When <code>.html()</code> is used to set an element's content, any content that was in that element is completely replaced by the new content. Consider the following HTML:</p>
+      <p>When <code>.html()</code> is used to set an element's content,
+      any content that was in that element is completely replaced by the new content.
+      Additionally, jQuery removes other constructs such as data and event
+      handlers from child elements before replacing those elements with the new content.</p>
+
+      <p>Consider the following HTML:</p>
       <pre><code>&lt;div class="demo-container"&gt;
   &lt;div class="demo-box"&gt;Demonstration Box&lt;/div&gt;
 &lt;/div&gt;</code></pre>
@@ -113,4 +122,4 @@ $("p").click(function () {
     <category slug="version/1.0"/>
     <category slug="version/1.4"/>
   </entry>
-</entries>
+</entries>