X-Git-Url: http://git.asbjorn.biz/?a=blobdiff_plain;f=src%2Fjquery%2Fjquery.js;h=f997aafa48e413109076eb081283824b5e4a21a9;hb=998d1d8839813b957a32465fdc7ef7d27d858eea;hp=d2141375e3b27ed556e7d52a97ae6768cfeed161;hpb=698eafb58a9b046446115be7d8a9d4a6db7ececb;p=jquery.git

diff --git a/src/jquery/jquery.js b/src/jquery/jquery.js
index d214137..f997aaf 100644
--- a/src/jquery/jquery.js
+++ b/src/jquery/jquery.js
@@ -3158,24 +3158,31 @@ jQuery.macros = {
 		},
 
 		/**
-		 * Binds a particular event (like click) to a each of a set of match elements.
-		 *
-		 * @example $("p").bind( "click", function() { alert("Hello"); } )
+		 * Binds a handler to a particular event (like click) for each matched element.
+		 * The event handler is passed an event object that you can use to prevent
+		 * default behaviour. To stop both default action and event bubbling, your handler
+		 * has to return false.
+		 *
+		 * @example $("p").bind( "click", function() {
+		 *   alert( $(this).text() );
+		 * } )
 		 * @before <p>Hello</p>
-		 * @result [ <p>Hello</p> ]
-		 *
-		 * Cancel a default action and prevent it from bubbling by returning false
-		 * from your function.
+		 * @result Hello
 		 *
 		 * @example $("form").bind( "submit", function() { return false; } )
+		 * @desc Cancel a default action and prevent it from bubbling by returning false
+		 * from your function.
 		 *
-		 * Cancel a default action by using the preventDefault method.
-		 *
-		 * @example $("form").bind( "submit", function() { e.preventDefault(); } )
+		 * @example $("form").bind( "submit", function(event) {
+		 *   event.preventDefault();
+		 * } );
+		 * @desc Cancel only the default action by using the preventDefault method.
 		 *
-		 * Stop an event from bubbling by using the stopPropogation method.
 		 *
-		 * @example $("form").bind( "submit", function() { e.stopPropogation(); } )
+		 * @example $("form").bind( "submit", function(event) {
+		 *   event.stopPropagation();
+		 * } )
+		 * @desc Stop only an event from bubbling by using the stopPropagation method.
 		 *
 		 * @name bind
 		 * @type jQuery