All: Mark positional selectors as deprecated since jQuery 3.4.0

Positional selectors: :first, :last, :eq, :even, :odd, :lt, :gt, and :nth are
deprecated since jQuery 3.4.0. This is now reflected in the docs & deprecated
pseudo-classes are not used in examples on other API pages.

Fixes gh-1144

Author: mgol

categories.xml

@@ -71,14 +71,19 @@
         <p>For more information, see the Release Notes/Changelog at <a href="https://blog.jquery.com/2016/06/09/jquery-3-0-final-released/">https://blog.jquery.com/2016/06/09/jquery-3-0-final-released/</a></p>
       ]]></desc>
     </category>
-	<category name="Deprecated 3.3" slug="deprecated-3.3">
+    <category name="Deprecated 3.3" slug="deprecated-3.3">
       <desc><![CDATA[All the aspects of the API that were deprecated in the corresponding version of jQuery.
         <p>For more information, see the Release Notes/Changelog at <a href="https://blog.jquery.com/2018/01/19/jquery-3-3-0-a-fragrant-bouquet-of-deprecations-and-is-that-a-new-feature/">https://blog.jquery.com/2018/01/19/jquery-3-3-0-a-fragrant-bouquet-of-deprecations-and-is-that-a-new-feature/</a></p>
       ]]></desc>
     </category>
+    <category name="Deprecated 3.4" slug="deprecated-3.4">
+      <desc><![CDATA[All the aspects of the API that were deprecated in the corresponding version of jQuery.
+        <p>For more information, see the Release Notes/Changelog at <a href="https://blog.jquery.com/2019/04/10/jquery-3-4-0-released/">https://blog.jquery.com/2019/04/10/jquery-3-4-0-released/</a></p>
+      ]]></desc>
+    </category>
   </category>
   <category name="Dimensions" slug="dimensions">
-	  <desc><![CDATA[These methods are used to get and set the CSS dimensions for the various properties.]]></desc>
+    <desc><![CDATA[These methods are used to get and set the CSS dimensions for the various properties.]]></desc>
   </category>
   <category name="Effects" slug="effects">
     <desc><![CDATA[The jQuery library provides several techniques for adding animation to a web page. These include simple, standard animations that are frequently used, and the ability to craft sophisticated custom effects.]]></desc>

entries/addClass.xml

