+ * Removes all matched elements from the DOM. This does NOT remove them from the
+ * jQuery object, allowing you to use the matched elements further.
+ *
+ * @example $("p").remove();
+ * @before <p>Hello</p> how are <p>you?</p>
+ * @result how are
+ *
+ * @name remove
+ * @type jQuery
+ * @cat DOM/Manipulation
+ */
+
+ /**
+ * Removes only elements (out of the list of matched elements) that match
+ * the specified jQuery expression. This does NOT remove them from the
+ * jQuery object, allowing you to use the matched elements further.
+ *
+ * @example $("p").remove(".hello");
+ * @before <p class="hello">Hello</p> how are <p>you?</p>
+ * @result how are <p>you?</p>
+ *
+ * @name remove
+ * @type jQuery
+ * @param String expr A jQuery expression to filter elements by.
+ * @cat DOM/Manipulation