Improved the categories of a bunch of docs, upped the version to 1.1.
[jquery.git] / src / event / event.js
index eaf6858..6e8a45f 100644 (file)
@@ -486,20 +486,7 @@ new function(){
         * @name scroll
         * @type jQuery
         * @param Function fn A function to bind to the scroll event on each of the matched elements.
-        * @cat Events/Browser
-        */
-
-       /**
-        * Trigger the scroll event of each matched element. This causes all of the functions
-        * that have been bound to thet scroll event to be executed.
-        *
-        * @example $("p").scroll();
-        * @before <p onscroll="alert('Hello');">Hello</p>
-        * @result alert('Hello');
-        *
-        * @name scroll
-        * @type jQuery
-        * @cat Events/Browser
+        * @cat Events
         */
 
        /**
@@ -514,7 +501,7 @@ new function(){
         * @name submit
         * @type jQuery
         * @param Function fn A function to bind to the submit event on each of the matched elements.
-        * @cat Events/Form
+        * @cat Events
         */
 
        /**
@@ -529,7 +516,7 @@ new function(){
         *
         * @name submit
         * @type jQuery
-        * @cat Events/Form
+        * @cat Events
         */
 
        /**
@@ -542,7 +529,7 @@ new function(){
         * @name focus
         * @type jQuery
         * @param Function fn A function to bind to the focus event on each of the matched elements.
-        * @cat Events/UI
+        * @cat Events
         */
 
        /**
@@ -558,7 +545,7 @@ new function(){
         *
         * @name focus
         * @type jQuery
-        * @cat Events/UI
+        * @cat Events
         */
 
        /**
@@ -571,20 +558,7 @@ new function(){
         * @name keydown
         * @type jQuery
         * @param Function fn A function to bind to the keydown event on each of the matched elements.
-        * @cat Events/Keyboard
-        */
-
-       /**
-        * Trigger the keydown event of each matched element. This causes all of the functions
-        * that have been bound to thet keydown event to be executed.
-        *
-        * @example $("p").keydown();
-        * @before <p onkeydown="alert('Hello');">Hello</p>
-        * @result alert('Hello');
-        *
-        * @name keydown
-        * @type jQuery
-        * @cat Events/Keyboard
+        * @cat Events
         */
 
        /**
@@ -597,20 +571,7 @@ new function(){
         * @name dblclick
         * @type jQuery
         * @param Function fn A function to bind to the dblclick event on each of the matched elements.
-        * @cat Events/Mouse
-        */
-
-       /**
-        * Trigger the dblclick event of each matched element. This causes all of the functions
-        * that have been bound to thet dblclick event to be executed.
-        *
-        * @example $("p").dblclick();
-        * @before <p ondblclick="alert('Hello');">Hello</p>
-        * @result alert('Hello');
-        *
-        * @name dblclick
-        * @type jQuery
-        * @cat Events/Mouse
+        * @cat Events
         */
 
        /**
@@ -623,20 +584,7 @@ new function(){
         * @name keypress
         * @type jQuery
         * @param Function fn A function to bind to the keypress event on each of the matched elements.
-        * @cat Events/Keyboard
-        */
-
-       /**
-        * Trigger the keypress event of each matched element. This causes all of the functions
-        * that have been bound to thet keypress event to be executed.
-        *
-        * @example $("p").keypress();
-        * @before <p onkeypress="alert('Hello');">Hello</p>
-        * @result alert('Hello');
-        *
-        * @name keypress
-        * @type jQuery
-        * @cat Events/Keyboard
+        * @cat Events
         */
 
        /**
@@ -649,20 +597,7 @@ new function(){
         * @name error
         * @type jQuery
         * @param Function fn A function to bind to the error event on each of the matched elements.
-        * @cat Events/Browser
-        */
-
-       /**
-        * Trigger the error event of each matched element. This causes all of the functions
-        * that have been bound to thet error event to be executed.
-        *
-        * @example $("p").error();
-        * @before <p onerror="alert('Hello');">Hello</p>
-        * @result alert('Hello');
-        *
-        * @name error
-        * @type jQuery
-        * @cat Events/Browser
+        * @cat Events
         */
 
        /**
@@ -675,7 +610,7 @@ new function(){
         * @name blur
         * @type jQuery
         * @param Function fn A function to bind to the blur event on each of the matched elements.
-        * @cat Events/UI
+        * @cat Events
         */
 
        /**
@@ -691,7 +626,7 @@ new function(){
         *
         * @name blur
         * @type jQuery
-        * @cat Events/UI
+        * @cat Events
         */
 
        /**
@@ -704,24 +639,7 @@ new function(){
         * @name load
         * @type jQuery
         * @param Function fn A function to bind to the load event on each of the matched elements.
-        * @cat Events/Browser
-        */
-
-       /**
-        * Trigger the load event of each matched element. This causes all of the functions
-        * that have been bound to thet load event to be executed.
-        *
-        * Marked as private: Calling load() without arguments throws exception because the ajax load
-        * does not handle it.
-        *
-        * @example $("p").load();
-        * @before <p onload="alert('Hello');">Hello</p>
-        * @result alert('Hello');
-        *
-        * @name load
-        * @private
-        * @type jQuery
-        * @cat Events/Browser
+        * @cat Events
         */
 
        /**
@@ -734,7 +652,7 @@ new function(){
         * @name select
         * @type jQuery
         * @param Function fn A function to bind to the select event on each of the matched elements.
-        * @cat Events/Form
+        * @cat Events
         */
 
        /**
@@ -747,7 +665,7 @@ new function(){
         *
         * @name select
         * @type jQuery
-        * @cat Events/Form
+        * @cat Events
         */
 
        /**
@@ -760,20 +678,7 @@ new function(){
         * @name mouseup
         * @type jQuery
         * @param Function fn A function to bind to the mouseup event on each of the matched elements.
-        * @cat Events/Mouse
-        */
-
-       /**
-        * Trigger the mouseup event of each matched element. This causes all of the functions
-        * that have been bound to thet mouseup event to be executed.
-        *
-        * @example $("p").mouseup();
-        * @before <p onmouseup="alert('Hello');">Hello</p>
-        * @result alert('Hello');
-        *
-        * @name mouseup
-        * @type jQuery
-        * @cat Events/Mouse
+        * @cat Events
         */
 
        /**
@@ -786,20 +691,7 @@ new function(){
         * @name unload
         * @type jQuery
         * @param Function fn A function to bind to the unload event on each of the matched elements.
-        * @cat Events/Browser
-        */
-
-       /**
-        * Trigger the unload event of each matched element. This causes all of the functions
-        * that have been bound to thet unload event to be executed.
-        *
-        * @example $("p").unload();
-        * @before <p onunload="alert('Hello');">Hello</p>
-        * @result alert('Hello');
-        *
-        * @name unload
-        * @type jQuery
-        * @cat Events/Browser
+        * @cat Events
         */
 
        /**
@@ -812,20 +704,7 @@ new function(){
         * @name change
         * @type jQuery
         * @param Function fn A function to bind to the change event on each of the matched elements.
-        * @cat Events/Form
-        */
-
-       /**
-        * Trigger the change event of each matched element. This causes all of the functions
-        * that have been bound to thet change event to be executed.
-        *
-        * @example $("p").change();
-        * @before <p onchange="alert('Hello');">Hello</p>
-        * @result alert('Hello');
-        *
-        * @name change
-        * @type jQuery
-        * @cat Events/Form
+        * @cat Events
         */
 
        /**
@@ -838,20 +717,7 @@ new function(){
         * @name mouseout
         * @type jQuery
         * @param Function fn A function to bind to the mouseout event on each of the matched elements.
-        * @cat Events/Mouse
-        */
-
-       /**
-        * Trigger the mouseout event of each matched element. This causes all of the functions
-        * that have been bound to thet mouseout event to be executed.
-        *
-        * @example $("p").mouseout();
-        * @before <p onmouseout="alert('Hello');">Hello</p>
-        * @result alert('Hello');
-        *
-        * @name mouseout
-        * @type jQuery
-        * @cat Events/Mouse
+        * @cat Events
         */
 
        /**
@@ -864,20 +730,7 @@ new function(){
         * @name keyup
         * @type jQuery
         * @param Function fn A function to bind to the keyup event on each of the matched elements.
-        * @cat Events/Keyboard
-        */
-
-       /**
-        * Trigger the keyup event of each matched element. This causes all of the functions
-        * that have been bound to thet keyup event to be executed.
-        *
-        * @example $("p").keyup();
-        * @before <p onkeyup="alert('Hello');">Hello</p>
-        * @result alert('Hello');
-        *
-        * @name keyup
-        * @type jQuery
-        * @cat Events/Keyboard
+        * @cat Events
         */
 
        /**
@@ -890,7 +743,7 @@ new function(){
         * @name click
         * @type jQuery
         * @param Function fn A function to bind to the click event on each of the matched elements.
-        * @cat Events/Mouse
+        * @cat Events
         */
 
        /**
@@ -903,7 +756,7 @@ new function(){
         *
         * @name click
         * @type jQuery
-        * @cat Events/Mouse
+        * @cat Events
         */
 
        /**
@@ -916,20 +769,7 @@ new function(){
         * @name resize
         * @type jQuery
         * @param Function fn A function to bind to the resize event on each of the matched elements.
-        * @cat Events/Browser
-        */
-
-       /**
-        * Trigger the resize event of each matched element. This causes all of the functions
-        * that have been bound to thet resize event to be executed.
-        *
-        * @example $("p").resize();
-        * @before <p onresize="alert('Hello');">Hello</p>
-        * @result alert('Hello');
-        *
-        * @name resize
-        * @type jQuery
-        * @cat Events/Browser
+        * @cat Events
         */
 
        /**
@@ -942,20 +782,7 @@ new function(){
         * @name mousemove
         * @type jQuery
         * @param Function fn A function to bind to the mousemove event on each of the matched elements.
-        * @cat Events/Mouse
-        */
-
-       /**
-        * Trigger the mousemove event of each matched element. This causes all of the functions
-        * that have been bound to thet mousemove event to be executed.
-        *
-        * @example $("p").mousemove();
-        * @before <p onmousemove="alert('Hello');">Hello</p>
-        * @result alert('Hello');
-        *
-        * @name mousemove
-        * @type jQuery
-        * @cat Events/Mouse
+        * @cat Events
         */
 
        /**
@@ -968,20 +795,7 @@ new function(){
         * @name mousedown
         * @type jQuery
         * @param Function fn A function to bind to the mousedown event on each of the matched elements.
-        * @cat Events/Mouse
-        */
-
-       /**
-        * Trigger the mousedown event of each matched element. This causes all of the functions
-        * that have been bound to thet mousedown event to be executed.
-        *
-        * @example $("p").mousedown();
-        * @before <p onmousedown="alert('Hello');">Hello</p>
-        * @result alert('Hello');
-        *
-        * @name mousedown
-        * @type jQuery
-        * @cat Events/Mouse
+        * @cat Events
         */
         
        /**
@@ -994,38 +808,18 @@ new function(){
         * @name mouseover
         * @type jQuery
         * @param Function fn A function to bind to the mousedown event on each of the matched elements.
-        * @cat Events/Mouse
-        */
-
-       /**
-        * Trigger the mouseover event of each matched element. This causes all of the functions
-        * that have been bound to thet mousedown event to be executed.
-        *
-        * @example $("p").mouseover();
-        * @before <p onmouseover="alert('Hello');">Hello</p>
-        * @result alert('Hello');
-        *
-        * @name mouseover
-        * @type jQuery
-        * @cat Events/Mouse
+        * @cat Events
         */
-
-       var e = ("blur,focus,load,resize,scroll,unload,click,dblclick," +
+       jQuery.each( ("blur,focus,load,resize,scroll,unload,click,dblclick," +
                "mousedown,mouseup,mousemove,mouseover,mouseout,change,select," + 
-               "submit,keydown,keypress,keyup,error").split(",");
-
-       // Go through all the event names, but make sure that
-       // it is enclosed properly
-       for ( var i = 0; i < e.length; i++ ) new function(){
-                       
-               var o = e[i];
+               "submit,keydown,keypress,keyup,error").split(","), function(i,o){
                
                // Handle event binding
                jQuery.fn[o] = function(f){
                        return f ? this.bind(o, f) : this.trigger(o);
                };
                        
-       };
+       });
        
        // If Mozilla is used
        if ( jQuery.browser.mozilla || jQuery.browser.opera )