@@ -64,7 +64,7 @@ $( "p" ).last().addClass( "selected" );
   <example>
     <desc>Add the classes "selected" and "highlight" to the matched elements.</desc>
     <code><![CDATA[
-$( "p:last" ).addClass( "selected highlight" );
+$( "p" ).last().addClass( "selected highlight" );
 ]]></code>
     <css><![CDATA[
   p {

entries/animate.xml

@@ -249,12 +249,12 @@ $( "#go4" ).click(function() {
     <desc>Animates the first div's left property and synchronizes the remaining divs, using the step function to set their left properties at each stage of the animation. </desc>
     <code><![CDATA[
 $( "#go" ).click(function() {
-  $( ".block:first" ).animate({
+  $( ".block" ).first().animate({
     left: 100
   }, {
     duration: 1000,
     step: function( now, fx ){
-      $( ".block:gt(0)" ).css( "left", now );
+      $( ".block" ).slice( 1 ).css( "left", now );
     }
   });
 });

entries/children.xml

@@ -43,8 +43,8 @@ $( "#container" ).click(function ( event ) {
   var kids = $( event.target ).children();
   var len = kids.addClass( "hilite" ).length;
 
-  $( "#results span:first" ).text( len );
-  $( "#results span:last" ).text( event.target.tagName );
+  $( "#results span" ).first().text( len );
+  $( "#results span" ).last().text( event.target.tagName );
 
   event.preventDefault();
 });

entries/contextmenu.xml

@@ -58,7 +58,7 @@ $( "p" ).contextmenu(function() {
   <example>
     <desc>Right click to toggle background color.</desc>
     <code><![CDATA[
-var div = $( "div:first" );
+var div = $( "div" ).first();
 div.contextmenu(function() {
   div.toggleClass( "contextmenu" );
 });

entries/data.xml

@@ -40,8 +40,8 @@ $( "body" ).data(); // { foo: 52, bar: { isManual: true }, baz: [ 1, 2, 3 ] }
       <desc>Store then retrieve a value from the div element.</desc>
       <code><![CDATA[
 $( "div" ).data( "test", { first: 16, last: "pizza!" } );
-$( "span:first" ).text( $( "div" ).data( "test" ).first );
-$( "span:last" ).text( $( "div" ).data( "test" ).last );
+$( "span" ).first().text( $( "div" ).data( "test" ).first );
+$( "span" ).last().text( $( "div" ).data( "test" ).last );
 ]]></code>
       <css><![CDATA[
   div {

entries/dblclick.xml

@@ -77,7 +77,7 @@ $( "p" ).dblclick(function() {
   <example>
     <desc>Double click to toggle background color.</desc>
     <code><![CDATA[
-var divdbl = $( "div:first" );
+var divdbl = $( "div" ).first();
 divdbl.dblclick(function() {
   divdbl.toggleClass( "dbl" );
 });

entries/end.xml

@@ -51,7 +51,7 @@ jQuery.fn.showTags = function( n ) {
   })
   .get()
   .join( ", " );
-  $( "b:eq( " + n + " )" ).text( tags );
+  $( "b" ).eq( n ).text( tags );
   return this;
 };
 

entries/eq-selector.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0"?>
-<entry type="selector" name="eq" return="">
+<entry type="selector" name="eq" return="" deprecated="3.4">
   <title>:eq() Selector</title>
   <signature>
     <sample>:eq(index)</sample>
@@ -17,6 +17,7 @@
   </signature>
   <desc>Select the element at index <code>n</code> within the matched set.</desc>
   <longdesc>
+    <p><strong>As of jQuery 3.4</strong>, the <code>:eq</code> pseudo-class is deprecated. Remove it from your selectors and filter the results later using <a href="/eq/"><code>.eq()</code></a>.</p>
     <p>The index-related selectors (<code>:eq()</code>, <code>:lt()</code>, <code>:gt()</code>, <code>:even</code>, <code>:odd</code>) filter the set of elements that have matched the expressions that precede them. They narrow the set down based on the order of the elements within this matched set. For example, if elements are first selected with a class selector (<code>.myclass</code>) and four elements are returned, these elements are given indices <code>0</code> through <code>3</code> for the purposes of these selectors.</p>
     <p>Note that since JavaScript arrays use <em>0-based indexing</em>, these selectors reflect that fact. This is why <code>$( ".myclass:eq(1)" )</code> selects the second element in the document with the class myclass, rather than the first. In contrast, <code>:nth-child(n)</code> uses <em>1-based indexing</em> to conform to the CSS specification.</p>
     <p>Prior to jQuery 1.8, the <code>:eq(index)</code> selector did <em>not</em> accept a negative value for <code>index</code> (though the <a href="/eq/"><code>.eq(index)</code></a> method did).</p>
@@ -92,4 +93,5 @@ $( "li:eq(-2)" ).addClass( "foo" )
   <category slug="selectors/jquery-selector-extensions"/>
   <category slug="version/1.0"/>
   <category slug="version/1.8"/>
+  <category slug="deprecated/deprecated-3.4"/>
 </entry>

entries/even-selector.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0"?>
-<entry type="selector" name="even" return="">
+<entry type="selector" name="even" return="" deprecated="3.4">
   <title>:even Selector</title>
   <sample>:even</sample>
   <signature>
@@ -33,4 +33,5 @@ $( "tr:even" ).css( "background-color", "#bbf" );
   <category slug="selectors/basic-filter-selectors"/>
   <category slug="selectors/jquery-selector-extensions"/>
   <category slug="version/1.0"/>
+  <category slug="deprecated/deprecated-3.4"/>
 </entry>