Error: Added deprecation note

Closes gh-824

Author: AurelioDeRosa

entries/error.xml

@@ -21,6 +21,7 @@
   </signature>
   <longdesc>
     <p>This method is a shortcut for <code>.on( "error", handler )</code>.</p>
+    <p><b>As of jQuery 1.8</b>, the <code>.error()</code> method is deprecated. Use <code>.on( "error", handler )</code> to attach event handlers to the <code>error</code> event instead.</p>
     <p>The <code>error</code> event is sent to elements, such as images, that are referenced by a document and loaded by the browser. It is called if the element was not loaded correctly.</p>
     <p>For example, consider a page with a simple image element:</p>
     <pre><code>