.get(): Split into 2 signatures and update content.

Author: kswedberg

entries/get.xml

@@ -5,51 +5,55 @@
   <title>.get()</title>
   <signature>
     <added>1.0</added>
-    <argument name="index" type="Number" optional="true">
+    <argument name="index" type="Integer">
       <desc>A zero-based integer indicating which element to retrieve.</desc>
     </argument>
   </signature>
+  <signature>
+    <added>1.0</added>
+  </signature>
   <desc>Retrieve the DOM elements matched by the jQuery object.</desc>
   <longdesc>
-    <p>The <code>.get()</code> method grants us access to the DOM nodes underlying each jQuery object. Suppose we had a simple unordered list on the page:</p>
+    <p>The <code>.get()</code> method grants us access to the DOM nodes underlying each jQuery object. Consider a simple unordered list:</p>
     <pre><code>
 &lt;ul&gt;
   &lt;li id="foo"&gt;foo&lt;/li&gt;
   &lt;li id="bar"&gt;bar&lt;/li&gt;
 &lt;/ul&gt;
     </code></pre>
-    <p>Without a parameter, <code>.get()</code> returns all of the elements:</p>
-    <pre><code>alert($('li').get());</code></pre>
-    <p>All of the matched DOM nodes are returned by this call, contained in a standard array:</p>
-    <p>
-      <span class="result">[&lt;li id="foo"&gt;, &lt;li id="bar"&gt;]</span>
-    </p>
-    <p>With an index specified, .get() will retrieve a single element:</p>
-    <pre><code>($('li').get(0));</code></pre>
+    <p>With an index specified, <code>.get(index)</code> retrieves a single element:</p>
+    <pre><code>console.log( $( "li" ).get( 0 ) );</code></pre>
     <p>Since the index is zero-based, the first list item is returned:</p>
     <p>
       <samp>&lt;li id="foo"&gt;</samp>
     </p>
+    <p>Without a parameter, <code>.get()</code> returns an array of all of the elements:</p>
+    <pre><code>console.log( $( "li" ).get() );</code></pre>
+    <p>All of the matched DOM nodes are returned by this call, contained in a standard array:</p>
+    <p>
+      <span class="result">[&lt;li id="foo"&gt;, &lt;li id="bar"&gt;]</span>
+    </p>
+
     <p>Each jQuery object also masquerades as an array, so we can use the array dereferencing operator to get at the list item instead:</p>
-    <pre><code>alert($('li')[0]);</code></pre>
+    <pre><code>console.log( $( "li" )[0] );</code></pre>
     <p>However, this syntax lacks some of the additional capabilities of .get(), such as specifying a negative index:</p>
-    <pre><code>alert($('li').get(-1));</code></pre>
-    <p>A negative index is counted from the end of the matched set, so this example will return the last item in the list:</p>
+    <pre><code>console.log( $( "li" ).get(-1) );</code></pre>
+    <p>A negative index is counted from the end of the matched set, so this example returns the last item in the list:</p>
     <p>
       <samp>&lt;li id="bar"&gt;</samp>
     </p>
   </longdesc>
   <example>
-    <desc>Selects all divs in the document and returns the DOM Elements as an Array, then uses the built-in reverse-method to reverse that array.</desc>
+    <desc>Select all divs in the document and return the DOM Elements as an Array; then use the built-in reverse() method to reverse that array.</desc>
     <code><![CDATA[
 function disp(divs) {
   var a = [];
-  for (var i = 0; i < divs.length; i++) {
-    a.push(divs[i].innerHTML);
+  for ( var i = 0; i < divs.length; i++) {
+    a.push( divs[i].innerHTML );
   }
-  $("span").text(a.join(" "));
+  $( "span" ).text( a.join(" ") );
 }
-disp( $("div").get().reverse() );
+disp( $( "div" ).get().reverse() );
 ]]></code>
     <css><![CDATA[
   span { color:red; }
@@ -61,12 +65,12 @@ disp( $("div").get().reverse() );
   <div>Three</div>]]></html>
   </example>
   <example>
-    <desc>Gives the tag name of the element clicked on.</desc>
+    <desc>Display the tag name of the click element.</desc>
     <code><![CDATA[
-$("*", document.body).click(function (e) {
+$( "*", document.body).click(function( e ) {
   e.stopPropagation();
-  var domEl = $(this).get(0);
-  $("span:first").text("Clicked on - " + domEl.tagName);
+  var domEl = $( this ).get( 0 );
+  $( "span:first" ).text( "Clicked on - " + domEl.nodeName );
 });
 ]]></code>
     <css><![CDATA[