Document array-accepting manipulation methods

jugglinmike · scottgonzalez · commit eb43c5fcfd0b · 2013-09-03T16:31:19.000-04:00
Unit tests which assert this behavior: - append: https://github.com/jquery/jquery/blob/410cf4ee6bd454fa7e2bb5dc37a0b051f15d3e96/test/unit/manipulation.js#L291 - appendTo: https://github.com/jquery/jquery/blob/410cf4ee6bd454fa7e2bb5dc37a0b051f15d3e96/test/unit/manipulation.js#L506 - prepend: https://github.com/jquery/jquery/blob/410cf4ee6bd454fa7e2bb5dc37a0b051f15d3e96/test/unit/manipulation.js#L607 - prependTo: https://github.com/jquery/jquery/blob/410cf4ee6bd454fa7e2bb5dc37a0b051f15d3e96/test/unit/manipulation.js#L671 - before: https://github.com/jquery/jquery/blob/410cf4ee6bd454fa7e2bb5dc37a0b051f15d3e96/test/unit/manipulation.js#L739 - after: https://github.com/jquery/jquery/blob/410cf4ee6bd454fa7e2bb5dc37a0b051f15d3e96/test/unit/manipulation.js#L291 - insertBefore: https://github.com/jquery/jquery/blob/410cf4ee6bd454fa7e2bb5dc37a0b051f15d3e96/test/unit/manipulation.js#L784 - insertAfter: https://github.com/jquery/jquery/blob/410cf4ee6bd454fa7e2bb5dc37a0b051f15d3e96/test/unit/manipulation.js#L853 - replaceWith: https://github.com/jquery/jquery/blob/410cf4ee6bd454fa7e2bb5dc37a0b051f15d3e96/test/unit/manipulation.js#L988 - replaceAll: https://github.com/jquery/jquery/blob/410cf4ee6bd454fa7e2bb5dc37a0b051f15d3e96/test/unit/manipulation.js#L1031
diff --git a/entries/after.xml b/entries/after.xml
@@ -4,9 +4,10 @@
   <signature>
     <added>1.0</added>
     <argument name="content">
-      <desc>HTML string, DOM element, or jQuery object to insert after each element in the set of matched elements.</desc>
+      <desc>HTML string, DOM element, array of elements, or jQuery object to insert after each element in the set of matched elements.</desc>
       <type name="htmlString"/>
       <type name="Element"/>
+      <type name="Array"/>
       <type name="jQuery"/>
     </argument>
     <argument name="content" optional="true">
diff --git a/entries/append.xml b/entries/append.xml
@@ -4,9 +4,10 @@
   <signature>
     <added>1.0</added>
     <argument name="content">
-      <desc>DOM element, HTML string, or jQuery object to insert at the end of each element in the set of matched elements.</desc>
+      <desc>DOM element, array of elements, HTML string, or jQuery object to insert at the end of each element in the set of matched elements.</desc>
       <type name="htmlString"/>
       <type name="Element"/>
+      <type name="Array"/>
       <type name="jQuery"/>
     </argument>
     <argument name="content" optional="true">
diff --git a/entries/appendTo.xml b/entries/appendTo.xml
@@ -4,10 +4,11 @@
   <signature>
     <added>1.0</added>
     <argument name="target">
-      <desc>A selector, element, HTML string, or jQuery object; the matched set of elements will be inserted at the end of the element(s) specified by this parameter.</desc>
+      <desc>A selector, element, HTML string, array of elements, or jQuery object; the matched set of elements will be inserted at the end of the element(s) specified by this parameter.</desc>
       <type name="Selector"/>
       <type name="htmlString"/>
       <type name="Element"/>
+      <type name="Array"/>
       <type name="jQuery"/>
     </argument>
   </signature>
diff --git a/entries/before.xml b/entries/before.xml
@@ -4,9 +4,10 @@
   <signature>
     <added>1.0</added>
     <argument name="content">
-      <desc>HTML string, DOM element, or jQuery object to insert before each element in the set of matched elements.</desc>
+      <desc>HTML string, DOM element, array of elements, or jQuery object to insert before each element in the set of matched elements.</desc>
       <type name="htmlString"/>
       <type name="Element"/>
