diff --git a/src/jquery/jquery.js b/src/jquery/jquery.js
index 1d96eacf6..cd4d4e796 100644
--- a/src/jquery/jquery.js
+++ b/src/jquery/jquery.js
@@ -768,12 +768,37 @@ jQuery.fn = jQuery.prototype = {
},
/**
- * End the most recent 'destructive' operation, reverting the list of matched elements
- * back to its previous state. After an end operation, the list of matched elements will
- * revert to the last state of matched elements.
+ * Revert the most recent 'destructive' operation, changing the set of matched elements
+ * to its previous state (right before the destructive operation).
*
* If there was no destructive operation before, an empty set is returned.
*
+ * A 'destructive' operation is any operation that changes the set of
+ * matched jQuery elements. These functions are:
+ * These functions are:
+ *
+ * add
+ *
+ * children
+ *
+ * clone
+ *
+ * filter
+ *
+ * find
+ *
+ * not
+ *
+ * next
+ *
+ * parent
+ *
+ * parents
+ *
+ * prev
+ *
+ * siblings
+ *
* @example $("p").find("span").end();
* @before
Hello, how are you?
* @result [...
] @@ -924,6 +949,13 @@ jQuery.fn = jQuery.prototype = { * of matched elements. This method is used to remove one or more * elements from a jQuery object. * + * Please note: the expression cannot use a reference to the + * element name. See the two examples below. + * + * This will not work: $(".res img").not("img[@src$=on]") + * + * This will: $(".res img").not("[@src$=on]"); // also could be written $(".res img:not([@src$=on])") + * * @example $("p").not( $("div p.selected") ) * @beforeHello
Hello Again
Hello
] @@ -952,8 +984,12 @@ jQuery.fn = jQuery.prototype = { * to the set of matched elements. * * @example $("p").add("span") - * @beforeHello
Hello Again - * @result [Hello
, Hello Again ] + * @before (HTML)Hello
Hello Again + * @result (jQuery object matching 2 elements) [Hello
, Hello Again ] + * @desc Compare the above result to the result of$('p')
,
+ * which would just result in [ Hello
]
.
+ * Using add(), matched elements of $('span')
are simply
+ * added to the returned jQuery-object.
*
* @name add
* @type jQuery
@@ -1783,7 +1819,7 @@ new function() {
* Get a set of elements containing the unique parents of the matched
* set of elements.
*
- * Can be filtered with an optional expressions.
+ * You may use an optional expression to filter the set of parent elements that will match.
*
* @example $("p").parent()
* @before Hello
Hello
Hello
Hello AgainHello
Hello Again
Hello
And Again
@@ -1897,7 +1934,8 @@ new function() { * Get a set of elements containing all of the unique children of each of the * matched set of elements. * - * Can be filtered with an optional expressions. + * This set can be filtered with an optional expression that will cause + * only elements matching the selector to be collected. * * @example $("div").children() * @beforeHello
And Again