Added test and documentation for filter(Function)

diff --git a/src/jquery/coreTest.js b/src/jquery/coreTest.js
index 287d709858f0f2f69c47d0be57466bccd6078145..2692715fade51ea01be2629c9bf1a50429522f8a 100644 (file)
--- a/src/jquery/coreTest.js
+++ b/src/jquery/coreTest.js
@@ -261,6 +261,7 @@ test("clone()", function() {
 test("filter()", function() {\r
        isSet( $("input").filter(":checked").get(), q("radio2", "check1"), "filter(String)" );\r
        isSet( $("p").filter(["#ap", "#sndp"]).get(), q("ap", "sndp"), "filter(Array<String>)" );\r
+       isSet( $("p").filter(function(el) { return !$("a", el).length }).get(), q("sndp", "first"), "filter(Function)" );\r
 });\r
 \r
 test("not(String)", function() {\r

diff --git a/src/jquery/jquery.js b/src/jquery/jquery.js
index 8b28fdbccfcf06a57090e95688600a21edcbfae5..14d2e0a3c149cac1891867522c669a13aa7da6db 100644 (file)
--- a/src/jquery/jquery.js
+++ b/src/jquery/jquery.js
@@ -852,13 +852,34 @@ jQuery.fn = jQuery.prototype = {
         *
         * @example $("p").filter(".selected")
         * @before <p class="selected">Hello</p><p>How are you?</p>
-        * @result $("p").filter(".selected") == [ <p class="selected">Hello</p> ]
+        * @result [ <p class="selected">Hello</p> ]
         *
         * @name filter
         * @type jQuery
         * @param String expr An expression to search with.
         * @cat DOM/Traversing
         */
+        
+       /**
+        * Removes all elements from the set of matched elements that do not
+        * pass the specified filter. This method is used to narrow down
+        * the results of a search.
+        *
+        * The elements to filter are passed as the first argument, their
+        * index inside the set as the second.
+        *
+        * @example $("p").filter(function(element, index) {
+        *   return $("ol", element).length == 0;
+        * })
+        * @before <p><ol><li>Hello</li></ol></p><p>How are you?</p>
+        * @result [ <p>How are you?</p> ]
+        * @desc Remove all elements that have a child ol element
+        *
+        * @name filter
+        * @type jQuery
+        * @param Function filter A function to use for filtering
+        * @cat DOM/Traversing
+        */
 
        /**
         * Removes all elements from the set of matched elements that do not
@@ -871,7 +892,7 @@ jQuery.fn = jQuery.prototype = {
         *
         * @example $("p").filter([".selected", ":first"])
         * @before <p>Hello</p><p>Hello Again</p><p class="selected">And Again</p>
-        * @result $("p").filter([".selected", ":first"]) == [ <p>Hello</p>, <p class="selected">And Again</p> ]
+        * @result [ <p>Hello</p>, <p class="selected">And Again</p> ]
         *
         * @name filter
         * @type jQuery