Moved some more files around.

1 files changed, 80 insertions, 0 deletions

diff --git a/build/docs/gen-events.pl b/build/docs/gen-events.pl
new file mode 100644
index 000000000..5e92df927
--- /dev/null
+++ b/build/docs/gen-events.pl
@@ -0,0 +1,80 @@
+#!/usr/bin/perl
+
+my @stuff = split(",", "blur,focus,load,resize,scroll,unload,click,dblclick," .
+		"mousedown,mouseup,mousemove,mouseover,mouseout,change,reset,select," .
+		"submit,keydown,keypress,keyup,error");
+
+foreach (@stuff) {
+
+print qq~
+		/**
+		 * Bind a function to the $_ event of each matched element.
+		 *
+		 * \@example \$("p").$_( function() { alert("Hello"); } );
+		 * \@before <p>Hello</p>
+		 * \@result <p on$_="alert('Hello');">Hello</p>
+		 *
+		 * \@name $_
+		 * \@type jQuery
+		 * \@param Function fn A function to bind to the $_ event on each of the matched elements.
+		 * \@cat Events
+		 */
+
+		/**
+		 * Trigger the $_ event of each matched element. This causes all of the functions
+		 * that have been bound to thet $_ event to be executed.
+		 *
+		 * \@example \$("p").$_();
+		 * \@before <p on$_="alert('Hello');">Hello</p>
+		 * \@result alert('Hello');
+		 *
+		 * \@name $_
+		 * \@type jQuery
+		 * \@cat Events
+		 */
+
+		/**
+		 * Bind a function to the $_ event of each matched element, which will only be executed once.
+		 * Unlike a call to the normal .$_() method, calling .one$_() causes the bound function to be
+		 * only executed the first time it is triggered, and never again (unless it is re-bound).
+		 *
+		 * \@example \$("p").one$_( function() { alert("Hello"); } );
+		 * \@before <p on$_="alert('Hello');">Hello</p>
+		 * \@result alert('Hello'); // Only executed for the first $_
+		 *
+		 * \@name one$_
+		 * \@type jQuery
+		 * \@param Function fn A function to bind to the $_ event on each of the matched elements.
+		 * \@cat Events
+		 */
+
+		/**
+		 * Removes a bound $_ event from each of the matched
+		 * elements. You must pass the identical function that was used in the original 
+		 * bind method.
+		 *
+		 * \@example \$("p").un$_( myFunction );
+		 * \@before <p on$_="myFunction">Hello</p>
+		 * \@result <p>Hello</p>
+		 *
+		 * \@name un$_
+		 * \@type jQuery
+		 * \@param Function fn A function to unbind from the $_ event on each of the matched elements.
+		 * \@cat Events
+		 */
+
+		/**
+		 * Removes all bound $_ events from each of the matched elements.
+		 *
+		 * \@example \$("p").un$_();
+		 * \@before <p on$_="alert('Hello');">Hello</p>
+		 * \@result <p>Hello</p>
+		 *
+		 * \@name un$_
+		 * \@type jQuery
+		 * \@cat Events
+		 */
+~;
+
+
+}