diff --git a/newandnoteworthy.txt b/newandnoteworthy.txt
index 051dff5e..d9c8b5c5 100644
--- a/newandnoteworthy.txt
+++ b/newandnoteworthy.txt
@@ -10,6 +10,7 @@ New and Noteworthy
  - Improved event fixing, using less browser and more object detection
  - Fixed ID with context selectors (eg. div#id doesn't ignore "div" anymore)
  - Improved jQuery.merge to avoid unnecessary loops
+ - Fixed docs for html(): Now mentions that is not available for XML documents
 
 1.0.4
 -----
diff --git a/src/jquery/jquery.js b/src/jquery/jquery.js
index fd6d3a26..8a0a115c 100644
--- a/src/jquery/jquery.js
+++ b/src/jquery/jquery.js
@@ -2461,6 +2461,9 @@ jQuery.macros = {
 		/**
 		 * Get the html contents of the first matched element.
 		 *
+		 * A wrapper for the innerHTML property of DOM elements, therefore
+		 * not available for XML documents.
+		 *
 		 * @example $("div").html();
 		 * @before <div><input/></div>
 		 * @result <input/>
@@ -2473,6 +2476,9 @@ jQuery.macros = {
 		/**
 		 * Set the html contents of every matched element.
 		 *
+		 * A wrapper for the innerHTML property of DOM elements, therefore
+		 * not available for XML documents.
+		 *
 		 * @example $("div").html("<b>new stuff</b>");
 		 * @before <div><input/></div>
 		 * @result <div><b>new stuff</b></div>