Improved docs for blur() and focus(), mentioning the difference between calling the...

diff --git a/newandnoteworthy.txt b/newandnoteworthy.txt
index d9c8b5c..10aa9ea 100644 (file)
--- a/newandnoteworthy.txt
+++ b/newandnoteworthy.txt
@@ -11,6 +11,7 @@ New and Noteworthy
  - 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
+ - Improved docs for blur() and focus(), mentioning the difference between calling the jQuery method and the DOM method
 
 1.0.4
 -----

diff --git a/src/event/event.js b/src/event/event.js
index 72ea29a..fd4385c 100644 (file)
--- a/src/event/event.js
+++ b/src/event/event.js
@@ -315,6 +315,9 @@ new function(){
                 * Trigger the focus event of each matched element. This causes all of the functions
                 * that have been bound to thet focus event to be executed.
                 *
+                * Note: This does not execute the focus method of the underlying elements! If you need to
+                * focus an element via code, you have to use the DOM method, eg. $("#myinput")[0].focus();
+                *
                 * @example $("p").focus();
                 * @before <p onfocus="alert('Hello');">Hello</p>
                 * @result alert('Hello');
@@ -655,6 +658,9 @@ new function(){
                 * Trigger the blur event of each matched element. This causes all of the functions
                 * that have been bound to thet blur event to be executed.
                 *
+                * Note: This does not execute the blur method of the underlying elements! If you need to
+                * blur an element via code, you have to use the DOM method, eg. $("#myinput")[0].blur();
+                *
                 * @example $("p").blur();
                 * @before <p onblur="alert('Hello');">Hello</p>
                 * @result alert('Hello');
@@ -1527,7 +1533,7 @@ new function(){
                 */
 
        var e = ("blur,focus,load,resize,scroll,unload,click,dblclick," +
-               "mousedown,mouseup,mousemove,mouseover,mouseout,change,reset,select," + 
+               "mousedown,mouseup,mousemove,mouseover,mouseout,change,select," + 
                "submit,keydown,keypress,keyup,error").split(",");
 
        // Go through all the event names, but make sure that