Marked load() as private, won't work anyway

[jquery.git] / src / event / event.js

diff --git a/src/event/event.js b/src/event/event.js
index 583f8f5..186fa0d 100644 (file)
--- a/src/event/event.js
+++ b/src/event/event.js
@@ -720,11 +720,15 @@ new function(){
                 * 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
                 */
@@ -1451,9 +1455,78 @@ new function(){
                 * @cat Events/Mouse
                 */
                 
+               /**
+                * Bind a function to the mouseover event of each matched element.
+                *
+                * @example $("p").mouseover( function() { alert("Hello"); } );
+                * @before <p>Hello</p>
+                * @result <p onmouseover="alert('Hello');">Hello</p>
+                *
+                * @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
+                */
+
+               /**
+                * Bind a function to the mouseover event of each matched element, which will only be executed once.
+                * Unlike a call to the normal .mouseover() method, calling .onemouseover() causes the bound function to be
+                * only executed the first time it is triggered, and never again (unless it is re-bound).
+                *
+                * @example $("p").onemouseover( function() { alert("Hello"); } );
+                * @before <p onmouseover="alert('Hello');">Hello</p>
+                * @result alert('Hello'); // Only executed for the first mouseover
+                *
+                * @name onemouseover
+                * @type jQuery
+                * @param Function fn A function to bind to the mouseover event on each of the matched elements.
+                * @cat Events/Mouse
+                */
+
+               /**
+                * Removes a bound mouseover event from each of the matched
+                * elements. You must pass the identical function that was used in the original 
+                * bind method.
+                *
+                * @example $("p").unmouseover( myFunction );
+                * @before <p onmouseover="myFunction">Hello</p>
+                * @result <p>Hello</p>
+                *
+                * @name unmouseover
+                * @type jQuery
+                * @param Function fn A function to unbind from the mouseover event on each of the matched elements.
+                * @cat Events/Mouse
+                */
+
+               /**
+                * Removes all bound mouseover events from each of the matched elements.
+                *
+                * @example $("p").unmouseover();
+                * @before <p onmouseover="alert('Hello');">Hello</p>
+                * @result <p>Hello</p>
+                *
+                * @name unmouseover
+                * @type jQuery
+                * @cat Events/Mouse
+                */
+                
                 /**
                  * @test var count;
-                 * var e = ("blur,focus,load,resize,scroll,unload,click,dblclick," +
+                 * // ignore load
+                 * var e = ("blur,focus,resize,scroll,unload,click,dblclick," +
                  *             "mousedown,mouseup,mousemove,mouseover,mouseout,change,reset,select," + 
                  *             "submit,keydown,keypress,keyup,error").split(",");
                  * var handler1 = function(event) {
@@ -1486,7 +1559,7 @@ new function(){
                  *     $(document)[event]();
                  *     
                  *     // assert count
-                 * @test ok( count == 6, 'Checking event ' + event);
+                 *     ok( count == 6, 'Checking event ' + event);
                  * }
                  *
                  * @private
@@ -1578,3 +1651,12 @@ new function(){
        jQuery.event.add( window, "load", jQuery.ready );
        
 };
+
+// Clean up after IE to avoid memory leaks
+if ($.browser.msie) $(window).unload(function() {
+       var event = jQuery.event, global = event.global;
+       for (var type in global) {
+               var els = global[type], i = els.length;
+               if (i>0) do event.remove(els[i-1], type); while (--i);
+       }
+});