+      <type name="Array"/>
       <type name="jQuery"/>
     </argument>
     <argument name="content" optional="true">
diff --git a/entries/insertAfter.xml b/entries/insertAfter.xml
@@ -4,10 +4,11 @@
   <signature>
     <added>1.0</added>
     <argument name="target">
-      <desc>A selector, element, HTML string, or jQuery object; the matched set of elements will be inserted after the element(s) specified by this parameter.</desc>
+      <desc>A selector, element, array of elements, HTML string, or jQuery object; the matched set of elements will be inserted after the element(s) specified by this parameter.</desc>
       <type name="Selector"/>
       <type name="htmlString"/>
       <type name="Element"/>
+      <type name="Array"/>
       <type name="jQuery"/>
     </argument>
   </signature>
diff --git a/entries/insertBefore.xml b/entries/insertBefore.xml
@@ -4,10 +4,11 @@
   <signature>
     <added>1.0</added>
     <argument name="target">
-      <desc>A selector, element, HTML string, or jQuery object; the matched set of elements will be inserted before the element(s) specified by this parameter.</desc>
+      <desc>A selector, element, array of elements, HTML string, or jQuery object; the matched set of elements will be inserted before the element(s) specified by this parameter.</desc>
       <type name="Selector"/>
       <type name="htmlString"/>
       <type name="Element"/>
+      <type name="Array"/>
       <type name="jQuery"/>
     </argument>
   </signature>
diff --git a/entries/prepend.xml b/entries/prepend.xml
@@ -7,11 +7,13 @@
       <desc>DOM element, array of elements, HTML string, or jQuery object to insert at the beginning of each element in the set of matched elements.</desc>
       <type name="htmlString"/>
       <type name="Element"/>
+      <type name="Array"/>
       <type name="jQuery"/>
     </argument>
     <argument name="content" optional="true">
       <type name="htmlString"/>
       <type name="Element"/>
+      <type name="Array"/>
       <type name="jQuery"/>
       <desc>One or more additional DOM elements, arrays of elements, HTML strings, or jQuery objects to insert at the beginning of each element in the set of matched elements.</desc>
     </argument>
diff --git a/entries/prependTo.xml b/entries/prependTo.xml
@@ -7,8 +7,9 @@
       <type name="Selector"/>
       <type name="htmlString"/>
       <type name="Element"/>
+      <type name="Array"/>
       <type name="jQuery"/>
-      <desc>A selector, element, HTML string, or jQuery object; the matched set of elements will be inserted at the beginning of the element(s) specified by this parameter.</desc>
+      <desc>A selector, element, HTML string, array of elements, or jQuery object; the matched set of elements will be inserted at the beginning of the element(s) specified by this parameter.</desc>
     </argument>
   </signature>
   <desc>Insert every element in the set of matched elements to the beginning of the target.</desc>
diff --git a/entries/replaceAll.xml b/entries/replaceAll.xml
@@ -4,9 +4,10 @@
   <signature>
     <added>1.2</added>
     <argument name="target">
-      <desc>A selector string, jQuery object, or DOM element reference indicating which element(s) to replace.</desc>
+      <desc>A selector string, jQuery object, DOM element, or array of elements indicating which element(s) to replace.</desc>
 	  <type name="Selector"/>
       <type name="jQuery"/>
+      <type name="Array"/>
       <type name="Element"/>
     </argument>
   </signature>
diff --git a/entries/replaceWith.xml b/entries/replaceWith.xml
@@ -4,9 +4,10 @@
   <signature>
     <added>1.2</added>
     <argument name="newContent">
-      <desc>The content to insert. May be an HTML string, DOM element, or jQuery object.</desc>
+      <desc>The content to insert. May be an HTML string, DOM element, array of DOM elements, or jQuery object.</desc>
       <type name="htmlString"/>
       <type name="Element"/>
+      <type name="Array"/>
       <type name="jQuery"/>
     </argument>
   </signature>
