From eae9d8bbbd85c44bb6409a99f3ee3397ad65bd7b Mon Sep 17 00:00:00 2001 From: Aurelio De Rosa Date: Wed, 22 Jan 2014 12:35:14 +0100 Subject: [PATCH 001/699] find: Improve wording Fixes gh-395 Closes gh-423 --- entries/find.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/entries/find.xml b/entries/find.xml index 8ce3d0fc..9db417af 100644 --- a/entries/find.xml +++ b/entries/find.xml @@ -49,7 +49,7 @@ $( "li.item-ii" ).find( "li" ).css( "background-color", "red" );

The result of this call is a red background on items A, B, 1, 2, 3, and C. Even though item II matches the selector expression, it is not included in the results; only descendants are considered candidates for the match.

-

Unlike in the rest of the tree traversal methods, the selector expression is required in a call to .find(). If we need to retrieve all of the descendant elements, we can pass in the universal selector '*' to accomplish this.

+

Unlike most of the tree traversal methods, the selector expression is required in a call to .find(). If we need to retrieve all of the descendant elements, we can pass in the universal selector '*' to accomplish this.

Selector context is implemented with the .find() method; therefore, $( "li.item-ii" ).find( "li" ) is equivalent to $( "li", "li.item-ii" ).

As of jQuery 1.6, we can also filter the selection with a given jQuery collection or element. With the same nested list as above, if we start with:

From c3ceeb43edbacb68ce7f1514bf17b6b0adebaba2 Mon Sep 17 00:00:00 2001 From: Karl Swedberg Date: Sun, 26 Jan 2014 17:53:19 -0500 Subject: [PATCH 002/699] Document escaping HTML, script injection. Fixes #23 --- entries/after.xml | 1 + entries/append.xml | 1 + entries/appendTo.xml | 1 + entries/before.xml | 1 + entries/html.xml | 1 + entries/insertAfter.xml | 1 + entries/insertBefore.xml | 1 + entries/prepend.xml | 1 + entries/prependTo.xml | 1 + notes.xsl | 3 +++ 10 files changed, 12 insertions(+) diff --git a/entries/after.xml b/entries/after.xml index 03324a88..8c0fe2c3 100644 --- a/entries/after.xml +++ b/entries/after.xml @@ -100,6 +100,7 @@ $( "p" ).first().after( $newdiv1, [ newdiv2, existingdiv1 ] );

Since .after() can accept any number of additional arguments, the same result can be achieved by passing in the three <div>s as three separate arguments, like so: $( "p" ).first().after( $newdiv1, newdiv2, existingdiv1 ). The type and number of arguments will largely depend on the elements that are collected in the code.

+ Inserts some HTML after all paragraphs.

Since .append() can accept any number of additional arguments, the same result can be achieved by passing in the three <div>s as three separate arguments, like so: $('body').append( $newdiv1, newdiv2, existingdiv1 ). The type and number of arguments will largely depend on how you collect the elements in your code.

+ Appends some HTML to all paragraphs. If there is more than one target element, however, cloned copies of the inserted element will be created for each target after the first, and that new set (the original element plus clones) is returned.

Before jQuery 1.9, the append-to-single-element case did not create a new set, but instead returned the original set which made it difficult to use the .end() method reliably when being used with an unknown number of elements.

+ Append all spans to the element with the ID "foo" (Check append() documentation for more examples)

Since .before() can accept any number of additional arguments, the same result can be achieved by passing in the three <div>s as three separate arguments, like so: $( "p" ).first().before( $newdiv1, newdiv2, existingdiv1 ). The type and number of arguments will largely depend on how you collect the elements in your code.

+ Inserts some HTML before all paragraphs.

This method uses the browser's innerHTML property. Some browsers may not return HTML that exactly replicates the HTML source in an original document. For example, Internet Explorer sometimes leaves off the quotes around attribute values if they contain only alphanumeric characters.

+ Click a paragraph to convert it from html to text. If there is more than one target element, however, cloned copies of the inserted element will be created for each target after the first, and that new set (the original element plus clones) is returned.

Before jQuery 1.9, the append-to-single-element case did not create a new set, but instead returned the original set which made it difficult to use the .end() method reliably when being used with an unknown number of elements.

+ Insert all paragraphs after an element with id of "foo". Same as $( "#foo" ).after( "p" ) If there is more than one target element, however, cloned copies of the inserted element will be created for each target after the first, and that new set (the original element plus clones) is returned.

Before jQuery 1.9, the append-to-single-element case did not create a new set, but instead returned the original set which made it difficult to use the .end() method reliably when being used with an unknown number of elements.

+ Insert all paragraphs before an element with id of "foo". Same as $( "#foo" ).before( "p" )

Since .prepend() can accept any number of additional arguments, the same result can be achieved by passing in the three <div>s as three separate arguments, like so: $( "body" ).prepend( $newdiv1, newdiv2, existingdiv1 ). The type and number of arguments will largely depend on how you collect the elements in your code.

+ Prepends some HTML to all paragraphs.

If there is more than one target element, however, cloned copies of the inserted element will be created for each target after the first.

+ Prepend all spans to the element with the ID "foo" (Check .prepend() documentation for more examples) If is called on an unordered list (<ul>) and its <li> elements have position (relative, absolute, or fixed), the effect may not work properly in IE6 through at least IE9 unless the <ul> has "layout." To remedy the problem, add the position: relative; and zoom: 1; CSS declarations to the ul. + + By design, any jQuery constructor or method that accepts an HTML string — jQuery(), .append(), .after(), etc. — can potentially execute code. This can occur by injection of script tags or use of HTML attributes that execute code (for example, <img onload="">). Do not use these methods to insert strings obtained from untrusted sources such as URL query parameters, cookies, or form inputs. Doing so can introduce cross-site-scripting (XSS) vulnerabilities. Remove or escape any user input before adding content to the document. + From f82164f3b3d8eaca43dad36bd85afadba832423d Mon Sep 17 00:00:00 2001 From: Dave Methvin Date: Sun, 26 Jan 2014 20:21:56 -0500 Subject: [PATCH 003/699] Fix broken link to jQuery type in .add(), closes gh-320 --- entries/add.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/entries/add.xml b/entries/add.xml index ba7bd723..cf110550 100644 --- a/entries/add.xml +++ b/entries/add.xml @@ -21,7 +21,7 @@ 1.3.2 - + An existing jQuery object to add to the set of matched elements. From 3fe6131a8747de97a749257fc752f32c9b2f723e Mon Sep 17 00:00:00 2001 From: Dave Methvin Date: Sun, 26 Jan 2014 20:42:01 -0500 Subject: [PATCH 004/699] Extend: Do not extend cyclical data structures, closes gh-332 --- entries/jQuery.extend.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/entries/jQuery.extend.xml b/entries/jQuery.extend.xml index 594a1b75..958e9d14 100644 --- a/entries/jQuery.extend.xml +++ b/entries/jQuery.extend.xml @@ -37,8 +37,8 @@

The merge performed by $.extend() is not recursive by default; if a property of the first object is itself an object or array, it will be completely overwritten by a property with the same key in the second or subsequent object. The values are not merged. This can be seen in the example below by examining the value of banana. However, by passing true for the first function argument, objects will be recursively merged.

Warning: Passing false for the first argument is not supported.

Undefined properties are not copied. However, properties inherited from the object's prototype will be copied over. Properties that are an object constructed via new MyCustomObject(args), or built-in JavaScript types such as Date or RegExp, are not re-constructed and will appear as plain Objects in the resulting object or array.

-

On a deep extend, Object and Array are extended, but object wrappers on primitive types such as String, Boolean, and Number are not.

-

For needs that fall outside of this behavior, write a custom extend method instead.

+

On a deep extend, Object and Array are extended, but object wrappers on primitive types such as String, Boolean, and Number are not. Deep-extending a cyclical data structure will result in an error.

+

For needs that fall outside of this behavior, write a custom extend method instead, or use a library like lodash.

Merge two objects, modifying the first. From 4cf1841161e07369ac7d273da669ab00d594b327 Mon Sep 17 00:00:00 2001 From: Dave Methvin Date: Sun, 26 Jan 2014 20:56:21 -0500 Subject: [PATCH 005/699] Types: Clarify behavior of jQuery-object-returning methods, ref gh-338 --- pages/Types.html | 2 ++ 1 file changed, 2 insertions(+) diff --git a/pages/Types.html b/pages/Types.html index 3ab239c0..e8a53c47 100644 --- a/pages/Types.html +++ b/pages/Types.html @@ -585,6 +585,8 @@

jQuery

Most frequently, you will use the jQuery() function to create a jQuery object. jQuery() can also be accessed by its familiar single-character alias of $(), unless you have called jQuery.noConflict() to disable this option. Many jQuery methods return the jQuery object itself, so that method calls can be chained:

+

In API calls that return jQuery, the value returned will be the original jQuery object unless otherwise documented by that API. API methods such as .filter() or .not() modify their incoming set and thus return a new jQuery object. +

$( "p" ).css( "color", "red" ).find( ".special" ).css( "color", "green" );

Whenever you use a "destructive" jQuery method that potentially changes the set of elements in the jQuery object, such as .filter() or .find(), that method actually returns a new jQuery object with the resulting elements. To return to the previous jQuery object, you use the .end() method. From b03d09a676acda8234164048a79c378272e4d31b Mon Sep 17 00:00:00 2001 From: Dave Methvin Date: Sun, 26 Jan 2014 21:11:06 -0500 Subject: [PATCH 006/699] CSS: Clarify computed style, closes gh-322 --- entries/css.xml | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/entries/css.xml b/entries/css.xml index ec95b3cc..6a5391cc 100644 --- a/entries/css.xml +++ b/entries/css.xml @@ -15,10 +15,11 @@ An array of one or more CSS properties. - Get the value of style properties for the first element in the set of matched elements. + Get the computed style properties for the first element in the set of matched elements.

The .css() method is a convenient way to get a style property from the first matched element, especially in light of the different ways browsers access most of those properties (the getComputedStyle() method in standards-based browsers versus the currentStyle and runtimeStyle properties in Internet Explorer) and the different terms browsers use for certain properties. For example, Internet Explorer's DOM implementation refers to the float property as styleFloat, while W3C standards-compliant browsers refer to it as cssFloat. For consistency, you can simply use "float", and jQuery will translate it to the correct value for each browser.

-

Also, jQuery can equally interpret the CSS and DOM formatting of multiple-word properties. For example, jQuery understands and returns the correct value for both .css( "background-color" ) and .css( "backgroundColor" ). Different browsers may return CSS color values that are logically but not textually equal, e.g., #FFF, #ffffff, and rgb(255,255,255).

+

Also, jQuery can equally interpret the CSS and DOM formatting of multiple-word properties. For example, jQuery understands and returns the correct value for both .css( "background-color" ) and .css( "backgroundColor" ).

+

Note that the computed style of an element may not be the same as the value specified for that element in a style sheet. For example, computed styles of dimensions are almost always pixels, but they can be specified as em, ex, px or % in a style sheet. Different browsers may return CSS color values that are logically but not textually equal, e.g., #FFF, #ffffff, and rgb(255,255,255).

Retrieval of shorthand CSS properties (e.g., margin, background, border), although functional with some browsers, is not guaranteed. For example, if you want to retrieve the rendered border-width, use: $( elem ).css( "borderTopWidth" ), $( elem ).css( "borderBottomWidth" ), and so on.

As of jQuery 1.9, passing an array of style properties to .css() will result in an object of property-value pairs. For example, to retrieve all four rendered border-width values, you could use $( elem ).css([ "borderTopWidth", "borderRightWidth", "borderBottomWidth", "borderLeftWidth" ]).

From e482af6a58b0f41125a995150e5e6d1bcc2075a3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Timoth=C3=A9e=20Boucher?= Date: Sun, 26 Jan 2014 21:37:28 -0500 Subject: [PATCH 007/699] append() clones for all elements but the last one, not first. Closes #344 --- entries/append.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/entries/append.xml b/entries/append.xml index 7804eee1..d8b4ebb9 100644 --- a/entries/append.xml +++ b/entries/append.xml @@ -66,7 +66,7 @@ $( ".container" ).append( $( "h2" ) ); <h2>Greetings</h2> </div> -

If there is more than one target element, however, cloned copies of the inserted element will be created for each target after the first.

+

If there is more than one target element, however, cloned copies of the inserted element will be created for each target except for the last one.

Additional Arguments

Similar to other content-adding methods such as .prepend() and .before(), .append() also supports passing in multiple arguments as input. Supported input includes DOM elements, jQuery objects, HTML strings, and arrays of DOM elements.

For example, the following will insert two new <div>s and an existing <div> as the last three child nodes of the body:

From 2ee862f48b3c1597f0ccff71fe8641e99fd18cdb Mon Sep 17 00:00:00 2001 From: Aurelio De Rosa Date: Sun, 26 Jan 2014 22:42:06 -0500 Subject: [PATCH 008/699] Update bind() - preventBubble argument is optional. Closes #416 --- entries/bind.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/entries/bind.xml b/entries/bind.xml index 8daadb80..3b00923b 100644 --- a/entries/bind.xml +++ b/entries/bind.xml @@ -21,7 +21,7 @@ An object containing data that will be passed to the event handler. - + Setting the third argument to false will attach a function that prevents the default action from occurring and stops the event from bubbling. The default is true. From cbebba7e889f16eabb04960ebe50a94292a192af Mon Sep 17 00:00:00 2001 From: Aurelio De Rosa Date: Sun, 26 Jan 2014 22:46:09 -0500 Subject: [PATCH 009/699] Update is(). Argument can take more than one element. Closes #415 --- entries/is.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/entries/is.xml b/entries/is.xml index 86715968..20ebd45d 100644 --- a/entries/is.xml +++ b/entries/is.xml @@ -21,8 +21,8 @@ 1.6 - - An element to match the current set of elements against. + + One or more elements to match the current set of elements against. Check the current matched set of elements against a selector, element, or jQuery object and return true if at least one of these elements matches the given arguments. From e47e9746b09bd3b54f7ceb92a043bc4fcf5d6cea Mon Sep 17 00:00:00 2001 From: Karl Swedberg Date: Sun, 26 Jan 2014 22:47:18 -0500 Subject: [PATCH 010/699] 1.11.0 --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 3efc2069..4c711514 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "api.jquery.com", "title": "jQuery API Docs", "description": "API reference documentation for the jQuery JavaScript Library.", - "version": "1.10.13", + "version": "1.11.0", "homepage": "https://github.com/jquery/api.jquery.com", "author": { "name": "jQuery Foundation (https://jquery.org/)" From 834e5503807fdbb58ff651e7da5b7ddeb2aef060 Mon Sep 17 00:00:00 2001 From: davidfregoli Date: Wed, 29 Jan 2014 07:58:32 -0500 Subject: [PATCH 011/699] Update SOP note in notes.xsl. Closes #398 --- notes.xsl | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/notes.xsl b/notes.xsl index 5925cd3f..c14473ee 100644 --- a/notes.xsl +++ b/notes.xsl @@ -26,7 +26,7 @@ Since the .live() method handles events once they have propagated to the top of the document, it is not possible to stop propagation of live events. Similarly, events handled by .delegate() will propagate to the elements to which they are delegated; event handlers bound on any elements below it in the DOM tree will already have been executed by the time the delegated event handler is called. These handlers, therefore, may prevent the delegated handler from triggering by calling event.stopPropagation() or returning false. - Due to browser security restrictions, most "Ajax" requests are subject to the same origin policy; the request can not successfully retrieve data from a different domain, subdomain, or protocol. + Due to browser security restrictions, most "Ajax" requests are subject to the same origin policy; the request can not successfully retrieve data from a different domain, subdomain, port, or protocol. Script and JSONP requests are not subject to the same origin policy restrictions. From dc83917209b4a637dcadb2c70692a3ea0490ea97 Mon Sep 17 00:00:00 2001 From: Karl Swedberg Date: Sat, 8 Feb 2014 14:07:42 -0500 Subject: [PATCH 012/699] .get() and .toArray(): Remove "DOM" from description. Fixes gh-443. --- entries/get.xml | 4 ++-- entries/toArray.xml | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/entries/get.xml b/entries/get.xml index d9e7428f..59457611 100644 --- a/entries/get.xml +++ b/entries/get.xml @@ -9,7 +9,7 @@ A zero-based integer indicating which element to retrieve. - Retrieve one of the DOM elements matched by the jQuery object. + Retrieve one of the elements matched by the jQuery object.

The .get() method grants us access to the DOM nodes underlying each jQuery object. Consider a simple unordered list:


@@ -71,7 +71,7 @@ $( "*", document.body ).click(function( event ) {
     
       1.0
     
-    Retrieve the DOM elements matched by the jQuery object.
+    Retrieve the elements matched by the jQuery object.
     
       
Consider a simple unordered list:

       

diff --git a/entries/toArray.xml b/entries/toArray.xml
index 73991abe..dc57da06 100644
--- a/entries/toArray.xml
+++ b/entries/toArray.xml
@@ -4,7 +4,7 @@
   
     1.4
   
-  Retrieve all the DOM elements contained in the jQuery set, as an array.
+  Retrieve all the elements contained in the jQuery set, as an array.
   
     
.toArray() returns all of the elements in the jQuery set:

     

@@ -16,7 +16,7 @@ alert( $( "li" ).toArray() );
     

   
   
-    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.
+    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.
     
Date: Sat, 8 Feb 2014 14:10:38 -0500
Subject: [PATCH 013/699] 1.11.1

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 4c711514..9f282076 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.0",
+  "version": "1.11.1",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From a7a562ca732e75062fbdc86526bd9f2b30f327b0 Mon Sep 17 00:00:00 2001
From: Dave Methvin 
Date: Sat, 8 Feb 2014 14:16:53 -0500
Subject: [PATCH 014/699] parseHTML: Add security warning, closes gh-59

---
 entries/jQuery.parseHTML.xml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/entries/jQuery.parseHTML.xml b/entries/jQuery.parseHTML.xml
index a6e3bab6..b0d245e6 100644
--- a/entries/jQuery.parseHTML.xml
+++ b/entries/jQuery.parseHTML.xml
@@ -17,6 +17,8 @@
   
     
jQuery.parseHTML uses a native DOM element creation function to convert the string to a set of DOM elements, which can then be inserted into the document.

     
By default, the context is the current document if not specified or given as null or undefined. If the HTML was to be used in another document such as an iframe, that frame's document could be used.

+	
Security Considerations

+	
Most jQuery APIs that accept HTML strings will run scripts that are included in the HTML. jQuery.parseHTML does not run script in the parsed HTML unless keepScripts is explicitly true. However, it is still possible in most environments to execute script indirectly, for example via the <img onerror> attribute. The caller should be aware of this and guard against it by cleaning or escaping any untrusted inputs from sources such as the URL or cookies. For future compatibility, callers should not depend on the ability to run any script content when keepScripts is unspecified or false.

   
   
     Create an array of Dom nodes using an HTML string and insert it into a div.

From 0e31d5adf9e5b5cd95b91c68cd73e9f766588d27 Mon Sep 17 00:00:00 2001
From: Dave Methvin 
Date: Sat, 8 Feb 2014 14:46:32 -0500
Subject: [PATCH 015/699] Dimensions: values are non-integer and unreliable
 zoomed. Fixes gh-76, gh-103

---
 entries/height.xml      | 3 ++-
 entries/innerHeight.xml | 3 ++-
 entries/innerWidth.xml  | 3 ++-
 entries/offset.xml      | 5 +++--
 entries/outerHeight.xml | 5 +++--
 entries/outerWidth.xml  | 3 ++-
 entries/position.xml    | 3 ++-
 entries/width.xml       | 3 ++-
 notes.xsl               | 3 +++
 9 files changed, 21 insertions(+), 10 deletions(-)

diff --git a/entries/height.xml b/entries/height.xml
index 3632ed02..dd809c0f 100644
--- a/entries/height.xml
+++ b/entries/height.xml
@@ -1,7 +1,7 @@
 
 
   Get the current computed height for the first element in the set of matched elements or set the height of every matched element.
-  
+  
     .height()
     
       1.0
@@ -22,6 +22,7 @@ $( document ).height(); // returns height of HTML document
         
Note: Although style and script tags will report a value for .width() or height() when absolutely positioned and given display:block, it is strongly discouraged to call those methods on these tags. In addition to being a bad practice, the results may also prove unreliable.

       
     
+	
     
       Show various heights.  Note the values are from the iframe so might be smaller than you expected.  The yellow highlight shows the iframe body.
       
-
+
   .innerHeight()
   
     1.2.6
@@ -12,6 +12,7 @@
       
     

   
+	
   
     Get the innerHeight of a paragraph.
     
-
+
   .innerWidth()
   
     1.2.6
@@ -12,6 +12,7 @@
       
     

   
+	
   
     Get the innerWidth of a paragraph.
     While it is possible to get the coordinates of elements with visibility:hidden set, display:none is excluded from the rendering tree and thus has a position that is undefined.

       
     
-    
+	
+     
       Access the offset of the second paragraph:
       
       1.4
       
-        An object containing the properties top and left, which are integers indicating the new top and left coordinates for the elements.
+        An object containing the properties top and left, which are numbers indicating the new top and left coordinates for the elements.
       
     
     
diff --git a/entries/outerHeight.xml b/entries/outerHeight.xml
index 67816672..529b0be7 100644
--- a/entries/outerHeight.xml
+++ b/entries/outerHeight.xml
@@ -1,5 +1,5 @@
 
-
+
   .outerHeight()
   
     1.2.6
@@ -7,7 +7,7 @@
       A Boolean indicating whether to include the element's margin in the calculation.
     
   
-  Get the current computed height for the first element in the set of matched elements, including padding, border, and optionally margin. Returns an integer (without "px") representation of the value or null if called on an empty set of elements.
+  Get the current computed height for the first element in the set of matched elements, including padding, border, and optionally margin. Returns a number (without "px") representation of the value or null if called on an empty set of elements.
   
     
The top and bottom padding and border are always included in the .outerHeight() calculation; if the includeMargin argument is set to true, the margin (top and bottom) is also included.

     
This method is not applicable to window and document objects; for these, use .height() instead.

@@ -15,6 +15,7 @@
       
     

   
+	
   
     Get the outerHeight of a paragraph.
     
-
+
   .outerWidth()
   
     1.2.6
@@ -16,6 +16,7 @@
       
     

   
+	
   
     Get the outerWidth of a paragraph.
     Note: jQuery does not support getting the position coordinates of hidden elements or accounting for borders, margins, or padding set on the body element.

     
   
-  
+	
+   
     Access the position of the second paragraph:
     
 
   Get the current computed width for the first element in the set of matched elements or set the width of every matched element.
-  
+  
     .width()
     
       1.0
@@ -22,6 +22,7 @@ $( document ).width();
       

       
Note that .width() will always return the content width, regardless of the value of the CSS box-sizing property. As of jQuery 1.8, this may require retrieving the CSS width plus box-sizing property and then subtracting any potential border and padding on each element when the element has box-sizing: border-box. To avoid this penalty, use .css( "width" ) rather than .width().

     
+	
     
       Show various widths.  Note the values are from the iframe so might be smaller than you expected.  The yellow highlight shows the iframe body.
       
 
 	
+		
+			The numbers returned by dimensions-related APIs, including , may be fractional in some cases. Code should not assume it is an integer. Also, dimensions may be incorrect when the page is zoomed by the user; browsers do not expose an API to detect this condition.
+		
 		
 			Selected elements are in the order of their appearance in the document.
 		

From 501491bd4139a1771a2c2dfd3653b72d596092cb Mon Sep 17 00:00:00 2001
From: Dave Methvin 
Date: Sat, 8 Feb 2014 14:57:35 -0500
Subject: [PATCH 016/699] Note new sane 1.9+ behavior for disconnected elems,
 ref gh-240

---
 entries/after.xml       |  1 +
 entries/before.xml      |  1 +
 entries/replaceWith.xml | 12 +-----------
 notes.xsl               |  2 ++
 4 files changed, 5 insertions(+), 11 deletions(-)

diff --git a/entries/after.xml b/entries/after.xml
index 8c0fe2c3..b55e3e96 100644
--- a/entries/after.xml
+++ b/entries/after.xml
@@ -100,6 +100,7 @@ $( "p" ).first().after( $newdiv1, [ newdiv2, existingdiv1 ] );
     

     
Since .after() can accept any number of additional arguments, the same result can be achieved by passing in the three <div>s as three separate arguments, like so: $( "p" ).first().after( $newdiv1, newdiv2, existingdiv1 ). The type and number of arguments will largely depend on the elements that are collected in the code.

   
+  
   
   
     Inserts some HTML after all paragraphs.
diff --git a/entries/before.xml b/entries/before.xml
index 13bfce2c..16738d29 100644
--- a/entries/before.xml
+++ b/entries/before.xml
@@ -80,6 +80,7 @@ $( "p" ).first().before( newdiv1, [ newdiv2, existingdiv1 ] );

Since .before() can accept any number of additional arguments, the same result can be achieved by passing in the three <div>s as three separate arguments, like so: $( "p" ).first().before( $newdiv1, newdiv2, existingdiv1 ). The type and number of arguments will largely depend on how you collect the elements in your code.

 + Inserts some HTML before all paragraphs. diff --git a/entries/replaceWith.xml b/entries/replaceWith.xml index 17e81829..0f01e47b 100644 --- a/entries/replaceWith.xml +++ b/entries/replaceWith.xml @@ -63,18 +63,8 @@ $( "div.third" ).replaceWith( $( ".first" ) );

This example demonstrates that the selected element replaces the target by being moved from its old location, not by being cloned.

The .replaceWith() method, like most jQuery methods, returns the jQuery object so that other methods can be chained onto it. However, it must be noted that the original jQuery object is returned. This object refers to the element that has been removed from the DOM, not the new element that has replaced it.

-

As of jQuery 1.4, .replaceWith() can also work on disconnected DOM nodes. For example, with the following code, .replaceWith() returns a jQuery set containing only a paragraph.:

- 

-$( "<div/>" ).replaceWith( "<p></p>" );
-
-

The .replaceWith() method can also take a function as its argument:

- 

-$( "div.container" ).replaceWith(function() {
-  return $( this ).contents();
-});
-
-

This results in <div class="container"> being replaced by its three child <div>s. The return value of the function may be an HTML string, DOM element, or jQuery object.

+ On click, replace the button with a div containing the same word. The numbers returned by dimensions-related APIs, including , may be fractional in some cases. Code should not assume it is an integer. Also, dimensions may be incorrect when the page is zoomed by the user; browsers do not expose an API to detect this condition. + + Prior to jQuery 1.9, would attempt to add or change nodes in the current jQuery set if the first node in the set was not connected to a document, and in those cases return a new jQuery set rather than the original set. The method might or might not return a new result depending on the number or connectedness of its arguments! As of jQuery 1.9, these methods always return the original unmodified set and attempting to use .after(), .before(), or .replaceWith() on a node without a parent has no effect--that is, neither the set or the nodes it contains are changed. Selected elements are in the order of their appearance in the document. From 276c9d69b792086aebbd2217377acd8db5e82d34 Mon Sep 17 00:00:00 2001 From: Karl Swedberg Date: Sat, 8 Feb 2014 15:03:10 -0500 Subject: [PATCH 017/699] Notes.xsl: Touch up note about manipulation of disconnected nodes --- notes.xsl | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/notes.xsl b/notes.xsl index 092fa484..6f1029d4 100644 --- a/notes.xsl +++ b/notes.xsl @@ -3,8 +3,9 @@ The numbers returned by dimensions-related APIs, including , may be fractional in some cases. Code should not assume it is an integer. Also, dimensions may be incorrect when the page is zoomed by the user; browsers do not expose an API to detect this condition. + - Prior to jQuery 1.9, would attempt to add or change nodes in the current jQuery set if the first node in the set was not connected to a document, and in those cases return a new jQuery set rather than the original set. The method might or might not return a new result depending on the number or connectedness of its arguments! As of jQuery 1.9, these methods always return the original unmodified set and attempting to use .after(), .before(), or .replaceWith() on a node without a parent has no effect--that is, neither the set or the nodes it contains are changed. + Prior to jQuery 1.9, would attempt to add or change nodes in the current jQuery set if the first node in the set was not connected to a document, and in those cases return a new jQuery set rather than the original set. The method might or might not have returned a new result depending on the number or connectedness of its arguments! As of jQuery 1.9, .after(), .before(), and .replaceWith() always return the original unmodified set. Attempting to use these methods on a node without a parent has no effect—that is, neither the set nor the nodes it contains are changed. Selected elements are in the order of their appearance in the document. From 258b3dcb5f22d091c76fc6dac114f4505f1e6be8 Mon Sep 17 00:00:00 2001 From: Karl Swedberg Date: Sat, 8 Feb 2014 15:03:53 -0500 Subject: [PATCH 018/699] 1.11.2 --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 9f282076..d57081d2 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "api.jquery.com", "title": "jQuery API Docs", "description": "API reference documentation for the jQuery JavaScript Library.", - "version": "1.11.1", + "version": "1.11.2", "homepage": "https://github.com/jquery/api.jquery.com", "author": { "name": "jQuery Foundation (https://jquery.org/)" From ece34cf78bcd213546c4bdd99ffd8c35601a1602 Mon Sep 17 00:00:00 2001 From: Dave Methvin Date: Tue, 11 Feb 2014 14:11:19 -0800 Subject: [PATCH 019/699] More emphasis about element order with .add() and jQuery() Fixes gh-240 Closes #435 --- entries/add.xml | 2 +- entries/jQuery.xml | 5 ++--- 2 files changed, 3 insertions(+), 4 deletions(-) diff --git a/entries/add.xml b/entries/add.xml index cf110550..e93025df 100644 --- a/entries/add.xml +++ b/entries/add.xml @@ -37,7 +37,7 @@ Add elements to the set of matched elements.

Given a jQuery object that represents a set of DOM elements, the .add() method constructs a new jQuery object from the union of those elements and the ones passed into the method. The argument to .add() can be pretty much anything that $() accepts, including a jQuery selector expression, references to DOM elements, or an HTML snippet.

-

Do not assume that this method appends the elements to the existing collection in the order they are passed to the .add() method. When all elements are members of the same document, the resulting collection from .add() will be sorted in document order; that is, in order of each element's appearance in the document. If the collection consists of elements from different documents or ones not in any document, the sort order is undefined. To create a jQuery object with elements in a well-defined order, use the $(array_of_DOM_elements) signature.

+

Do not assume that this method appends the elements to the existing collection in the order they are passed to the .add() method. When all elements are members of the same document, the resulting collection from .add() will be sorted in document order; that is, in order of each element's appearance in the document. If the collection consists of elements from different documents or ones not in any document, the sort order is undefined. To create a jQuery object with elements in a well-defined order and without sorting overhead, use the $(array_of_DOM_elements) signature.

The updated set of elements can be used in a following (chained) method, or assigned to a variable for later use. For example:


 $( "p" ).add( "div" ).addClass( "widget" );
diff --git a/entries/jQuery.xml b/entries/jQuery.xml
index 3cd7dedb..014a5fcf 100644
--- a/entries/jQuery.xml
+++ b/entries/jQuery.xml
@@ -57,9 +57,8 @@ $( "div.foo" ).click(function() {
       
Internally, selector context is implemented with the .find() method, so  $( "span", this ) is equivalent to  $( this ).find( "span" ).

 
       
Using DOM elements

-      
The second and third formulations of this function create a jQuery object using one or more DOM elements that were already selected in some other way.

-      
Note: These formulations are meant to consume only DOM elements; feeding mixed data to the elementArray form is particularly discouraged.

-      
A common use of this facility is to call jQuery methods on an element that has been passed to a callback function through the keyword this:

+      
The second and third formulations of this function create a jQuery object using one or more DOM elements that were already selected in some other way. When passing an array, each element must be a DOM element; mixed data is not supported. A jQuery object is created from the array elements in the order they appeared in the array; unlike most other multi-element jQuery operations, the elements are not sorted in DOM order.

+      
A common use of single-DOM-element construction is to call jQuery methods on an element that has been passed to a callback function through the keyword this:

       

 $( "div.foo" ).click(function() {
   $( this ).slideUp();

From 49699e71cc0387ba10e6eb651c90d1254ce2b969 Mon Sep 17 00:00:00 2001
From: Dave Methvin 
Date: Tue, 11 Feb 2014 14:21:05 -0800
Subject: [PATCH 020/699] Fix broken links to docs.jquery.com.

Fixes gh-169
Closes #432
---
 categories.xml               | 8 ++++----
 entries/hidden-selector.xml  | 2 +-
 entries/visible-selector.xml | 2 +-
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/categories.xml b/categories.xml
index 4255912c..8db3b46b 100644
--- a/categories.xml
+++ b/categories.xml
@@ -328,22 +328,22 @@ jQuery.event.props.push( "dataTransfer" );
     
     
       jQuery 1.2 Release Notes
+				jQuery 1.2 Release Notes
 			]]>
     
     
       1.2.1, 1.2.2, 1.2.3.
+				Release Notes: 1.2.1, 1.2.2, 1.2.3.
 			]]>
     
     
       jQuery 1.2.6 Release Notes.
+				jQuery 1.2.6 Release Notes.
 			]]>
     
     
       1.3, 1.3.1, 1.3.2
+				Release Notes: 1.3, 1.3.1, 1.3.2
 			]]>
     
     
diff --git a/entries/hidden-selector.xml b/entries/hidden-selector.xml
index 6df903bf..2daf20e6 100644
--- a/entries/hidden-selector.xml
+++ b/entries/hidden-selector.xml
@@ -17,7 +17,7 @@
     
Elements with visibility: hidden or opacity: 0 are considered to be visible, since they still consume space in the layout. During animations that hide an element, the element is considered to be visible until the end of the animation.

     
Elements that are not in a document are not considered to be visible; jQuery does not have a way to know if they will be visible when appended to a document since it depends on the applicable styles.

     
During animations to show an element, the element is considered to be visible at the start of the animation.

-    
How :hidden is determined was changed in jQuery 1.3.2. An element is assumed to be hidden if it or any of its parents consumes no space in the document. CSS visibility isn't taken into account (therefore $( elem ).css( "visibility", "hidden" ).is( ":hidden" ) == false). The release notes outline the changes in more detail.

+    
How :hidden is determined was changed in jQuery 1.3.2. An element is assumed to be hidden if it or any of its parents consumes no space in the document. CSS visibility isn't taken into account (therefore $( elem ).css( "visibility", "hidden" ).is( ":hidden" ) == false). The release notes outline the changes in more detail.

   
   
   
diff --git a/entries/visible-selector.xml b/entries/visible-selector.xml
index a6a6efa4..59fc4b42 100644
--- a/entries/visible-selector.xml
+++ b/entries/visible-selector.xml
@@ -11,7 +11,7 @@
     
Elements with visibility: hidden or opacity: 0 are considered visible, since they still consume space in the layout.

     
Elements that are not in a document are considered to be hidden; jQuery does not have a way to know if they will be visible when appended to a document since it depends on the applicable styles.

     
During animations that hide an element, the element is considered to be visible until the end of the animation. During animations to show an element, the element is considered to be visible at the start at the animation.

-    
How :visible is calculated was changed in jQuery 1.3.2. The release notes outline the changes in more detail.

+    
How :visible is calculated was changed in jQuery 1.3.2. The release notes outline the changes in more detail.

   
   
   

From 0051b225f73aae7b719afa2b8d2da2363a0c4082 Mon Sep 17 00:00:00 2001
From: Dave Methvin 
Date: Tue, 11 Feb 2014 14:32:56 -0800
Subject: [PATCH 021/699] inner/outer height/width setters

Fixes gh-98
Closes #431
---
 entries/innerWidth.xml | 65 ++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 63 insertions(+), 2 deletions(-)

diff --git a/entries/innerWidth.xml b/entries/innerWidth.xml
index dbfe77bc..c2e30f3d 100644
--- a/entries/innerWidth.xml
+++ b/entries/innerWidth.xml
@@ -1,10 +1,12 @@
 
-
+
+  Get the current computed inner width (including padding but not border) for the first element in the set of matched elements or set the inner width of every matched element.
+
   .innerWidth()
   
     1.2.6
   
-  Get the current computed width for the first element in the set of matched elements, including padding but not border.
+  Get the current computed inner width for the first element in the set of matched elements, including padding but not border.
   
     
This method returns the width of the element, including left and right padding, in pixels.

     
This method is not applicable to window and document objects; for these, use .width() instead.

@@ -36,3 +38,62 @@ $( "p:last" ).text( "innerWidth:" + p.innerWidth() );
   
   
 
+
+
+
+  1.8.0
+  
+	
+	
+	A number representing the number of pixels, or a number along with an optional unit of measure appended (as a string).
+  
+
+
+  1.8.0
+  
+	A function returning the inner width (including padding but not border) to set. Receives the index position of the element in the set and the old inner width as arguments. Within the function, this refers to the current element in the set.
+  
+
+Set the CSS inner width of each element in the set of matched elements.
+
+  
When calling .innerWidth("value"), the value can be either a string (number and unit) or a number. If only a number is provided for the value, jQuery assumes a pixel unit. If a string is provided, however, any valid CSS measurement may be used for the width (such as 100px, 50%, or auto). Note that in modern browsers, the CSS width property does not include padding, border, or margin, unless the box-sizing CSS property is used.

+  
If no explicit unit is specified (like "em" or "%") then "px" is assumed.

+
+
+  Change the inner width of each div the first time it is clicked (and change its color).
+  
+  
+  d
+
d

+
d

+
d

+
d

+]]>
+
+
+
+
+
+
+

From 04fa3f5a6c930b0596d4dea38c0727bfe315e55a Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Tue, 11 Feb 2014 14:38:41 -0800
Subject: [PATCH 022/699] event.which text update

---
 entries/event.which.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/event.which.xml b/entries/event.which.xml
index f2f74685..efa9cddf 100644
--- a/entries/event.which.xml
+++ b/entries/event.which.xml
@@ -29,7 +29,7 @@ $( "#whichkey" ).on( "mousedown", function( event ) {
 });
 ]]>
     
+
 

 ]]>
   

From 2b156c298a395d69baa33626edde2c8f09f274b9 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Sat, 15 Feb 2014 10:55:14 -0700
Subject: [PATCH 023/699] 1.11.3

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index d57081d2..d397cfd9 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.2",
+  "version": "1.11.3",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From 2152cf588bf756f115a70682ef0c07774f0e4243 Mon Sep 17 00:00:00 2001
From: Mike Pennisi 
Date: Sat, 15 Feb 2014 11:32:22 -0700
Subject: [PATCH 024/699] Insertion methods: Correct description of insertion
 cloning behavior.

Closes gh-438
---
 entries/after.xml   | 2 +-
 entries/append.xml  | 2 +-
 entries/before.xml  | 2 +-
 entries/prepend.xml | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/entries/after.xml b/entries/after.xml
index b55e3e96..2c8869c9 100644
--- a/entries/after.xml
+++ b/entries/after.xml
@@ -60,7 +60,7 @@ $( ".container" ).after( $( "h2" ) );
 </div>
 <h2>Greetings</h2>
     

-    
If there is more than one target element, however, cloned copies of the inserted element will be created for each target after the first.

+    
Important: If there is more than one target element, however, cloned copies of the inserted element will be created for each target except for the last one.

     
Inserting Disconnected DOM nodes

     
As of jQuery 1.4, .before() and .after() will also work on disconnected DOM nodes. For example, given the following code:

     
$( "<div></div>" ).after( "<p></p>" );

diff --git a/entries/append.xml b/entries/append.xml
index d8b4ebb9..5903fa05 100644
--- a/entries/append.xml
+++ b/entries/append.xml
@@ -66,7 +66,7 @@ $( ".container" ).append( $( "h2" ) );
   <h2>Greetings</h2>
 </div>
-

If there is more than one target element, however, cloned copies of the inserted element will be created for each target except for the last one.

+

Important: If there is more than one target element, however, cloned copies of the inserted element will be created for each target except for the last one.

Additional Arguments

Similar to other content-adding methods such as .prepend() and .before(), .append() also supports passing in multiple arguments as input. Supported input includes DOM elements, jQuery objects, HTML strings, and arrays of DOM elements.

For example, the following will insert two new <div>s and an existing <div> as the last three child nodes of the body:

diff --git a/entries/before.xml b/entries/before.xml index 16738d29..4aeae8d6 100644 --- a/entries/before.xml +++ b/entries/before.xml @@ -62,7 +62,7 @@ $( ".container" ).before( $( "h2" ) ); <div class="inner">Goodbye</div> </div> -

If there is more than one target element, however, cloned copies of the inserted element will be created for each target after the first.

+

Important: If there is more than one target element, however, cloned copies of the inserted element will be created for each target except for the last one.

In jQuery 1.4, .before() and .after() will also work on disconnected DOM nodes:


 $( "<div>" ).before( "<p></p>" );
diff --git a/entries/prepend.xml b/entries/prepend.xml
index df99494c..ca783d51 100644
--- a/entries/prepend.xml
+++ b/entries/prepend.xml
@@ -66,7 +66,7 @@ $( ".container" ).prepend( $( "h2" ) );
     <div class="inner">Goodbye</div>
 </div>
-

Important: If there is more than one target element, however, cloned copies of the inserted element will be created for each target after the first.

+

Important: If there is more than one target element, however, cloned copies of the inserted element will be created for each target except for the last one.

Additional Arguments

Similar to other content-adding methods such as .append() and .before(), .prepend() also supports passing in multiple arguments as input. Supported input includes DOM elements, jQuery objects, HTML strings, and arrays of DOM elements.

For example, the following will insert two new <div>s and an existing <div> as the first three child nodes of the body:

From 7c87b42f559fee080dd90f923a9f7655b57e2d66 Mon Sep 17 00:00:00 2001 From: michalstanko Date: Sat, 15 Feb 2014 16:06:59 -0700 Subject: [PATCH 025/699] jQuery.proxy(): Add missing word --- entries/jQuery.proxy.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/entries/jQuery.proxy.xml b/entries/jQuery.proxy.xml index 42a64dbd..e7c5f0ff 100644 --- a/entries/jQuery.proxy.xml +++ b/entries/jQuery.proxy.xml @@ -48,7 +48,7 @@

This method is most useful for attaching event handlers to an element where the context is pointing back to a different object. Additionally, jQuery makes sure that even if you bind the function returned from jQuery.proxy() it will still unbind the correct function if passed the original.

Be aware, however, that jQuery's event binding subsystem assigns a unique id to each event handling function in order to track it when it is used to specify the function to be unbound. The function represented by jQuery.proxy() is seen as a single function by the event subsystem, even when it is used to bind different contexts. To avoid unbinding the wrong handler, use a unique event namespace for binding and unbinding (e.g., "click.myproxy1") rather than specifying the proxied function during unbinding.

-

As of jQuery 1.6, any number of additional arguments may supplied to $.proxy(), and they will be passed to the function whose context will be changed.

+

As of jQuery 1.6, any number of additional arguments may be supplied to $.proxy(), and they will be passed to the function whose context will be changed.

As of jQuery 1.9, when the context is null or undefined the proxied function will be called with the same this object as the proxy was called with. This allows $.proxy() to be used to partially apply the arguments of a function without changing the context.

 From f96d8d861ba7fc08e83090439b10a7c8dfe287e3 Mon Sep 17 00:00:00 2001 From: TJ VanToll Date: Fri, 14 Feb 2014 09:09:31 -0800 Subject: [PATCH 026/699] Types: Add Date type Fixes jquery/api.jqueryui.com#194 Closes gh-445 --- pages/Types.html | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/pages/Types.html b/pages/Types.html index e8a53c47..f1987a32 100644 --- a/pages/Types.html +++ b/pages/Types.html @@ -73,6 +73,7 @@
  • PlainObject
    • +
  • Date
  • Function
    • Arguments
      • @@ -421,6 +422,18 @@

      PlainObject

      jQuery.isPlainObject( o ); // true +

      Date

      +

      The Date type is a JavaScript object that represents a single moment in time. Date objects are instantiated using their constructor function, which by default creates an object that represents the current date and time. +

      +
      
+new Date();
+
      +

      To create a Date object for an alternative date and time, pass numeric arguments in the following order: year, month, day, minute, second, millisecond - although note that the month is zero-based, whereas the other arguments are one-based. The following creates a Date object representing January 1st, 2014 at 8:15. +

      +
      
+new Date( 2014, 0, 1, 8, 15 );
+
      +

      Function

      A function in JavaScript can be either named or anonymous. Any function can be assigned to a variable or passed to a method, but passing member functions this way can cause them to be called in the context of another object (i.e. with a different "this" object).

      From 6a7601fff5c3fcd6dea92f6dd8d3c7cb5ce34feb Mon Sep 17 00:00:00 2001 From: Karl Swedberg Date: Mon, 17 Feb 2014 23:10:15 -0500 Subject: [PATCH 027/699] Types: Punctuation. No ticket. --- pages/Types.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/Types.html b/pages/Types.html index f1987a32..5a4f10d6 100644 --- a/pages/Types.html +++ b/pages/Types.html @@ -428,7 +428,7 @@

      Date 

      
 new Date();
      -

      To create a Date object for an alternative date and time, pass numeric arguments in the following order: year, month, day, minute, second, millisecond - although note that the month is zero-based, whereas the other arguments are one-based. The following creates a Date object representing January 1st, 2014 at 8:15. +

      To create a Date object for an alternative date and time, pass numeric arguments in the following order: year, month, day, minute, second, millisecond — although note that the month is zero-based, whereas the other arguments are one-based. The following creates a Date object representing January 1st, 2014, at 8:15. 

      
 new Date( 2014, 0, 1, 8, 15 );

From c6d5da3b86dd3b8c5aff197058b1490e931aadf2 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Mon, 17 Feb 2014 23:10:25 -0500
Subject: [PATCH 028/699] 1.11.4

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index d397cfd9..907a22e2 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.3",
+  "version": "1.11.4",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From 356fbe9b47ac80afb22d203dfcb62850c72ef5ec Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Wed, 26 Feb 2014 16:13:57 -0500
Subject: [PATCH 029/699] get.xml: Add note about returning undefined when
 number out of bounds

---
 entries/get.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/get.xml b/entries/get.xml
index 59457611..5698760d 100644
--- a/entries/get.xml
+++ b/entries/get.xml
@@ -11,7 +11,7 @@
     
     Retrieve one of the elements matched by the jQuery object.
     
-      
      The .get() method grants us access to the DOM nodes underlying each jQuery object. Consider a simple unordered list:
      
+      
      The .get() method grants access to the DOM nodes underlying each jQuery object. If the value of index is out of bounds — less than 0 or equal to or greater than the number of elements — it returns undefined. Consider a simple unordered list:
      
       
      
 <ul>
   <li id="foo">foo</li>

From 501e5a44e068e1be73ee3913b57ac3ce34c0644c Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Wed, 26 Feb 2014 16:56:47 -0500
Subject: [PATCH 030/699] closest.xml: Sublist  should be indented for style
 consistency with sublist

Closes #394.

Author:    Aurelio De Rosa 
---
 entries/closest.xml | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/entries/closest.xml b/entries/closest.xml
index b3c8e169..9a01fb1e 100644
--- a/entries/closest.xml
+++ b/entries/closest.xml
@@ -64,17 +64,17 @@
 <ul id="one" class="level-1">
   <li class="item-i">I</li>
   <li id="ii" class="item-ii">II
-  <ul class="level-2">
-    <li class="item-a">A</li>
-    <li class="item-b">B
-      <ul class="level-3">
-        <li class="item-1">1</li>
-        <li class="item-2">2</li>
-        <li class="item-3">3</li>
-      </ul>
-    </li>
-    <li class="item-c">C</li>
-  </ul>
+    <ul class="level-2">
+      <li class="item-a">A</li>
+      <li class="item-b">B
+        <ul class="level-3">
+          <li class="item-1">1</li>
+          <li class="item-2">2</li>
+          <li class="item-3">3</li>
+        </ul>
+      </li>
+      <li class="item-c">C</li>
+    </ul>
   </li>
   <li class="item-iii">III</li>
 </ul>

From 0426c7655e8fa526e4db2fab677623cc0afd5336 Mon Sep 17 00:00:00 2001
From: Tomasz Ratajczak 
Date: Sun, 16 Mar 2014 14:31:22 -0400
Subject: [PATCH 031/699] Fix Event Object url. Closes #402

---
 entries/on.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/on.xml b/entries/on.xml
index 3bd2dff0..a322724e 100644
--- a/entries/on.xml
+++ b/entries/on.xml
@@ -62,7 +62,7 @@ function notify() {
 }
 $( "button" ).on( "click", notify );
     
      
-    
      When the browser triggers an event or other JavaScript calls jQuery's .trigger() method, jQuery passes the handler an event object it can use to analyze and change the status of the event. This object is a normalized subset of data provided by the browser; the browser's unmodified native event object is available in event.originalEvent. For example, event.type contains the event name (e.g., "resize") and event.target indicates the deepest (innermost) element where the event occurred.
      
+    
      When the browser triggers an event or other JavaScript calls jQuery's .trigger() method, jQuery passes the handler an event object it can use to analyze and change the status of the event. This object is a normalized subset of data provided by the browser; the browser's unmodified native event object is available in event.originalEvent. For example, event.type contains the event name (e.g., "resize") and event.target indicates the deepest (innermost) element where the event occurred.
      
     
      By default, most events bubble up from the original event target to the document element. At each element along the way, jQuery calls any matching event handlers that have been attached. A handler can prevent the event from bubbling further up the document tree (and thus prevent handlers on those elements from running) by calling event.stopPropagation(). Any other handlers attached on the current element will run however. To prevent that, call event.stopImmediatePropagation(). (Event handlers bound to an element are called in the same order that they were bound.)
      
     
      Similarly, a handler can call event.preventDefault() to cancel any default action that the browser may have for this event; for example, the default action on a click event is to follow the link. Not all browser events have default actions, and not all default actions can be canceled. See the W3C Events Specification for details.
      
     
      Returning false from an event handler will automatically call event.stopPropagation() and event.preventDefault(). A false value can also be passed for the handler as a shorthand for function(){ return false; }. So, $( "a.disabled" ).on( "click", false ); attaches an event handler to all links with class "disabled" that prevents them from being followed when they are clicked and also stops the event from bubbling. 
      

From 08bdef496ff292a6daec6f58c9b51c646e950968 Mon Sep 17 00:00:00 2001
From: Richard Gibson 
Date: Sun, 16 Mar 2014 14:42:43 -0400
Subject: [PATCH 032/699] .width() and .height(): synhronize documentation

* Include the style/script warning
* Follow the style guide for comments
* Ref jQuery #14545
* Closes #403
---
 entries/height.xml | 7 +++++--
 entries/width.xml  | 3 +++
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/entries/height.xml b/entries/height.xml
index dd809c0f..4d315e46 100644
--- a/entries/height.xml
+++ b/entries/height.xml
@@ -14,8 +14,11 @@
       
      
       
      This method is also able to find the height of the window and document.
      
       
      
-$( window ).height(); // returns height of browser viewport
-$( document ).height(); // returns height of HTML document
+// Returns height of browser viewport
+$( window ).height();
+
+// Returns height of HTML document
+$( document ).height();
       
      
       
      Note that .height() will always return the content height, regardless of the value of the CSS box-sizing property. As of jQuery 1.8, this may require retrieving the CSS height plus box-sizing property and then subtracting any potential border and padding on each element when the element has box-sizing: border-box. To avoid this penalty, use .css( "height" ) rather than .height().
      
       
      
diff --git a/entries/width.xml b/entries/width.xml
index c8a11a28..27ac3a0d 100644
--- a/entries/width.xml
+++ b/entries/width.xml
@@ -21,6 +21,9 @@ $( window ).width();
 $( document ).width();

      Note that .width() will always return the content width, regardless of the value of the CSS box-sizing property. As of jQuery 1.8, this may require retrieving the CSS width plus box-sizing property and then subtracting any potential border and padding on each element when the element has box-sizing: border-box. To avoid this penalty, use .css( "width" ) rather than .width().

      +
      +

      Note: Although style and script tags will report a value for .width() or height() when absolutely positioned and given display:block, it is strongly discouraged to call those methods on these tags. In addition to being a bad practice, the results may also prove unreliable.

      +
      From a05af326c486e575ca90a6d43773e858ca03654c Mon Sep 17 00:00:00 2001 From: Aurelio De Rosa Date: Sun, 16 Mar 2014 14:49:55 -0400 Subject: [PATCH 033/699] .filter: Update signature. An array of elements works as well. Closes #396 --- entries/filter.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/entries/filter.xml b/entries/filter.xml index 9d8f53cc..9aa08474 100644 --- a/entries/filter.xml +++ b/entries/filter.xml @@ -15,8 +15,8 @@ 1.4 - - An element to match the current set of elements against. + + One or more DOM elements to match the current set of elements against. From 7c6cd12222932d7ebfb5240c1743a61041065343 Mon Sep 17 00:00:00 2001 From: Aurelio De Rosa Date: Sun, 16 Mar 2014 14:51:52 -0400 Subject: [PATCH 034/699] .removeData(): Fix a small typo. Closes #400 --- entries/removeData.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/entries/removeData.xml b/entries/removeData.xml index 7286016d..2c346cba 100644 --- a/entries/removeData.xml +++ b/entries/removeData.xml @@ -17,7 +17,7 @@ Remove a previously-stored piece of data. -

      The .removeData() method allows us to remove values that were previously set using .data(). When called with the name of a key, .removeData() deletes that particular value; when called with no arguments, all values are removed. Removing data from jQuery's internal .data() cache does not effect any HTML5 data- attributes in a document; use .removeAttr() to remove those.

      +

      The .removeData() method allows us to remove values that were previously set using .data(). When called with the name of a key, .removeData() deletes that particular value; when called with no arguments, all values are removed. Removing data from jQuery's internal .data() cache does not affect any HTML5 data- attributes in a document; use .removeAttr() to remove those.

      When using .removeData("name"), jQuery will attempt to locate a data- attribute on the element if no property by that name is in the internal data cache. To avoid a re-query of the data- attribute, set the name to a value of either null or undefined (e.g. .data("name", undefined)) rather than using .removeData().

      As of jQuery 1.7, when called with an array of keys or a string of space-separated keys, .removeData() deletes the value of each key in that array or string.

      As of jQuery 1.4.3, calling .removeData() will cause the value of the property being removed to revert to the value of the data attribute of the same name in the DOM, rather than being set to undefined.

      From d0ce77df70bfcdd2784f0f459b9fabd02f88b761 Mon Sep 17 00:00:00 2001 From: Aurelio De Rosa Date: Sun, 16 Mar 2014 14:56:15 -0400 Subject: [PATCH 035/699] .nextUntil(): Make explicit that element can be a jQuery object. Closes #404 --- entries/nextUntil.xml | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/entries/nextUntil.xml b/entries/nextUntil.xml index 3f0f3f0c..619b95a2 100644 --- a/entries/nextUntil.xml +++ b/entries/nextUntil.xml @@ -12,8 +12,10 @@ 1.6 - + A DOM node or jQuery object indicating where to stop matching following sibling elements. + + A string containing a selector expression to match elements against. From 5b6edccaaafb8526fb86575977316f81f6d3431d Mon Sep 17 00:00:00 2001 From: Karl Swedberg Date: Sun, 16 Mar 2014 15:10:41 -0400 Subject: [PATCH 036/699] .prevUntil(), .parentsUntil(): Make explicit that Element can be a jQuery object. --- entries/parentsUntil.xml | 4 +++- entries/prevUntil.xml | 4 +++- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/entries/parentsUntil.xml b/entries/parentsUntil.xml index b2aa8eb7..93e5e1fa 100644 --- a/entries/parentsUntil.xml +++ b/entries/parentsUntil.xml @@ -12,7 +12,9 @@ 1.6 - + + + A DOM node or jQuery object indicating where to stop matching ancestor elements. diff --git a/entries/prevUntil.xml b/entries/prevUntil.xml index 14c468ca..5e6effb0 100644 --- a/entries/prevUntil.xml +++ b/entries/prevUntil.xml @@ -12,7 +12,9 @@ 1.6 - + + + A DOM node or jQuery object indicating where to stop matching preceding sibling elements. From 0b9391316b0511206aeea1b49879111ffd674027 Mon Sep 17 00:00:00 2001 From: Aurelio De Rosa Date: Sun, 16 Mar 2014 15:14:36 -0400 Subject: [PATCH 037/699] .triggerHandler(): Use "triggered" (not "created"). Closes #428 --- entries/triggerHandler.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/entries/triggerHandler.xml b/entries/triggerHandler.xml index a470e31f..df6fb8af 100644 --- a/entries/triggerHandler.xml +++ b/entries/triggerHandler.xml @@ -16,7 +16,7 @@
      • The .triggerHandler() method does not cause the default behavior of an event to occur (such as a form submission).
      • While .trigger() will operate on all elements matched by the jQuery object, .triggerHandler() only affects the first matched element.
        • -
      • Events created with .triggerHandler() do not bubble up the DOM hierarchy; if they are not handled by the target element directly, they do nothing.
        • +
      • Events triggered with .triggerHandler() do not bubble up the DOM hierarchy; if they are not handled by the target element directly, they do nothing.
      • Instead of returning the jQuery object (to allow chaining), .triggerHandler() returns whatever value was returned by the last handler it caused to be executed. If no handlers are triggered, it returns undefined

      For more information on this method, see the discussion for .trigger().

      From b83bd13f827f1e1a65f2a32930be71ebeca639cc Mon Sep 17 00:00:00 2001 From: Bill Edgington Date: Sun, 16 Mar 2014 15:18:12 -0400 Subject: [PATCH 038/699] .clone(): Specify which form controls maintain state when cloned. Fixes #381. Closes #382 --- entries/clone.xml | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/entries/clone.xml b/entries/clone.xml index 8dcd4fb2..91d7bc29 100644 --- a/entries/clone.xml +++ b/entries/clone.xml @@ -18,7 +18,10 @@       Create a deep copy of the set of matched elements. -

      The .clone() method performs a deep copy of the set of matched elements, meaning that it copies the matched elements as well as all of their descendant elements and text nodes. For performance reasons, the dynamic state of form elements (e.g., user data typed into input, and textarea or user selections made to a select) is not copied to the cloned elements. The clone operation sets these fields to their default values as specified in the HTML.

      +

      The .clone() method performs a deep copy of the set of matched elements, meaning that it copies the matched elements as well as all of their descendant elements and text nodes.

      +
      +

      Note: For performance reasons, the dynamic state of certain form elements (e.g., user data typed into textarea and user selections made to a select) is not copied to the cloned elements. When cloning input elements, the dynamic state of the element (e.g., user data typed into text inputs and user selections made to a checkbox) is retained in the cloned elements.

      +

      When used in conjunction with one of the insertion methods, .clone() is a convenient way to duplicate elements on a page. Consider the following HTML:

      
 <div class="container">

From bcb87bf842e734ab631c46bf30ab322ab8ff4348 Mon Sep 17 00:00:00 2001
From: Richard Gibson 
Date: Sun, 16 Mar 2014 15:23:17 -0400
Subject: [PATCH 039/699] .val(): Be more clear about when null is returned

Ref jQuery #14654
Closes #406
---
 entries/val.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/val.xml b/entries/val.xml
index 3d1b96bf..9285a546 100644
--- a/entries/val.xml
+++ b/entries/val.xml
@@ -11,7 +11,7 @@
     
     Get the current value of the first element in the set of matched elements.
     
-      
      The .val() method is primarily used to get the values of form elements such as input, select and textarea. In the case of <select multiple="multiple"> elements, the .val() method returns an array containing each selected option; if no option is selected, it returns null. 
      
+      
      The .val() method is primarily used to get the values of form elements such as input, select and textarea. In the case of select elements, it returns null when no option is selected and an array containing the value of each selected option when there is at least one and it is possible to select more because the multiple attribute is present.
      
       
      For selects and checkboxes, you can also use the :selected and :checked selectors to get at values, for example:
      
       
      
 // Get the value from a dropdown select

From 58be0ddb785f435d9310143ad70e25b9d0cc0c57 Mon Sep 17 00:00:00 2001
From: John Reilly 
Date: Tue, 18 Mar 2014 13:52:32 -0400
Subject: [PATCH 040/699] .text(): Include Number and Boolean types for
 argument. Closes #460

---
 entries/text.xml | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/entries/text.xml b/entries/text.xml
index af7880ea..8ba40495 100644
--- a/entries/text.xml
+++ b/entries/text.xml
@@ -52,8 +52,11 @@ $( "p:last" ).html( str );
   
     
       1.0
-      
-        A string of text to set as the content of each matched element.
+      
+        
+        
+        
+        The text to set as the content of each matched element. When Number or Boolean is supplied, it will be converted to a String representation.
       
     
     

From fb3f5f8ceb98f73c6a35326c71fb33af429d5533 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Tue, 18 Mar 2014 15:39:25 -0400
Subject: [PATCH 041/699] 1.11.5

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 907a22e2..b2200764 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.4",
+  "version": "1.11.5",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From cd7773862216f4a0be105688fe95058d6ef611ed Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 23 Mar 2014 12:26:14 +0100
Subject: [PATCH 042/699] Update jQuery.xml

Fixed a small typo
---
 entries/jQuery.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.xml b/entries/jQuery.xml
index 014a5fcf..089834f1 100644
--- a/entries/jQuery.xml
+++ b/entries/jQuery.xml
@@ -248,7 +248,7 @@ $( "
      ", {
     
     Binds a function to be executed when the DOM has finished loading.
     
-      
      This function behaves just like $( document ).ready(), in that it should be used to wrap other $() operations on your page that depend on the DOM being ready. While this function is, technically, chainable, there really isn"t much use for chaining against it.
      
+      
      This function behaves just like $( document ).ready(), in that it should be used to wrap other $() operations on your page that depend on the DOM being ready. While this function is, technically, chainable, there really isn't much use for chaining against it.
      
           
     
       Execute the function when the DOM is ready to be used.

From 3043a60aaab2755dc1d7b05ba506b7200bc3f1c1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Mon, 14 Apr 2014 11:31:45 -0400
Subject: [PATCH 043/699] Build: Normalize line endings

---
 .gitattributes | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 .gitattributes

diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 00000000..b7ca95b5
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,5 @@
+# Auto detect text files and perform LF normalization
+* text=auto
+
+# JS files must always use LF for tools to work
+*.js eol=lf

From 59bcdbd045db6d5fa7c73970e155403b6ffb10df Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Wed, 16 Apr 2014 09:26:11 -0400
Subject: [PATCH 044/699] load: Don't rely on site content for demo

Fixes gh-475
---
 entries/load.xml    |  8 ++++----
 resources/load.html | 20 ++++++++++++++++++++
 2 files changed, 24 insertions(+), 4 deletions(-)
 create mode 100644 resources/load.html

diff --git a/entries/load.xml b/entries/load.xml
index 7389800c..f5aea57c 100644
--- a/entries/load.xml
+++ b/entries/load.xml
@@ -56,9 +56,9 @@ $( "#b" ).load( "article.html #target" );
   
   
   
-    Load the main page's footer navigation into an ordered list.
+    Load another page's list items into an ordered list.
     
     
     Footer navigation:
-
        
+Projects:
+
          
 ]]>
             
   
diff --git a/resources/load.html b/resources/load.html
new file mode 100644
index 00000000..659f6044
--- /dev/null
+++ b/resources/load.html
@@ -0,0 +1,20 @@
+
+
+
+	
+	Sample Page
+
+
+
+
          Popular jQuery Projects
          
+
+
            
+	
          • jQuery
            • 
+	
          • jQuery UI
            • 
+	
          • jQuery Mobile
            • 
+	
          • QUnit
            • 
+	
          • Sizzle
            • 
+
          
+
+
+
\ No newline at end of file

From 102e6130831fde253914a519c9d63894a76f3241 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Wed, 16 Apr 2014 09:29:39 -0400
Subject: [PATCH 045/699] 1.11.6

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index b2200764..b603cf5d 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.5",
+  "version": "1.11.6",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From 18706517dc86f07368f5971f252768ad449def33 Mon Sep 17 00:00:00 2001
From: Manuel Strehl 
Date: Thu, 24 Apr 2014 14:08:53 -0400
Subject: [PATCH 046/699] .get(): Fix description for negative indexes. Closes
 #481

---
 entries/get.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/get.xml b/entries/get.xml
index 5698760d..64272cf4 100644
--- a/entries/get.xml
+++ b/entries/get.xml
@@ -11,7 +11,7 @@
     
     Retrieve one of the elements matched by the jQuery object.
     
-      
          The .get() method grants access to the DOM nodes underlying each jQuery object. If the value of index is out of bounds — less than 0 or equal to or greater than the number of elements — it returns undefined. Consider a simple unordered list:
          
+      
          The .get() method grants access to the DOM nodes underlying each jQuery object. If the value of index is out of bounds — less than the negative number of elements or equal to or greater than the number of elements — it returns undefined. Consider a simple unordered list:
          
       
          
 <ul>
   <li id="foo">foo</li>

From fdce4a1a0e27573ceb38d1808c271ce0b51fd825 Mon Sep 17 00:00:00 2001
From: Mark Amery 
Date: Wed, 30 Apr 2014 14:46:17 -0400
Subject: [PATCH 047/699] jQuery.ajax: rewrite Data Types section. Fixes #482

---
 entries/jQuery.ajax.xml | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index fa35ac58..3b70d572 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -281,15 +281,14 @@ jqxhr.always(function() {
     
 
     
          Data Types
          
-    
          The $.ajax() function relies on the server to provide information about the retrieved data. If the server reports the return data as XML, the result can be traversed using normal XML methods or jQuery's selectors. If another type is detected, such as HTML in the example above, the data is treated as text.
          
-    
          Different data handling can be achieved by using the dataType option. Besides plain xml, the dataType can be html, json, jsonp, script, or text.
          
-    
          The text and xml types return the data with no processing. The data is simply passed on to the success handler, either through the responseText or responseXML property of the jqXHR object, respectively.
          
-    
          Note: We must ensure that the MIME type reported by the web server matches our choice of dataType. In particular, XML must be declared by the server as text/xml or application/xml for consistent results.
          
-    
          If html is specified, any embedded JavaScript inside the retrieved data is executed before the HTML is returned as a string. Similarly, script will execute the JavaScript that is pulled back from the server, then return nothing.
          
-    
          The json type parses the fetched data file as a JavaScript object and returns the constructed object as the result data. To do so, it uses jQuery.parseJSON() when the browser supports it; otherwise it uses a Function constructor. Malformed JSON data will throw a parse error (see json.org for more information). JSON data is convenient for communicating structured data in a way that is concise and easy for JavaScript to parse. If the fetched data file exists on a remote server, specify the jsonp type instead.
          
-    
          The jsonp type appends a query string parameter of callback=? to the URL. The server should prepend the JSON data with the callback name to form a valid JSONP response. We can specify a parameter name other than callback with the jsonp option to $.ajax().
          
-    
          Note: JSONP is an extension of the JSON format, requiring some server-side code to detect and handle the query string parameter. More information about it can be found in the original post detailing its use.
          
-    
          When data is retrieved from remote servers (which is only possible using the script or jsonp data types), the error callbacks and global events will never be fired.
          
+    
          Different types of response to $.ajax() call are subjected to different kinds of pre-processing before being passed to the success handler. The type of pre-processing depends by default upon the Content-Type of the response, but can be set explicitly using the dataType option. If the dataType option is provided, the Content-Type header of the response will be disregarded.
          
+    
          The available data types are text, html, xml, json, jsonp, and script.
          
+    
          If text or html is specified, no pre-processing occurs. The data is simply passed on to the success handler, and made available through the responseText property of the jqXHR object.
          
+    
          If xml is specified, the response is parsed using jQuery.parseXML before being passed, as an XMLDocument, to the success handler. The XML document is made available through the responseXML property of the jqXHR object.
          
+    
          If json is specified, the response is parsed using jQuery.parseJSON before being passed, as an object, to the success handler. The parsed JSON object is made available through the responseJSON property of the jqXHR object.
          
+    
          If script is specified, $.ajax() will execute the JavaScript that is received from the server before passing it on to the success handler as a string.
          
+    
          If jsonp is specified, $.ajax() will automatically append a query string parameter of (by default) callback=? to the URL. The jsonp and jsonpCallback properties of the settings passed to $.ajax() can be used to specify, respectively, the name of the query string parameter and the name of the JSONP callback function. The server should return valid JavaScript that passes the JSON response into the callback function. $.ajax() will execute the returned JavaScript, calling the JSONP callback function, before passing the JSON object contained in the response to the $.ajax() success handler.
          
+    
          For more information on JSONP, see the original post detailing its use.
          
     
          Sending Data to the Server
          
     
          By default, Ajax requests are sent using the GET HTTP method. If the POST method is required, the method can be specified by setting a value for the type option. This option affects how the contents of the data option are sent to the server. POST data will always be transmitted to the server using UTF-8 charset, per the W3C XMLHTTPRequest standard.
          
     
          The data option can contain either a query string of the form key1=value1&key2=value2, or an object of the form {key1: 'value1', key2: 'value2'}. If the latter form is used, the data is converted into a query string using jQuery.param() before it is sent. This processing can be circumvented by setting processData to false.  The processing might be undesirable if you wish to send an XML object to the server; in this case, change the contentType option from application/x-www-form-urlencoded to a more appropriate MIME type.
          

From a92dd1ba0b0ff1f080b769f015311a4084f697f4 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Wed, 30 Apr 2014 14:55:06 -0400
Subject: [PATCH 048/699] 1.11.7

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index b603cf5d..d1719340 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.6",
+  "version": "1.11.7",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From c137cb36bf96146a6045ffc7a789a2c70a82763a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Mon, 5 May 2014 14:07:33 -0400
Subject: [PATCH 049/699] jQuery.getScript: raw.github.com ->
 raw.githubusercontent.com

---
 entries/jQuery.getScript.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.getScript.xml b/entries/jQuery.getScript.xml
index bc86be4b..d519358f 100644
--- a/entries/jQuery.getScript.xml
+++ b/entries/jQuery.getScript.xml
@@ -91,7 +91,7 @@ $.cachedScript( "ajax/test.js" ).done(function( script, textStatus ) {
   
     Load the official jQuery Color Animation plugin dynamically and bind some color animations to occur once the new functionality is loaded.
     
Date: Mon, 12 May 2014 12:02:56 -0400
Subject: [PATCH 050/699] jQuery.parseJSON: Fix stray line break in example

---
 entries/jQuery.parseJSON.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/jQuery.parseJSON.xml b/entries/jQuery.parseJSON.xml
index b6f2ac08..1f13da91 100644
--- a/entries/jQuery.parseJSON.xml
+++ b/entries/jQuery.parseJSON.xml
@@ -22,8 +22,8 @@
     Parse a JSON string.
     
+alert( obj.name === "John" );
+]]>
   
   
   

From 1b7e2e704b97c5e1415679a8ec4edb2736c228e2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Mon, 12 May 2014 12:03:06 -0400
Subject: [PATCH 051/699] 1.11.8

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index d1719340..0079431e 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.7",
+  "version": "1.11.8",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From e708998f137f531418e18c46117ca62289666b2b Mon Sep 17 00:00:00 2001
From: Usman Akeju 
Date: Wed, 14 May 2014 09:54:06 -0400
Subject: [PATCH 052/699] jQuery.boxModel: removed since 1.8 Closes gh451

---
 entries/jQuery.boxModel.xml | 33 +++------------------------------
 1 file changed, 3 insertions(+), 30 deletions(-)

diff --git a/entries/jQuery.boxModel.xml b/entries/jQuery.boxModel.xml
index 18411216..f260538a 100644
--- a/entries/jQuery.boxModel.xml
+++ b/entries/jQuery.boxModel.xml
@@ -1,40 +1,13 @@
 
-
+
   jQuery.boxModel
   
     1.0
   
-  Deprecated in jQuery 1.3 (see jQuery.support). States if the current page, in the user's browser, is being rendered using the W3C CSS Box Model.
+  States if the current page, in the user's browser, is being rendered using the W3C CSS Box Model. This property was removed in jQuery 1.8. Please try to use feature detection instead.
   
-  
-    Returns the box model for the iframe.
-    " +
-  jQuery.boxModel + "" );
-]]>
-    
-    
          
-]]>
-            
-  
-    Returns false if the page is in Quirks Mode in Internet Explorer
-    
-    
-  
   
   
   
+  
           

From 1c2c0f68582bffdafa60cb2ea7ab6680bc986f82 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Wed, 14 May 2014 09:57:12 -0400
Subject: [PATCH 053/699] 1.11.9

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 0079431e..47d187f9 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.8",
+  "version": "1.11.9",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From 9206d3f53f663d2a973712cdb103169071ed16f2 Mon Sep 17 00:00:00 2001
From: Usman Akeju 
Date: Wed, 14 May 2014 16:34:04 +0200
Subject: [PATCH 054/699] jQuery.type: Argument can be anything

Closes gh-494
---
 entries/jQuery.type.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.type.xml b/entries/jQuery.type.xml
index 690bee10..f77b3139 100644
--- a/entries/jQuery.type.xml
+++ b/entries/jQuery.type.xml
@@ -3,7 +3,7 @@
   jQuery.type()
   
     1.4.3
-    
+    
       Object to get the internal JavaScript [[Class]] of.
     
   

From a93a1cc7203d16b6ee01de07c88bb83c9486b54d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Thu, 15 May 2014 19:03:55 -0400
Subject: [PATCH 055/699] Build: Use vagrant for sample config

---
 config-sample.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/config-sample.json b/config-sample.json
index 85f8556b..b26cf9fc 100644
--- a/config-sample.json
+++ b/config-sample.json
@@ -1,5 +1,5 @@
 {
-	"url": "local.api.jquery.com",
+	"url": "vagrant.api.jquery.com",
 	"username": "admin",
 	"password": "secret"
 }

From 11c93b9d0639be79bd72020652af92e6c226603e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Olav=20Junker=20Kj=C3=A6r?= 
Date: Sat, 18 Jan 2014 12:44:11 +0100
Subject: [PATCH 056/699] All: Added structured types for higer order function
 parameters

Some function parameters of function type (e.g. handlers, callbacks) was
described with the signature in the name-attribute, eg. . This have been modified
to used nested -elements to describe the signatures more
consistently.

Changed some argument type from XMLHttpRequest to jsXHR

Some callback functions was indicated to receive XMLHttpRequest rather
than jsXHR.

Fixed spelling and changed 'ajaxOptions' to 'PlainObject'

The ajaxOptions/ajaxSettings options object is not documented as a
seperate type, so now changed to PlainObject. Changed misspelling of
jsXHR to jqXHR.

Changed nargument names to valid identifers to avoid confusion

Argument names with whitespace like "jQuery object" are confusing,
because it might easily be mistaken for two arguments when reading the
signature. Argument names like "-index" are also confusing since they
look like an expression rather than a name. I have renamed the argument
names to be valid javascript identifiers, just like actual argument
names have to be. Also changed argument type "Object" and "PlainObject"
to "JQuery" where the prose documentation indicates that the type is a
jQuery object.

Changed argument name 'jQueryObject' to 'selection'

As per discussion on #jquery-content. Also changed type from 'Object'
to 'jQuery' where prose indicates a jQuery object.

Closes gh-419
---
 entries/add.xml                  |  2 +-
 entries/addClass.xml             |  5 ++++-
 entries/after.xml                |  9 ++++++++-
 entries/ajaxComplete.xml         |  5 ++++-
 entries/ajaxError.xml            |  6 +++++-
 entries/ajaxSend.xml             |  5 ++++-
 entries/ajaxStart.xml            |  2 +-
 entries/ajaxStop.xml             |  2 +-
 entries/ajaxSuccess.xml          |  6 +++++-
 entries/append.xml               |  9 ++++++++-
 entries/attr.xml                 |  8 +++++++-
 entries/before.xml               |  7 +++++++
 entries/bind.xml                 |  3 ++-
 entries/blur.xml                 |  6 ++++--
 entries/change.xml               |  6 ++++--
 entries/click.xml                |  6 ++++--
 entries/closest.xml              |  2 +-
 entries/css.xml                  |  8 +++++++-
 entries/dblclick.xml             |  6 ++++--
 entries/delegate.xml             |  6 ++++--
 entries/each.xml                 |  4 +++-
 entries/eq-selector.xml          |  2 +-
 entries/eq.xml                   |  2 +-
 entries/error.xml                |  6 ++++--
 entries/filter.xml               |  7 +++++--
 entries/find.xml                 |  2 +-
 entries/focus.xml                |  6 ++++--
 entries/focusin.xml              |  6 ++++--
 entries/focusout.xml             |  6 ++++--
 entries/gt-selector.xml          |  2 +-
 entries/height.xml               |  8 +++++++-
 entries/hover.xml                | 15 +++++++++------
 entries/html.xml                 |  5 ++++-
 entries/is.xml                   |  9 ++++++---
 entries/jQuery.ajaxPrefilter.xml |  5 ++++-
 entries/jQuery.ajaxTransport.xml |  5 ++++-
 entries/jQuery.each.xml          | 19 ++++++++++++++++---
 entries/jQuery.get.xml           |  5 ++++-
 entries/jQuery.getJSON.xml       |  5 ++++-
 entries/jQuery.getScript.xml     |  5 ++++-
 entries/jQuery.grep.xml          |  5 ++++-
 entries/jQuery.map.xml           | 20 ++++++++++++--------
 entries/jQuery.post.xml          |  5 ++++-
 entries/jQuery.queue.xml         |  2 +-
 entries/jQuery.xml               |  2 +-
 entries/keydown.xml              |  6 ++++--
 entries/keypress.xml             |  6 ++++--
 entries/keyup.xml                |  6 ++++--
 entries/live.xml                 |  6 ++++--
 entries/load-event.xml           |  6 ++++--
 entries/load.xml                 |  5 ++++-
 entries/lt-selector.xml          |  2 +-
 entries/map.xml                  |  5 ++++-
 entries/mousedown.xml            |  6 ++++--
 entries/mouseenter.xml           |  6 ++++--
 entries/mouseleave.xml           |  6 ++++--
 entries/mousemove.xml            |  6 ++++--
 entries/mouseout.xml             |  6 ++++--
 entries/mouseover.xml            |  6 ++++--
 entries/mouseup.xml              |  6 ++++--
 entries/not.xml                  |  7 +++++--
 entries/off.xml                  |  3 ++-
 entries/offset.xml               |  5 ++++-
 entries/on.xml                   |  3 ++-
 entries/one.xml                  |  6 ++++--
 entries/prepend.xml              |  9 ++++++++-
 entries/prop.xml                 | 14 +++++++++++++-
 entries/queue.xml                |  3 ++-
 entries/removeClass.xml          |  5 ++++-
 entries/resize.xml               |  6 ++++--
 entries/scroll.xml               |  6 ++++--
 entries/select.xml               |  6 ++++--
 entries/submit.xml               |  6 ++++--
 entries/text.xml                 |  5 ++++-
 entries/toggle-event.xml         |  9 ++++++---
 entries/toggleClass.xml          |  6 +++++-
 entries/unbind.xml               |  3 ++-
 entries/undelegate.xml           |  3 ++-
 entries/unload.xml               |  6 ++++--
 entries/val.xml                  |  5 ++++-
 entries/width.xml                |  8 +++++++-
 entries/wrap.xml                 |  7 ++++++-
 entries/wrapInner.xml            |  4 +++-
 83 files changed, 357 insertions(+), 129 deletions(-)

diff --git a/entries/add.xml b/entries/add.xml
index e93025df..1bd30426 100644
--- a/entries/add.xml
+++ b/entries/add.xml
@@ -21,7 +21,7 @@
   
   
     1.3.2
-    
+    
       An existing jQuery object to add to the set of matched elements.
     
   
diff --git a/entries/addClass.xml b/entries/addClass.xml
index 7d299dba..238d03e5 100644
--- a/entries/addClass.xml
+++ b/entries/addClass.xml
@@ -9,8 +9,11 @@
   
   
     1.4
-    
+    
       A function returning one or more space-separated class names to be added to the existing class name(s). Receives the index position of the element in the set and the existing class name(s) as arguments. Within the function, this refers to the current element in the set.
+      
+      
+      
     
   
   Adds the specified class(es) to each of the set of matched elements.
diff --git a/entries/after.xml b/entries/after.xml
index 2c8869c9..8e57cdac 100644
--- a/entries/after.xml
+++ b/entries/after.xml
@@ -20,8 +20,15 @@
   
   
     1.4
-    
+    
       A function that returns an HTML string, DOM element(s), or jQuery object to insert after each element in the set of matched elements. Receives the index position of the element in the set as an argument. Within the function, this refers to the current element in the set.
+      
+      
+      
+        
+        
+                
+      
     
   
   Insert content, specified by the parameter, after each element in the set of matched elements.
diff --git a/entries/ajaxComplete.xml b/entries/ajaxComplete.xml
index 3b3fc93e..3ff3b58c 100644
--- a/entries/ajaxComplete.xml
+++ b/entries/ajaxComplete.xml
@@ -3,7 +3,10 @@
   .ajaxComplete()
   
     1.0
-    
+          
+      
+      
+      
       The function to be invoked.
     
   
diff --git a/entries/ajaxError.xml b/entries/ajaxError.xml
index 4029c7be..fbee691d 100644
--- a/entries/ajaxError.xml
+++ b/entries/ajaxError.xml
@@ -3,8 +3,12 @@
   .ajaxError()
   
     1.0
-    
+    
       The function to be invoked.
+      
+      
+            
+         
     
   
   Register a handler to be called when Ajax requests complete with an error. This is an Ajax Event.
diff --git a/entries/ajaxSend.xml b/entries/ajaxSend.xml
index dd2dc44b..2d609b71 100644
--- a/entries/ajaxSend.xml
+++ b/entries/ajaxSend.xml
@@ -3,8 +3,11 @@
   .ajaxSend()
   
     1.0
-    
+    
       The function to be invoked.
+      
+      
+      
     
   
   Attach a function to be executed before an Ajax request is sent. This is an Ajax Event.
diff --git a/entries/ajaxStart.xml b/entries/ajaxStart.xml
index 854ad019..7747e5b6 100644
--- a/entries/ajaxStart.xml
+++ b/entries/ajaxStart.xml
@@ -3,7 +3,7 @@
   .ajaxStart()
   
     1.0
-    
+    
       The function to be invoked.
     
   
diff --git a/entries/ajaxStop.xml b/entries/ajaxStop.xml
index 63e14639..76b3bffc 100644
--- a/entries/ajaxStop.xml
+++ b/entries/ajaxStop.xml
@@ -4,7 +4,7 @@
   Register a handler to be called when all Ajax requests have completed. This is an Ajax Event.
   
     1.0
-    
+    
       The function to be invoked.
     
   
diff --git a/entries/ajaxSuccess.xml b/entries/ajaxSuccess.xml
index 968350d8..26583e2e 100644
--- a/entries/ajaxSuccess.xml
+++ b/entries/ajaxSuccess.xml
@@ -3,8 +3,12 @@
   .ajaxSuccess()
   
     1.0
-    
+    
       The function to be invoked.
+      
+      
+           
+        
     
   
   Attach a function to be executed whenever an Ajax request completes successfully. This is an Ajax Event.
diff --git a/entries/append.xml b/entries/append.xml
index 5903fa05..c1de1420 100644
--- a/entries/append.xml
+++ b/entries/append.xml
@@ -20,8 +20,15 @@
   
   
     1.4
-    
+    
       A function that returns an HTML string, DOM element(s), or jQuery object to insert at the end of each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, this refers to the current element in the set.
+      
+      
+      
+        
+        
+                
+      
     
   
   Insert content, specified by the parameter, to the end of each element in the set of matched elements.
diff --git a/entries/attr.xml b/entries/attr.xml
index 5e9dd89c..3e181e67 100644
--- a/entries/attr.xml
+++ b/entries/attr.xml
@@ -164,8 +164,14 @@ The title of the emphasis is:
          
       
         The name of the attribute to set.
       
-      
+      
         A function returning the value to set. this is the current element. Receives the index position of the element in the set and the old attribute value as arguments.
+        
+        
+        
+          
+                    
+        
       
     
     Set one or more attributes for the set of matched elements.
diff --git a/entries/before.xml b/entries/before.xml
index 4aeae8d6..7c2ebb7b 100644
--- a/entries/before.xml
+++ b/entries/before.xml
@@ -21,6 +21,13 @@
   
     1.4
     
+      
+      
+      
+        
+        
+                
+            
       A function that returns an HTML string, DOM element(s), or jQuery object to insert before each element in the set of matched elements. Receives the index position of the element in the set as an argument. Within the function, this refers to the current element in the set.
       
     
diff --git a/entries/bind.xml b/entries/bind.xml
index 3b00923b..be20d77c 100644
--- a/entries/bind.xml
+++ b/entries/bind.xml
@@ -9,8 +9,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/blur.xml b/entries/blur.xml
index 3029a6fc..ddb9bf99 100644
--- a/entries/blur.xml
+++ b/entries/blur.xml
@@ -4,8 +4,9 @@
   Bind an event handler to the "blur" JavaScript event, or trigger that event on an element.
   
     1.0
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/change.xml b/entries/change.xml
index d5f4f4f1..eedea432 100644
--- a/entries/change.xml
+++ b/entries/change.xml
@@ -4,8 +4,9 @@
   Bind an event handler to the "change" JavaScript event, or trigger that event on an element.
   
     1.0
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/click.xml b/entries/click.xml
index 4715cac3..c6a014c1 100644
--- a/entries/click.xml
+++ b/entries/click.xml
@@ -4,8 +4,9 @@
   Bind an event handler to the "click" JavaScript event, or trigger that event on an element.
   
     1.0
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/closest.xml b/entries/closest.xml
index 9a01fb1e..5f1bb2b4 100644
--- a/entries/closest.xml
+++ b/entries/closest.xml
@@ -19,7 +19,7 @@
     
     
       1.6
-      
+      
         A jQuery object to match elements against.
       
     
diff --git a/entries/css.xml b/entries/css.xml
index 6a5391cc..178fc326 100644
--- a/entries/css.xml
+++ b/entries/css.xml
@@ -123,8 +123,14 @@ $( "div" ).click(function() {
       
         A CSS property name.
       
-      
+      
         A function returning the value to set. this is the current element. Receives the index position of the element in the set and the old value as arguments.
+        
+        
+          
+          
+          
+        
       
     
     
diff --git a/entries/dblclick.xml b/entries/dblclick.xml
index c08c2915..ec851198 100644
--- a/entries/dblclick.xml
+++ b/entries/dblclick.xml
@@ -4,8 +4,9 @@
   Bind an event handler to the "dblclick" JavaScript event, or trigger that event on an element.
   
     1.0
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/delegate.xml b/entries/delegate.xml
index 09d6d7b5..dd57ffee 100644
--- a/entries/delegate.xml
+++ b/entries/delegate.xml
@@ -10,8 +10,9 @@
     
       A string containing one or more space-separated JavaScript event types, such as "click" or "keydown," or custom event names.
     
-    
+    
       A function to execute at the time the event is triggered.
+      
     
   
   
@@ -25,8 +26,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute at the time the event is triggered.
+      
     
   
   
diff --git a/entries/each.xml b/entries/each.xml
index ea75814e..9a882fb2 100644
--- a/entries/each.xml
+++ b/entries/each.xml
@@ -3,8 +3,10 @@
   .each()
   
     1.0
-    
+    
       A function to execute for each matched element.
+      
+            
     
   
   Iterate over a jQuery object, executing a function for each matched element. 
diff --git a/entries/eq-selector.xml b/entries/eq-selector.xml
index aad654c0..1e48407b 100644
--- a/entries/eq-selector.xml
+++ b/entries/eq-selector.xml
@@ -11,7 +11,7 @@
   
     :eq(-index)
     1.8
-    
+    
       Zero-based index of the element to match, counting backwards from the last element. 
     
   
diff --git a/entries/eq.xml b/entries/eq.xml
index af0b7a72..ddb06c74 100644
--- a/entries/eq.xml
+++ b/entries/eq.xml
@@ -9,7 +9,7 @@
   
   
     1.4
-    
+    
       An integer indicating the position of the element, counting backwards from the last element in the set. 
     
   
diff --git a/entries/error.xml b/entries/error.xml
index e5c0c07d..f93ba9fd 100644
--- a/entries/error.xml
+++ b/entries/error.xml
@@ -4,8 +4,9 @@
   Bind an event handler to the "error" JavaScript event.
   
     1.0
-    
+    
       A function to execute when the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/filter.xml b/entries/filter.xml
index 9aa08474..440b4277 100644
--- a/entries/filter.xml
+++ b/entries/filter.xml
@@ -9,8 +9,11 @@
   
   
     1.0
-    
+    
       A function used as a test for each element in the set. this is the current DOM element.
+      
+      
+      
     
   
   
@@ -21,7 +24,7 @@
   
   
     1.4
-    
+    
       An existing jQuery object to match the current set of elements against.
     
   
diff --git a/entries/find.xml b/entries/find.xml
index 9db417af..16c1d799 100644
--- a/entries/find.xml
+++ b/entries/find.xml
@@ -9,7 +9,7 @@
   
   
     1.6
-    
+    
       A jQuery object to match elements against.
     
   
diff --git a/entries/focus.xml b/entries/focus.xml
index b8398786..0651faab 100644
--- a/entries/focus.xml
+++ b/entries/focus.xml
@@ -4,8 +4,9 @@
   Bind an event handler to the "focus" JavaScript event, or trigger that event on an element.
   
     1.0
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/focusin.xml b/entries/focusin.xml
index e441a4e4..a692e3bb 100644
--- a/entries/focusin.xml
+++ b/entries/focusin.xml
@@ -4,8 +4,9 @@
   Bind an event handler to the "focusin" event.
   
     1.4
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/focusout.xml b/entries/focusout.xml
index 5528f56a..2d110637 100644
--- a/entries/focusout.xml
+++ b/entries/focusout.xml
@@ -4,8 +4,9 @@
   Bind an event handler to the "focusout" JavaScript event.
   
     1.4
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/gt-selector.xml b/entries/gt-selector.xml
index b4a44f50..303723a9 100644
--- a/entries/gt-selector.xml
+++ b/entries/gt-selector.xml
@@ -11,7 +11,7 @@
   
     :gt(-index)
     1.8
-    
+    
       Zero-based index, counting backwards from the last element. 
     
   
diff --git a/entries/height.xml b/entries/height.xml
index 4d315e46..8808ac6c 100644
--- a/entries/height.xml
+++ b/entries/height.xml
@@ -87,7 +87,13 @@ $( "#getw" ).click(function() {
     
     
       1.4.1
-      
+      
+        
+        
+        
+          
+                    
+        
         A function returning the height to set. Receives the index position of the element in the set and the old height as arguments. Within the function, this refers to the current element in the set.
       
     
diff --git a/entries/hover.xml b/entries/hover.xml
index fcfdd377..3eb38753 100644
--- a/entries/hover.xml
+++ b/entries/hover.xml
@@ -6,11 +6,13 @@
     Bind two handlers to the matched elements, to be executed when the mouse pointer enters and leaves the elements.
     
       1.0
-      
-        A function to execute when the mouse pointer enters the element.
+      
+        
+        A function to execute when the mouse pointer enters the element.        
       
-      
-        A function to execute when the mouse pointer leaves the element.
+      
+        
+        A function to execute when the mouse pointer leaves the element.        
       
     
     
@@ -83,8 +85,9 @@ $( "td" ).off( "mouseenter mouseleave" );
     Bind a single handler to the matched elements, to be executed when the mouse pointer enters or leaves the elements.
     
       1.4
-      
-        A function to execute when the mouse pointer enters or leaves the element.
+      
+        
+        A function to execute when the mouse pointer enters or leaves the element.        
       
     
     
diff --git a/entries/html.xml b/entries/html.xml
index c4160f72..0e9f9dcc 100644
--- a/entries/html.xml
+++ b/entries/html.xml
@@ -74,7 +74,10 @@ $( "p" ).click(function() {
     
     
       1.4
-      
+      
+        
+        
+        
         A function returning the HTML content to set. Receives the
           index position of the element in the set and the old HTML value as arguments.
           jQuery empties the element before calling the function;
diff --git a/entries/is.xml b/entries/is.xml
index 20ebd45d..2a14f6a3 100644
--- a/entries/is.xml
+++ b/entries/is.xml
@@ -9,13 +9,16 @@
   
   
     1.6
-    
-      A function used as a test for the set of elements. It accepts one argument, index, which is the element's index in the jQuery collection.Within the function, this refers to the current DOM element. 
+    
+      A function used as a test for the set of elements. It accepts one argument, index, which is the element's index in the jQuery collection. Within the function, this refers to the current DOM element. 
+      
+      
+            
     
   
   
     1.6
-    
+    
       An existing jQuery object to match the current set of elements against.
     
   
diff --git a/entries/jQuery.ajaxPrefilter.xml b/entries/jQuery.ajaxPrefilter.xml
index 405811bc..eb762dfb 100644
--- a/entries/jQuery.ajaxPrefilter.xml
+++ b/entries/jQuery.ajaxPrefilter.xml
@@ -7,8 +7,11 @@
     
       An optional string containing one or more space-separated dataTypes
     
-    
+    
       A handler to set default values for future Ajax requests.
+      
+      
+            
     
   
   
diff --git a/entries/jQuery.ajaxTransport.xml b/entries/jQuery.ajaxTransport.xml
index d44730d3..ccf5151e 100644
--- a/entries/jQuery.ajaxTransport.xml
+++ b/entries/jQuery.ajaxTransport.xml
@@ -7,8 +7,11 @@
     
       A string identifying the data type to use
     
-    
+    
       A handler to return the new transport object to use with the data type provided in the first argument.
+      
+      
+      
     
   
   
diff --git a/entries/jQuery.each.xml b/entries/jQuery.each.xml
index 55cd16f9..f8ab8a64 100644
--- a/entries/jQuery.each.xml
+++ b/entries/jQuery.each.xml
@@ -3,10 +3,23 @@
   jQuery.each()
   
     1.0
-    
-      The object or array to iterate over.
+    
+      The array to iterate over.
     
-    
+    
+            
+            
+      The function that will be executed on every object.
+    
+    
+  
+    1.0
+    
+      The object to iterate over.
+    
+    
+      
+            
       The function that will be executed on every object.
     
   
diff --git a/entries/jQuery.get.xml b/entries/jQuery.get.xml
index af75af2c..396e58b0 100644
--- a/entries/jQuery.get.xml
+++ b/entries/jQuery.get.xml
@@ -11,7 +11,10 @@
       
       A plain object or string that is sent to the server with the request.
     
-    
+    
+      
+      
+      
       A callback function that is executed if the request succeeds.
     
     
diff --git a/entries/jQuery.getJSON.xml b/entries/jQuery.getJSON.xml
index 92adffa6..1485a2a2 100644
--- a/entries/jQuery.getJSON.xml
+++ b/entries/jQuery.getJSON.xml
@@ -9,7 +9,10 @@
     
       A plain object or string that is sent to the server with the request.
     
-    
+    
+      
+      
+            
       A callback function that is executed if the request succeeds.
     
   
diff --git a/entries/jQuery.getScript.xml b/entries/jQuery.getScript.xml
index d519358f..488b4525 100644
--- a/entries/jQuery.getScript.xml
+++ b/entries/jQuery.getScript.xml
@@ -6,7 +6,10 @@
     
       A string containing the URL to which the request is sent.
     
-    
+    
+      
+      
+            
       A callback function that is executed if the request succeeds.
     
   
diff --git a/entries/jQuery.grep.xml b/entries/jQuery.grep.xml
index 3aa99aae..245a672d 100644
--- a/entries/jQuery.grep.xml
+++ b/entries/jQuery.grep.xml
@@ -7,7 +7,10 @@
     
       The array to search through.
     
-    
+    
+      
+      
+      
       The function to process each item against.  The first argument to the function is the item, and the second argument is the index.  The function should return a Boolean value.  this will be the global window object.
     
     
diff --git a/entries/jQuery.map.xml b/entries/jQuery.map.xml
index 8bb6a279..3c499e6c 100644
--- a/entries/jQuery.map.xml
+++ b/entries/jQuery.map.xml
@@ -6,19 +6,23 @@
     
       The Array to translate.
     
-    
-      The function to process each item against.  The first argument to the function is the array item, the second argument is the index in array The function can return any value. Within the function, this refers to the global (window) object.
+    
+      
+      
+            
+      The function to process each item against.  The first argument to the function is the array item, the second argument is the index in array The function can return any value. A returned array will be flattened into the resulting array. Within the function, this refers to the global (window) object.
     
   
   
     1.6
-    
-      
-      
-      The Array or Object to translate.
+    
+      The Object to translate.
     
-    
-      The function to process each item against.  The first argument to the function is the value; the second argument is the index or key of the array or object property. The function can return any value to add to the array. A returned array will be flattened into the resulting array. Within the function, this refers to the global (window) object. 
+    
+      
+      
+                  
+      The function to process each item against.  The first argument to the function is the value; the second argument is the key of the object property. The function can return any value to add to the array. A returned array will be flattened into the resulting array. Within the function, this refers to the global (window) object. 
     
   
   Translate all items in an array or object to new array of items.
diff --git a/entries/jQuery.post.xml b/entries/jQuery.post.xml
index e32e7e00..c066cbf4 100644
--- a/entries/jQuery.post.xml
+++ b/entries/jQuery.post.xml
@@ -11,7 +11,10 @@
       
       A plain object or string that is sent to the server with the request.
     
-    
+    
+      
+      
+              
       A callback function that is executed if the request succeeds. Required if dataType is provided, but can be null in that case.
     
     
diff --git a/entries/jQuery.queue.xml b/entries/jQuery.queue.xml
index 8b620b8f..3921e020 100644
--- a/entries/jQuery.queue.xml
+++ b/entries/jQuery.queue.xml
@@ -91,7 +91,7 @@ runIt();
       
         A string containing the name of the queue. Defaults to fx, the standard effects queue.
       
-      
+      
         The new function to add to the queue.
       
     
diff --git a/entries/jQuery.xml b/entries/jQuery.xml
index 014a5fcf..ea052d35 100644
--- a/entries/jQuery.xml
+++ b/entries/jQuery.xml
@@ -34,7 +34,7 @@
     
     
       1.0
-      
+      
         An existing jQuery object to clone.
       
     
diff --git a/entries/keydown.xml b/entries/keydown.xml
index b72e0ad7..893be2a7 100644
--- a/entries/keydown.xml
+++ b/entries/keydown.xml
@@ -3,8 +3,9 @@
   .keydown()
   
     1.0
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
@@ -12,8 +13,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/keypress.xml b/entries/keypress.xml
index b6421b20..0724c1bf 100644
--- a/entries/keypress.xml
+++ b/entries/keypress.xml
@@ -4,8 +4,9 @@
   Bind an event handler to the "keypress" JavaScript event, or trigger that event on an element.
   
     1.0
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/keyup.xml b/entries/keyup.xml
index f65c6a03..517d94b9 100644
--- a/entries/keyup.xml
+++ b/entries/keyup.xml
@@ -4,8 +4,9 @@
   Bind an event handler to the "keyup" JavaScript event, or trigger that event on an element.
   
     1.0
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/live.xml b/entries/live.xml
index 4ed78cc8..95f9d5d8 100644
--- a/entries/live.xml
+++ b/entries/live.xml
@@ -7,8 +7,9 @@
     
       A string containing a JavaScript event type, such as "click" or "keydown." As of jQuery 1.4 the string can contain multiple, space-separated event types or custom event names.
     
-    
+    
       A function to execute at the time the event is triggered.
+      
     
   
   
@@ -19,8 +20,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute at the time the event is triggered.
+      
     
   
   
diff --git a/entries/load-event.xml b/entries/load-event.xml
index 30e7662a..b8e48626 100644
--- a/entries/load-event.xml
+++ b/entries/load-event.xml
@@ -4,8 +4,9 @@
   Bind an event handler to the "load" JavaScript event.
   
     1.0
-    
+    
       A function to execute when the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/load.xml b/entries/load.xml
index f5aea57c..951c43f6 100644
--- a/entries/load.xml
+++ b/entries/load.xml
@@ -11,7 +11,10 @@
       
       A plain object or string that is sent to the server with the request.
     
-    
+    
+      
+      
+             
       A callback function that is executed when the request completes.
     
   
diff --git a/entries/lt-selector.xml b/entries/lt-selector.xml
index d301f11d..b85b5f77 100644
--- a/entries/lt-selector.xml
+++ b/entries/lt-selector.xml
@@ -11,7 +11,7 @@
   
     :lt(-index)
     1.8
-    
+    
       Zero-based index, counting backwards from the last element. 
     
   
diff --git a/entries/map.xml b/entries/map.xml
index 6fbe68d7..55a87d83 100644
--- a/entries/map.xml
+++ b/entries/map.xml
@@ -3,7 +3,10 @@
   .map()
   
     1.2
-    
+    
+        
+        
+        
       A function object that will be invoked for each element in the current set.
     
   
diff --git a/entries/mousedown.xml b/entries/mousedown.xml
index 5f663575..51186203 100644
--- a/entries/mousedown.xml
+++ b/entries/mousedown.xml
@@ -4,8 +4,9 @@
   Bind an event handler to the "mousedown" JavaScript event, or trigger that event on an element.
   
     1.0
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/mouseenter.xml b/entries/mouseenter.xml
index c90a8a03..72acea07 100644
--- a/entries/mouseenter.xml
+++ b/entries/mouseenter.xml
@@ -4,8 +4,9 @@
   Bind an event handler to be fired when the mouse enters an element, or trigger that handler on an element.
   
     1.0
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/mouseleave.xml b/entries/mouseleave.xml
index e7fd4c49..af7f8589 100644
--- a/entries/mouseleave.xml
+++ b/entries/mouseleave.xml
@@ -4,8 +4,9 @@
   Bind an event handler to be fired when the mouse leaves an element, or trigger that handler on an element.
   
     1.0
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/mousemove.xml b/entries/mousemove.xml
index a0e1a46a..56943fd4 100644
--- a/entries/mousemove.xml
+++ b/entries/mousemove.xml
@@ -4,8 +4,9 @@
   Bind an event handler to the "mousemove" JavaScript event, or trigger that event on an element.
   
     1.0
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/mouseout.xml b/entries/mouseout.xml
index a84b825f..844d886f 100644
--- a/entries/mouseout.xml
+++ b/entries/mouseout.xml
@@ -4,8 +4,9 @@
   Bind an event handler to the "mouseout" JavaScript event, or trigger that event on an element.
   
     1.0
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/mouseover.xml b/entries/mouseover.xml
index 016ad3d5..1ddfd9e5 100644
--- a/entries/mouseover.xml
+++ b/entries/mouseover.xml
@@ -4,8 +4,9 @@
   Bind an event handler to the "mouseover" JavaScript event, or trigger that event on an element.
   
     1.0
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/mouseup.xml b/entries/mouseup.xml
index 018ea304..6006ea69 100644
--- a/entries/mouseup.xml
+++ b/entries/mouseup.xml
@@ -4,8 +4,9 @@
   Bind an event handler to the "mouseup" JavaScript event, or trigger that event on an element.
   
     1.0
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/not.xml b/entries/not.xml
index def00389..dec089f6 100644
--- a/entries/not.xml
+++ b/entries/not.xml
@@ -15,13 +15,16 @@
   
   
     1.4
-    
+    
       A function used as a test for each element in the set. this is the current DOM element.
+      
+      
+            
     
   
   
     1.4
-    
+    
       An existing jQuery object to match the current set of elements against.
     
   
diff --git a/entries/off.xml b/entries/off.xml
index 78ab983b..b83e3868 100644
--- a/entries/off.xml
+++ b/entries/off.xml
@@ -10,8 +10,9 @@
     
       A selector which should match the one originally passed to .on() when attaching event handlers.
     
-    
+    
       A handler function previously attached for the event(s), or the special value false.
+      
     
   
   
diff --git a/entries/offset.xml b/entries/offset.xml
index 2b10ef34..9b1a0093 100644
--- a/entries/offset.xml
+++ b/entries/offset.xml
@@ -87,7 +87,10 @@ $( "*", document.body ).click(function( event ) {
     
     
       1.4
-      
+      
+        
+        
+           
         A function to return the coordinates to set. Receives the index of the element in the collection as the first argument and the current coordinates as the second argument. The function should return an object with the new top and left properties.
       
     
diff --git a/entries/on.xml b/entries/on.xml
index a322724e..a875aa37 100644
--- a/entries/on.xml
+++ b/entries/on.xml
@@ -13,8 +13,9 @@
     
       Data to be passed to the handler in event.data when an event is triggered.
     
-    
+    
       A function to execute when the event is triggered. The value false is also allowed as a shorthand for a function that simply does return false.
+      
     
   
   
diff --git a/entries/one.xml b/entries/one.xml
index 8f55d4aa..f923fe0a 100644
--- a/entries/one.xml
+++ b/entries/one.xml
@@ -10,8 +10,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute at the time the event is triggered.
+      
     
   
   
@@ -25,8 +26,9 @@
     
       Data to be passed to the handler in event.data when an event is triggered.
     
-    
+    
       A function to execute when the event is triggered. The value false is also allowed as a shorthand for a function that simply does return false.
+      
     
   
   
diff --git a/entries/prepend.xml b/entries/prepend.xml
index ca783d51..e1a2b548 100644
--- a/entries/prepend.xml
+++ b/entries/prepend.xml
@@ -20,7 +20,14 @@
   
   
     1.4
-    
+    
+      
+      
+      
+        
+        
+                
+           
       A function that returns an HTML string, DOM element(s), or jQuery object to insert at the beginning of each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, this refers to the current element in the set.
     
   
diff --git a/entries/prop.xml b/entries/prop.xml
index 541f788f..423e2c11 100644
--- a/entries/prop.xml
+++ b/entries/prop.xml
@@ -3,6 +3,7 @@
   Get the value of a property for the first element in the set of matched elements or set one or more properties for every matched element.
   
     
+    
     
     .prop()
     
@@ -132,7 +133,18 @@ $( "input" ).change(function() {
       
         The name of the property to set.
       
-      
+      
+      
+      
+        
+        
+                        
+      
+      
+        
+        
+                
+              
         A function returning the value to set. Receives the index position of the element in the set and the old property value as arguments. Within the function, the keyword this refers to the current element.
       
     
diff --git a/entries/queue.xml b/entries/queue.xml
index b5d512af..08c5f09a 100644
--- a/entries/queue.xml
+++ b/entries/queue.xml
@@ -80,7 +80,8 @@ showIt();
       
         A string containing the name of the queue. Defaults to fx, the standard effects queue.
       
-      
+      
+        
         The new function to add to the queue, with a function to call that will dequeue the next item.
       
     
diff --git a/entries/removeClass.xml b/entries/removeClass.xml
index d172f88e..8bb11196 100644
--- a/entries/removeClass.xml
+++ b/entries/removeClass.xml
@@ -9,7 +9,10 @@
   
   
     1.4
-    
+    
+      
+      
+      
       A function returning one or more space-separated class names to be removed. Receives the index position of the element in the set and the old class value as arguments.
     
   
diff --git a/entries/resize.xml b/entries/resize.xml
index f7c9c2dd..280ff015 100644
--- a/entries/resize.xml
+++ b/entries/resize.xml
@@ -4,8 +4,9 @@
   Bind an event handler to the "resize" JavaScript event, or trigger that event on an element.
   
     1.0
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/scroll.xml b/entries/scroll.xml
index 080ecdc9..1f0e6454 100644
--- a/entries/scroll.xml
+++ b/entries/scroll.xml
@@ -4,8 +4,9 @@
   Bind an event handler to the "scroll" JavaScript event, or trigger that event on an element.
   
     1.0
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/select.xml b/entries/select.xml
index cb0cc4e8..44e51043 100644
--- a/entries/select.xml
+++ b/entries/select.xml
@@ -4,8 +4,9 @@
   Bind an event handler to the "select" JavaScript event, or trigger that event on an element.
   
     1.0
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/submit.xml b/entries/submit.xml
index ec3c5025..38ee1f06 100644
--- a/entries/submit.xml
+++ b/entries/submit.xml
@@ -4,8 +4,9 @@
   Bind an event handler to the "submit" JavaScript event, or trigger that event on an element.
   
     1.0
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
@@ -13,8 +14,9 @@
     
       An object containing data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   
diff --git a/entries/text.xml b/entries/text.xml
index 8ba40495..3752dd10 100644
--- a/entries/text.xml
+++ b/entries/text.xml
@@ -61,7 +61,10 @@ $( "p:last" ).html( str );
     
     
       1.4
-      
+      
+        
+        
+                
         A function returning the text content to set. Receives the index position of the element in the set and the old text value as arguments.
       
     
diff --git a/entries/toggle-event.xml b/entries/toggle-event.xml
index ed329adb..a095eace 100644
--- a/entries/toggle-event.xml
+++ b/entries/toggle-event.xml
@@ -4,14 +4,17 @@
   Bind two or more handlers to the matched elements, to be executed on alternate clicks.
   
     1.0
-    
+    
       A function to execute every even time the element is clicked.
+      
     
-    
+    
       A function to execute every odd time the element is clicked.
+      
     
-    
+    
       Additional handlers to cycle through after clicks.
+      
     
   
   
diff --git a/entries/toggleClass.xml b/entries/toggleClass.xml
index 9fcb5a94..a4516652 100644
--- a/entries/toggleClass.xml
+++ b/entries/toggleClass.xml
@@ -24,7 +24,11 @@
   
   
     1.4
-    
+    
+      
+      
+      
+        
       A function that returns class names to be toggled in the class attribute of each element in the matched set. Receives the index position of the element in the set, the old class value, and the switch as arguments.
     
     
diff --git a/entries/unbind.xml b/entries/unbind.xml
index 19a3d8a0..f7f61514 100644
--- a/entries/unbind.xml
+++ b/entries/unbind.xml
@@ -7,8 +7,9 @@
     
       A string containing a JavaScript event type, such as click or submit.
     
-    
+    
       The function that is to be no longer executed.
+      
     
   
   
diff --git a/entries/undelegate.xml b/entries/undelegate.xml
index 460410d5..842a504a 100644
--- a/entries/undelegate.xml
+++ b/entries/undelegate.xml
@@ -22,8 +22,9 @@
     
       A string containing a JavaScript event type, such as "click" or "keydown"
     
-    
+    
       A function to execute at the time the event is triggered.
+      
     
   
   
diff --git a/entries/unload.xml b/entries/unload.xml
index 077ec6fc..9fc62283 100644
--- a/entries/unload.xml
+++ b/entries/unload.xml
@@ -3,8 +3,9 @@
   .unload()
   
     1.0
-    
+    
       A function to execute when the event is triggered.
+      
     
   
   
@@ -12,8 +13,9 @@
     
       A plain object of data that will be passed to the event handler.
     
-    
+    
       A function to execute each time the event is triggered.
+      
     
   
   Bind an event handler to the "unload" JavaScript event.
diff --git a/entries/val.xml b/entries/val.xml
index 9285a546..27cbc392 100644
--- a/entries/val.xml
+++ b/entries/val.xml
@@ -112,7 +112,10 @@ $( "input" )
     
     
       1.4
-      
+      
+        
+             
+                 
         A function returning the value to set. this is the current element. Receives the index position of the element in the set and the old value as arguments.
       
     
diff --git a/entries/width.xml b/entries/width.xml
index 27ac3a0d..bbef2fd0 100644
--- a/entries/width.xml
+++ b/entries/width.xml
@@ -86,7 +86,13 @@ $("#getw").click(function() {
     
     
       1.4.1
-      
+      
+        
+             
+        
+          
+                    
+                  
         A function returning the width to set. Receives the index position of the element in the set and the old width as arguments. Within the function, this refers to the current element in the set.
       
     
diff --git a/entries/wrap.xml b/entries/wrap.xml
index 1f8f2f91..02bce46c 100644
--- a/entries/wrap.xml
+++ b/entries/wrap.xml
@@ -13,8 +13,13 @@
   
   
     1.4
-    
+    
       A callback function returning the HTML content or jQuery object to wrap around the matched elements. Receives the index position of the element in the set as an argument. Within the function, this refers to the current element in the set.
+      
+      
+        
+        
+      
     
   
   Wrap an HTML structure around each element in the set of matched elements.
diff --git a/entries/wrapInner.xml b/entries/wrapInner.xml
index a3e1ef49..6a459161 100644
--- a/entries/wrapInner.xml
+++ b/entries/wrapInner.xml
@@ -9,8 +9,10 @@
   
   
     1.4
-    
+    
       A callback function which generates a structure to wrap around the content of the matched elements. Receives the index position of the element in the set as an argument. Within the function, this refers to the current element in the set.
+      
+      
     
   
   Wrap an HTML structure around the content of each element in the set of matched elements.

From edf0730d4a5ac67af00ee2f911e1d5a706bdee6e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Olav=20Junker=20Kj=C3=A6r?= 
Date: Sat, 17 May 2014 15:17:38 +0200
Subject: [PATCH 057/699] prop: Change values to Anything type

Fixes gh-496
Closes gh-497
---
 entries/prop.xml | 23 +++++------------------
 1 file changed, 5 insertions(+), 18 deletions(-)

diff --git a/entries/prop.xml b/entries/prop.xml
index 423e2c11..adccbc85 100644
--- a/entries/prop.xml
+++ b/entries/prop.xml
@@ -2,9 +2,7 @@
 
   Get the value of a property for the first element in the set of matched elements or set one or more properties for every matched element.
   
-    
-    
-    
+    
     .prop()
     
       1.6
@@ -115,10 +113,7 @@ $( "input" ).change(function() {
       
         The name of the property to set.
       
-      
-        
-        
-        
+      
         A value to set for the property.
       
     
@@ -134,17 +129,9 @@ $( "input" ).change(function() {
         The name of the property to set.
       
       
-      
-      
-        
-        
-                        
-      
-      
-        
-        
-                
-              
+        
+        
+        
         A function returning the value to set. Receives the index position of the element in the set and the old property value as arguments. Within the function, the keyword this refers to the current element.
       
     

From 005432107ba30fb140d7cb8b26f12204ae2daaa9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Mon, 26 May 2014 11:41:57 -0400
Subject: [PATCH 058/699] 1.11.10

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 47d187f9..49b27803 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.9",
+  "version": "1.11.10",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From f0bfb23213dff4e27de020ec3530b138e23f3881 Mon Sep 17 00:00:00 2001
From: Usman Akeju 
Date: Mon, 2 Jun 2014 20:19:28 +0200
Subject: [PATCH 059/699] Types: Document "Anything" virtual type

Ref gh-391
Closes gh-504
---
 pages/Types.html | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/pages/Types.html b/pages/Types.html
index 5a4f10d6..073fd0aa 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -35,6 +35,7 @@
 
          
 
          Contents
          
 
            
+  
          1. Anything
   
          2. String
     
          
 
+
           Anything 
          
+
          The Anything virtual type is used in jQuery documentation to indicate that any type can be used or should be expected.
+
          
+
 
           String 
          
 
          A string in JavaScript is an immutable object that contains none, one or many characters.
 
          

From d0f0b6d95a3ee33beac33c7652788b34bd33b221 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Tue, 27 May 2014 13:43:34 -0400
Subject: [PATCH 060/699] Build: Update license

Closes gh-502
---
 LICENSE-MIT.txt => LICENSE.txt | 27 ++++++++++++++++++++++++---
 1 file changed, 24 insertions(+), 3 deletions(-)
 rename LICENSE-MIT.txt => LICENSE.txt (60%)

diff --git a/LICENSE-MIT.txt b/LICENSE.txt
similarity index 60%
rename from LICENSE-MIT.txt
rename to LICENSE.txt
index 27ec7f48..01839718 100644
--- a/LICENSE-MIT.txt
+++ b/LICENSE.txt
@@ -1,9 +1,15 @@
-Copyright (c) 2009 Packt Publishing, http://packtpub.com/
-Copyright (c) 2013 jQuery Foundation, https://jquery.org/
+Copyright 2009 Packt Publishing, http://packtpub.com/
+Copyright 2012, 2014 jQuery Foundation and other contributors,
+https://jquery.org/
 
 This software consists of voluntary contributions made by many
 individuals. For exact contribution history, see the revision history
-and logs, available at https://github.com/jquery/api.jquery.com
+available at https://github.com/jquery/api.jquery.com
+
+The following license applies to all parts of this software except as
+documented below:
+
+====
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the
@@ -23,3 +29,18 @@ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
 LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
 OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+====
+
+Copyright and related rights for sample code are waived via CC0. Sample
+code is defined as all source code displayed within the prose of the
+documentation and all examples and demos.
+
+CC0: http://creativecommons.org/publicdomain/zero/1.0/
+
+====
+
+All files located in the node_modules directory are externally
+maintained libraries used by this software which have their own
+licenses; we recommend you read them, as their terms may differ from the
+terms above.

From 630f90bb079d2bad992cd15358f453b10b0ae9be Mon Sep 17 00:00:00 2001
From: Usman Akeju 
Date: Sat, 5 Jul 2014 17:21:43 -0400
Subject: [PATCH 061/699] jQuery.browser: Mark as removed. Closes gh-513

---
 entries/jQuery.browser.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/entries/jQuery.browser.xml b/entries/jQuery.browser.xml
index fe0f3add..e7c690ac 100644
--- a/entries/jQuery.browser.xml
+++ b/entries/jQuery.browser.xml
@@ -48,6 +48,7 @@ $.browser.msie;
     
     
     
+    
             
   
     

From 8ad0c6021786795dda56743a435c70ce4beb3ba8 Mon Sep 17 00:00:00 2001
From: Markus Staab 
Date: Sat, 5 Jul 2014 17:48:28 -0400
Subject: [PATCH 062/699] .ajaxError(): parameter name in example  -> . Closes
 #439

---
 entries/ajaxError.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/ajaxError.xml b/entries/ajaxError.xml
index fbee691d..d13f71e6 100644
--- a/entries/ajaxError.xml
+++ b/entries/ajaxError.xml
@@ -36,7 +36,7 @@ $( "button.trigger" ).on( "click", function() {
     
          As of jQuery 1.8, the .ajaxError() method should only be attached to document.
          
     
          All ajaxError handlers are invoked, regardless of what Ajax request was completed. To differentiate between the requests, use the parameters passed to the handler. Each time an ajaxError handler is executed, it is passed the event object, the jqXHR object (prior to jQuery 1.5, the XHR object), and the settings object that was used in the creation of the request. When an HTTP error occurs, the fourth argument (thrownError) receives the textual portion of the HTTP status, such as "Not Found" or "Internal Server Error." For example, to restrict the error callback to only handling events dealing with a particular URL:
          
     
          
-$( document ).ajaxError(function( event, jqxhr, settings, exception ) {
+$( document ).ajaxError(function( event, jqxhr, settings, thrownError ) {
   if ( settings.url == "ajax/missing.html" ) {
     $( "div.log" ).text( "Triggered ajaxError handler." );
   }

From 4418ffc682b1513be5f30ed0fa6f66c06062dba1 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sat, 5 Jul 2014 18:43:10 -0400
Subject: [PATCH 063/699] jQuery.ajax(): data option can also be an Array.
 Closes #480

---
 entries/jQuery.ajax.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index 3b70d572..33f985de 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -61,6 +61,7 @@ $.ajax({
       
         
         
+        
         Data to be sent to the server. It is converted to a query string, if not already a string. It's appended to the url for GET-requests. See processData option to prevent this automatic processing. Object must be Key/Value pairs. If value is an Array, jQuery serializes multiple values with same key based on the value of the traditional setting (described below).
       
       

From 03710c0966cf50d7e7801dc8db49b9f67813b590 Mon Sep 17 00:00:00 2001
From: John Reilly 
Date: Sat, 5 Jul 2014 18:46:35 -0400
Subject: [PATCH 064/699] ajaxComplete(): responseXML -> responseText. Closes
 #483

---
 entries/ajaxComplete.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/ajaxComplete.xml b/entries/ajaxComplete.xml
index 3ff3b58c..7f045973 100644
--- a/entries/ajaxComplete.xml
+++ b/entries/ajaxComplete.xml
@@ -38,11 +38,11 @@ $( ".trigger" ).click(function() {
 $( document ).ajaxComplete(function( event, xhr, settings ) {
   if ( settings.url === "ajax/test.html" ) {
     $( ".log" ).text( "Triggered ajaxComplete handler. The result is " +
-      xhr.responseHTML );
+      xhr.responseText );
   }
 });
     
          
-    
          Note: You can get the returned ajax contents by looking at xhr.responseXML or xhr.responseHTML for xml and html respectively.
          
+    
          Note: You can get the returned ajax contents by looking at xhr.responseText.
          
   
   
   

From 517615b8277305af5fd4546d9062ceadaa93c18a Mon Sep 17 00:00:00 2001
From: Konstantin 
Date: Sat, 5 Jul 2014 18:55:34 -0400
Subject: [PATCH 065/699] jQuery.ajax(): Note settings that could trigger a
 preflight OPTIONS request. Closes #488

---
 entries/jQuery.ajax.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index 33f985de..9ebf3145 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -38,7 +38,7 @@
         An object of string/regular-expression pairs that determine how jQuery will parse the response, given its content type.
       
       
-        When sending data to the server, use this content type. Default is "application/x-www-form-urlencoded; charset=UTF-8", which is fine for most cases. If you explicitly pass in a content-type to $.ajax(), then it is always sent to the server (even if no data is sent). The W3C XMLHttpRequest specification dictates that the charset is always UTF-8; specifying another charset will not force the browser to change the encoding.
+        When sending data to the server, use this content type. Default is "application/x-www-form-urlencoded; charset=UTF-8", which is fine for most cases. If you explicitly pass in a content-type to $.ajax(), then it is always sent to the server (even if no data is sent). The W3C XMLHttpRequest specification dictates that the charset is always UTF-8; specifying another charset will not force the browser to change the encoding. Note: For cross-domain requests, setting the content type to anything other than application/x-www-form-urlencoded, multipart/form-data, or text/plain will trigger the browser to send a preflight OPTIONS request to the server.
       
       
         This object will be made the context of all Ajax-related callbacks. By default, the context is an object that represents the ajax settings used in the call ($.ajaxSettings merged with the settings passed to $.ajax). For example,  specifying a DOM element as the context will make that the context for the complete callback of a request, like so:

From cec12dfc344e2ad501db4077ae638055b76665f1 Mon Sep 17 00:00:00 2001
From: Tom Fuertes 
Date: Sat, 5 Jul 2014 19:53:17 -0400
Subject: [PATCH 066/699] one(): Fix description of behavior for delegated
 .one() events. Closes #489

---
 entries/one.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/one.xml b/entries/one.xml
index f923fe0a..3b53235e 100644
--- a/entries/one.xml
+++ b/entries/one.xml
@@ -50,7 +50,7 @@ $( "#foo" ).one( "click", function() {
   alert( "This will be displayed only once." );
 });
 $( "body" ).one( "click", "#foo", function() {
-  alert( "This displays if #foo is the first thing clicked in the body." );
+  alert( "This displays the first time #foo is clicked in the body." );
 });
     
          
     
          After the code is executed, a click on the element with ID foo will display the alert. Subsequent clicks will do nothing. This code is equivalent to:
          

From 7fe431e681ae60fa2effae50c97db0a1f96079ac Mon Sep 17 00:00:00 2001
From: Trent Larson 
Date: Sat, 5 Jul 2014 22:11:25 -0400
Subject: [PATCH 067/699] Types page: add 'hour' to the Date param list. Closes
 #485

---
 pages/Types.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pages/Types.html b/pages/Types.html
index 073fd0aa..b003f444 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -433,7 +433,7 @@ 
           Date 
          
 
          
 new Date();
 
          
-
          To create a Date object for an alternative date and time, pass numeric arguments in the following order: year, month, day, minute, second, millisecond — although note that the month is zero-based, whereas the other arguments are one-based. The following creates a Date object representing January 1st, 2014, at 8:15.
+
          To create a Date object for an alternative date and time, pass numeric arguments in the following order: year, month, day, hour, minute, second, millisecond — although note that the month is zero-based, whereas the other arguments are one-based. The following creates a Date object representing January 1st, 2014, at 8:15.
 
          
 
          
 new Date( 2014, 0, 1, 8, 15 );

From bffd21edd5d6fe7addafb7651e5877fad079e318 Mon Sep 17 00:00:00 2001
From: Nick Bottomley 
Date: Sat, 5 Jul 2014 22:14:02 -0400
Subject: [PATCH 068/699] deferred.notifyWith(): second argument takes Array.
 Closes #461

---
 entries/deferred.notifyWith.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/deferred.notifyWith.xml b/entries/deferred.notifyWith.xml
index 79c845ef..add312b8 100644
--- a/entries/deferred.notifyWith.xml
+++ b/entries/deferred.notifyWith.xml
@@ -8,9 +8,9 @@
         Context passed to the progressCallbacks as the this object.
       
     
-    
+    
       
-        Optional arguments that are passed to the progressCallbacks.
+        An optional array of arguments that are passed to the progressCallbacks.
       
     
   

From 6efa8ef5eb09d29492ec9a552ad2cdbee978528a Mon Sep 17 00:00:00 2001
From: Timo Tijhof 
Date: Sun, 6 Jul 2014 15:24:46 -0400
Subject: [PATCH 069/699] attribute-contains-selector: Remove odd word from
 desc Fixes #507. Closes #508

---
 entries/attribute-contains-selector.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/attribute-contains-selector.xml b/entries/attribute-contains-selector.xml
index 691b3f4e..8cb21dfc 100644
--- a/entries/attribute-contains-selector.xml
+++ b/entries/attribute-contains-selector.xml
@@ -11,7 +11,7 @@
       An attribute value. Can be either an unquoted single word or a quoted string.
     
   
-  Selects elements that have the specified attribute with a value containing the a given substring.
+  Selects elements that have the specified attribute with a value containing a given substring.
   
     
          This is the most generous of the jQuery attribute selectors that match against a value. It will select an element if the selector's string appears anywhere within the element's attribute value. Compare this selector with the Attribute Contains Word selector (e.g. [attr~="word"]), which is more appropriate in many cases.
          
             

From 3306dc702f51fd4748e9e51f55ba05c996909c2a Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 6 Jul 2014 15:31:28 -0400
Subject: [PATCH 070/699] jQuery.fx.off(): Remove broken link (error 404).
 Fixes #457. Closes #516

---
 entries/jQuery.fx.off.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.fx.off.xml b/entries/jQuery.fx.off.xml
index ae9b32d3..74bfd60a 100644
--- a/entries/jQuery.fx.off.xml
+++ b/entries/jQuery.fx.off.xml
@@ -9,7 +9,7 @@
     
          When this property is set to true, all animation methods will immediately set elements to their final state when called, rather than displaying an effect. This may be desirable for a couple reasons:
          
     
            
       
          • jQuery is being used on a low-resource device.
            • 
-      
          • Users are encountering accessibility problems with the animations (see the article Turn Off Animation for more information).
            • 
+      
          • Users are encountering accessibility problems with the animations.
            • 
     
          
     
          Animations can be turned back on by setting the property to false.
          
   

From 08e6cefcd6dff6ddd43d2eb8c95b670bbdb708d3 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 6 Jul 2014 15:36:28 -0400
Subject: [PATCH 071/699] .is(): Refer to 2nd argument of function argument.
 Fixes #512. Closes #517

---
 entries/is.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/is.xml b/entries/is.xml
index 2a14f6a3..5595d26a 100644
--- a/entries/is.xml
+++ b/entries/is.xml
@@ -10,7 +10,7 @@
   
     1.6
     
-      A function used as a test for the set of elements. It accepts one argument, index, which is the element's index in the jQuery collection. Within the function, this refers to the current DOM element. 
+      A function used as a test for every element in the set. It accepts two arguments, index, which is the element's index in the jQuery collection, and element, which is the DOM element. Within the function, this refers to the current DOM element.
       
       
             

From 3fc31d08f030a483b5bcd2adf86c5ef5383aab40 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 6 Jul 2014 15:39:35 -0400
Subject: [PATCH 072/699] .not(): Clean up signatures/arguments. Fixes #452.
 Closes #515

---
 entries/not.xml | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/entries/not.xml b/entries/not.xml
index dec089f6..6b5cf416 100644
--- a/entries/not.xml
+++ b/entries/not.xml
@@ -3,14 +3,11 @@
   .not()
   
     1.0
-    
-      A string containing a selector expression to match elements against.
-    
-  
-  
-    1.0
-    
-      One or more DOM elements to remove from the matched set.
+    
+      A string containing a selector expression, a DOM element, or an array of elements to match against the set.
+      
+      
+      
     
   
   

From ebc7dbcf4655d6f39fb661142601c816966620d9 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 6 Jul 2014 15:42:30 -0400
Subject: [PATCH 073/699] .not(): Improve documentation for Function parameter.
 Closes #518

---
 entries/not.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/not.xml b/entries/not.xml
index 6b5cf416..059e5e29 100644
--- a/entries/not.xml
+++ b/entries/not.xml
@@ -13,7 +13,7 @@
   
     1.4
     
-      A function used as a test for each element in the set. this is the current DOM element.
+      A function used as a test for each element in the set. It accepts two arguments, index, which is the element's index in the jQuery collection, and element, which is the DOM element. Within the function, this refers to the current DOM element.
       
       
             

From c08ab1caa1de01a1fee7cb4523051c50b3c8ef0b Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Sun, 6 Jul 2014 15:57:29 -0400
Subject: [PATCH 074/699] Types page: improve wording of Element section

---
 pages/Types.html | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/pages/Types.html b/pages/Types.html
index b003f444..3889f34f 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -582,19 +582,19 @@ 
          Event
          
 
          The standard events in the Document Object Model are: blur, focus,  load, resize, scroll, unload, beforeunload, click, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, and keyup. Since the DOM event names have predefined meanings for some elements, using them for other purposes is not recommended. jQuery's event model can trigger an event by any name on an element, and it is propagated up the DOM tree to which that element belongs, if any.
 
          
 
           Element 
          
-
          An element in the Document Object Model (DOM) has attributes, text and children. It provides methods to traverse the parent and children and to get access to its attributes. Due to a lot of flaws in DOM API specifications and implementations, those methods are no fun to use. jQuery provides a wrapper around those elements to help interacting with the DOM. But often enough you will be working directly with DOM elements, or see methods that (also) accept DOM elements as arguments.
+
          An element in the Document Object Model (DOM) can have attributes, text, and children. It provides methods to traverse the parent and children and to get access to its attributes. Due to inconsistencies in DOM API specifications and implementations, however, those methods can be a challenge to use. jQuery provides a "wrapper" around those elements to help interacting with the DOM. But sometimes you will be working directly with DOM elements, or see methods that (also) accept DOM elements as arguments.
 
          
-
          Whenever you use jQuery's each-method, the context of your callback is set to a DOM element. That is also the case for event handlers.
+
          Whenever you call jQuery's .each() method or one of its event methods on a jQuery collection, the context of the callback function — this — is set to a DOM element.
 
          
-
          Some properties of DOM elements are quite consistent among browsers. Consider this example of a simple on-blur-validation:
+
          Some properties of DOM elements are quite consistent among browsers. Consider this example of a simple onblur validation:
 
          
-
          $( ":text" ).blur(function() {
+
          $( "input[type='text']" ).on( "blur", function() {
   if( !this.value ) {
     alert( "Please enter some text!" );
   }
 });
 
          
-
          You could replace this.value with $(this).val() to access the value of the text input via jQuery, but in that case you don't gain anything.
+
          You could replace this.value with $(this).val() to access the value of the text input via jQuery, but in that case you wouldn't gain anything.
 
          
 
           jQuery 
          
 
          A jQuery object contains a collection of Document Object Model (DOM) elements that have been created from an HTML string or selected from a document. Since jQuery methods often use CSS selectors to match elements from a document, the set of elements in a jQuery object is often called a set of "matched elements" or "selected elements".

From 73f074b4b554633217bd07c91eb52343973917ef Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Sun, 6 Jul 2014 16:07:16 -0400
Subject: [PATCH 075/699] 1.11.11

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 49b27803..4a338267 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.10",
+  "version": "1.11.11",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From 65733cfd6e7cadf5743d8463c7b12c9750d5142c Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 6 Jul 2014 21:38:49 -0400
Subject: [PATCH 076/699] wrapInner(): Add accepted types for the
 wrappingElement argument. Closes #520

---
 entries/wrapInner.xml | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/entries/wrapInner.xml b/entries/wrapInner.xml
index 6a459161..42e0101a 100644
--- a/entries/wrapInner.xml
+++ b/entries/wrapInner.xml
@@ -3,8 +3,12 @@
   .wrapInner()
   
     1.2
-    
+    
       An HTML snippet, selector expression, jQuery object, or DOM element specifying the structure to wrap around the content of the matched elements.
+      
+      
+      
+      
     
   
   

From a1ddea947b273fb6375b035d0f468b32cd661d23 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 7 Jul 2014 09:07:30 -0400
Subject: [PATCH 077/699] wrapAll(): Add missing documentation of the
 possibility to pass a function (since jQuery 1.4). Closes #521

---
 entries/wrapAll.xml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/entries/wrapAll.xml b/entries/wrapAll.xml
index c4c7c49a..80112ca0 100644
--- a/entries/wrapAll.xml
+++ b/entries/wrapAll.xml
@@ -11,6 +11,14 @@
       A selector, element, HTML string, or jQuery object specifying the structure to wrap around the matched elements.
     
   
+  
+    1.4
+    
+      A function that returns a structure to wrap around the matched elements. Receives the index position of the element in the set as an argument. Within the function, this refers to the current element in the set.
+      
+      
+    
+  
   Wrap an HTML structure around all elements in the set of matched elements.
   
     
          The .wrapAll() function can take any string or object that could be passed to the $() function to specify a DOM structure. This structure may be nested several levels deep, but should contain only one inmost element. The structure will be wrapped around all of the elements in the set of matched elements, as a single group.
          

From c46264705e04b873a28043582a692e2d6e41f7f0 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Mon, 7 Jul 2014 09:19:44 -0400
Subject: [PATCH 078/699] 1.11.12

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 4a338267..4d3c5a10 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.11",
+  "version": "1.11.12",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From 9959d69147ea0a7edba9201055363aacba213bda Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?B=2E=20Agust=C3=ADn=20Amenabar=20L?= 
Date: Tue, 8 Jul 2014 17:33:16 -0400
Subject: [PATCH 079/699] jQuery.inArray(): Note that inArray campares values
 strictly. Closes #470

---
 entries/jQuery.inArray.xml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/entries/jQuery.inArray.xml b/entries/jQuery.inArray.xml
index 16e43b60..e7a3ca80 100644
--- a/entries/jQuery.inArray.xml
+++ b/entries/jQuery.inArray.xml
@@ -16,7 +16,9 @@
   Search for a specified value within an array and return its index (or -1 if not found).
   
     
          The $.inArray() method is similar to JavaScript's native .indexOf() method in that it returns -1 when it doesn't find a match. If the first element within the array matches value, $.inArray() returns 0.
          
-    
          Because JavaScript treats 0 as loosely equal to false (i.e. 0 == false, but 0 !== false), if we're checking for the presence of value within array, we need to check if it's not equal to (or greater than) -1.
          
+    
          Because JavaScript treats 0 as loosely equal to false (i.e. 0 == false, but 0 !== false), to check for the presence of value within array, you need to check if it's not equal to (or greater than) -1.
          
+    
          The comparison between values is strict. The following will return -1 (not found) because a number is being searched in an array of strings:
          
+    
          $.inArray( 5 + 5, [ "8", "9", "10", 10 + "" ] );
          
             
   
     Report the index of some elements in the array.

From fd3b18b4a5bcc92b57a481245a0f8d48986730e9 Mon Sep 17 00:00:00 2001
From: Tom Fuertes 
Date: Wed, 9 Jul 2014 22:24:02 -0400
Subject: [PATCH 080/699] one(): Fix description of behavior for delegated
 .one() events. Closes #519

---
 entries/one.xml | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/entries/one.xml b/entries/one.xml
index 3b53235e..1327dbf0 100644
--- a/entries/one.xml
+++ b/entries/one.xml
@@ -44,13 +44,10 @@
     
   
   
-    
          The first form of this method is identical to .bind(), except that the handler is unbound after its first invocation. The second two forms, introduced in jQuery 1.7, are identical to .on() except that the handler is removed after the first time the event occurs at the delegated element, whether the selector matched anything or not. For example:
          
+    
          The  .one() method is identical to  .on(), except that the handler is unbound after its first invocation. For example:
          
     
          
 $( "#foo" ).one( "click", function() {
   alert( "This will be displayed only once." );
-});
-$( "body" ).one( "click", "#foo", function() {
-  alert( "This displays the first time #foo is clicked in the body." );
 });
     
          
     
          After the code is executed, a click on the element with ID foo will display the alert. Subsequent clicks will do nothing. This code is equivalent to:
          

From 07349e4353d9bb629c71894f26e94478bf4f0d17 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Wed, 9 Jul 2014 22:24:47 -0400
Subject: [PATCH 081/699] 1.11.13

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 4d3c5a10..0611958f 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.12",
+  "version": "1.11.13",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From fd64c7c501235c0324f89828d091df60950be43d Mon Sep 17 00:00:00 2001
From: Mike Spangler 
Date: Sat, 12 Jul 2014 11:34:32 -0400
Subject: [PATCH 082/699] added missing parameter in example. closes issue #465

---
 entries/jQuery.ajaxTransport.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.ajaxTransport.xml b/entries/jQuery.ajaxTransport.xml
index ccf5151e..ab8e4d9b 100644
--- a/entries/jQuery.ajaxTransport.xml
+++ b/entries/jQuery.ajaxTransport.xml
@@ -19,7 +19,7 @@
     
          Since each request requires its own transport object instance, transports cannot be registered directly. Therefore, you should provide a function that returns a transport instead.
          
     
          Transports factories are registered using $.ajaxTransport(). A typical registration looks like this:
          
     
          
-$.ajaxTransport(function( options, originalOptions, jqXHR ) {
+$.ajaxTransport( dataType, function( options, originalOptions, jqXHR ) {
   if( /* transportCanHandleRequest */ ) {
     return {
       send: function( headers, completeCallback ) {

From e1a33e0e9f046f6deef01711b1afd1b894805770 Mon Sep 17 00:00:00 2001
From: Matt Lunn 
Date: Sat, 12 Jul 2014 11:39:58 -0400
Subject: [PATCH 083/699] Added notes that replaceWith() and replaceAll()
 remove node data

---
 entries/replaceAll.xml  | 3 ++-
 entries/replaceWith.xml | 1 +
 notes.xsl               | 3 +++
 3 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/entries/replaceAll.xml b/entries/replaceAll.xml
index 8dd9f191..64759e81 100644
--- a/entries/replaceAll.xml
+++ b/entries/replaceAll.xml
@@ -13,7 +13,7 @@
   
   Replace each target element with the set of matched elements.
   
-    
          The .replaceAll() method is corollary to .replaceWith(), but with the source and target reversed. Consider this DOM structure:
          
+    
          The .replaceAll() method is similar to .replaceWith(), but with the source and target reversed. Consider this DOM structure:
          
     
          
 <div class="container">
   <div class="inner first">Hello</div>
@@ -44,6 +44,7 @@ $( ".first" ).replaceAll( ".third" );
     
          
     
          From this example, we can see that the selected element replaces the target by being moved from its old location, not by being cloned.
          
             
+  
   
     Replace all the paragraphs with bold words.
     This example demonstrates that the selected element replaces the target by being moved from its old location, not by being cloned.
          
     
          The .replaceWith() method, like most jQuery methods, returns the jQuery object so that other methods can be chained onto it. However, it must be noted that the original jQuery object is returned. This object refers to the element that has been removed from the DOM, not the new element that has replaced it.
          
   
+  
   
   
     On click, replace the button with a div containing the same word.
diff --git a/notes.xsl b/notes.xsl
index 6f1029d4..6d4ed1fb 100644
--- a/notes.xsl
+++ b/notes.xsl
@@ -7,6 +7,9 @@
 		
 			Prior to jQuery 1.9,  would attempt to add or change nodes in the current jQuery set if the first node in the set was not connected to a document, and in those cases return a new jQuery set rather than the original set. The method might or might not have returned a new result depending on the number or connectedness of its arguments! As of jQuery 1.9, .after(), .before(), and .replaceWith() always return the original unmodified set. Attempting to use these methods on a node without a parent has no effect—that is, neither the set nor the nodes it contains are changed.
 		
+		
+			The  method removes all data and event handlers associated with the removed nodes.
+		
 		
 			Selected elements are in the order of their appearance in the document.
 		

From 9cd7cee4c6cae7a277d1d16e4e1b5a3493f00f27 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Sat, 12 Jul 2014 11:42:29 -0400
Subject: [PATCH 084/699] 1.11.14

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 0611958f..7ec6f18b 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.13",
+  "version": "1.11.14",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From bed527e567095c668f77ef44f5f0d429c66a5aca Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 13 Jul 2014 08:49:38 -0400
Subject: [PATCH 085/699] jQuery(): Fix small typo. Closes #525

---
 entries/jQuery.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.xml b/entries/jQuery.xml
index 9fb438b1..ad58d2c7 100644
--- a/entries/jQuery.xml
+++ b/entries/jQuery.xml
@@ -175,7 +175,7 @@ $( myForm.elements ).hide();
       
          For explicit parsing of a string to HTML, use the $.parseHTML() method.
          
       
          By default, elements are created with an ownerDocument matching the document into which the jQuery library was loaded. Elements being injected into a different document should be created using that document, e.g., $("<p>hello iframe</p>", $("#myiframe").prop("contentWindow").document).
          
       
          If the HTML is more complex than a single tag without attributes, as it is in the above example, the actual creation of the elements is handled by the browser's innerHTML mechanism. In most cases, jQuery creates a new <div> element and sets the innerHTML property of the element to the HTML snippet that was passed in. When the parameter has a single tag (with optional closing tag or quick-closing) — $( "<img />" ) or $( "<img>" ), $( "<a></a>" ) or $( "<a>" ) — jQuery creates the element using the native JavaScript createElement() function.
          
-      
          When passing in complex HTML, some browsers may not generate a DOM that exactly replicates the HTML source provided. As mentioned, jQuery uses the browser"s .innerHTML property to parse the passed HTML and insert it into the current document. During this process, some  browsers filter out certain elements such as  <html>,  <title>, or  <head> elements. As a result, the  elements inserted may not be representative of the original string  passed.
          
+      
          When passing in complex HTML, some browsers may not generate a DOM that exactly replicates the HTML source provided. As mentioned, jQuery uses the browser's .innerHTML property to parse the passed HTML and insert it into the current document. During this process, some browsers filter out certain elements such as <html>, <title>, or <head> elements. As a result, the elements inserted may not be representative of the original string passed.
          
       
          Filtering isn't, however, limited to these tags. For example, Internet Explorer prior to version 8 will also convert all href properties on links to absolute URLs, and Internet Explorer prior to version 9 will not correctly handle HTML5 elements without the addition of a separate compatibility layer.
          
       
          To ensure cross-platform compatibility, the snippet must be well-formed. Tags that can contain other elements should be paired with a closing tag:
          
       
          $( "<a href='http://jquery.com'></a>" );
          

From 03fcbfbd17b494cc1122b6727adfcd8101b0ea9b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Fri, 18 Jul 2014 10:09:34 -0400
Subject: [PATCH 086/699] Build: Upgrade to grunt-jquery-content 0.11.2

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 7ec6f18b..0e6061d4 100644
--- a/package.json
+++ b/package.json
@@ -24,7 +24,7 @@
     "grunt": "0.3.17",
     "grunt-clean": "0.3.0",
     "grunt-wordpress": "1.0.7",
-    "grunt-jquery-content": "0.11.0",
+    "grunt-jquery-content": "0.11.2",
     "grunt-check-modules": "0.1.0"
   },
   "devDependencies": {},

From 3cb7ccfb21eb842305e8e6f4738a2292147af4b1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Thu, 24 Jul 2014 12:00:19 -0400
Subject: [PATCH 087/699] Build: Upgrade to grunt-jquery-content 0.11.3

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 0e6061d4..be48f017 100644
--- a/package.json
+++ b/package.json
@@ -24,7 +24,7 @@
     "grunt": "0.3.17",
     "grunt-clean": "0.3.0",
     "grunt-wordpress": "1.0.7",
-    "grunt-jquery-content": "0.11.2",
+    "grunt-jquery-content": "0.11.3",
     "grunt-check-modules": "0.1.0"
   },
   "devDependencies": {},

From 10f0f86ebc2219a5522ff8e5b6b2fc4ac52670d0 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Tue, 5 Aug 2014 08:06:33 -0400
Subject: [PATCH 088/699] visible selector: Add note that option elements are
 always considered hidden. Closes #522

---
 entries/visible-selector.xml | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/entries/visible-selector.xml b/entries/visible-selector.xml
index 59fc4b42..28a716fb 100644
--- a/entries/visible-selector.xml
+++ b/entries/visible-selector.xml
@@ -9,8 +9,9 @@
   
     
          Elements are considered visible if they consume space in the document. Visible elements have a width or height that is greater than zero.
          
     
          Elements with visibility: hidden or opacity: 0 are considered visible, since they still consume space in the layout.
          
-    
          Elements that are not in a document are considered to be hidden; jQuery does not have a way to know if they will be visible when appended to a document since it depends on the applicable styles.
          
-    
          During animations that hide an element, the element is considered to be visible until the end of the animation. During animations to show an element, the element is considered to be visible at the start at the animation.
          
+    
          Elements that are not in a document are considered hidden; jQuery does not have a way to know if they will be visible when appended to a document since it depends on the applicable styles.
          
+    
          All option elements are considered hidden, regardless of their selected state.
          
+    
          During animations that hide an element, the element is considered visible until the end of the animation. During animations to show an element, the element is considered visible at the start at the animation.
          
     
          How :visible is calculated was changed in jQuery 1.3.2. The release notes outline the changes in more detail.
          
             
   

From 62e06654e896f53f676020c05dbc6617fdf0d1dd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Tue, 19 Aug 2014 16:56:03 -0400
Subject: [PATCH 089/699] Build: Upgrade to grunt-jquery-content 0.12.0

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index be48f017..c596290b 100644
--- a/package.json
+++ b/package.json
@@ -24,7 +24,7 @@
     "grunt": "0.3.17",
     "grunt-clean": "0.3.0",
     "grunt-wordpress": "1.0.7",
-    "grunt-jquery-content": "0.11.3",
+    "grunt-jquery-content": "0.12.0",
     "grunt-check-modules": "0.1.0"
   },
   "devDependencies": {},

From b2173569981481cafd0f2f78cea6cc9e62c5f216 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Tue, 19 Aug 2014 16:56:06 -0400
Subject: [PATCH 090/699] 1.11.15

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index c596290b..15fce595 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.14",
+  "version": "1.11.15",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From 536292ca835a44c20a107894f468bd3cfd8bd8ca Mon Sep 17 00:00:00 2001
From: Andy Li 
Date: Tue, 19 Aug 2014 22:40:13 -0400
Subject: [PATCH 091/699] innerWidth(): Specify the signature of the function
 argument.

---
 entries/innerWidth.xml | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/entries/innerWidth.xml b/entries/innerWidth.xml
index c2e30f3d..1e5c2bf6 100644
--- a/entries/innerWidth.xml
+++ b/entries/innerWidth.xml
@@ -50,8 +50,14 @@ $( "p:last" ).text( "innerWidth:" + p.innerWidth() );
 
 
   1.8.0
-  
-	A function returning the inner width (including padding but not border) to set. Receives the index position of the element in the set and the old inner width as arguments. Within the function, this refers to the current element in the set.
+  
+        
+        
+        
+          
+          
+        
+        A function returning the inner width (including padding but not border) to set. Receives the index position of the element in the set and the old inner width as arguments. Within the function, this refers to the current element in the set.
   
 
 Set the CSS inner width of each element in the set of matched elements.

From 9d78f2d17b3083c323c406273e07b4962334358a Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Tue, 19 Aug 2014 22:42:28 -0400
Subject: [PATCH 092/699] innerHeight(): Add documentation for innerHeight as
 setter

---
 entries/innerHeight.xml | 69 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)

diff --git a/entries/innerHeight.xml b/entries/innerHeight.xml
index d8b71770..a7cd3eec 100644
--- a/entries/innerHeight.xml
+++ b/entries/innerHeight.xml
@@ -1,4 +1,7 @@
 
+
+  Get the current computed inner height (including padding but not border) for the first element in the set of matched elements or set the inner height of every matched element.
+
 
   .innerHeight()
   
@@ -36,3 +39,69 @@ $( "p:last" ).text( "innerHeight:" + p.innerHeight() );
   
   
 
+
+
+
+  1.8.0
+  
+  
+  
+  A number representing the number of pixels, or a number along with an optional unit of measure appended (as a string).
+  
+
+
+  1.8.0
+  
+    
+    
+    
+      
+      
+    
+    A function returning the inner height (including padding but not border) to set. Receives the index position of the element in the set and the old inner height as arguments. Within the function, this refers to the current element in the set.
+  
+
+Set the CSS inner height of each element in the set of matched elements.
+
+  
          When calling .innerHeight("value"), the value can be either a string (number and unit) or a number. If only a number is provided for the value, jQuery assumes a pixel unit. If a string is provided, however, any valid CSS measurement may be used for the height (such as 100px, 50%, or auto). Note that in modern browsers, the CSS height property does not include padding, border, or margin, unless the box-sizing CSS property is used.
          
+  
          If no explicit unit is specified (like "em" or "%") then "px" is assumed.
          
+          
+
+  Change the inner height of each div the first time it is clicked (and change its color).
+  
+  
+  d
          
+
          d
          
+
          d
          
+
          d
          
+
          d
          
+]]>
+
+
+
+
+
+          
+
+

From d8ee9fa661c543f8e74bfb0b50f021aa9a0062c5 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Tue, 19 Aug 2014 22:44:12 -0400
Subject: [PATCH 093/699] 1.11.16

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 15fce595..dc01a78e 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.15",
+  "version": "1.11.16",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From 821f0199223d82a1d8d6cec3bd924e0477792c1b Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Wed, 20 Aug 2014 10:47:37 -0400
Subject: [PATCH 094/699] jQuery.ajax(): Uppercase 'JSONP'

---
 entries/jQuery.ajax.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index 9ebf3145..fd4d1878 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -95,7 +95,7 @@ $.ajax({
         Allow the current environment to be recognized as "local," (e.g. the filesystem), even if jQuery does not recognize it as such by default. The following protocols are currently recognized as local: file, *-extension, and widget. If the isLocal setting needs modification, it is recommended to do so once in the $.ajaxSetup() method.  
       
       
-        Override the callback function name in a jsonp request.  This value will be used instead of 'callback' in the 'callback=?' part of the query string in the url.  So {jsonp:'onJSONPLoad'} would result in 'onJSONPLoad=?' passed to the server. As of jQuery 1.5, setting the jsonp option to false prevents jQuery from adding the "?callback" string to the URL or attempting to use "=?" for transformation. In this case, you should also explicitly set the jsonpCallback setting. For example, { jsonp: false, jsonpCallback: "callbackName" }
+        Override the callback function name in a JSONP request.  This value will be used instead of 'callback' in the 'callback=?' part of the query string in the url.  So {jsonp:'onJSONPLoad'} would result in 'onJSONPLoad=?' passed to the server. As of jQuery 1.5, setting the jsonp option to false prevents jQuery from adding the "?callback" string to the URL or attempting to use "=?" for transformation. In this case, you should also explicitly set the jsonpCallback setting. For example, { jsonp: false, jsonpCallback: "callbackName" }
       
       
         

From 7f5293d8a5cc257009d8cd05e30c8bcc2696ad4a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Thu, 21 Aug 2014 08:19:03 -0400
Subject: [PATCH 095/699] innerHeight: Fix typo

---
 entries/innerHeight.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/innerHeight.xml b/entries/innerHeight.xml
index a7cd3eec..cf9bb667 100644
--- a/entries/innerHeight.xml
+++ b/entries/innerHeight.xml
@@ -53,7 +53,7 @@ $( "p:last" ).text( "innerHeight:" + p.innerHeight() );
   1.8.0
   
     
-    
+    
     
       
       

From a1e3a17bbad3c2d01f3f26ec73644bfcb19d8a8e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Thu, 21 Aug 2014 08:19:33 -0400
Subject: [PATCH 096/699] 1.11.17

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index dc01a78e..53e488d4 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.16",
+  "version": "1.11.17",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From 6f40df9ce96abfaca77f052b494102b302eac1a5 Mon Sep 17 00:00:00 2001
From: John Ryding 
Date: Sun, 24 Aug 2014 14:13:33 -0400
Subject: [PATCH 097/699] callbacks.has(): Make argument optional and clarify
 description. Closes #453

---
 entries/callbacks.has.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/callbacks.has.xml b/entries/callbacks.has.xml
index 44c65247..401c9d85 100644
--- a/entries/callbacks.has.xml
+++ b/entries/callbacks.has.xml
@@ -3,11 +3,11 @@
   callbacks.has()
   
     1.7
-    
+    
       The callback to search for.
     
   
-  Determine whether a supplied callback is in a list
+  Determine whether or not the list has any callbacks attached. If a callback is provided as an argument, determine whether it is in a list.
   
   
     Use callbacks.has() to check if a callback list contains a specific callback:

From 51636241f0dfe953b3d9a088e46a85f492cbefaf Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 24 Aug 2014 14:17:03 -0400
Subject: [PATCH 098/699] find(): Merge two similar signatures introduced in
 the same version. Closes #555.

---
 entries/find.xml | 12 ++++--------
 1 file changed, 4 insertions(+), 8 deletions(-)

diff --git a/entries/find.xml b/entries/find.xml
index 16c1d799..b6a82654 100644
--- a/entries/find.xml
+++ b/entries/find.xml
@@ -9,14 +9,10 @@
   
   
     1.6
-    
-      A jQuery object to match elements against.
-    
-  
-  
-    1.6
-    
-      An element to match elements against.
+    
+      An element or a jQuery object to match elements against.
+      
+      
     
   
   Get the descendants of each element in the current set of matched elements, filtered by a selector, jQuery object, or element.

From d408dd2ea8c6ce8f7bd1a0c87cb805865d1179de Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Sun, 24 Aug 2014 14:33:48 -0400
Subject: [PATCH 099/699] Event docs: eventData argument can accept "Anything."
 Fixes #556

---
 entries/bind.xml       | 4 ++--
 entries/blur.xml       | 2 +-
 entries/change.xml     | 2 +-
 entries/click.xml      | 2 +-
 entries/dblclick.xml   | 2 +-
 entries/delegate.xml   | 2 +-
 entries/error.xml      | 2 +-
 entries/focus.xml      | 2 +-
 entries/focusin.xml    | 2 +-
 entries/focusout.xml   | 2 +-
 entries/keydown.xml    | 2 +-
 entries/keypress.xml   | 2 +-
 entries/keyup.xml      | 2 +-
 entries/load-event.xml | 2 +-
 entries/mousedown.xml  | 2 +-
 entries/mouseenter.xml | 2 +-
 entries/mouseleave.xml | 2 +-
 entries/mousemove.xml  | 2 +-
 entries/mouseout.xml   | 2 +-
 entries/mouseover.xml  | 2 +-
 entries/mouseup.xml    | 2 +-
 entries/resize.xml     | 2 +-
 entries/scroll.xml     | 2 +-
 entries/select.xml     | 2 +-
 entries/submit.xml     | 2 +-
 entries/unload.xml     | 2 +-
 26 files changed, 27 insertions(+), 27 deletions(-)

diff --git a/entries/bind.xml b/entries/bind.xml
index be20d77c..a81e46a8 100644
--- a/entries/bind.xml
+++ b/entries/bind.xml
@@ -6,7 +6,7 @@
     
       A string containing one or more DOM event types, such as "click" or "submit," or custom event names.
     
-    
+    
       An object containing data that will be passed to the event handler.
     
     
@@ -19,7 +19,7 @@
     
       A string containing one or more DOM event types, such as "click" or "submit," or custom event names.
     
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/blur.xml b/entries/blur.xml
index ddb9bf99..747a7d1e 100644
--- a/entries/blur.xml
+++ b/entries/blur.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/change.xml b/entries/change.xml
index eedea432..4884ff1e 100644
--- a/entries/change.xml
+++ b/entries/change.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/click.xml b/entries/click.xml
index c6a014c1..9be0e863 100644
--- a/entries/click.xml
+++ b/entries/click.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/dblclick.xml b/entries/dblclick.xml
index ec851198..7db082fe 100644
--- a/entries/dblclick.xml
+++ b/entries/dblclick.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/delegate.xml b/entries/delegate.xml
index dd57ffee..e1670e84 100644
--- a/entries/delegate.xml
+++ b/entries/delegate.xml
@@ -23,7 +23,7 @@
     
       A string containing one or more space-separated JavaScript event types, such as "click" or "keydown," or custom event names.
     
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/error.xml b/entries/error.xml
index f93ba9fd..ff4a0ccf 100644
--- a/entries/error.xml
+++ b/entries/error.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/focus.xml b/entries/focus.xml
index 0651faab..96957219 100644
--- a/entries/focus.xml
+++ b/entries/focus.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/focusin.xml b/entries/focusin.xml
index a692e3bb..dd273e67 100644
--- a/entries/focusin.xml
+++ b/entries/focusin.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/focusout.xml b/entries/focusout.xml
index 2d110637..b8ac4373 100644
--- a/entries/focusout.xml
+++ b/entries/focusout.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/keydown.xml b/entries/keydown.xml
index 893be2a7..d18b6011 100644
--- a/entries/keydown.xml
+++ b/entries/keydown.xml
@@ -10,7 +10,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/keypress.xml b/entries/keypress.xml
index 0724c1bf..bd4fcbf2 100644
--- a/entries/keypress.xml
+++ b/entries/keypress.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/keyup.xml b/entries/keyup.xml
index 517d94b9..2d523041 100644
--- a/entries/keyup.xml
+++ b/entries/keyup.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/load-event.xml b/entries/load-event.xml
index b8e48626..d95f81bc 100644
--- a/entries/load-event.xml
+++ b/entries/load-event.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/mousedown.xml b/entries/mousedown.xml
index 51186203..98f03d33 100644
--- a/entries/mousedown.xml
+++ b/entries/mousedown.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/mouseenter.xml b/entries/mouseenter.xml
index 72acea07..ae59e888 100644
--- a/entries/mouseenter.xml
+++ b/entries/mouseenter.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/mouseleave.xml b/entries/mouseleave.xml
index af7f8589..25ed2dc7 100644
--- a/entries/mouseleave.xml
+++ b/entries/mouseleave.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/mousemove.xml b/entries/mousemove.xml
index 56943fd4..240f92c3 100644
--- a/entries/mousemove.xml
+++ b/entries/mousemove.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/mouseout.xml b/entries/mouseout.xml
index 844d886f..664e2164 100644
--- a/entries/mouseout.xml
+++ b/entries/mouseout.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/mouseover.xml b/entries/mouseover.xml
index 1ddfd9e5..d8e8b0b0 100644
--- a/entries/mouseover.xml
+++ b/entries/mouseover.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/mouseup.xml b/entries/mouseup.xml
index 6006ea69..80d0f619 100644
--- a/entries/mouseup.xml
+++ b/entries/mouseup.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/resize.xml b/entries/resize.xml
index 280ff015..53b2a4cf 100644
--- a/entries/resize.xml
+++ b/entries/resize.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/scroll.xml b/entries/scroll.xml
index 1f0e6454..372d6c64 100644
--- a/entries/scroll.xml
+++ b/entries/scroll.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/select.xml b/entries/select.xml
index 44e51043..597c0f1d 100644
--- a/entries/select.xml
+++ b/entries/select.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/submit.xml b/entries/submit.xml
index 38ee1f06..28666420 100644
--- a/entries/submit.xml
+++ b/entries/submit.xml
@@ -11,7 +11,7 @@
   
   
     1.4.3
-    
+    
       An object containing data that will be passed to the event handler.
     
     
diff --git a/entries/unload.xml b/entries/unload.xml
index 9fc62283..e7c12492 100644
--- a/entries/unload.xml
+++ b/entries/unload.xml
@@ -10,7 +10,7 @@
   
   
     1.4.3
-    
+    
       A plain object of data that will be passed to the event handler.
     
     

From 500f05eccd7c5a48803db6dba19f592fef34cc36 Mon Sep 17 00:00:00 2001
From: Matt 
Date: Thu, 28 Aug 2014 09:03:04 -0400
Subject: [PATCH 100/699] jQuery(): Document change in jQuery( html ) behavior
 as of 1.9. Minor style fixes. Closes #531

---
 entries/jQuery.xml | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/entries/jQuery.xml b/entries/jQuery.xml
index ad58d2c7..fc13219d 100644
--- a/entries/jQuery.xml
+++ b/entries/jQuery.xml
@@ -173,8 +173,8 @@ $( myForm.elements ).hide();
       
          If a string is passed as the parameter to $(), jQuery examines the string to see if it looks like HTML (i.e., it starts with <tag ... >). If not, the string is interpreted as a selector expression, as explained above. But if the string appears to be an HTML snippet, jQuery attempts to create new DOM elements as described by the HTML. Then a jQuery object is created and returned that refers to these elements. You can perform any of the usual jQuery methods on this object:
          
       
          $( "<p id='test'>My <em>new</em> text</p>" ).appendTo( "body" );
          
       
          For explicit parsing of a string to HTML, use the $.parseHTML() method.
          
-      
          By default, elements are created with an ownerDocument matching the document into which the jQuery library was loaded. Elements being injected into a different document should be created using that document, e.g., $("<p>hello iframe</p>", $("#myiframe").prop("contentWindow").document).
          
-      
          If the HTML is more complex than a single tag without attributes, as it is in the above example, the actual creation of the elements is handled by the browser's innerHTML mechanism. In most cases, jQuery creates a new <div> element and sets the innerHTML property of the element to the HTML snippet that was passed in. When the parameter has a single tag (with optional closing tag or quick-closing) — $( "<img />" ) or $( "<img>" ), $( "<a></a>" ) or $( "<a>" ) — jQuery creates the element using the native JavaScript createElement() function.
          
+      
          By default, elements are created with an .ownerDocument matching the document into which the jQuery library was loaded. Elements being injected into a different document should be created using that document, e.g., $("<p>hello iframe</p>", $("#myiframe").prop("contentWindow").document).
          
+      
          If the HTML is more complex than a single tag without attributes, as it is in the above example, the actual creation of the elements is handled by the browser's .innerHTML mechanism. In most cases, jQuery creates a new <div> element and sets the innerHTML property of the element to the HTML snippet that was passed in. When the parameter has a single tag (with optional closing tag or quick-closing) — $( "<img />" ) or $( "<img>" ), $( "<a></a>" ) or $( "<a>" ) — jQuery creates the element using the native JavaScript .createElement() function.
          
       
          When passing in complex HTML, some browsers may not generate a DOM that exactly replicates the HTML source provided. As mentioned, jQuery uses the browser's .innerHTML property to parse the passed HTML and insert it into the current document. During this process, some browsers filter out certain elements such as <html>, <title>, or <head> elements. As a result, the elements inserted may not be representative of the original string passed.
          
       
          Filtering isn't, however, limited to these tags. For example, Internet Explorer prior to version 8 will also convert all href properties on links to absolute URLs, and Internet Explorer prior to version 9 will not correctly handle HTML5 elements without the addition of a separate compatibility layer.
          
       
          To ensure cross-platform compatibility, the snippet must be well-formed. Tags that can contain other elements should be paired with a closing tag:
          
@@ -184,14 +184,14 @@ $( myForm.elements ).hide();
 $( "<img>" );
 $( "<input>" );
       
          
-      
          When passing HTML to jQuery(), please also note that text nodes are not treated as DOM elements. With the exception of a few methods (such as .content()), they are generally otherwise ignored or removed. E.g:
          
+      
          When passing HTML to jQuery(), note that text nodes are not treated as DOM elements. With the exception of a few methods (such as .content()), they are generally ignored or removed. E.g:
          
       
          
-var el = $( "1<br>2<br>3" ); // returns [<br>, "2", <br>]
-el = $( "1<br>2<br>3 >" ); // returns [<br>, "2", <br>, "3 &gt;"]
+var el = $( "<br>2<br>3" ); // returns [<br>, "2", <br>]
+el = $( "<br>2<br>3 >" ); // returns [<br>, "2", <br>, "3 &gt;"]
       
          
-      
          This behavior is expected. 
          
-      
          As of jQuery 1.4, the second argument to jQuery() can accept a plain object consisting of a superset of the properties that can be passed to the .attr() method.
          
-      
          Important: If the second argument is passed, the HTML string in the first argument must represent a a simple element with no attributes. As of jQuery 1.4, any event type can be passed in, and the following jQuery methods can be called: val, css, html, text, data, width, height, or offset.
          
+      
          This behavior is expected. As of jQuery 1.9.0 (and unless using the jQuery Migrate plugin), jQuery() requires the HTML string to start with a < (i.e text nodes cannot appear at the front of the HTML string).
          
+      
          As of jQuery 1.4, the second argument to jQuery() can accept a plain object consisting of a superset of the properties that can be passed to the .attr() method.
          
+      
          Important: If the second argument is passed, the HTML string in the first argument must represent a simple element with no attributes. As of jQuery 1.4, any event type can be passed in, and the following jQuery methods can be called: val, css, html, text, data, width, height, or offset.
          
       
          As of jQuery 1.8, any jQuery instance method (a method of jQuery.fn) can be used as a property of the object passed to the second parameter:
          
       
          
 $( "
          ", {

From 1b41725878f0c5b3a0c1872204cb04c272799059 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Thu, 28 Aug 2014 09:27:12 -0400
Subject: [PATCH 101/699] 1.11.18

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 53e488d4..478553bd 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.17",
+  "version": "1.11.18",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From 44c1990c3a69a174f28a758a842a6ff8b24d414d Mon Sep 17 00:00:00 2001
From: Alex Monk 
Date: Thu, 11 Sep 2014 15:02:37 -0500
Subject: [PATCH 102/699] Types page: Remove extra space from beginning of
 'load' DOM event

---
 pages/Types.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pages/Types.html b/pages/Types.html
index 3889f34f..e30e97e2 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -579,7 +579,7 @@ 
          Event
          
 
          
 
          Those properties are all documented, and accompanied by examples, on the Event object page.
 
          
-
          The standard events in the Document Object Model are: blur, focus,  load, resize, scroll, unload, beforeunload, click, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, and keyup. Since the DOM event names have predefined meanings for some elements, using them for other purposes is not recommended. jQuery's event model can trigger an event by any name on an element, and it is propagated up the DOM tree to which that element belongs, if any.
+
          The standard events in the Document Object Model are: blur, focus, load, resize, scroll, unload, beforeunload, click, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, and keyup. Since the DOM event names have predefined meanings for some elements, using them for other purposes is not recommended. jQuery's event model can trigger an event by any name on an element, and it is propagated up the DOM tree to which that element belongs, if any.
 
          
 
           Element 
          
 
          An element in the Document Object Model (DOM) can have attributes, text, and children. It provides methods to traverse the parent and children and to get access to its attributes. Due to inconsistencies in DOM API specifications and implementations, however, those methods can be a challenge to use. jQuery provides a "wrapper" around those elements to help interacting with the DOM. But sometimes you will be working directly with DOM elements, or see methods that (also) accept DOM elements as arguments.

From 8592feba7790c8b6195298192f00f119fdeb3dc0 Mon Sep 17 00:00:00 2001
From: Matt 
Date: Thu, 11 Sep 2014 15:37:06 -0500
Subject: [PATCH 103/699] jQuery.when(): Clarify multiple deferred behavior and
 provide example. Closes #545

---
 entries/jQuery.when.xml | 36 ++++++++++++++++++++++++++++++++----
 1 file changed, 32 insertions(+), 4 deletions(-)

diff --git a/entries/jQuery.when.xml b/entries/jQuery.when.xml
index 3a147ab2..e28819e3 100644
--- a/entries/jQuery.when.xml
+++ b/entries/jQuery.when.xml
@@ -9,20 +9,48 @@
   
   Provides a way to execute callback functions based on one or more objects, usually Deferred objects that represent asynchronous events.
   
-    
          If a single Deferred is passed to jQuery.when, its Promise object (a subset of the Deferred methods) is returned by the method. Additional methods of the Promise object can be called to attach callbacks, such as deferred.then. When the Deferred is resolved or rejected, usually by the code that created the Deferred originally, the appropriate callbacks will be called. For example, the jqXHR object returned by jQuery.ajax() is a Promise and can be used this way:
          
+    
          If a single Deferred is passed to jQuery.when(), its Promise object (a subset of the Deferred methods) is returned by the method. Additional methods of the Promise object can be called to attach callbacks, such as deferred.then. When the Deferred is resolved or rejected, usually by the code that created the Deferred originally, the appropriate callbacks will be called. For example, the jqXHR object returned by jQuery.ajax() is a Promise and can be used this way:
          
     
          
 $.when( $.ajax( "test.aspx" ) ).then(function( data, textStatus, jqXHR ) {
   alert( jqXHR.status ); // Alerts 200
 });
     
          
-    
          If a single argument is passed to jQuery.when and it is not a Deferred or a Promise, it will be treated as a resolved Deferred and any doneCallbacks attached will be executed immediately. The doneCallbacks are passed the original argument. In this case any failCallbacks you might set are never called since the Deferred is never rejected. For example:
          
+    
          If a single argument is passed to jQuery.when() and it is not a Deferred or a Promise, it will be treated as a resolved Deferred and any doneCallbacks attached will be executed immediately. The doneCallbacks are passed the original argument. In this case any failCallbacks you might set are never called since the Deferred is never rejected. For example:
          
     
          
 $.when( { testing: 123 } ).done(function( x ) {
   alert( x.testing ); // Alerts "123"
 });
     
          
-    
          In the case where multiple Deferred objects are passed to jQuery.when, the method returns the Promise from a new "master" Deferred object that tracks the aggregate state of all the Deferreds it has been passed. The method will resolve its master Deferred as soon as all the Deferreds resolve, or reject the master Deferred as soon as one of the Deferreds is rejected. If the master Deferred is resolved, it is passed the resolved values of all the Deferreds that were passed to jQuery.when. For example, when the Deferreds are jQuery.ajax() requests, the arguments will be the jqXHR objects for the requests, in the order they were given in the argument list.
          
-    
          In the multiple-Deferreds case where one of the Deferreds is rejected, jQuery.when immediately fires the failCallbacks for its master Deferred. Note that some of the Deferreds may still be unresolved at that point. If you need to perform additional processing for this case, such as canceling any unfinished ajax requests, you can keep references to the underlying jqXHR objects in a closure and inspect/cancel them in the failCallback.
          
+    
          In the case where multiple Deferred objects are passed to jQuery.when(), the method returns the Promise from a new "master" Deferred object that tracks the aggregate state of all the Deferreds it has been passed. The method will resolve its master Deferred as soon as all the Deferreds resolve, or reject the master Deferred as soon as one of the Deferreds is rejected. If the master Deferred is resolved, the doneCallbacks for the master Deferred are executed. The arguments passed to the doneCallbacks provide the resolved values for each of the Deferreds, and matches the order the Deferreds were passed to jQuery.when(). For example:
          
+    
          
+var d1 = new $.Deferred();
+var d2 = new $.Deferred();
+
+$.when( d1, d2 ).done(function ( v1, v2 ) {
+    console.log( v1 ); // "Fish"
+    console.log( v2 ); // "Pizza"
+});
+
+d1.resolve( "Fish" );
+d2.resolve( "Pizza" );
+    
          
+    
          In the event a Deferred was resolved with no value, the corresponding doneCallback argument will be undefined. If a Deferred resolved to a single value, the corresponding argument will hold that value. In the case where a Deferred resolved to multiple values, the corresponding argument will be an array of those values. For example:
          
+    
          
+var d1 = new $.Deferred();
+var d2 = new $.Deferred();
+var d3 = new $.Deferred();
+
+$.when( d1, d2, d3 ).done(function ( v1, v2, v3 ) {
+    console.log( v1 ); // v1 is undefined
+    console.log( v2 ); // v2 is "abc"
+    console.log( v3 ); // v3 is an array [ 1, 2, 3, 4, 5 ]
+});
+
+d1.resolve();
+d2.resolve( "abc" );
+d3.resolve( 1, 2, 3, 4, 5 );
+    
          
+    
          In the multiple-Deferreds case where one of the Deferreds is rejected, jQuery.when() immediately fires the failCallbacks for its master Deferred. Note that some of the Deferreds may still be unresolved at that point. The arguments passed to the failCallbacks match the signature of the failCallback for the Deferred that was rejected. If you need to perform additional processing for this case, such as canceling any unfinished ajax requests, you can keep references to the underlying jqXHR objects in a closure and inspect/cancel them in the failCallback.
          
   
   
     Execute a function after two ajax requests are successful. (See the jQuery.ajax() documentation for a complete description of success and error cases for an ajax request).

From bb5a21d6215d229190182b52bd77ffc98d046e23 Mon Sep 17 00:00:00 2001
From: Matt 
Date: Thu, 11 Sep 2014 15:59:02 -0500
Subject: [PATCH 104/699] Remove recommendation that removeData() is the same
 as data("key", undefined). Closes #542.

---
 entries/data.xml        | 7 ++++---
 entries/jQuery.data.xml | 7 ++++---
 entries/removeData.xml  | 9 ++++++---
 notes.xsl               | 9 ++++++---
 4 files changed, 20 insertions(+), 12 deletions(-)

diff --git a/entries/data.xml b/entries/data.xml
index 560f49d5..67fa35be 100644
--- a/entries/data.xml
+++ b/entries/data.xml
@@ -8,8 +8,8 @@
       
         A string naming the piece of data to set.
       
-      
-        The new data value; it can be any Javascript type including Array or Object.
+      
+        The new data value; this can be any Javascript type except undefined.
       
     
     
@@ -30,10 +30,11 @@ $( "body" ).data( "foo" ); // 52
 $( "body" ).data(); // { foo: 52, bar: { myType: "test", count: 40 }, baz: [ 1, 2, 3 ] }
       
          
       
          In jQuery 1.4.3 setting an element's data object with .data(obj) extends the data previously stored with that element. jQuery itself uses the .data() method to save information under the names 'events' and 'handle', and also reserves any data name starting with an underscore ('_') for internal use.
          
-      
          Prior to jQuery 1.4.3 (starting in jQuery 1.4) the .data() method completely replaced all data, instead of just extending the data object. If you are using third-party plugins it may not be advisable to completely replace the element's data object, since plugins may have also set data.
          
+      
          Prior to jQuery 1.4.3 (starting in jQuery 1.4) the .data() method completely replaced all data, instead of just extending the data object. If you are using third-party plugins it may not be advisable to completely replace the element's data object, since plugins may have also set data.
          
       
          Due to the way browsers interact with plugins and external code, the .data() method cannot be used on <object> (unless it's a Flash plugin), <applet> or <embed> elements.
          
               
     
+    
     
       Store then retrieve a value from the div element.
       
         A string naming the piece of data to set.
       
-      
-        The new data value.
+      
+        The new data value; this can be any Javascript type except undefined.
       
     
     Store arbitrary data associated with the specified element. Returns the value that was set.
@@ -23,8 +23,9 @@
 jQuery.data( document.body, "foo", 52 );
 jQuery.data( document.body, "bar", "test" );
          -

          Note: this method currently does not provide cross-platform support for setting data on XML documents, as Internet Explorer does not allow data to be attached via expando properties.

           + + Store then retrieve a value from the div element. Remove a previously-stored piece of data. -

          The .removeData() method allows us to remove values that were previously set using .data(). When called with the name of a key, .removeData() deletes that particular value; when called with no arguments, all values are removed. Removing data from jQuery's internal .data() cache does not affect any HTML5 data- attributes in a document; use .removeAttr() to remove those.

          -

          When using .removeData("name"), jQuery will attempt to locate a data- attribute on the element if no property by that name is in the internal data cache. To avoid a re-query of the data- attribute, set the name to a value of either null or undefined (e.g. .data("name", undefined)) rather than using .removeData().

          +

          The .removeData() method allows us to remove values that were previously set using .data(). When called with the name of a key, .removeData() deletes that particular value. When called with no arguments, .removeData() removes all values.

          +

          + Note that .removeData() will only remove data from jQuery's internal .data() cache, and any corresponding data- attributes on the element will not be removed. A later call to data() + will therefore re-retrieve the value from the data- attribute. To prevent this, use .removeAttr() alongside .removeData() to remove the data- attribute as well. Prior to jQuery 1.4.3, + as data() did not use data- attributes, this was not an issue. +

          As of jQuery 1.7, when called with an array of keys or a string of space-separated keys, .removeData() deletes the value of each key in that array or string.

          -

          As of jQuery 1.4.3, calling .removeData() will cause the value of the property being removed to revert to the value of the data attribute of the same name in the DOM, rather than being set to undefined.

           Set a data store for 2 names then remove one of them. diff --git a/notes.xsl b/notes.xsl index 6d4ed1fb..7c1c0c9a 100644 --- a/notes.xsl +++ b/notes.xsl @@ -1,15 +1,15 @@ + + undefined is not recognised as a data value. Calls such as ( , undefined ) will return the corresponding data for "name", and is therefore the same as ( ). + The numbers returned by dimensions-related APIs, including , may be fractional in some cases. Code should not assume it is an integer. Also, dimensions may be incorrect when the page is zoomed by the user; browsers do not expose an API to detect this condition. Prior to jQuery 1.9, would attempt to add or change nodes in the current jQuery set if the first node in the set was not connected to a document, and in those cases return a new jQuery set rather than the original set. The method might or might not have returned a new result depending on the number or connectedness of its arguments! As of jQuery 1.9, .after(), .before(), and .replaceWith() always return the original unmodified set. Attempting to use these methods on a node without a parent has no effect—that is, neither the set nor the nodes it contains are changed. - - The method removes all data and event handlers associated with the removed nodes. - Selected elements are in the order of their appearance in the document. @@ -34,6 +34,9 @@ Since the .live() method handles events once they have propagated to the top of the document, it is not possible to stop propagation of live events. Similarly, events handled by .delegate() will propagate to the elements to which they are delegated; event handlers bound on any elements below it in the DOM tree will already have been executed by the time the delegated event handler is called. These handlers, therefore, may prevent the delegated handler from triggering by calling event.stopPropagation() or returning false. + + The method removes all data and event handlers associated with the removed nodes. + Due to browser security restrictions, most "Ajax" requests are subject to the same origin policy; the request can not successfully retrieve data from a different domain, subdomain, port, or protocol. From 9bf9b1f98402081bd3d1fcfd7e71fa0deaeb120b Mon Sep 17 00:00:00 2001 From: Matt Date: Thu, 11 Sep 2014 16:06:37 -0500 Subject: [PATCH 105/699] Dimensions methods: Note that various height/width methods may return inaccurate value if parent is hidden. Fixes #469. Closes #544. --- entries/height.xml | 5 +++-- entries/innerHeight.xml | 1 + entries/innerWidth.xml | 1 + entries/outerHeight.xml | 1 + entries/outerWidth.xml | 1 + entries/width.xml | 9 +++++---- notes.xsl | 5 ++++- 7 files changed, 16 insertions(+), 7 deletions(-) diff --git a/entries/height.xml b/entries/height.xml index 8808ac6c..9d4b86bc 100644 --- a/entries/height.xml +++ b/entries/height.xml @@ -25,7 +25,8 @@ $( document ).height();

          Note: Although style and script tags will report a value for .width() or height() when absolutely positioned and given display:block, it is strongly discouraged to call those methods on these tags. In addition to being a bad practice, the results may also prove unreliable.

           - + + Show various heights. Note the values are from the iframe so might be smaller than you expected. The yellow highlight shows the iframe body. - + A function returning the height to set. Receives the index position of the element in the set and the old height as arguments. Within the function, this refers to the current element in the set. diff --git a/entries/innerHeight.xml b/entries/innerHeight.xml index cf9bb667..6b689d47 100644 --- a/entries/innerHeight.xml +++ b/entries/innerHeight.xml @@ -16,6 +16,7 @@

          + Get the innerHeight of a paragraph. + Get the innerWidth of a paragraph. + Get the outerHeight of a paragraph. + Get the outerWidth of a paragraph. Note: Although style and script tags will report a value for .width() or height() when absolutely positioned and given display:block, it is strongly discouraged to call those methods on these tags. In addition to being a bad practice, the results may also prove unreliable.

          - + + Show various widths. Note the values are from the iframe so might be smaller than you expected. The yellow highlight shows the iframe body. 1.4.1 - + - - + + A function returning the width to set. Receives the index position of the element in the set and the old width as arguments. Within the function, this refers to the current element in the set. diff --git a/notes.xsl b/notes.xsl index 7c1c0c9a..756cedf7 100644 --- a/notes.xsl +++ b/notes.xsl @@ -5,7 +5,7 @@ undefined is not recognised as a data value. Calls such as ( , undefined ) will return the corresponding data for "name", and is therefore the same as ( ). - The numbers returned by dimensions-related APIs, including , may be fractional in some cases. Code should not assume it is an integer. Also, dimensions may be incorrect when the page is zoomed by the user; browsers do not expose an API to detect this condition. + The number returned by dimensions-related APIs, including , may be fractional in some cases. Code should not assume it is an integer. Also, dimensions may be incorrect when the page is zoomed by the user; browsers do not expose an API to detect this condition. Prior to jQuery 1.9, would attempt to add or change nodes in the current jQuery set if the first node in the set was not connected to a document, and in those cases return a new jQuery set rather than the original set. The method might or might not have returned a new result depending on the number or connectedness of its arguments! As of jQuery 1.9, .after(), .before(), and .replaceWith() always return the original unmodified set. Attempting to use these methods on a node without a parent has no effect—that is, neither the set nor the nodes it contains are changed. @@ -16,6 +16,9 @@ Forms and their child elements should not use input names or ids that conflict with properties of a form, such as submit, length, or method. Name conflicts can cause confusing failures. For a complete list of rules and to check your markup for these problems, see DOMLint. + + The value reported by is not guaranteed to be accurate when the element's parent is hidden. To get an accurate value, you should show the parent first, before using . + Because is a jQuery extension and not part of the CSS specification, queries using cannot take advantage of the performance boost provided by the native DOM querySelectorAll() method. To achieve the best performance when using to select elements, first select the elements using a pure CSS selector, then use .filter(""). From a607d538976c90bf197bfb25f329c72a60d8a1cb Mon Sep 17 00:00:00 2001 From: Richard Gibson Date: Thu, 11 Sep 2014 16:19:15 -0500 Subject: [PATCH 106/699] serializeArray(): Improve description of valid input elements. Ref jQuery #15191. Closes #536. --- entries/serializeArray.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/entries/serializeArray.xml b/entries/serializeArray.xml index a86f1373..bc46e920 100644 --- a/entries/serializeArray.xml +++ b/entries/serializeArray.xml @@ -6,7 +6,7 @@ Encode a set of form elements as an array of names and values. -

          The .serializeArray() method creates a JavaScript array of objects, ready to be encoded as a JSON string. It operates on a jQuery object representing a set of form elements. The form elements can be of several types:

          +

          The .serializeArray() method creates a JavaScript array of objects, ready to be encoded as a JSON string. It operates on a jQuery collection of forms and/or form controls. The controls can be of several types:

          
 <form>
   <div><input type="text" name="a" value="1" id="a"></div>
@@ -29,7 +29,7 @@
 </form>

          The .serializeArray() method uses the standard W3C rules for successful controls to determine which elements it should include; in particular the element cannot be disabled and must contain a name attribute. No submit button value is serialized since the form was not submitted using a button. Data from file select elements is not serialized.

          -

          This method can act on a jQuery object that has selected individual form elements, such as <input>, <textarea>, and <select>. However, it is typically easier to select the <form> tag itself for serialization:

          +

          This method can act on a jQuery object that has selected individual form controls, such as <input>, <textarea>, and <select>. However, it is typically easier to select the <form> element itself for serialization:

          
 $( "form" ).submit(function( event ) {
   console.log( $( this ).serializeArray() );

From 8b84cc453e52a2b16c7c11642a2bba48693c35af Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Thu, 11 Sep 2014 16:27:00 -0500
Subject: [PATCH 107/699] 1.11.19

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 478553bd..6a3fe702 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.18",
+  "version": "1.11.19",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From c2c633afcd8bd4704afcc951afb904e1cc473e9b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Sat, 13 Sep 2014 14:17:17 -0500
Subject: [PATCH 108/699] Build: Upgrade to grunt-wordpress 1.1.0 and
 grunt-jquery-content 0.12.1

---
 package.json | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/package.json b/package.json
index 6a3fe702..f6960c5a 100644
--- a/package.json
+++ b/package.json
@@ -23,8 +23,8 @@
   "dependencies": {
     "grunt": "0.3.17",
     "grunt-clean": "0.3.0",
-    "grunt-wordpress": "1.0.7",
-    "grunt-jquery-content": "0.12.0",
+    "grunt-wordpress": "1.1.0",
+    "grunt-jquery-content": "0.12.1",
     "grunt-check-modules": "0.1.0"
   },
   "devDependencies": {},

From 95f96adc190342d32213cc5367c651bd261386a3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Sat, 13 Sep 2014 16:37:28 -0500
Subject: [PATCH 109/699] 1.11.20

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index f6960c5a..930b7619 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.19",
+  "version": "1.11.20",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From 8d5ed5bc77e86a31897d8e58fa1f3c26eb586bfb Mon Sep 17 00:00:00 2001
From: Matt 
Date: Fri, 12 Sep 2014 09:25:56 -0500
Subject: [PATCH 110/699] on(): Document that on() accepts .trigger() args.
 Fixes #472. Closes #538.

---
 entries/on.xml | 31 +++++++++++++++++++++++++------
 1 file changed, 25 insertions(+), 6 deletions(-)

diff --git a/entries/on.xml b/entries/on.xml
index a875aa37..eeab0009 100644
--- a/entries/on.xml
+++ b/entries/on.xml
@@ -16,6 +16,7 @@
     
       A function to execute when the event is triggered. The value false is also allowed as a shorthand for a function that simply does return false.
       
+      
     
   
   
@@ -63,7 +64,7 @@ function notify() {
 }
 $( "button" ).on( "click", notify );
          -

          When the browser triggers an event or other JavaScript calls jQuery's .trigger() method, jQuery passes the handler an event object it can use to analyze and change the status of the event. This object is a normalized subset of data provided by the browser; the browser's unmodified native event object is available in event.originalEvent. For example, event.type contains the event name (e.g., "resize") and event.target indicates the deepest (innermost) element where the event occurred.

          +

          When the browser triggers an event or other JavaScript calls jQuery's .trigger() method, jQuery passes the handler an Event object it can use to analyze and change the status of the event. This object is a normalized subset of data provided by the browser; the browser's unmodified native event object is available in event.originalEvent. For example, event.type contains the event name (e.g., "resize") and event.target indicates the deepest (innermost) element where the event occurred.

          By default, most events bubble up from the original event target to the document element. At each element along the way, jQuery calls any matching event handlers that have been attached. A handler can prevent the event from bubbling further up the document tree (and thus prevent handlers on those elements from running) by calling event.stopPropagation(). Any other handlers attached on the current element will run however. To prevent that, call event.stopImmediatePropagation(). (Event handlers bound to an element are called in the same order that they were bound.)

          Similarly, a handler can call event.preventDefault() to cancel any default action that the browser may have for this event; for example, the default action on a click event is to follow the link. Not all browser events have default actions, and not all default actions can be canceled. See the W3C Events Specification for details.

          Returning false from an event handler will automatically call event.stopPropagation() and event.preventDefault(). A false value can also be passed for the handler as a shorthand for function(){ return false; }. So, $( "a.disabled" ).on( "click", false ); attaches an event handler to all links with class "disabled" that prevents them from being followed when they are clicked and also stops the event from bubbling.

          @@ -83,7 +84,7 @@ $( "button" ).on( "click", { }, greet );

          The above code will generate two different alerts when the button is clicked.

          -

          As an alternative or in addition to the data argument provided to the .on() method, you can also pass data to an event handler using a second argument to .trigger() or .triggerHandler().

          +

          As an alternative or in addition to the data argument provided to the .on() method, you can also pass data to an event handler using a second argument to .trigger() or .triggerHandler(). Data provided this way is passed to the event handler as further parameters after the Event object. If an array was passed to the second argument of .trigger() or .triggerHandler(), each element in the array will be presented to the event handler as an individual parameter.

          Event performance

          In most cases, an event such as click occurs infrequently and performance is not a significant concern. However, high frequency events such as mousemove or scroll can fire dozens of times per second, and in those cases it becomes more important to use events judiciously. Performance can be increased by reducing the amount of work done in the handler itself, caching information needed by the handler rather than recalculating it, or by rate-limiting the number of actual page updates using setTimeout.

          Attaching many delegated event handlers near the top of the document tree can degrade performance. Each time the event occurs, jQuery must compare all selectors of all attached events of that type to every element in the path from the event target up to the top of the document. For best performance, attach delegated events at a document location as close as possible to the target elements. Avoid excessive use of document or document.body for delegated events on large documents.

          @@ -120,7 +121,7 @@ $( "form" ).on( "submit", false ); ]]>                     - Cancel only the default action by using .preventDefault(). + Cancel only the default action by using .preventDefault(). - Stop submit events from bubbling without preventing form submit, using .stopPropagation(). + Stop submit events from bubbling without preventing form submit, using .stopPropagation(). + + + Pass data to the event handler using the second argument to .trigger() + + + + Use the the second argument of .trigger() to pass an array of data to the event handler + @@ -196,7 +215,7 @@ $( "div.test" ).on({ ]]> - Click any paragraph to add another after it. Note that .on() allows a click event on any paragraph--even new ones--since the event is handled by the ever-present body element after it bubbles to there. + Click any paragraph to add another after it. Note that .on() allows a click event on any paragraph--even new ones--since the event is handled by the ever-present body element after it bubbles to there. - Cancel a link's default action using the preventDefault method. + Cancel a link's default action using the .preventDefault() method. Date: Wed, 24 Sep 2014 14:56:35 -0400 Subject: [PATCH 111/699] Add missing removed category slugs. Closes gh-557 --- entries/deferred.isRejected.xml | 1 + entries/deferred.isResolved.xml | 1 + entries/selector.xml | 1 + 3 files changed, 3 insertions(+) diff --git a/entries/deferred.isRejected.xml b/entries/deferred.isRejected.xml index ebf93473..5fdd1e95 100644 --- a/entries/deferred.isRejected.xml +++ b/entries/deferred.isRejected.xml @@ -13,4 +13,5 @@ + diff --git a/entries/deferred.isResolved.xml b/entries/deferred.isResolved.xml index fa1a9392..b5941322 100644 --- a/entries/deferred.isResolved.xml +++ b/entries/deferred.isResolved.xml @@ -13,4 +13,5 @@ + diff --git a/entries/selector.xml b/entries/selector.xml index 74ea2326..971a2535 100644 --- a/entries/selector.xml +++ b/entries/selector.xml @@ -12,4 +12,5 @@ + From 9cf8d5f5ba537bb461d94659753097a07f4d18ad Mon Sep 17 00:00:00 2001 From: Karl Swedberg Date: Wed, 24 Sep 2014 15:01:56 -0400 Subject: [PATCH 112/699] 1.11.21 --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 930b7619..d1152a05 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "api.jquery.com", "title": "jQuery API Docs", "description": "API reference documentation for the jQuery JavaScript Library.", - "version": "1.11.20", + "version": "1.11.21", "homepage": "https://github.com/jquery/api.jquery.com", "author": { "name": "jQuery Foundation (https://jquery.org/)" From 21cc6b608b3c22349cc57a5cac5ae418ea6fda4e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= Date: Tue, 30 Sep 2014 15:02:50 -0400 Subject: [PATCH 113/699] Build: Upgrade to grunt-wordpress 1.2.1 and grunt-jquery-content 0.13.0 --- package.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/package.json b/package.json index d1152a05..ca70c3a8 100644 --- a/package.json +++ b/package.json @@ -23,8 +23,8 @@ "dependencies": { "grunt": "0.3.17", "grunt-clean": "0.3.0", - "grunt-wordpress": "1.1.0", - "grunt-jquery-content": "0.12.1", + "grunt-wordpress": "1.2.1", + "grunt-jquery-content": "0.13.0", "grunt-check-modules": "0.1.0" }, "devDependencies": {}, From ae9390d2185b6ef0a53032af8aa4911719878d64 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= Date: Tue, 30 Sep 2014 15:06:01 -0400 Subject: [PATCH 114/699] 1.11.22 --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index ca70c3a8..1b998f3f 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "api.jquery.com", "title": "jQuery API Docs", "description": "API reference documentation for the jQuery JavaScript Library.", - "version": "1.11.21", + "version": "1.11.22", "homepage": "https://github.com/jquery/api.jquery.com", "author": { "name": "jQuery Foundation (https://jquery.org/)" From f9b6ff0fa5e1bba629dc38b39aeb1cd09b49cb5a Mon Sep 17 00:00:00 2001 From: Steve Clay Date: Tue, 30 Sep 2014 14:33:41 -0400 Subject: [PATCH 115/699] add: Make it more obvious that add() doesn't mutate Fixes gh-565 Closes gh-566 --- entries/add.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/entries/add.xml b/entries/add.xml index 1bd30426..04b4a3bc 100644 --- a/entries/add.xml +++ b/entries/add.xml @@ -34,7 +34,7 @@ The point in the document at which the selector should begin matching; similar to the context argument of the $(selector, context) method. - Add elements to the set of matched elements. + Create a new jQuery object with elements added to the set of matched elements.

          Given a jQuery object that represents a set of DOM elements, the .add() method constructs a new jQuery object from the union of those elements and the ones passed into the method. The argument to .add() can be pretty much anything that $() accepts, including a jQuery selector expression, references to DOM elements, or an HTML snippet.

          Do not assume that this method appends the elements to the existing collection in the order they are passed to the .add() method. When all elements are members of the same document, the resulting collection from .add() will be sorted in document order; that is, in order of each element's appearance in the document. If the collection consists of elements from different documents or ones not in any document, the sort order is undefined. To create a jQuery object with elements in a well-defined order and without sorting overhead, use the $(array_of_DOM_elements) signature.

          From 72035197dcd1fc10004f556919a296b806546f1a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= Date: Wed, 1 Oct 2014 08:04:07 -0400 Subject: [PATCH 116/699] 1.11.23 --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 1b998f3f..31fe4466 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "api.jquery.com", "title": "jQuery API Docs", "description": "API reference documentation for the jQuery JavaScript Library.", - "version": "1.11.22", + "version": "1.11.23", "homepage": "https://github.com/jquery/api.jquery.com", "author": { "name": "jQuery Foundation (https://jquery.org/)" From 4b2558184e561cc9bd7bb817cd4720e4dbaef02f Mon Sep 17 00:00:00 2001 From: Aurelio De Rosa Date: Fri, 3 Oct 2014 08:44:38 -0400 Subject: [PATCH 117/699] jQuery.each(): Add note about length prop in objects. * Fixes #473. Closes #527. --- entries/jQuery.each.xml | 1 + 1 file changed, 1 insertion(+) diff --git a/entries/jQuery.each.xml b/entries/jQuery.each.xml index f8ab8a64..67fe70cc 100644 --- a/entries/jQuery.each.xml +++ b/entries/jQuery.each.xml @@ -26,6 +26,7 @@ A generic iterator function, which can be used to seamlessly iterate over both objects and arrays. Arrays and array-like objects with a length property (such as a function's arguments object) are iterated by numeric index, from 0 to length-1. Other objects are iterated via their named properties.

          The $.each() function is not the same as $(selector).each(), which is used to iterate, exclusively, over a jQuery object. The $.each() function can be used to iterate over any collection, whether it is an object or an array. In the case of an array, the callback is passed an array index and a corresponding array value each time. (The value can also be accessed through the this keyword, but Javascript will always wrap the this value as an Object even if it is a simple string or number value.) The method returns its first argument, the object that was iterated.

          +

          Note: The $.each() function internally retrieves and uses the length property of the passed collection. So, if the collection has a property called length — e.g. {bar: 'foo', length: 10} — the function might not work as expected.

          
 $.each([ 52, 97 ], function( index, value ) {
   alert( index + ": " + value );

From aad41f24fc7f33edcb89fb3e4aa4bd681209bb4f Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Fri, 3 Oct 2014 08:52:08 -0400
Subject: [PATCH 118/699] data(): Add description of camel-case-to-dash
 conversion.

* Fixes #427. Closes #534.
---
 entries/data.xml | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/entries/data.xml b/entries/data.xml
index 67fa35be..bdd69604 100644
--- a/entries/data.xml
+++ b/entries/data.xml
@@ -101,10 +101,11 @@ $( "div" ).data( "lastValue" ) === 43;
 $( "div" ).data( "hidden" ) === true;
 $( "div" ).data( "options" ).name === "John";
          +

          The second statement of the code above correctly refers to the data-last-value attribute of the element. In case no data is stored with the passed key, jQuery searches among the attributes of the element, converting a camel-cased string into a dashed string and then prepending data- to the result. So, the string lastValue is converted to data-last-value.

          Every attempt is made to convert the string to a JavaScript value (this includes booleans, numbers, objects, arrays, and null). A value is only converted to a number if doing so doesn't change the value's representation. For example, "1E02" and "100.000" are equivalent as numbers (numeric value 100) but converting them would alter their representation so they are left as strings. The string value "100" is converted to the number 100.

          -

          When the data attribute is an object (starts with '{') or array (starts with '[') then jQuery.parseJSON is used to parse the string; it must follow valid JSON syntax including quoted property names. If the value isn't parseable as a JavaScript value, it is left as a string.

          -

          To retrieve the value's attribute as a string without any attempt to convert it, use the attr() method.

          -

          The data- attributes are pulled in the first time the data property is accessed and then are no longer accessed or mutated (all data values are then stored internally in jQuery).

          +

          When the data attribute is an object (starts with '{') or array (starts with '[') then jQuery.parseJSON is used to parse the string; it must follow valid JSON syntax including quoted property names. If the value isn't parseable as a JavaScript value, it is left as a string.

          +

          To retrieve the value's attribute as a string without any attempt to convert it, use the attr() method.

          +

          The data- attributes are pulled in the first time the data property is accessed and then are no longer accessed or mutated (all data values are then stored internally in jQuery).

          Calling .data() with no parameters retrieves all of the values as a JavaScript object. This object can be safely cached in a variable as long as a new object is not set with .data(obj). Using the object directly to get or set values is faster than making individual calls to .data() to get or set each value:

          
 var mydata = $( "#mydiv" ).data();

From 4d5f1fca836a941d7eac1ceb7355409919ba7df2 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Fri, 3 Oct 2014 08:53:15 -0400
Subject: [PATCH 119/699] 1.11.24

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 31fe4466..647df5a9 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.23",
+  "version": "1.11.24",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From ad3e554b097253e4acbca3db1dc2db5b97544472 Mon Sep 17 00:00:00 2001
From: Usman Akeju 
Date: Fri, 3 Oct 2014 10:20:53 -0400
Subject: [PATCH 120/699] jQuery.support(): Mark as deprecated as of version
 1.9

---
 categories.xml             | 5 +++++
 entries/jQuery.support.xml | 3 ++-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/categories.xml b/categories.xml
index 8db3b46b..40a34dd9 100644
--- a/categories.xml
+++ b/categories.xml
@@ -56,6 +56,11 @@
         
          For more information, see the Release Notes/Changelog at http://blog.jquery.com/2012/08/09/jquery-1-8-released/
          
       ]]>
     
+    
+      For more information, see the Release Notes/Changelog at http://blog.jquery.com/2013/01/15/jquery-1-9-final-jquery-2-0-beta-migrate-final-released/
          
+      ]]>          
+              
     
       For more information, see the Release Notes/Changelog at http://blog.jquery.com/2013/05/24/jquery-1-10-0-and-2-0-1-released/
          
diff --git a/entries/jQuery.support.xml b/entries/jQuery.support.xml
index e04634c9..c44b2b42 100644
--- a/entries/jQuery.support.xml
+++ b/entries/jQuery.support.xml
@@ -1,5 +1,5 @@
 
-
+
   jQuery.support
   
     1.3
@@ -9,4 +9,5 @@
   
   
   
+  
 

From 54f299f883e03740b138a4ffe481329955b9be9b Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Fri, 3 Oct 2014 10:21:12 -0400
Subject: [PATCH 121/699] 1.11.25

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 647df5a9..19334aca 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.24",
+  "version": "1.11.25",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From f838424dfcb88ad7724c0cb5b7060c06bde98158 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Sun, 5 Oct 2014 21:57:26 -0400
Subject: [PATCH 122/699] jQuery.Deferred(): Change "Deferred-compatible" to
 "Promise-compatible". Thanks @AurelioDeRosa. Fixes #567.

---
 entries/jQuery.Deferred.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.Deferred.xml b/entries/jQuery.Deferred.xml
index 5bf4ca60..fa9455c0 100644
--- a/entries/jQuery.Deferred.xml
+++ b/entries/jQuery.Deferred.xml
@@ -25,7 +25,7 @@
     
          In JavaScript it is common to invoke functions that optionally accept callbacks that are called within that function. For example, in versions prior to jQuery 1.5, asynchronous processes such as jQuery.ajax() accept callbacks to be invoked some time in the near-future upon success, error, and completion of the ajax request.
          
     
          jQuery.Deferred() introduces several enhancements to the way callbacks are managed and invoked. In particular, jQuery.Deferred() provides flexible ways to provide multiple callbacks, and these callbacks can be invoked regardless of whether the original callback dispatch has already occurred. jQuery Deferred is based on the CommonJS Promises/A design.
          
     
          One model for understanding Deferred is to think of it as a chain-aware function wrapper. The deferred.then(), deferred.always(), deferred.done(), and deferred.fail() methods specify the functions to be called and the deferred.resolve(args) or deferred.reject(args) methods "call" the functions with the arguments you supply. Once the Deferred has been resolved or rejected it stays in that state; a second call to deferred.resolve(), for example, is ignored. If more functions are added by deferred.then(), for example, after the Deferred is resolved, they are called immediately with the arguments previously provided.
          
-    
          In most cases where a jQuery API call returns a Deferred or Deferred-compatible object, such as jQuery.ajax() or jQuery.when(), you will only want to use the deferred.then(), deferred.done(), and deferred.fail() methods to add callbacks to the Deferred's queues. The internals of the API call or code that created the Deferred will invoke deferred.resolve() or deferred.reject() on the deferred at some point, causing the appropriate callbacks to run.
          
+    
          In most cases where a jQuery API call returns a Deferred or Promise-compatible object, such as jQuery.ajax() or jQuery.when(), you will only want to use the deferred.then(), deferred.done(), and deferred.fail() methods to add callbacks to the Deferred's queues. The internals of the API call or code that created the Deferred will invoke deferred.resolve() or deferred.reject() on the deferred at some point, causing the appropriate callbacks to run.
          
   
   
   

From 4b45436b4948a891f2a009d565dde7995c0dca27 Mon Sep 17 00:00:00 2001
From: Usman Akeju 
Date: Mon, 6 Oct 2014 08:17:06 -0400
Subject: [PATCH 123/699] jQuery.parseJSON: Function has multiple return types,
 not just Object. Closes #490

---
 entries/jQuery.parseJSON.xml | 21 +++++++++++++++------
 1 file changed, 15 insertions(+), 6 deletions(-)

diff --git a/entries/jQuery.parseJSON.xml b/entries/jQuery.parseJSON.xml
index 1f13da91..bc9dcc78 100644
--- a/entries/jQuery.parseJSON.xml
+++ b/entries/jQuery.parseJSON.xml
@@ -1,5 +1,10 @@
 
-
+
+  
+  
+  
+  
+  
   jQuery.parseJSON()
   
     1.4.1
@@ -7,16 +12,20 @@
       The JSON string to parse.
     
   
-  Takes a well-formed JSON string and returns the resulting JavaScript object.
+  Takes a well-formed JSON string and returns the resulting JavaScript value.
   
-    
          Passing in a malformed JSON string results in a JavaScript exception being thrown. For example, the following are all malformed JSON strings:
          
+    
          Passing in a malformed JSON string results in a JavaScript exception being thrown. For example, the following are all invalid JSON strings:
          
     
            
-      
          • {test: 1} (test does not have double quotes around it).
            • 
-      
          • {'test': 1} ('test' is using single quotes instead of double quotes).
            • 
+      
          • "{test: 1}" (test does not have double quotes around it).
            • 
+      
          • "{'test': 1}" ('test' is using single quotes instead of double quotes).
            • 
+      
          • "'test'" ('test' is using single quotes instead of double quotes).
            • 
+      
          • ".1" (a number must start with a digit; "0.1" would be valid).
            • 
+      
          • "undefined" (undefined cannot be represented in a JSON string; null, however, can be).
            • 
+      
          • "NaN" (NaN cannot be represented in a JSON string; direct representation of Infinity is also not permitted).
            • 
     
          
     
          The JSON standard does not permit "control characters" such as a tab or newline. An example like $.parseJSON( '{ "testing":"1\t2\n3" }' ) will throw an error in most implementations because the JavaScript parser converts the string's tab and newline escapes into literal tab and newline; doubling the backslashes like "1\\t2\\n3" yields expected results. This problem is often seen when injecting JSON into a JavaScript file from a server-side language such as PHP.
          
     
          Where the browser provides a native implementation of JSON.parse, jQuery uses it to parse the string. For details on the JSON format, see http://json.org/.
          
-    
          Prior to jQuery 1.9, $.parseJSON returned null instead of throwing an error if it was passed an empty string, null, or undefined, even though those are not valid JSON. 
          
+    
          Prior to jQuery 1.9, $.parseJSON returned null instead of throwing an error if it was passed an empty string, null, or undefined, even though those are not valid JSON.
          
             
   
     Parse a JSON string.

From edbc98ab58a9c81643ee96768dcc64f42f4423e7 Mon Sep 17 00:00:00 2001
From: Usman Akeju 
Date: Mon, 6 Oct 2014 08:54:26 -0400
Subject: [PATCH 124/699] jQuery.ajax:  callback and  signatures should use
 Anything type. Closes #492

---
 entries/jQuery.ajax.xml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index fd4d1878..93e8aaaa 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -67,8 +67,8 @@ $.ajax({
       
         
         
-        
-        A function to be used to handle the raw response data of XMLHttpRequest.This is a pre-filtering function to sanitize the response. You should return the sanitized data. The function accepts two arguments: The raw data returned from the server and the 'dataType' parameter.
+        
+        A function to be used to handle the raw response data of XMLHttpRequest. This is a pre-filtering function to sanitize the response. You should return the sanitized data. The function accepts two arguments: The raw data returned from the server and the 'dataType' parameter.
       
       
         The type of data that you're expecting back from the server. If none is specified, jQuery will try to infer it based on the MIME type of the response (an XML MIME type will yield XML, in 1.4 JSON will yield a JavaScript object, in 1.4 script will execute the script, and anything else will be returned as a string). The available types (and the result passed as the first argument to your success callback) are:
@@ -130,10 +130,10 @@ $.ajax({
         
       
       
-        
+        
         
         
-        A function to be called if the request succeeds. The function gets passed three arguments: The data returned from the server, formatted according to the dataType parameter; a string describing the status; and the jqXHR (in jQuery 1.4.x, XMLHttpRequest) object. As of jQuery 1.5, the success setting can accept an array of functions. Each function will be called in turn. This is an Ajax Event.
+        A function to be called if the request succeeds. The function gets passed three arguments: The data returned from the server, formatted according to the dataType parameter or the dataFilter callback function, if specified; a string describing the status; and the jqXHR (in jQuery 1.4.x, XMLHttpRequest) object. As of jQuery 1.5, the success setting can accept an array of functions. Each function will be called in turn. This is an Ajax Event.
       
       
         Set a timeout (in milliseconds) for the request. This will override any global timeout set with $.ajaxSetup(). The timeout period starts at the point the $.ajax call is made; if several other requests are in progress and the browser has no connections available, it is possible for a request to time out before it can be sent. In jQuery 1.4.x and below, the XMLHttpRequest object will be in an invalid state if the request times out; accessing any object members may throw an exception. In Firefox 3.0+ only, script and JSONP requests cannot be cancelled by a timeout; the script will run even if it arrives after the timeout period.

From 5f7fa2b79009cf4ef9ca4b736f63ee142c6c75b8 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Mon, 6 Oct 2014 08:57:00 -0400
Subject: [PATCH 125/699] 1.11.26

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 19334aca..f93bcb3f 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.25",
+  "version": "1.11.26",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From bdb9c9360e03edf4cfaf09cb25728933dbf6d90c Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 9 Oct 2014 21:45:24 +0200
Subject: [PATCH 126/699] README: Link to Github Issues instead of
 bugs.jquery.com

Closes gh-571
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 9c25bb24..e33d9099 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 ## Referencing Bug Tracker Tickets
 
-* Pull requests for changes that were requested or recommended via the [jQuery Bug Tracker](http://bugs.jquery.com) should include a link back to the relevant ticket.
+* Pull requests for changes that were requested or recommended via the [jQuery Issue Tracker](https://github.com/jquery/jquery/issues) should include a link back to the relevant ticket.
 
 ## Building
 

From c21b7879e89e24673e9047371dc2d484b03976e8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=CC=88rn=20Zaefferer?= 
Date: Fri, 17 Oct 2014 12:11:04 -0400
Subject: [PATCH 127/699] Types: Add entry for QUnit's Assert type Ref
 jquery/api.qunitjs.com#58

---
 pages/Types.html | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/pages/Types.html b/pages/Types.html
index e30e97e2..4e49174b 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -639,3 +639,5 @@ 
          Callbacks Object
          
 
          A multi-purpose object that provides a powerful way to manage callback lists. It supports adding, removing, firing, and disabling callbacks. The Callbacks object is created and returned by the $.Callbacks function and subsequently returned by most of that function's methods. 
          
 
          XML Document
          
 
          A document object created by the browser's XML DOM parser, usually from a string representing XML. XML documents have different semantics than HTML documents, but most of the traversing and manipulation methods provided by jQuery will work with them.
          
+
          Assert
          
+
          A reference to or instance of the object holding all of QUnit's assertions. See the API documentation for QUnit.assert for details.
          

From 55cb98ca3d5cfca59728eb927596f24357a50bd5 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Sat, 18 Oct 2014 12:27:25 -0400
Subject: [PATCH 128/699] has-attribute selector: Make use of ".one()" explicit
 for example

---
 entries/has-attribute-selector.xml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/entries/has-attribute-selector.xml b/entries/has-attribute-selector.xml
index facceca4..1bd8b4d8 100644
--- a/entries/has-attribute-selector.xml
+++ b/entries/has-attribute-selector.xml
@@ -11,8 +11,10 @@
   Selects elements that have the specified attribute, with any value. 
   
   
-    Bind a single click that adds the div id to its text.
+    Bind a single click to divs with an id that adds the id to the div's text.
     
Date: Sat, 18 Oct 2014 12:33:41 -0400
Subject: [PATCH 129/699] 1.11.27

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index f93bcb3f..b14fda16 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.26",
+  "version": "1.11.27",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From c881b2bf3fbcd462582d89423386ec137f910735 Mon Sep 17 00:00:00 2001
From: Mike Pennisi 
Date: Wed, 29 Oct 2014 21:20:01 -0400
Subject: [PATCH 130/699] before(), after(): Document new callback signature
 since jQuery version 1.10

Closes gh-580
---
 entries/after.xml  | 14 +++++++++++++-
 entries/before.xml | 15 ++++++++++++++-
 2 files changed, 27 insertions(+), 2 deletions(-)

diff --git a/entries/after.xml b/entries/after.xml
index 8e57cdac..f6c52bf4 100644
--- a/entries/after.xml
+++ b/entries/after.xml
@@ -23,13 +23,25 @@
     
       A function that returns an HTML string, DOM element(s), or jQuery object to insert after each element in the set of matched elements. Receives the index position of the element in the set as an argument. Within the function, this refers to the current element in the set.
       
-      
       
         
         
                 
       
     
+  
+   
+    1.10
+    
+      A function that returns an HTML string, DOM element(s), or jQuery object to insert after each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, this refers to the current element in the set.
+      
+      
+      
+        
+        
+        
+      
+    
   
   Insert content, specified by the parameter, after each element in the set of matched elements.
   
diff --git a/entries/before.xml b/entries/before.xml
index 7c2ebb7b..5d1bc1aa 100644
--- a/entries/before.xml
+++ b/entries/before.xml
@@ -22,7 +22,6 @@
     1.4
     
       
-      
       
         
         
@@ -31,6 +30,20 @@
       A function that returns an HTML string, DOM element(s), or jQuery object to insert before each element in the set of matched elements. Receives the index position of the element in the set as an argument. Within the function, this refers to the current element in the set.
       
     
+  
+   
+    1.10
+    
+      
+      
+      
+        
+        
+        
+      
+      A function that returns an HTML string, DOM element(s), or jQuery object to insert before each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, this refers to the current element in the set.
+      
+    
   
   Insert content, specified by the parameter, before each element in the set of matched elements.
   

From 18285f27fd5a27e5bde93f55c7eb802b90e6b6bc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=CC=88rn=20Zaefferer?= 
Date: Wed, 29 Oct 2014 21:27:46 -0400
Subject: [PATCH 131/699] Types: Add assert to ToC

Closes gh-582
---
 package.json     | 2 +-
 pages/Types.html | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/package.json b/package.json
index b14fda16..a2e9bf1c 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.27",
+  "version": "1.11.28",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"
diff --git a/pages/Types.html b/pages/Types.html
index 4e49174b..c2b9d219 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -94,6 +94,7 @@
   
        1. Promise Object
          2. 
   
        2. Callbacks Object
          3. 
   
        3. XML Document
          4. 
+  
        4. Qunit's Assert Object
          5. 
 
 
 
           Anything 
          

From a30e119728abe17d7f921c54d6061652c4042ebf Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Wed, 29 Oct 2014 21:28:34 -0400
Subject: [PATCH 132/699] 1.11.29

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index a2e9bf1c..1655c634 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.28",
+  "version": "1.11.29",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From 44fb8212e00dc2f0afaa9f377351b249fada84b8 Mon Sep 17 00:00:00 2001
From: Omar Meky 
Date: Thu, 30 Oct 2014 08:42:46 -0400
Subject: [PATCH 133/699] jQuery.ajax(): Removed repeated sentence

Closes gh-576
---
 entries/jQuery.ajax.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index 93e8aaaa..7f8b7d3b 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -294,7 +294,7 @@ jqxhr.always(function() {
     
          By default, Ajax requests are sent using the GET HTTP method. If the POST method is required, the method can be specified by setting a value for the type option. This option affects how the contents of the data option are sent to the server. POST data will always be transmitted to the server using UTF-8 charset, per the W3C XMLHTTPRequest standard.
          
     
          The data option can contain either a query string of the form key1=value1&key2=value2, or an object of the form {key1: 'value1', key2: 'value2'}. If the latter form is used, the data is converted into a query string using jQuery.param() before it is sent. This processing can be circumvented by setting processData to false.  The processing might be undesirable if you wish to send an XML object to the server; in this case, change the contentType option from application/x-www-form-urlencoded to a more appropriate MIME type.
          
     
          Advanced Options
          
-    
          The global option prevents handlers registered using .ajaxSend(), .ajaxError(), and similar methods from firing when this request would trigger them. This can be useful to, for example, suppress a loading indicator that was implemented with .ajaxSend() if the requests are frequent and brief. With cross-domain script and JSONP requests, the global option is automatically set to false. See the descriptions of these methods below for more details.  See the descriptions of these methods below for more details.
          
+    
          The global option prevents handlers registered using .ajaxSend(), .ajaxError(), and similar methods from firing when this request would trigger them. This can be useful to, for example, suppress a loading indicator that was implemented with .ajaxSend() if the requests are frequent and brief. With cross-domain script and JSONP requests, the global option is automatically set to false. See the descriptions of these methods below for more details.
          
     
          If the server performs HTTP authentication before providing a response, the user name and password pair can be sent via the username and password options.
          
     
          Ajax requests are time-limited, so errors can be caught and handled to provide a better user experience. Request timeouts are usually either left at their default or set as a global default using $.ajaxSetup() rather than being overridden for specific requests with the timeout option.
          
     
          By default, requests are always issued, but the browser may serve results out of its cache. To disallow use of the cached results, set cache to false. To cause the request to report failure if the asset has not been modified since the last request, set ifModified to true.
          

From 20095344621e719519c7943f1209ae33d53d600a Mon Sep 17 00:00:00 2001
From: phistuck 
Date: Thu, 30 Oct 2014 08:56:28 -0400
Subject: [PATCH 134/699] .trigger(): invoking the on(event-type) property of
 an object

note that calling .trigger(event-type) on an object invokes
the on(event-type) property of that object

Closes gh-509
---
 entries/trigger.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/entries/trigger.xml b/entries/trigger.xml
index 6a1f1288..a377c0f5 100644
--- a/entries/trigger.xml
+++ b/entries/trigger.xml
@@ -45,6 +45,7 @@ $( "#foo").trigger( "custom", [ "Custom", "Event" ] );
     
          Note the difference between the extra parameters passed here and the eventData parameter to the .on() method. Both are mechanisms for passing information to an event handler, but the extraParameters argument to .trigger() allows information to be determined at the time the event is triggered, while the eventData argument to .on() requires the information to be already computed at the time the handler is bound.
          
     
          The .trigger() method can be used on jQuery collections that wrap plain JavaScript objects similar to a pub/sub mechanism; any event handlers bound to the object will be called when the event is triggered. 
          
     
          Note: For both plain objects and DOM objects other than window, if a triggered event name matches the name of a property on the object, jQuery will attempt to invoke the property as a method if no event handler calls event.preventDefault(). If this behavior is not desired, use .triggerHandler() instead.
          
+    
          Note: As with .triggerHandler(), when calling .trigger() with an event name matches the name of a property on the object, prefixed by on (e.g. triggering click on window that has a non null onclick method), jQuery will attempt to invoke that property as a method.
          
             
   
     Clicks to button #2 also trigger a click for button #1.

From 98b2b386a6c861e800b45cae19fe1e3f04975ae5 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Fri, 31 Oct 2014 10:05:13 -0400
Subject: [PATCH 135/699] 1.11.30

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 1655c634..63e25860 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.29",
+  "version": "1.11.30",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From d70ba7556380e9a8090da0879e4c21b5837cfe44 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Tue, 4 Nov 2014 08:13:25 -0500
Subject: [PATCH 136/699] after(): Remove section regarding disconnected DOM
 nodes

Fixes gh-559
---
 entries/after.xml | 21 +--------------------
 1 file changed, 1 insertion(+), 20 deletions(-)

diff --git a/entries/after.xml b/entries/after.xml
index f6c52bf4..0fc251d3 100644
--- a/entries/after.xml
+++ b/entries/after.xml
@@ -26,7 +26,7 @@
       
         
         
-                
+        
       
               
   
@@ -80,25 +80,6 @@ $( ".container" ).after( $( "h2" ) );
 <h2>Greetings</h2>

          Important: If there is more than one target element, however, cloned copies of the inserted element will be created for each target except for the last one.

          -

          Inserting Disconnected DOM nodes

          -

          As of jQuery 1.4, .before() and .after() will also work on disconnected DOM nodes. For example, given the following code:

          - 
          $( "<div></div>" ).after( "<p></p>" );
          -

          The result is a jQuery set containing a div and a paragraph, in that order. That set can be further manipulated, even before it is inserted in the document.

          - 
          
-$( "<div></div>" )
-  .after( "<p></p>" )
-  .addClass( "foo" )
-  .filter( "p" )
-    .attr( "id", "bar" )
-    .html( "hello" )
-  .end()
-  .appendTo( "body" );
-
          -

          This results in the following elements inserted just before the closing </body> tag:

          - 
          
-<div class="foo"></div>
-<p class="foo" id="bar">hello</p>
-

          Passing a Function

          As of jQuery 1.4, .after() supports passing a function that returns the elements to insert.

          

From 8b4faabb8445debc34d0dc9fc973f3df133812e8 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Tue, 4 Nov 2014 08:51:39 -0500
Subject: [PATCH 137/699] after(): Improve first paragraph of long description

---
 entries/after.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/after.xml b/entries/after.xml
index 0fc251d3..1e195510 100644
--- a/entries/after.xml
+++ b/entries/after.xml
@@ -45,7 +45,7 @@
   
   Insert content, specified by the parameter, after each element in the set of matched elements.
   
-    
          The .after() and .insertAfter() methods perform the same task. The major difference is in the syntax—specifically, in the placement of the content and target. With .after(), the selector expression preceding the method is the container after which the content is inserted. With .insertAfter(), on the other hand, the content precedes the method, either as a selector expression or as markup created on the fly, and it is inserted after the target container.
          
+    
          The .after() and .insertAfter() methods perform the same task. The major difference is in the syntax—specifically, in the placement of the content and target. With .after(), the content to be inserted comes from the method's argument: $(target).after(contentToBeInserted). With .insertAfter(), on the other hand, the content precedes the method and is inserted after the target, which in turn is passed as the .insertAfter() method's argument: $(contentToBeInserted).insertAfter(target).
          
     
          Using the following HTML:
          
     
          
 <div class="container">

From 76a2669570bea9bf10473afc6c1503d6432a0f96 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Tue, 4 Nov 2014 09:19:58 -0500
Subject: [PATCH 138/699] before(): Remove note about disconnected DOM nodes
 and improve some wording.

Refs gh-559
---
 entries/before.xml | 11 +++--------
 1 file changed, 3 insertions(+), 8 deletions(-)

diff --git a/entries/before.xml b/entries/before.xml
index 5d1bc1aa..cba817a9 100644
--- a/entries/before.xml
+++ b/entries/before.xml
@@ -25,8 +25,8 @@
       
         
         
-                
-            
+        
+      
       A function that returns an HTML string, DOM element(s), or jQuery object to insert before each element in the set of matched elements. Receives the index position of the element in the set as an argument. Within the function, this refers to the current element in the set.
       
     
@@ -47,7 +47,7 @@
   
   Insert content, specified by the parameter, before each element in the set of matched elements.
   
-    
          The .before() and .insertBefore() methods perform the same task. The major difference is in the syntax-specifically, in the placement of the content and target. With .before(), the selector expression preceding the method is the container before which the content is inserted. With .insertBefore(), on the other hand, the content precedes the method, either as a selector expression or as markup created on the fly, and it is inserted before the target container.
          
+    
          The .before() and .insertBefore() methods perform the same task. The major difference is in the syntax—specifically, in the placement of the content and target. With .before(), the content to be inserted comes from the method's argument: $(target).before(contentToBeInserted). With .insertBefore(), on the other hand, the content precedes the method and is inserted before the target, which in turn is passed as the .insertBefore() method's argument: $(contentToBeInserted).insertBefore(target).
          
     
          Consider the following HTML:
          
     
          
 <div class="container">
@@ -83,11 +83,6 @@ $( ".container" ).before( $( "h2" ) );
 </div>
     
          
     
          Important: If there is more than one target element, however, cloned copies of the inserted element will be created for each target except for the last one.
          
-    
          In jQuery 1.4, .before() and .after() will also work on disconnected DOM nodes:
          
-    
          
-$( "<div>" ).before( "<p></p>" );
-    
          
-    
          The result is a jQuery set that contains a paragraph and a div (in that order).
          
     
          Additional Arguments
          
     
          Similar to other content-adding methods such as .prepend() and .after(), .before() also supports passing in multiple arguments as input. Supported input includes DOM elements, jQuery objects, HTML strings, and arrays of DOM elements.
          
     
          For example, the following will insert two new <div>s and an existing <div> before the first paragraph:
          

From ced7160e8500b750b54500b0b6f91f9f1dd3e269 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Tue, 4 Nov 2014 09:23:14 -0500
Subject: [PATCH 139/699] 1.11.31

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 63e25860..adda6fa7 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.30",
+  "version": "1.11.31",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From f9531d8233b465657dc85998dc1951e93faa79c7 Mon Sep 17 00:00:00 2001
From: Corey Frang 
Date: Thu, 6 Nov 2014 08:20:41 -0500
Subject: [PATCH 140/699] jQuery.getScript: Fix external link to jquery-color.

Point the link to the file on code.jquery.com, not GitHub.

Fixes #583.
---
 entries/jQuery.getScript.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.getScript.xml b/entries/jQuery.getScript.xml
index 488b4525..7579f713 100644
--- a/entries/jQuery.getScript.xml
+++ b/entries/jQuery.getScript.xml
@@ -94,7 +94,7 @@ $.cachedScript( "ajax/test.js" ).done(function( script, textStatus ) {
   
     Load the official jQuery Color Animation plugin dynamically and bind some color animations to occur once the new functionality is loaded.
     
Date: Thu, 6 Nov 2014 08:27:35 -0500
Subject: [PATCH 141/699] 1.11.32

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index adda6fa7..bc2cec1d 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.31",
+  "version": "1.11.32",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From 845a44268a666b863e60362faf6e175eea4a8ec5 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Thu, 6 Nov 2014 11:42:08 -0500
Subject: [PATCH 142/699] jQuery.getScript: Change jquery-color script
 reference to latest stable.

Refs gh-583
Refs gh-584
---
 entries/jQuery.getScript.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/jQuery.getScript.xml b/entries/jQuery.getScript.xml
index 7579f713..d942a51c 100644
--- a/entries/jQuery.getScript.xml
+++ b/entries/jQuery.getScript.xml
@@ -9,7 +9,7 @@
     
       
       
-            
+      
       A callback function that is executed if the request succeeds.
     
   
@@ -94,7 +94,7 @@ $.cachedScript( "ajax/test.js" ).done(function( script, textStatus ) {
   
     Load the official jQuery Color Animation plugin dynamically and bind some color animations to occur once the new functionality is loaded.
     
Date: Thu, 6 Nov 2014 11:43:06 -0500
Subject: [PATCH 143/699] 1.11.33

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index bc2cec1d..9d0f1cb0 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.32",
+  "version": "1.11.33",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From 421f9f99ab8dd4565b966fc9a389cf5b710fd488 Mon Sep 17 00:00:00 2001
From: Dave Methvin 
Date: Thu, 13 Nov 2014 22:11:07 -0500
Subject: [PATCH 144/699] Remove prevValue from copied properties

prevValue was never copied, not sure how it got onto this list.
---
 categories.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/categories.xml b/categories.xml
index 40a34dd9..d89d5580 100644
--- a/categories.xml
+++ b/categories.xml
@@ -143,7 +143,7 @@ jQuery( "body" ).trigger( e );

        The following properties are also copied to the event object, though some of their values may be undefined depending on the event:

        -

        altKey, bubbles, button, cancelable, charCode, clientX, clientY, ctrlKey, currentTarget, data, detail, eventPhase, metaKey, offsetX, offsetY, originalTarget, pageX, pageY, prevValue, relatedTarget, screenX, screenY, shiftKey, target, view, which

        +

        altKey, bubbles, button, cancelable, charCode, clientX, clientY, ctrlKey, currentTarget, data, detail, eventPhase, metaKey, offsetX, offsetY, originalTarget, pageX, pageY, relatedTarget, screenX, screenY, shiftKey, target, view, which

        OtherProperties

        Certain events may have properties specific to them. Those can be accessed as properties of the event.originalEvent object.

        Example:

        @@ -406,7 +406,7 @@ jQuery.event.props.push( "dataTransfer" );

        For more information, see the Release Notes/Changelog at http://blog.jquery.com/2012/08/09/jquery-1-8-released/

        ]]> - + p Aspects of the API that were changed in the corresponding version of jQuery. Changes in jQuery 1.9 dealt primarily removal or modification of several APIs that behaved inconsistently or inefficiently in the past. A jQuery Migrate Plugin was offered to help developers with a transitional upgrade path. From e0e513e6b86bf3991ccdfef17ee7b6602aed2a92 Mon Sep 17 00:00:00 2001 From: Dave Methvin Date: Thu, 13 Nov 2014 22:13:16 -0500 Subject: [PATCH 145/699] Remove extraneous character --- categories.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/categories.xml b/categories.xml index d89d5580..d4941b0e 100644 --- a/categories.xml +++ b/categories.xml @@ -406,7 +406,7 @@ jQuery.event.props.push( "dataTransfer" );

        For more information, see the Release Notes/Changelog at http://blog.jquery.com/2012/08/09/jquery-1-8-released/

        ]]>         -         p + Aspects of the API that were changed in the corresponding version of jQuery. Changes in jQuery 1.9 dealt primarily removal or modification of several APIs that behaved inconsistently or inefficiently in the past. A jQuery Migrate Plugin was offered to help developers with a transitional upgrade path. From 1d26e2a594fdb1a3e66e689a08ab706043d2396b Mon Sep 17 00:00:00 2001 From: antishok Date: Fri, 14 Nov 2014 08:36:38 -0500 Subject: [PATCH 146/699] jQuery.getScript: Remove random code sample. Closes gh-588. --- entries/jQuery.getScript.xml | 3 --- 1 file changed, 3 deletions(-) diff --git a/entries/jQuery.getScript.xml b/entries/jQuery.getScript.xml index d942a51c..e36d021c 100644 --- a/entries/jQuery.getScript.xml +++ b/entries/jQuery.getScript.xml @@ -28,9 +28,6 @@ $.ajax({ Success Callback

        The callback is fired once the script has been loaded but not necessarily executed.

        - 
        
-$( ".result" ).html( "<p>Lorem ipsum dolor sit amet.</p>" );
-

        Scripts are included and run by referencing the file name:

        
 $.getScript( "ajax/test.js", function( data, textStatus, jqxhr ) {

From 5c84fb5c49731dab4c1cf6a45a6b9a167f0a9895 Mon Sep 17 00:00:00 2001
From: Chris Rebert 
Date: Sat, 15 Nov 2014 11:42:04 -0500
Subject: [PATCH 147/699] :text selector: Clarify that it is for s, not
 DOM text nodes

Closes gh-587
---
 entries/text-selector.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/text-selector.xml b/entries/text-selector.xml
index b6fbb228..9af4dc44 100644
--- a/entries/text-selector.xml
+++ b/entries/text-selector.xml
@@ -5,7 +5,7 @@
   
     1.0
   
-  Selects all elements of type text.
+  Selects all input elements of type text.
   
     
        $( ":text" ) allows us to select all <input type="text"> elements. As with other pseudo-class selectors (those that begin with a ":") it is recommended to precede it with a tag name or some other selector; otherwise, the universal selector ( "*" ) is implied. In other words, the bare $( ":text" ) is equivalent to $( "*:text" ), so $( "input:text" ) should be used instead. 
        
     
        Note: As of jQuery 1.5.2, :text selects input elements that have no specified type attribute (in which case type="text" is implied).  
        

From 444039c491992338ba50b8bed7675d8c5f31202c Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Sat, 15 Nov 2014 11:44:10 -0500
Subject: [PATCH 148/699] 1.11.34

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 9d0f1cb0..9ed57519 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.33",
+  "version": "1.11.34",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From 1029bf307dfe53468994c522eee342e6291d6056 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Tue, 18 Nov 2014 13:05:21 -0500
Subject: [PATCH 149/699] live(): The  parameter is optional.

Closes gh-589.
---
 entries/live.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/live.xml b/entries/live.xml
index 95f9d5d8..049322e2 100644
--- a/entries/live.xml
+++ b/entries/live.xml
@@ -17,7 +17,7 @@
     
       A string containing a JavaScript event type, such as "click" or "keydown." As of jQuery 1.4 the string can contain multiple, space-separated event types or custom event names.
     
-    
+    
       An object containing data that will be passed to the event handler.
     
     

From bf15a22f2926e92b9dc2bf6d01c897d797ac9284 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Tue, 18 Nov 2014 13:08:12 -0500
Subject: [PATCH 150/699] triggerHandler(): Add plainObject type to
 extraParameters argument

Closes gh-590
---
 entries/triggerHandler.xml | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/entries/triggerHandler.xml b/entries/triggerHandler.xml
index df6fb8af..2167142e 100644
--- a/entries/triggerHandler.xml
+++ b/entries/triggerHandler.xml
@@ -7,8 +7,10 @@
     
       A string containing a JavaScript event type, such as click or submit.
     
-    
-      An array of additional parameters to pass along to the event handler.
+    
+      
+      
+      Additional parameters to pass along to the event handler.
     
   
   

From 4e8e8dcb7773004bda308dd9e57ff8b86f342766 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Tue, 18 Nov 2014 13:08:52 -0500
Subject: [PATCH 151/699] 1.11.35

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 9ed57519..ea892b16 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.34",
+  "version": "1.11.35",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From a3cc9b422c5c245a1f334f65de82275dda048084 Mon Sep 17 00:00:00 2001
From: tym-network 
Date: Wed, 19 Nov 2014 08:27:14 -0500
Subject: [PATCH 152/699] contents(): Add a missing space

Closes gh-591
---
 entries/contents.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/contents.xml b/entries/contents.xml
index 833aea25..d10defc0 100644
--- a/entries/contents.xml
+++ b/entries/contents.xml
@@ -6,7 +6,7 @@
   
   Get the children of each element in the set of matched elements, including text and comment nodes.
   
-    
        Given a jQuery object that represents a set of DOM elements, the .contents() method allows us to search throughthe immediate children of these elements in the DOM tree and construct a new jQuery object from the matching elements. The .contents() and .children() methods are similar, except that the former includes text nodes as well as HTML elements in the resulting jQuery object.
        
+    
        Given a jQuery object that represents a set of DOM elements, the .contents() method allows us to search through the immediate children of these elements in the DOM tree and construct a new jQuery object from the matching elements. The .contents() and .children() methods are similar, except that the former includes text nodes as well as HTML elements in the resulting jQuery object.
        
     
        The .contents() method can also be used to get the content document of an iframe, if the iframe is on the same domain as the main page.
        
     
        Consider a simple <div> with a number of text nodes, each of which is separated by two line break elements (<br>):
        
     
        

From f0466fb5fc4fcd686e608f1b47aaeb5d467aacf2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Tue, 2 Dec 2014 09:50:19 -0500
Subject: [PATCH 153/699] removeProp: Fix errors in code example

Fixes #604
---
 entries/removeProp.xml | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/entries/removeProp.xml b/entries/removeProp.xml
index 0f4b7790..987ab339 100644
--- a/entries/removeProp.xml
+++ b/entries/removeProp.xml
@@ -17,11 +17,12 @@
   
     Set a numeric property on a paragraph and then remove it. 
     
     
Date: Tue, 2 Dec 2014 09:50:44 -0500
Subject: [PATCH 154/699] 1.11.36

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index ea892b16..43f1c399 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.35",
+  "version": "1.11.36",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From 6d903c8f4a14769377b40e9974b1c6bbc498f7b4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Tue, 2 Dec 2014 15:57:59 -0500
Subject: [PATCH 155/699] Build: Replace grunt-clean with rimraf

---
 grunt.js     | 10 ++++++----
 package.json |  4 ++--
 2 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/grunt.js b/grunt.js
index ea16b469..0be80090 100644
--- a/grunt.js
+++ b/grunt.js
@@ -1,18 +1,16 @@
+var rimraf = require( "rimraf" );
+
 /*jshint node:true */
 module.exports = function( grunt ) {
 "use strict";
 
 var entryFiles = grunt.file.expandFiles( "entries/*.xml" );
 
-grunt.loadNpmTasks( "grunt-clean" );
 grunt.loadNpmTasks( "grunt-wordpress" );
 grunt.loadNpmTasks( "grunt-jquery-content" );
 grunt.loadNpmTasks( "grunt-check-modules" );
 
 grunt.initConfig({
-	clean: {
-		folder: "dist"
-	},
 	lint: {
 		grunt: "grunt.js"
 	},
@@ -36,6 +34,10 @@ grunt.initConfig({
 	}, grunt.file.readJSON( "config.json" ) )
 });
 
+grunt.registerTask( "clean", function() {
+	rimraf.sync( "dist" );
+});
+
 grunt.registerTask( "default", "build-wordpress" );
 grunt.registerTask( "build", "build-pages build-xml-entries build-xml-categories build-xml-full build-resources" );
 grunt.registerTask( "build-wordpress", "check-modules clean lint xmllint build" );
diff --git a/package.json b/package.json
index 43f1c399..f421d5ad 100644
--- a/package.json
+++ b/package.json
@@ -22,10 +22,10 @@
   ],
   "dependencies": {
     "grunt": "0.3.17",
-    "grunt-clean": "0.3.0",
     "grunt-wordpress": "1.2.1",
     "grunt-jquery-content": "0.13.0",
-    "grunt-check-modules": "0.1.0"
+    "grunt-check-modules": "0.1.0",
+    "rimraf": "2.2.8"
   },
   "devDependencies": {},
   "keywords": []

From f0afafb380377f537a0fc7b412081c23ac4d7a52 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Tue, 2 Dec 2014 16:00:41 -0500
Subject: [PATCH 156/699] Build: Remove unused tasks

---
 grunt.js | 16 +++-------------
 1 file changed, 3 insertions(+), 13 deletions(-)

diff --git a/grunt.js b/grunt.js
index 0be80090..dbe79fd3 100644
--- a/grunt.js
+++ b/grunt.js
@@ -1,25 +1,17 @@
 var rimraf = require( "rimraf" );
 
-/*jshint node:true */
 module.exports = function( grunt ) {
-"use strict";
 
 var entryFiles = grunt.file.expandFiles( "entries/*.xml" );
 
-grunt.loadNpmTasks( "grunt-wordpress" );
-grunt.loadNpmTasks( "grunt-jquery-content" );
 grunt.loadNpmTasks( "grunt-check-modules" );
+grunt.loadNpmTasks( "grunt-jquery-content" );
+grunt.loadNpmTasks( "grunt-wordpress" );
 
 grunt.initConfig({
-	lint: {
-		grunt: "grunt.js"
-	},
 	xmllint: {
 		all: [].concat( entryFiles, "categories.xml", "entries2html.xsl", "notes.xsl" )
 	},
-	xmltidy: {
-		all: [].concat( entryFiles, "categories.xml" )
-	},
 	"build-pages": {
 		all: grunt.file.expandFiles( "pages/**" )
 	},
@@ -38,9 +30,7 @@ grunt.registerTask( "clean", function() {
 	rimraf.sync( "dist" );
 });
 
-grunt.registerTask( "default", "build-wordpress" );
 grunt.registerTask( "build", "build-pages build-xml-entries build-xml-categories build-xml-full build-resources" );
-grunt.registerTask( "build-wordpress", "check-modules clean lint xmllint build" );
-grunt.registerTask( "tidy", "xmllint xmltidy" );
+grunt.registerTask( "build-wordpress", "check-modules clean xmllint build" );
 
 };

From 04f42c47bfa8a3236b76dd69a332359384a1a4b5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Tue, 2 Dec 2014 16:06:50 -0500
Subject: [PATCH 157/699] README: Cleanup

---
 README.md | 15 ++++++---------
 1 file changed, 6 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index e33d9099..67260550 100644
--- a/README.md
+++ b/README.md
@@ -1,18 +1,15 @@
-## Referencing Bug Tracker Tickets
+# api.jquery.com
 
-* Pull requests for changes that were requested or recommended via the [jQuery Issue Tracker](https://github.com/jquery/jquery/issues) should include a link back to the relevant ticket.
+## Building and Deploying
 
-## Building
+To build and deploy your changes for previewing in a [`jquery-wp-content`](https://github.com/jquery/jquery-wp-content) instance, follow the [workflow instructions](http://contribute.jquery.org/web-sites/#workflow) from our documentation on [contributing to jQuery Foundation web sites](http://contribute.jquery.org/web-sites/).
 
 ### Requirements
-* libxml2
-* libxslt
 
-The `xmllint` and `xsltproc` utilities need to be in your path. If you are on Windows, you can get libxml2 and libxslt from zlatkovic.com.
+* [libxml2](http://xmlsoft.org/)
+* [libxslt](http://xmlsoft.org/libxslt/)
 
-### Build
-
-To build and deploy your changes for previewing in a [jquery-wp-content](https://github.com/jquery/jquery-wp-content) instance, follow the [workflow instructions](http://contribute.jquery.org/web-sites/#workflow) from our documentation on [contributing to jQuery Foundation web sites](http://contribute.jquery.org/web-sites/).
+The `xmllint` and `xsltproc` utilities need to be in your path. If you are on Windows, you can get libxml2 and libxslt from GnuWin32.
 
 ## Style Guidelines
 

From 1af30ac254c825907de2cbeb9a1f0f28fe8cc24e Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Tue, 2 Dec 2014 20:03:07 -0500
Subject: [PATCH 158/699] jQuery.ajax: Remove warning about PUT and DELETE

Fixes gh-412
---
 entries/jQuery.ajax.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index 7f8b7d3b..94e223cc 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -142,7 +142,7 @@ $.ajax({
         Set this to true if you wish to use the traditional style of param serialization.
       
       
-        The type of request to make ("POST" or "GET"), default is "GET". Note: Other HTTP request methods, such as PUT and DELETE, can also be used here, but they are not supported by all browsers.
+        The type of request to make (e.g. "POST", "GET", "PUT"); default is "GET". 
       
       
          A string containing the URL to which the request is sent.

From c797af05d9ecb509f1b829642abe2fb20a28fc1b Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Tue, 2 Dec 2014 20:14:09 -0500
Subject: [PATCH 159/699] 1.11.37

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index f421d5ad..db8831d3 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.36",
+  "version": "1.11.37",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation (https://jquery.org/)"

From d39fb3dcba61ef3f56ba3a0e82c4143ee3427cfa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Fri, 5 Dec 2014 09:00:06 -0500
Subject: [PATCH 160/699] Build: Upgrade to Grunt 0.4.5

* Upgrade to grunt-check-modules 0.2.0
* Upgrade to grunt-jquery-content 1.0.0
---
 .gitignore   | 13 +++----------
 Gruntfile.js | 53 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 grunt.js     | 36 -----------------------------------
 package.json |  7 +++----
 4 files changed, 59 insertions(+), 50 deletions(-)
 create mode 100644 Gruntfile.js
 delete mode 100644 grunt.js

diff --git a/.gitignore b/.gitignore
index 2dc8b339..633f1bde 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,10 +1,3 @@
-dist
-entries_tmp
-node_modules
-config.json
-.project
-*~
-*.diff
-*.patch
-.DS_Store
-.settings
\ No newline at end of file
+/dist/
+/node_modules/
+config.js*
diff --git a/Gruntfile.js b/Gruntfile.js
new file mode 100644
index 00000000..f6bc20df
--- /dev/null
+++ b/Gruntfile.js
@@ -0,0 +1,53 @@
+var rimraf = require( "rimraf" );
+
+module.exports = function( grunt ) {
+
+grunt.loadNpmTasks( "grunt-check-modules" );
+grunt.loadNpmTasks( "grunt-jquery-content" );
+
+grunt.initConfig({
+	xmllint: {
+		all: [
+			"entries/**",
+			"includes/**",
+			"categories.xml",
+			"entries2html.xsl",
+			"notes.xsl"
+		]
+	},
+	"build-pages": {
+		all: "pages/**"
+	},
+	"build-xml-entries": {
+		all: "entries/**"
+	},
+	"build-resources": {
+		all: "resources/**"
+	},
+	wordpress: (function() {
+		var config = require( "./config" );
+		config.dir = "dist/wordpress";
+		return config;
+	})()
+});
+
+grunt.registerTask( "clean", function() {
+	rimraf.sync( "dist" );
+});
+
+grunt.registerTask( "build", [
+	"build-pages",
+	"build-resources",
+	"build-xml-entries",
+	"build-xml-categories",
+	"build-xml-full"
+]);
+
+grunt.registerTask( "build-wordpress", [
+	"check-modules",
+	"xmllint",
+	"clean",
+	"build"
+]);
+
+};
diff --git a/grunt.js b/grunt.js
deleted file mode 100644
index dbe79fd3..00000000
--- a/grunt.js
+++ /dev/null
@@ -1,36 +0,0 @@
-var rimraf = require( "rimraf" );
-
-module.exports = function( grunt ) {
-
-var entryFiles = grunt.file.expandFiles( "entries/*.xml" );
-
-grunt.loadNpmTasks( "grunt-check-modules" );
-grunt.loadNpmTasks( "grunt-jquery-content" );
-grunt.loadNpmTasks( "grunt-wordpress" );
-
-grunt.initConfig({
-	xmllint: {
-		all: [].concat( entryFiles, "categories.xml", "entries2html.xsl", "notes.xsl" )
-	},
-	"build-pages": {
-		all: grunt.file.expandFiles( "pages/**" )
-	},
-	"build-xml-entries": {
-		all: entryFiles
-	},
-	"build-resources": {
-		all: grunt.file.expandFiles( "resources/**" )
-	},
-	wordpress: grunt.utils._.extend({
-		dir: "dist/wordpress"
-	}, grunt.file.readJSON( "config.json" ) )
-});
-
-grunt.registerTask( "clean", function() {
-	rimraf.sync( "dist" );
-});
-
-grunt.registerTask( "build", "build-pages build-xml-entries build-xml-categories build-xml-full build-resources" );
-grunt.registerTask( "build-wordpress", "check-modules clean xmllint build" );
-
-};
diff --git a/package.json b/package.json
index db8831d3..41f1592d 100644
--- a/package.json
+++ b/package.json
@@ -21,10 +21,9 @@
     }
   ],
   "dependencies": {
-    "grunt": "0.3.17",
-    "grunt-wordpress": "1.2.1",
-    "grunt-jquery-content": "0.13.0",
-    "grunt-check-modules": "0.1.0",
+    "grunt": "0.4.5",
+    "grunt-check-modules": "0.2.0",
+    "grunt-jquery-content": "1.0.0",
     "rimraf": "2.2.8"
   },
   "devDependencies": {},

From 622226edc7b9b91ba190f54ea88ccffef0c0612c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Fri, 5 Dec 2014 09:04:58 -0500
Subject: [PATCH 161/699] Build: Remove dates from copyright notice

---
 LICENSE.txt | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/LICENSE.txt b/LICENSE.txt
index 01839718..19a9bad2 100644
--- a/LICENSE.txt
+++ b/LICENSE.txt
@@ -1,6 +1,5 @@
-Copyright 2009 Packt Publishing, http://packtpub.com/
-Copyright 2012, 2014 jQuery Foundation and other contributors,
-https://jquery.org/
+Copyright Packt Publishing (http://packtpub.com/),
+jQuery Foundation (https://jquery.org/), and other contributors.
 
 This software consists of voluntary contributions made by many
 individuals. For exact contribution history, see the revision history

From 6d2054fc066cb7019be831eff76bd1c05b2270a1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Fri, 5 Dec 2014 09:05:55 -0500
Subject: [PATCH 162/699] Build: package.json cleanup

---
 package.json | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/package.json b/package.json
index 41f1592d..bc682bf5 100644
--- a/package.json
+++ b/package.json
@@ -5,7 +5,7 @@
   "version": "1.11.37",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
-    "name": "jQuery Foundation (https://jquery.org/)"
+    "name": "jQuery Foundation and other contributors"
   },
   "repository": {
     "type": "git",
@@ -17,7 +17,7 @@
   "licenses": [
     {
       "type": "MIT",
-      "url": "http://www.opensource.org/licenses/MIT"
+      "url": "https://github.com/jquery/api.jquery.com/blob/master/LICENSE.txt"
     }
   ],
   "dependencies": {
@@ -25,7 +25,5 @@
     "grunt-check-modules": "0.2.0",
     "grunt-jquery-content": "1.0.0",
     "rimraf": "2.2.8"
-  },
-  "devDependencies": {},
-  "keywords": []
+  }
 }

From 001d725dba78a4e00d8e1e3a352cb27c41bb7cde Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Fri, 5 Dec 2014 15:12:16 -0500
Subject: [PATCH 163/699] 1.11.38

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index bc682bf5..258fe004 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.37",
+  "version": "1.11.38",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 82daaa0fded99c2a92fcba1f31b1cf0d9594fae5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Mon, 8 Dec 2014 12:17:18 -0500
Subject: [PATCH 164/699] Build: Upgrade to grunt-jquery-content 2.0.0

---
 Gruntfile.js | 20 ++++----------------
 package.json |  4 +---
 2 files changed, 5 insertions(+), 19 deletions(-)

diff --git a/Gruntfile.js b/Gruntfile.js
index f6bc20df..cc71e7be 100644
--- a/Gruntfile.js
+++ b/Gruntfile.js
@@ -1,8 +1,5 @@
-var rimraf = require( "rimraf" );
-
 module.exports = function( grunt ) {
 
-grunt.loadNpmTasks( "grunt-check-modules" );
 grunt.loadNpmTasks( "grunt-jquery-content" );
 
 grunt.initConfig({
@@ -15,8 +12,8 @@ grunt.initConfig({
 			"notes.xsl"
 		]
 	},
-	"build-pages": {
-		all: "pages/**"
+	"build-posts": {
+		page: "pages/**"
 	},
 	"build-xml-entries": {
 		all: "entries/**"
@@ -31,23 +28,14 @@ grunt.initConfig({
 	})()
 });
 
-grunt.registerTask( "clean", function() {
-	rimraf.sync( "dist" );
-});
+grunt.registerTask( "lint", [ "xmllint" ]);
 
 grunt.registerTask( "build", [
-	"build-pages",
+	"build-posts",
 	"build-resources",
 	"build-xml-entries",
 	"build-xml-categories",
 	"build-xml-full"
 ]);
 
-grunt.registerTask( "build-wordpress", [
-	"check-modules",
-	"xmllint",
-	"clean",
-	"build"
-]);
-
 };
diff --git a/package.json b/package.json
index 258fe004..9c4b386c 100644
--- a/package.json
+++ b/package.json
@@ -22,8 +22,6 @@
   ],
   "dependencies": {
     "grunt": "0.4.5",
-    "grunt-check-modules": "0.2.0",
-    "grunt-jquery-content": "1.0.0",
-    "rimraf": "2.2.8"
+    "grunt-jquery-content": "2.0.0"
   }
 }

From 0a5bd237f3c77c7b55efd50ba1b7b5a2d00498db Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Mon, 8 Dec 2014 12:22:24 -0500
Subject: [PATCH 165/699] 1.11.39

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 9c4b386c..f955be2e 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.38",
+  "version": "1.11.39",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 5a0192c0a4c89725dd69bb4b67cfb2c91ab68ae7 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sun, 7 Dec 2014 12:12:50 +0100
Subject: [PATCH 166/699] add: Fix element type

Closes gh-606
Fixes gh-309
---
 entries/add.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/add.xml b/entries/add.xml
index 04b4a3bc..6f1d7870 100644
--- a/entries/add.xml
+++ b/entries/add.xml
@@ -9,7 +9,7 @@
   
   
     1.0
-    
+    
       One or more elements to add to the set of matched elements.
     
   

From 891500f6de5b05748fd633da604561f489dc4f51 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sun, 21 Dec 2014 15:00:18 +0100
Subject: [PATCH 167/699] toggleClass: rename 'switch' variable

Closes gh-610
Fixes gh-581
---
 entries/toggleClass.xml | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/entries/toggleClass.xml b/entries/toggleClass.xml
index a4516652..1d034d86 100644
--- a/entries/toggleClass.xml
+++ b/entries/toggleClass.xml
@@ -12,13 +12,13 @@
     
       One or more class names (separated by spaces) to be toggled for each element in the matched set.
     
-    
+    
       A Boolean (not just truthy/falsy) value to determine whether the class should be added or removed.
     
   
   
     1.4
-    
+    
       A boolean value to determine whether the class should be added or removed.
     
   
@@ -27,15 +27,15 @@
     
       
       
-      
+      
         
-      A function that returns class names to be toggled in the class attribute of each element in the matched set. Receives the index position of the element in the set, the old class value, and the switch as arguments.
+      A function that returns class names to be toggled in the class attribute of each element in the matched set. Receives the index position of the element in the set, the old class value, and the state as arguments.
     
-    
+    
       A boolean value to determine whether the class should be added or removed.
     
   
-  Add or remove one or more classes from each element in the set of matched elements, depending on either the class's presence or the value of the switch argument.
+  Add or remove one or more classes from each element in the set of matched elements, depending on either the class's presence or the value of the state argument.
   
     
        This method takes one or more class names as its parameter. In the first version, if an element in the matched set of elements already has the class, then it is removed; if an element does not have the class, then it is added. For example, we can apply .toggleClass() to a simple <div>: 
        
     
        

From e77a192cdc3691596a87a1b50a85babbdb32cce8 Mon Sep 17 00:00:00 2001
From: Corey Frang 
Date: Mon, 22 Dec 2014 13:59:58 -0500
Subject: [PATCH 168/699] jQuery.ajax: Document contentType false

Added Boolean as a type for contentType.
Added a sentance about what passing false does for contentType

Ref gh-547
Ref gh-369
---
 entries/jQuery.ajax.xml | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index 94e223cc..21463bb8 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -37,8 +37,10 @@
       
         An object of string/regular-expression pairs that determine how jQuery will parse the response, given its content type.
       
-      
-        When sending data to the server, use this content type. Default is "application/x-www-form-urlencoded; charset=UTF-8", which is fine for most cases. If you explicitly pass in a content-type to $.ajax(), then it is always sent to the server (even if no data is sent). The W3C XMLHttpRequest specification dictates that the charset is always UTF-8; specifying another charset will not force the browser to change the encoding. Note: For cross-domain requests, setting the content type to anything other than application/x-www-form-urlencoded, multipart/form-data, or text/plain will trigger the browser to send a preflight OPTIONS request to the server.
+      
+        
+        
+        When sending data to the server, use this content type. Default is "application/x-www-form-urlencoded; charset=UTF-8", which is fine for most cases.  If you explicitly pass in a content-type to $.ajax(), then it is always sent to the server (even if no data is sent).  As of jQuery 1.6 you can pass false to tell jQuery to not set any content type header.  Note: The W3C XMLHttpRequest specification dictates that the charset is always UTF-8; specifying another charset will not force the browser to change the encoding. Note: For cross-domain requests, setting the content type to anything other than application/x-www-form-urlencoded, multipart/form-data, or text/plain will trigger the browser to send a preflight OPTIONS request to the server.
       
       
         This object will be made the context of all Ajax-related callbacks. By default, the context is an object that represents the ajax settings used in the call ($.ajaxSettings merged with the settings passed to $.ajax). For example,  specifying a DOM element as the context will make that the context for the complete callback of a request, like so:

From eb7611d91dbd93f262a9a8ddb2b8d9573d1c7736 Mon Sep 17 00:00:00 2001
From: Corey Frang 
Date: Mon, 22 Dec 2014 14:10:59 -0500
Subject: [PATCH 169/699] parent: Clarify wording about behavior

Fixes gh-537
Ref gh-543
---
 entries/parent.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/parent.xml b/entries/parent.xml
index 0fdf5b73..4c375255 100644
--- a/entries/parent.xml
+++ b/entries/parent.xml
@@ -9,8 +9,8 @@
   
   Get the parent of each element in the current set of matched elements, optionally filtered by a selector.
   
-    
        Given a jQuery object that represents a set of DOM elements, the .parent() method allows us to search through the parents of these elements in the DOM tree and construct a new jQuery object from the matching elements.
        
-    
        The .parents() and .parent() methods are similar, except that the latter only travels a single level up the DOM tree. Also, $( "html" ).parent() method returns a set containing document whereas $( "html" ).parents() returns an empty set.
        
+    
        Given a jQuery object that represents a set of DOM elements, the parent() method traverses to the immediate parent of each of these elements in the DOM tree and constructs a new jQuery object from the matching elements.
        
+    
        This method is similar to .parents(), except .parent() only travels a single level up the DOM tree. Also, $( "html" ).parent() method returns a set containing document whereas $( "html" ).parents() returns an empty set.
        
     
        The method optionally accepts a selector expression of the same type that we can pass to the $() function. If the selector is supplied, the elements will be filtered by testing whether they match it.
        
     
        Consider a page with a basic nested list on it:
        
     
        

From 918bdef49502c4e7206f3284f409e47748581227 Mon Sep 17 00:00:00 2001
From: Corey Frang 
Date: Mon, 22 Dec 2014 11:11:55 -0500
Subject: [PATCH 170/699] trigger: add some links to triggerHandler

---
 entries/trigger.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/trigger.xml b/entries/trigger.xml
index a377c0f5..c840b058 100644
--- a/entries/trigger.xml
+++ b/entries/trigger.xml
@@ -44,8 +44,8 @@ $( "#foo").trigger( "custom", [ "Custom", "Event" ] );
     
        The event object is always passed as the first parameter to an event handler. An array of arguments can also be passed to the .trigger() call, and these parameters will be passed along to the handler as well following the event object. As of jQuery 1.6.2, single string or numeric argument can be passed without being wrapped in an array.
        
     
        Note the difference between the extra parameters passed here and the eventData parameter to the .on() method. Both are mechanisms for passing information to an event handler, but the extraParameters argument to .trigger() allows information to be determined at the time the event is triggered, while the eventData argument to .on() requires the information to be already computed at the time the handler is bound.
        
     
        The .trigger() method can be used on jQuery collections that wrap plain JavaScript objects similar to a pub/sub mechanism; any event handlers bound to the object will be called when the event is triggered. 
        
-    
        Note: For both plain objects and DOM objects other than window, if a triggered event name matches the name of a property on the object, jQuery will attempt to invoke the property as a method if no event handler calls event.preventDefault(). If this behavior is not desired, use .triggerHandler() instead.
        
-    
        Note: As with .triggerHandler(), when calling .trigger() with an event name matches the name of a property on the object, prefixed by on (e.g. triggering click on window that has a non null onclick method), jQuery will attempt to invoke that property as a method.
        
+    
        Note: For both plain objects and DOM objects other than window, if a triggered event name matches the name of a property on the object, jQuery will attempt to invoke the property as a method if no event handler calls event.preventDefault(). If this behavior is not desired, use .triggerHandler() instead.
        
+    
        Note: As with .triggerHandler(), when calling .trigger() with an event name matches the name of a property on the object, prefixed by on (e.g. triggering click on window that has a non null onclick method), jQuery will attempt to invoke that property as a method.
        
   
   
     Clicks to button #2 also trigger a click for button #1.

From 41fc7513bd8b186bab24483443c1dc5a4faad5d0 Mon Sep 17 00:00:00 2001
From: Corey Frang 
Date: Mon, 22 Dec 2014 11:12:28 -0500
Subject: [PATCH 171/699] triggerHandler: Rephrase description and differences
 from trigger

---
 entries/triggerHandler.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/triggerHandler.xml b/entries/triggerHandler.xml
index 2167142e..e174311f 100644
--- a/entries/triggerHandler.xml
+++ b/entries/triggerHandler.xml
@@ -14,9 +14,9 @@
     
   
   
-    
        The .triggerHandler() method behaves similarly to .trigger(), with the following exceptions:
        
+    
        .triggerHandler( eventType ) executes all handlers bound with jQuery for the event type.  It will also execute any method called on{eventType}() found on the element.  The behavior of this method is similar to .trigger(), with the following exceptions:
        
     
          
-      
        • The .triggerHandler() method does not cause the default behavior of an event to occur (such as a form submission).
          • 
+      
        • The .triggerHandler( "event" ) method will not call .event() on the element it is triggered on.  This means .triggerHandler( "submit" ) on a form will not call .submit() on the form.
          • 
       
        • While .trigger() will operate on all elements matched by the jQuery object, .triggerHandler() only affects the first matched element.
          • 
       
        • Events triggered with .triggerHandler() do not bubble up the DOM hierarchy; if they are not handled by the target element directly, they do nothing.
          • 
       
        • Instead of returning the jQuery object (to allow chaining), .triggerHandler() returns whatever value was returned by the last handler it caused to be executed. If no handlers are triggered, it returns undefined
          • 

From d443d9610abed4a28712602b3b918be25ca0d87e Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 6 Oct 2014 02:24:42 +0100
Subject: [PATCH 172/699] deferred.progress: Accepts multiple arguments

Closes gh-568
---
 entries/deferred.progress.xml | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/entries/deferred.progress.xml b/entries/deferred.progress.xml
index fd7635a1..3a827a24 100644
--- a/entries/deferred.progress.xml
+++ b/entries/deferred.progress.xml
@@ -10,10 +10,17 @@
         A function, or array of functions, to be called when the Deferred generates progress notifications.
       
     
+    
+      
+      
+      
+        Optional additional function, or array of functions, to be called when the Deferred generates progress notifications.
+      
+    
   
    Add handlers to be called when the Deferred object generates progress notifications.
   
-    
          The argument can be either a single function or an array of functions. When the Deferred generates progress notifications by calling notify or notifyWith, the progressCallbacks are called. Since deferred.progress() returns the Deferred object, other methods of the Deferred object can be chained to this one. When the Deferred is resolved or rejected, progress callbacks will no longer be called, with the exception that any progressCallbacks added after the Deferred enters the resolved or rejected state are executed immediately when they are added, using the arguments that were passed to the .notify() or notifyWith() call. For more information, see the documentation for jQuery.Deferred().
          
+    
          The deferred.progress() method accepts one or more arguments, all of which can be either a single function or an array of functions. When the Deferred generates progress notifications by calling notify or notifyWith, the progressCallbacks are called. Since deferred.progress() returns the Deferred object, other methods of the Deferred object can be chained to this one. When the Deferred is resolved or rejected, progress callbacks will no longer be called, with the exception that any progressCallbacks added after the Deferred enters the resolved or rejected state are executed immediately when they are added, using the arguments that were passed to the .notify() or notifyWith() call. For more information, see the documentation for jQuery.Deferred().
          
             
   
   

From 0c7e90bc8d00d95d0f9526a8b886e525514a266a Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Fri, 10 Oct 2014 20:19:27 +0100
Subject: [PATCH 173/699] jQuery.when: Update to "Promise-Compatible"

Based on gh-567 the returned value of $.ajax() is actually a Promise-compatible object and not a Promise object.

Closes gh-574
Ref gh-567
---
 entries/jQuery.when.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.when.xml b/entries/jQuery.when.xml
index e28819e3..310613e7 100644
--- a/entries/jQuery.when.xml
+++ b/entries/jQuery.when.xml
@@ -9,7 +9,7 @@
   
   Provides a way to execute callback functions based on one or more objects, usually Deferred objects that represent asynchronous events.
   
-    
          If a single Deferred is passed to jQuery.when(), its Promise object (a subset of the Deferred methods) is returned by the method. Additional methods of the Promise object can be called to attach callbacks, such as deferred.then. When the Deferred is resolved or rejected, usually by the code that created the Deferred originally, the appropriate callbacks will be called. For example, the jqXHR object returned by jQuery.ajax() is a Promise and can be used this way:
          
+    
          If a single Deferred is passed to jQuery.when(), its Promise object (a subset of the Deferred methods) is returned by the method. Additional methods of the Promise object can be called to attach callbacks, such as deferred.then. When the Deferred is resolved or rejected, usually by the code that created the Deferred originally, the appropriate callbacks will be called. For example, the jqXHR object returned by jQuery.ajax() is a Promise-compatible object and can be used this way:
          
     
          
 $.when( $.ajax( "test.aspx" ) ).then(function( data, textStatus, jqXHR ) {
   alert( jqXHR.status ); // Alerts 200

From d2c4f7a2cad3c14b4930a82ce9a680c31cb73a83 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Fri, 2 Jan 2015 18:25:49 +0100
Subject: [PATCH 174/699] finish: clarify .finish() defaults to .finish("fx")

Closes gh-615
Fixes gh-464
---
 entries/finish.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/finish.xml b/entries/finish.xml
index 96975750..506d53f2 100644
--- a/entries/finish.xml
+++ b/entries/finish.xml
@@ -4,7 +4,7 @@
   Stop the currently-running animation, remove all queued animations, and complete all animations for the matched elements.
   
     1.9
-    
+    
       The name of the queue in which to stop animations.
     
   

From a6b3b6ffcb6e6366fd1dfc92d43950f74647a987 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 11 Jan 2015 20:12:10 -0500
Subject: [PATCH 175/699] jQuery.getJSON: Update data argument. Can take
 string.

---
 entries/jQuery.getJSON.xml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/entries/jQuery.getJSON.xml b/entries/jQuery.getJSON.xml
index 1485a2a2..97c8b0a9 100644
--- a/entries/jQuery.getJSON.xml
+++ b/entries/jQuery.getJSON.xml
@@ -6,7 +6,9 @@
     
       A string containing the URL to which the request is sent.
     
-    
+    
+      
+      
       A plain object or string that is sent to the server with the request.
     
     

From 4730880526de7b8fc3e9cf76803a6716105b3bb5 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Sun, 11 Jan 2015 21:21:06 -0500
Subject: [PATCH 176/699] 1.11.40

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index f955be2e..6c608d92 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.39",
+  "version": "1.11.40",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 1373b93d9bdf774782c6c14d0522ab0933498ce5 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 15 Jan 2015 07:15:31 +0100
Subject: [PATCH 177/699] attr: move parenthesis outside code element

Closes gh-612
---
 entries/attr.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/attr.xml b/entries/attr.xml
index 3e181e67..f0f1408b 100644
--- a/entries/attr.xml
+++ b/entries/attr.xml
@@ -206,7 +206,7 @@ $( "#greatphoto" ).attr( "title", function( i, val ) {
 });
       
          
       
          This use of a function to compute attribute values can be particularly useful when modifying the attributes of multiple elements at once.
          
-      
          Note: If nothing is returned in the setter function (ie. function(index, attr){}), or if undefined is returned, the current value is not changed. This is useful for selectively setting values only when certain criteria are met.
          
+      
          Note: If nothing is returned in the setter function (ie. function(index, attr){}), or if undefined is returned, the current value is not changed. This is useful for selectively setting values only when certain criteria are met.
          
               
     
       Set some attributes for all <img>s in the page.

From 50ce24477abf3a5156a02296427092c8f6975123 Mon Sep 17 00:00:00 2001
From: Anne-Gaelle Colom 
Date: Sat, 17 Jan 2015 10:23:00 +0000
Subject: [PATCH 178/699] Image-selector: Fix incorrect closing tag

Closes gh-626
---
 entries/image-selector.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/image-selector.xml b/entries/image-selector.xml
index 461c438c..8af0a351 100644
--- a/entries/image-selector.xml
+++ b/entries/image-selector.xml
@@ -42,7 +42,7 @@ $( "form" ).submit(function( event ) {
   
   
   
   
   

From 95a9b6591549cec0e1b07b8ee6baa1d625071262 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Sun, 18 Jan 2015 17:38:42 -0500
Subject: [PATCH 179/699] on(): Remove ambiguous information about event
 handlers on detached DOM elements. Fixes gh-548

---
 entries/on.xml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/entries/on.xml b/entries/on.xml
index eeab0009..0f2f9474 100644
--- a/entries/on.xml
+++ b/entries/on.xml
@@ -41,18 +41,18 @@
     
          The majority of browser events bubble, or propagate, from the deepest, innermost element (the event target) in the document where they occur all the way up to the body and the document element. In Internet Explorer 8 and lower, a few events such as change and submit do not natively bubble but jQuery patches these to bubble and create consistent cross-browser behavior.
          
     
          If selector is omitted or is null, the event handler is referred to as direct or directly-bound. The handler is called every time an event occurs on the selected elements, whether it occurs directly on the element or bubbles from a descendant (inner) element.
          
     
          When a selector is provided, the event handler is referred to as delegated. The handler is not called when the event occurs directly on the bound element, but only for descendants (inner elements) that match the selector. jQuery bubbles the event from the event target up to the element where the handler is attached (i.e., innermost to outermost element) and runs the handler for any elements along that path matching the selector.
          
-    
          Event handlers are bound only to the currently selected elements; they must exist on the page at the time your code makes the call to .on(). To ensure the elements are present and can be selected, perform event binding inside a document ready handler for elements that are in the HTML markup on the page. If new HTML is being injected into the page, select the elements and attach event handlers after the new HTML is placed into the page. Or, use delegated events to attach an event handler, as described next.
          
-    
          Delegated events have the advantage that they can process events from descendant elements that are added to the document at a later time. By picking an element that is guaranteed to be present at the time the delegated event handler is attached, you can use delegated events to avoid the need to frequently attach and remove event handlers. This element could be the container element of a view in a Model-View-Controller design, for example, or document if the event handler wants to monitor all bubbling events in the document. The document element is available in the head of the document before loading any other HTML, so it is safe to attach events there without waiting for the document to be ready.
          
+    
          Event handlers are bound only to the currently selected elements; they must exist at the time your code makes the call to .on(). To ensure the elements are present and can be selected, place scripts after the elements in the HTML markup or perform event binding inside a document ready handler. Alternatively, use delegated events to attach event handlers.
          
+    
          Delegated events have the advantage that they can process events from descendant elements that are added to the document at a later time. By picking an element that is guaranteed to be present at the time the delegated event handler is attached, you can use delegated events to avoid the need to frequently attach and remove event handlers. This element could be the container element of a view in a Model-View-Controller design, for example, or document if the event handler wants to monitor all bubbling events in the document. The document element is available in the head of the document before loading any other HTML, so it is safe to attach events there without waiting for the document to be ready.
          
     
          In addition to their ability to handle events on descendant elements not yet created, another advantage of delegated events is their potential for much lower overhead when many elements must be monitored. On a data table with 1,000 rows in its tbody, this example attaches a handler to 1,000 elements:
          
     
          
 $( "#dataTable tbody tr" ).on( "click", function() {
-  alert( $( this ).text() );
+  console.log( $( this ).text() );
 });
     
          
-    
          A delegated-events approach attaches an event handler to only one element, the tbody, and the event only needs to bubble up one level (from the clicked tr to tbody):
          
+    
          An event-delegation approach attaches an event handler to only one element, the tbody, and the event only needs to bubble up one level (from the clicked tr to tbody):
          
     
          
 $( "#dataTable tbody" ).on( "click", "tr", function() {
-  alert( $( this ).text() );
+  console.log( $( this ).text() );
 });
     
          
     
          Note: Delegated events do not work for SVG.
          

From b19ce2a46f6fccee8b9b8334a3ecc26f2ac30a22 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Sun, 18 Jan 2015 17:38:59 -0500
Subject: [PATCH 180/699] 1.11.41

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 6c608d92..3f4c81e4 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.40",
+  "version": "1.11.41",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 1bf56e3d650b398e80f64f189304f50d81cfc996 Mon Sep 17 00:00:00 2001
From: Anne-Gaelle Colom 
Date: Sun, 18 Jan 2015 10:59:59 +0000
Subject: [PATCH 181/699] Submit-selector: Fix indentation for closing style
 tag

Closes gh-627
---
 entries/submit-selector.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/submit-selector.xml b/entries/submit-selector.xml
index dfb9ca72..a4c9aa01 100644
--- a/entries/submit-selector.xml
+++ b/entries/submit-selector.xml
@@ -39,7 +39,7 @@ $( "#exampleTable" ).find( "td" ).each(function( i, el ) {
   textarea {
     height: 45px;
   }
-  ]]>
+]]>
     
 

From 310a550cee5bcf065ec566350d0c16553695c196 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Mon, 19 Jan 2015 20:06:12 +0100
Subject: [PATCH 182/699] 1.11.42

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 3f4c81e4..58e7ae6f 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.41",
+  "version": "1.11.42",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From eb06b0e6c3f6b3790dd617f25ae608033cdea187 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sat, 10 Jan 2015 17:16:10 +0100
Subject: [PATCH 183/699] Data: remove mention to `.data( "events" )`

Fixes gh-346
Closes gh-623
---
 entries/data.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/data.xml b/entries/data.xml
index bdd69604..944efa14 100644
--- a/entries/data.xml
+++ b/entries/data.xml
@@ -29,7 +29,7 @@ $( "body" ).data( { baz: [ 1, 2, 3 ] } );
 $( "body" ).data( "foo" ); // 52
 $( "body" ).data(); // { foo: 52, bar: { myType: "test", count: 40 }, baz: [ 1, 2, 3 ] }
       
-      
          In jQuery 1.4.3 setting an element's data object with .data(obj) extends the data previously stored with that element. jQuery itself uses the .data() method to save information under the names 'events' and 'handle', and also reserves any data name starting with an underscore ('_') for internal use.
          
+      
          In jQuery 1.4.3 setting an element's data object with .data(obj) extends the data previously stored with that element.
          
       
          Prior to jQuery 1.4.3 (starting in jQuery 1.4) the .data() method completely replaced all data, instead of just extending the data object. If you are using third-party plugins it may not be advisable to completely replace the element's data object, since plugins may have also set data.
          
       
          Due to the way browsers interact with plugins and external code, the .data() method cannot be used on <object> (unless it's a Flash plugin), <applet> or <embed> elements.
          
     

From c24d60b33a3a62187addb85731d1eee0bb71e9d6 Mon Sep 17 00:00:00 2001
From: George Mauer 
Date: Thu, 8 Jan 2015 23:12:52 -0600
Subject: [PATCH 184/699] jQuery.get, jQuery post: add new config object
 signature

Fixes gh-620
Closes gh-622
---
 entries/jQuery.get.xml  | 6 ++++++
 entries/jQuery.post.xml | 6 ++++++
 2 files changed, 12 insertions(+)

diff --git a/entries/jQuery.get.xml b/entries/jQuery.get.xml
index 396e58b0..411a5889 100644
--- a/entries/jQuery.get.xml
+++ b/entries/jQuery.get.xml
@@ -1,6 +1,12 @@
 
 
   jQuery.get()
+  
+    3.0
+    
+      A set of key/value pairs that configure the Ajax request. All properties except for url are optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) for a complete list of all settings. The type option will automatically be set to POST.
+    
+  
   
     1.0
     
diff --git a/entries/jQuery.post.xml b/entries/jQuery.post.xml
index c066cbf4..2300cbe7 100644
--- a/entries/jQuery.post.xml
+++ b/entries/jQuery.post.xml
@@ -1,6 +1,12 @@
 
 
   jQuery.post()
+  
+    3.0
+    
+      A set of key/value pairs that configure the Ajax request. All properties except for url are optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) for a complete list of all settings. Type will automatically be set to POST.
+    
+  
   
     1.0
     

From 12c4d7e52300cb723e6e11aaea401cb8ab0a6d85 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Tue, 20 Jan 2015 21:48:12 +0100
Subject: [PATCH 185/699] 1.11.43

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 58e7ae6f..4618da73 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.42",
+  "version": "1.11.43",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 7852b046241d2f3f4d571e2f6b534b91b077e0c6 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Thu, 22 Jan 2015 05:50:38 +0000
Subject: [PATCH 186/699] nth-last-of-type-selector: correct description

Fixes gh-603
Closes gh-629
---
 entries/nth-last-of-type-selector.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/nth-last-of-type-selector.xml b/entries/nth-last-of-type-selector.xml
index 91b3db02..eb96db43 100644
--- a/entries/nth-last-of-type-selector.xml
+++ b/entries/nth-last-of-type-selector.xml
@@ -8,7 +8,7 @@
       The index of each child to match, starting with the last one (1), the string even or odd, or an equation ( eg. :nth-last-of-type(even), :nth-last-of-type(4n) )
     
   
-  Selects all elements that are the nth-child of their parent, counting from the last element to the first.
+  Selects all the elements that are the nth-child of their parent in relation to siblings with the same element name, counting from the last element to the first.
   
     
          Because jQuery's implementation of :nth- selectors is strictly derived from the CSS specification, the value of n is "1-indexed", meaning that the counting starts at 1. For other selector expressions such as :eq() or :even jQuery follows JavaScript's "0-indexed" counting. Given a single <ul> containing three <li>s, $('li:nth-last-of-type(1)') selects the third, last, <li>.
          
     
          Further discussion of this usage can be found in the W3C CSS specification.
          

From 4f1bd2b871d3b2e221bd729f4b95bdb2af0c19ce Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Thu, 22 Jan 2015 15:01:11 +0000
Subject: [PATCH 187/699] jQuery.param: add jQuery collection as possible type

Fixes gh-598
Closes gh-631
---
 entries/jQuery.param.xml | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/entries/jQuery.param.xml b/entries/jQuery.param.xml
index 56d88fc6..bc715497 100644
--- a/entries/jQuery.param.xml
+++ b/entries/jQuery.param.xml
@@ -6,7 +6,8 @@
     
       
       
-      An array or object to serialize.
+      
+      An array, a plain object, or a jQuery object to serialize.
     
             
   
@@ -14,13 +15,14 @@
     
       
       
-      An array or object to serialize.
+      
+      An array, a plain object, or a jQuery object to serialize.
     
     
       A Boolean indicating whether to perform a traditional "shallow" serialization.
     
   
-  Create a serialized representation of an array or object, suitable for use in a URL query string or Ajax request. 
+  Create a serialized representation of an array, a plain object, or a jQuery object suitable for use in a URL query string or Ajax request. In case a jQuery object is passed, it should contain <input> elements with name/value properties.
   
     
          This function is used internally to convert form element values into a serialized string representation (See .serialize() for more information).
          
     
          As of jQuery 1.3, the return value of a function is used instead of the function as a String.
          

From 2f2a30a8ee4f9fb5c3e35c99c2207da809f12e80 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 22 Jan 2015 19:48:19 +0100
Subject: [PATCH 188/699] 1.11.44

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 4618da73..aa4a7722 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.43",
+  "version": "1.11.44",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 52a1b7d7cbba2645f72f78f945f0ac150ddbd50b Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sat, 3 Jan 2015 14:20:22 +0100
Subject: [PATCH 189/699] change: note that JS-initiated change does not
 trigger change event

Fixes gh-345
Closes gh-617
---
 entries/change.xml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/entries/change.xml b/entries/change.xml
index 4884ff1e..97a9b5e7 100644
--- a/entries/change.xml
+++ b/entries/change.xml
@@ -52,6 +52,9 @@ $( "#other" ).click(function() {
     
     
          After this code executes, clicks on Trigger the handler will also alert the message. The message will display twice, because the handler has been bound to the change event on both of the form elements.
          
     
          As of jQuery 1.4, the change event bubbles in Internet Explorer, behaving consistently with the event in other modern browsers.
          
+    
          
+	  
          Note: Changing the value of an input element using JavaScript, using .val() for example, won't fire the event.
          
+    
          
             
   
     Attaches a change event to the select that gets the text for each selected option and writes them in the div.  It then triggers the event for the initial text draw.

From baef2154dccfb55c68b90da70d4eca94391e84e4 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Fri, 23 Jan 2015 14:18:25 +0000
Subject: [PATCH 190/699] off: add `.off(Event_object)` signature

Fixes gh-384
Closes gh-634
---
 entries/off.xml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/entries/off.xml b/entries/off.xml
index b83e3868..2c711a68 100644
--- a/entries/off.xml
+++ b/entries/off.xml
@@ -24,6 +24,12 @@
       A selector which should match the one originally passed to .on() when attaching event handlers.
     
   
+  
+    1.7
+    
+      A jQuery.Event object.
+    
+  
   
     1.7
   

From 860f822b19b08cb3f2331efe751e0befbf6a95fe Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sun, 25 Jan 2015 21:56:40 +0100
Subject: [PATCH 191/699] 1.11.45

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index aa4a7722..79654d03 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.44",
+  "version": "1.11.45",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 8642d2e4a6a54f25b54bf04998d6db108b1fee0e Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Fri, 23 Jan 2015 23:50:14 +0000
Subject: [PATCH 192/699] unbind: update the signature to take a jQuery.Event
 object

---
 entries/unbind.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/unbind.xml b/entries/unbind.xml
index f7f61514..e6be9a13 100644
--- a/entries/unbind.xml
+++ b/entries/unbind.xml
@@ -23,8 +23,8 @@
   
   
     1.0
-    
-      A JavaScript event object as passed to an event handler.
+    
+      A jQuery.Event object.
     
   
   

From 3a5ff1550bce6e0879f65d0bf67906753d4f6662 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sat, 31 Jan 2015 17:52:07 +0100
Subject: [PATCH 193/699] 1.11.46

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 79654d03..6e48a8e8 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.45",
+  "version": "1.11.46",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 3282ee5bc0473ab2b414865eb71a5752d48c9ca6 Mon Sep 17 00:00:00 2001
From: LaurentBarbareau 
Date: Thu, 20 Nov 2014 15:49:46 +0100
Subject: [PATCH 194/699] jQuery.ajax: remove misplaced word

Closes gh-595
---
 entries/jQuery.ajax.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index 21463bb8..d7362cb2 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -43,7 +43,7 @@
         When sending data to the server, use this content type. Default is "application/x-www-form-urlencoded; charset=UTF-8", which is fine for most cases.  If you explicitly pass in a content-type to $.ajax(), then it is always sent to the server (even if no data is sent).  As of jQuery 1.6 you can pass false to tell jQuery to not set any content type header.  Note: The W3C XMLHttpRequest specification dictates that the charset is always UTF-8; specifying another charset will not force the browser to change the encoding. Note: For cross-domain requests, setting the content type to anything other than application/x-www-form-urlencoded, multipart/form-data, or text/plain will trigger the browser to send a preflight OPTIONS request to the server.
       
       
-        This object will be made the context of all Ajax-related callbacks. By default, the context is an object that represents the ajax settings used in the call ($.ajaxSettings merged with the settings passed to $.ajax). For example,  specifying a DOM element as the context will make that the context for the complete callback of a request, like so:
+        This object will be the context of all Ajax-related callbacks. By default, the context is an object that represents the ajax settings used in the call ($.ajaxSettings merged with the settings passed to $.ajax). For example,  specifying a DOM element as the context will make that the context for the complete callback of a request, like so:
           
          
 $.ajax({
   url: "test.html",

From 881570d8fb901e0724d0ce17d8b6b5d3bab53bff Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sat, 31 Jan 2015 18:05:43 +0100
Subject: [PATCH 195/699] 1.11.47

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 6e48a8e8..9521f6f8 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.46",
+  "version": "1.11.47",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 76c6268061695b515ae7151aecab1a8f2af38efa Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 29 Jan 2015 17:38:02 +0100
Subject: [PATCH 196/699] jQuery.get: fix default for `type` option

Closes gh-640
---
 entries/jQuery.get.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.get.xml b/entries/jQuery.get.xml
index 411a5889..aefc58fa 100644
--- a/entries/jQuery.get.xml
+++ b/entries/jQuery.get.xml
@@ -4,7 +4,7 @@
   
     3.0
     
-      A set of key/value pairs that configure the Ajax request. All properties except for url are optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) for a complete list of all settings. The type option will automatically be set to POST.
+      A set of key/value pairs that configure the Ajax request. All properties except for url are optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) for a complete list of all settings. The type option will automatically be set to GET.
     
   
   

From 0e02309cbd780a5ff1885ff68931e55ebedacc31 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sun, 1 Feb 2015 00:24:57 +0100
Subject: [PATCH 197/699] 1.11.48

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 9521f6f8..99e2e45e 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.47",
+  "version": "1.11.48",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 91d4fa56916c7d5cf03296bd8c55e7bfc0b6bf3d Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 26 Jan 2015 17:09:07 +0000
Subject: [PATCH 198/699] jQuery.param: remove code in summary

Fixes gh-636
Closes gh-637
---
 entries/jQuery.param.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.param.xml b/entries/jQuery.param.xml
index bc715497..468b6db9 100644
--- a/entries/jQuery.param.xml
+++ b/entries/jQuery.param.xml
@@ -22,7 +22,7 @@
       A Boolean indicating whether to perform a traditional "shallow" serialization.
     
   
-  Create a serialized representation of an array, a plain object, or a jQuery object suitable for use in a URL query string or Ajax request. In case a jQuery object is passed, it should contain <input> elements with name/value properties.
+  Create a serialized representation of an array, a plain object, or a jQuery object suitable for use in a URL query string or Ajax request. In case a jQuery object is passed, it should contain input elements with name/value properties.
   
     
          This function is used internally to convert form element values into a serialized string representation (See .serialize() for more information).
          
     
          As of jQuery 1.3, the return value of a function is used instead of the function as a String.
          

From 996e73b0fd0f0a6845e7f1054d7eb0174606f8f9 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sun, 1 Feb 2015 20:04:31 +0100
Subject: [PATCH 199/699] 1.11.49

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 99e2e45e..a8c1981f 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.48",
+  "version": "1.11.49",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From e82e9db30568ee50474e5d2251d19aa87d6e043d Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Wed, 28 Jan 2015 16:52:15 +0100
Subject: [PATCH 200/699] Unload: update examples using `alert()`

Fixes gh-388
Closes gh-639
---
 entries/unload.xml | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/entries/unload.xml b/entries/unload.xml
index e7c12492..e33dc639 100644
--- a/entries/unload.xml
+++ b/entries/unload.xml
@@ -28,18 +28,16 @@
     
          Any unload event handler should be bound to the window object:
          
     
          
 $( window ).unload(function() {
-  alert( "Handler for .unload() called." );
+  return "Handler for .unload() called.";
 });
     
          
-    
          After this code executes, the alert will be displayed whenever the browser leaves the current page.
-It is not possible to cancel the unload event with .preventDefault(). This event is available so that scripts can perform cleanup when the user leaves the page.
-    
          
+    
          This event is available so that scripts can perform cleanup when the user leaves the page. Most browsers will ignore calls to alert(), confirm() and prompt() inside the event handler. The string you return may be used in a confirmation dialog, but not all browsers support this. It is not possible to cancel the unload event with .preventDefault().
          
             
   
     To display an alert when a page is unloaded:
     
   

From 2213245a65baad50a0cf31023c8e0b84bf6ad6eb Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Mon, 2 Feb 2015 22:14:27 +0100
Subject: [PATCH 201/699] 1.11.50

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index a8c1981f..390c9b3d 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.49",
+  "version": "1.11.50",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 3cbcc98ce3e1185c72687e1949d1773280b78db6 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 13 Jul 2014 16:10:29 +0100
Subject: [PATCH 202/699] css: document passing an empty string as a second
 parameter

Closes gh-528
---
 entries/css.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/css.xml b/entries/css.xml
index 178fc326..1f441945 100644
--- a/entries/css.xml
+++ b/entries/css.xml
@@ -143,7 +143,7 @@ $( "div" ).click(function() {
     
       
          As with the .prop() method, the .css() method makes setting properties of elements quick and easy. This method can take either a property name and value as separate parameters, or a single object of key-value pairs.
          
       
          Also, jQuery can equally interpret the CSS and DOM formatting of multiple-word properties. For example, jQuery understands and returns the correct value for both .css({ "background-color": "#ffe", "border-left": "5px solid #ccc" }) and .css({backgroundColor: "#ffe", borderLeft: "5px solid #ccc" }). Notice that with the DOM notation, quotation marks around the property names are optional, but with CSS notation they're required due to the hyphen in the name.
          
-      
          When using .css() as a setter, jQuery modifies the element's style property. For example,  $( "#mydiv" ).css( "color", "green" ) is equivalent to document.getElementById( "mydiv" ).style.color = "green". Setting the value of a style property to an empty string — e.g. $( "#mydiv" ).css( "color", "" ) — removes that property from an element if it has already been directly applied, whether in the HTML style attribute, through jQuery's .css() method, or through direct DOM manipulation of the style property. It does not, however, remove a style that has been applied with a CSS rule in a stylesheet or <style> element. Warning: one notable exception is that, for IE 8 and below, removing a shorthand property such as border or background will remove that style entirely from the element, regardless of what is set in a stylesheet or <style> element.
          
+      
          When using .css() as a setter, jQuery modifies the element's style property. For example,  $( "#mydiv" ).css( "color", "green" ) is equivalent to document.getElementById( "mydiv" ).style.color = "green". Setting the value of a style property to an empty string — e.g. $( "#mydiv" ).css( "color", "" ) — removes that property from an element if it has already been directly applied, whether in the HTML style attribute, through jQuery's .css() method, or through direct DOM manipulation of the style property. As a consequence, the element's style for that property will be restored to whatever value was applied. So, this method can be used to cancel any style modification you have previously performed. It does not, however, remove a style that has been applied with a CSS rule in a stylesheet or <style> element. Warning: one notable exception is that, for IE 8 and below, removing a shorthand property such as border or background will remove that style entirely from the element, regardless of what is set in a stylesheet or <style> element.
          
       
          As of jQuery 1.6, .css() accepts relative values similar to .animate(). Relative values are a string starting with += or -= to increment or decrement the current value. For example, if an element's padding-left was 10px, .css( "padding-left", "+=15" ) would result in a total padding-left of 25px.
          
       
          As of jQuery 1.4, .css() allows us to pass a function as the property value:
          
       
          

From f348efd916559081f0acdcd0b55508ca680bd697 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Tue, 3 Feb 2015 20:58:02 +0100
Subject: [PATCH 203/699] 1.11.51

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 390c9b3d..ae302c92 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.50",
+  "version": "1.11.51",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From b4b273fa0ca113037f8c42e26a117aea06dd3624 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Thu, 5 Feb 2015 23:46:04 +0000
Subject: [PATCH 204/699] val: mention support for numbers

Fixes gh-624
Closes gh-645
---
 entries/val.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/entries/val.xml b/entries/val.xml
index 27cbc392..bb5f03e2 100644
--- a/entries/val.xml
+++ b/entries/val.xml
@@ -106,8 +106,9 @@ $( "input" )
       1.0
       
         
+        
         
-        A string of text or an array of strings corresponding to the value of each matched element to set as selected/checked.
+        A string of text, a number, or an array of strings corresponding to the value of each matched element to set as selected/checked.
       
     
     

From fe4e1b848cf8f9ca58de36c40bada8f85575d9c9 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Fri, 6 Feb 2015 07:18:34 +0100
Subject: [PATCH 205/699] 1.11.52

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index ae302c92..84c9e073 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.51",
+  "version": "1.11.52",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 3aeb4c237861831b0ddc5da3034e56f32f466e71 Mon Sep 17 00:00:00 2001
From: Ian MacIntosh 
Date: Fri, 21 Nov 2014 11:30:25 -0500
Subject: [PATCH 206/699] jQuery.ajax: Add request status 'nocontent'

Closes gh-596
---
 entries/jQuery.ajax.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index d7362cb2..af8c2cd7 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -32,7 +32,7 @@
       
         
         
-        A function to be called when the request finishes (after success and error callbacks are executed). The function gets passed two arguments: The jqXHR (in jQuery 1.4.x, XMLHTTPRequest) object and a string categorizing the status of the request ("success", "notmodified", "error", "timeout", "abort", or "parsererror"). As of jQuery 1.5, the complete setting can accept an array of functions. Each function will be called in turn. This is an Ajax Event.
+        A function to be called when the request finishes (after success and error callbacks are executed). The function gets passed two arguments: The jqXHR (in jQuery 1.4.x, XMLHTTPRequest) object and a string categorizing the status of the request ("success", "notmodified", "nocontent", "error", "timeout", "abort", or "parsererror"). As of jQuery 1.5, the complete setting can accept an array of functions. Each function will be called in turn. This is an Ajax Event.
       
       
         An object of string/regular-expression pairs that determine how jQuery will parse the response, given its content type.

From 2ce5e66788612dcd7ee72ebc34119c6c2a968fd9 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Fri, 6 Feb 2015 20:45:34 +0100
Subject: [PATCH 207/699] 1.11.53

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 84c9e073..ec105d55 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.52",
+  "version": "1.11.53",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From da211e93e0a9322c8853e45df76f18dfd77ce2b5 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Tue, 6 Jan 2015 22:16:20 +0100
Subject: [PATCH 208/699] css: add info on automatic prefixing since 1.8

Fixes gh-339
Closes gh-621
---
 entries/css.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/entries/css.xml b/entries/css.xml
index 1f441945..c2e0ae50 100644
--- a/entries/css.xml
+++ b/entries/css.xml
@@ -144,6 +144,7 @@ $( "div" ).click(function() {
       
          As with the .prop() method, the .css() method makes setting properties of elements quick and easy. This method can take either a property name and value as separate parameters, or a single object of key-value pairs.
          
       
          Also, jQuery can equally interpret the CSS and DOM formatting of multiple-word properties. For example, jQuery understands and returns the correct value for both .css({ "background-color": "#ffe", "border-left": "5px solid #ccc" }) and .css({backgroundColor: "#ffe", borderLeft: "5px solid #ccc" }). Notice that with the DOM notation, quotation marks around the property names are optional, but with CSS notation they're required due to the hyphen in the name.
          
       
          When using .css() as a setter, jQuery modifies the element's style property. For example,  $( "#mydiv" ).css( "color", "green" ) is equivalent to document.getElementById( "mydiv" ).style.color = "green". Setting the value of a style property to an empty string — e.g. $( "#mydiv" ).css( "color", "" ) — removes that property from an element if it has already been directly applied, whether in the HTML style attribute, through jQuery's .css() method, or through direct DOM manipulation of the style property. As a consequence, the element's style for that property will be restored to whatever value was applied. So, this method can be used to cancel any style modification you have previously performed. It does not, however, remove a style that has been applied with a CSS rule in a stylesheet or <style> element. Warning: one notable exception is that, for IE 8 and below, removing a shorthand property such as border or background will remove that style entirely from the element, regardless of what is set in a stylesheet or <style> element.
          
+      
          As of jQuery 1.8, the .css() setter will automatically take care of prefixing the property name. For example, take .css( "user-select", "none" ) in Chrome/Safari will set it as -webkit-user-select, Firefox will use -moz-user-select, and IE10 will use -ms-user-select.
          
       
          As of jQuery 1.6, .css() accepts relative values similar to .animate(). Relative values are a string starting with += or -= to increment or decrement the current value. For example, if an element's padding-left was 10px, .css( "padding-left", "+=15" ) would result in a total padding-left of 25px.
          
       
          As of jQuery 1.4, .css() allows us to pass a function as the property value:
          
       
          

From 8d907790537c98a0bd401b01725e2de78488384f Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sat, 7 Feb 2015 09:44:08 +0100
Subject: [PATCH 209/699] 1.11.54

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index ec105d55..24c75964 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.53",
+  "version": "1.11.54",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 1fc9603a29a9d0f8f0fdcd7a03a6da68c5dc1ae7 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Fri, 6 Feb 2015 20:01:09 +0100
Subject: [PATCH 210/699] css: clarify getter returns computed value

Fixes gh-326
Closes gh-646
---
 entries/css.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/css.xml b/entries/css.xml
index c2e0ae50..7778699f 100644
--- a/entries/css.xml
+++ b/entries/css.xml
@@ -1,6 +1,6 @@
 
 
-  Get the value of a style property for the first element in the set of matched elements or set one or more CSS properties for every matched element.
+  Get the value of a computed style property for the first element in the set of matched elements or set one or more CSS properties for every matched element.
   
     .css()
     
@@ -17,7 +17,7 @@
     
     Get the computed style properties for the first element in the set of matched elements.
     
-      
          The .css() method is a convenient way to get a style property from the first matched element, especially in light of the different ways browsers access most of those properties (the getComputedStyle() method in standards-based browsers versus the currentStyle and runtimeStyle properties in Internet Explorer) and the different terms browsers use for certain properties. For example, Internet Explorer's DOM implementation refers to the float property as styleFloat, while W3C standards-compliant browsers refer to it as cssFloat. For consistency, you can simply use "float", and jQuery will translate it to the correct value for each browser.
          
+      
          The .css() method is a convenient way to get a computed style property from the first matched element, especially in light of the different ways browsers access most of those properties (the getComputedStyle() method in standards-based browsers versus the currentStyle and runtimeStyle properties in Internet Explorer) and the different terms browsers use for certain properties. For example, Internet Explorer's DOM implementation refers to the float property as styleFloat, while W3C standards-compliant browsers refer to it as cssFloat. For consistency, you can simply use "float", and jQuery will translate it to the correct value for each browser.
          
       
          Also, jQuery can equally interpret the CSS and DOM formatting of multiple-word properties. For example, jQuery understands and returns the correct value for both .css( "background-color" ) and .css( "backgroundColor" ).
          
 	  
          Note that the computed style of an element may not be the same as the value specified for that element in a style sheet. For example, computed styles of dimensions are almost always pixels, but they can be specified as em, ex, px or % in a style sheet. Different browsers may return CSS color values that are logically but not textually equal, e.g., #FFF, #ffffff, and rgb(255,255,255).
          
       
          Retrieval of shorthand CSS properties (e.g., margin, background, border), although functional with some browsers, is not guaranteed. For example, if you want to retrieve the rendered border-width, use: $( elem ).css( "borderTopWidth" ), $( elem ).css( "borderBottomWidth" ), and so on.
          

From 7eeea9584ead9339b2b56bc5ea0e2e0a71931be2 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sat, 7 Feb 2015 23:45:29 +0100
Subject: [PATCH 211/699] 1.11.55

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 24c75964..10a7c84c 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.54",
+  "version": "1.11.55",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From c64b9904930610da21710afac66be48fd87cef34 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sun, 8 Feb 2015 16:32:29 +0100
Subject: [PATCH 212/699] outerHeight: document the method as a setter

Closes gh-647
Ref gh-98
---
 entries/outerHeight.xml | 62 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 62 insertions(+)

diff --git a/entries/outerHeight.xml b/entries/outerHeight.xml
index 302de40d..38b8816d 100644
--- a/entries/outerHeight.xml
+++ b/entries/outerHeight.xml
@@ -1,4 +1,6 @@
 
+
+  Get the current computed height for the first element in the set of matched elements, including padding, border, and optionally margin. Returns a number (without "px") representation of the value or null if called on an empty set of elements.
 
   .outerHeight()
   
@@ -41,3 +43,63 @@ $( "p:last" ).text(
   
   
 
+
+
+  
+    1.8.0
+    
+      
+      
+      A number representing the number of pixels, or a number along with an optional unit of measure appended (as a string).
+    
+  
+  
+    1.8.0
+    
+      A function returning the outer height to set. Receives the index position of the element in the set and the old outer height as arguments. Within the function, this refers to the current element in the set.
+    
+  
+  Set the CSS outer Height of each element in the set of matched elements.
+  
+    
          When calling .outerHeight(value), the value can be either a string (number and unit) or a number. If only a number is provided for the value, jQuery assumes a pixel unit. If a string is provided, however, any valid CSS measurement may be used (such as 100px, 50%, or auto).
          
+            
+
+  
+    Change the outer height of each div the first time it is clicked (and change its color).
+    
+    
+    d
+
          d
          
+
          d
          
+
          d
          
+
          d
          
+]]>
+            
+
+  
+  
+  
+  
+          
+          

From aaea07c7e885ffd7b65e7c8907784788001eaf8c Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Mon, 9 Feb 2015 17:41:57 +0100
Subject: [PATCH 213/699] 1.11.56

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 10a7c84c..98c84f0c 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.55",
+  "version": "1.11.56",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 80d53f0433fabb30ea069d011e0587bf2b6bb180 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Mon, 9 Feb 2015 21:42:10 +0100
Subject: [PATCH 214/699] outerWidth: document method as a setter

Fixes gh-98
Closes gh-648
---
 entries/outerWidth.xml | 61 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)

diff --git a/entries/outerWidth.xml b/entries/outerWidth.xml
index d9cda5a7..f5ac7b0d 100644
--- a/entries/outerWidth.xml
+++ b/entries/outerWidth.xml
@@ -1,4 +1,6 @@
 
+
+  Get the current computed width for the first element in the set of matched elements, including padding and border.
 
   .outerWidth()
   
@@ -42,3 +44,62 @@ $( "p:last" ).text(
   
   
 
+
+  
+    1.8.0
+    
+      
+      
+      A number representing the number of pixels, or a number along with an optional unit of measure appended (as a string).
+    
+  
+  
+    1.8.0
+    
+      A function returning the outer width to set. Receives the index position of the element in the set and the old outer width as arguments. Within the function, this refers to the current element in the set.
+    
+  
+  Set the CSS outer width of each element in the set of matched elements.
+  
+    
          When calling .outerWidth(value), the value can be either a string (number and unit) or a number. If only a number is provided for the value, jQuery assumes a pixel unit. If a string is provided, however, any valid CSS measurement may be used (such as 100px, 50%, or auto).
          
+            
+  
+  
+    Change the outer width of each div the first time it is clicked (and change its color).
+    
+    
+    d
+
          d
          
+
          d
          
+
          d
          
+
          d
          
+]]>
+            
+  
+  
+  
+  
+  
+          
+          

From 14d39448abfadfd2625090ec8cb47d32b15349e7 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Tue, 10 Feb 2015 07:06:21 +0100
Subject: [PATCH 215/699] 1.11.57

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 98c84f0c..ca407be9 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.56",
+  "version": "1.11.57",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From fa97019e2d8a71b1d2dde1ec6ffe9263600f1e1c Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Tue, 10 Feb 2015 21:11:10 +0100
Subject: [PATCH 216/699] Types: add `progress` to list of methods on a Promise

Fixes gh-355
Closes gh-649
---
 pages/Types.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pages/Types.html b/pages/Types.html
index c2b9d219..cd66dd4d 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -634,7 +634,7 @@ 
           Deferred Object
          
 
          As of jQuery 1.5, the Deferred object provides a way to register multiple callbacks into self-managed callback queues, invoke callback queues as appropriate, and relay the success or failure state of any synchronous or asynchronous function.
 
          
 
           Promise Object
          
-
          This object provides a subset of the methods of the Deferred object (then, done, fail, always, pipe, and state) to prevent users from changing the state of the Deferred.
+
          This object provides a subset of the methods of the Deferred object (then, done, fail, always, pipe, progress, and state) to prevent users from changing the state of the Deferred.
 
          
 
          Callbacks Object
          
 
          A multi-purpose object that provides a powerful way to manage callback lists. It supports adding, removing, firing, and disabling callbacks. The Callbacks object is created and returned by the $.Callbacks function and subsequently returned by most of that function's methods. 
          

From 7ed6ab885d51af1f427d93118410f3d0f54d96bd Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Wed, 11 Feb 2015 07:01:52 +0100
Subject: [PATCH 217/699] 1.11.58

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index ca407be9..0c2c1e89 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.57",
+  "version": "1.11.58",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From a6f6b373488782538bd6ff0905efb6a679e918cb Mon Sep 17 00:00:00 2001
From: Eric Mill 
Date: Sun, 1 Feb 2015 22:24:37 -0500
Subject: [PATCH 218/699] All: replace protocol-relative URLs

Fixes gh-613
Closes gh-641
---
 entries/jQuery.getScript.xml  | 2 +-
 entries/jQuery.noConflict.xml | 2 +-
 entries2html.xsl              | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/entries/jQuery.getScript.xml b/entries/jQuery.getScript.xml
index e36d021c..be884042 100644
--- a/entries/jQuery.getScript.xml
+++ b/entries/jQuery.getScript.xml
@@ -91,7 +91,7 @@ $.cachedScript( "ajax/test.js" ).done(function( script, textStatus ) {
   
     Load the official jQuery Color Animation plugin dynamically and bind some color animations to occur once the new functionality is loaded.
      p" ).hide();
 
          
   
          Before $.noConflict(true)
          
 
          
-
+
 ]]>
      demo</title>
 	<style>	</style>
-	<script src="//code.jquery.com/jquery-1.10.2.js"></script>
+	<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
 	<script>
 	
 	</script>

From f19b0e08d6fb4331139901b986f51a07493302c5 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Wed, 11 Feb 2015 20:12:38 +0100
Subject: [PATCH 219/699] 1.11.59

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 0c2c1e89..ac3c3d0a 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.58",
+  "version": "1.11.59",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 56151463d9b68f010c70f081568349591b81b746 Mon Sep 17 00:00:00 2001
From: burka 
Date: Mon, 16 Feb 2015 23:30:15 +0100
Subject: [PATCH 220/699] toggle: renamed toggle(showOrHide) to
 toggle(setShown)

To make it clear that passing true shows and passing false hides. Otherwise if you take showOrHide at its word, it would do nothing if you pass false and would call the regular toggle() if you pass true ;-)

Closes gh-654
---
 entries/toggle.xml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/entries/toggle.xml b/entries/toggle.xml
index 76d95f42..8fe34ab7 100644
--- a/entries/toggle.xml
+++ b/entries/toggle.xml
@@ -24,8 +24,8 @@
   
   
     1.3
-    
-      A Boolean indicating whether to show or hide the elements.
+    
+      Use true to show the element or false to hide it.
     
   
 
@@ -75,13 +75,13 @@ $( "#clickme" ).click(function() {
     
          The second version of the method accepts a Boolean parameter. If this parameter is true, then the matched elements are shown; if false, the elements are hidden. In essence, the statement:
     
          
     
          
-$( "#foo" ).toggle( showOrHide );
+$( "#foo" ).toggle( setShown );
     
          
     
          is equivalent to:
          
     
          
-if ( showOrHide === true ) {
+if ( setShown === true ) {
   $( "#foo" ).show();
-} else if ( showOrHide === false ) {
+} else if ( setShown === false ) {
   $( "#foo" ).hide();
 }
     
          

From 6c6858c3c4016f6b44e471967ba72d5fafccef06 Mon Sep 17 00:00:00 2001
From: Corey Frang 
Date: Tue, 17 Feb 2015 09:37:49 -0500
Subject: [PATCH 221/699] 1.11.60

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index ac3c3d0a..1c20ffa8 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.59",
+  "version": "1.11.60",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From ce73bb3c3d0ed1b8dfb157b07ff2a3e48c09b2fa Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Wed, 18 Feb 2015 16:36:16 +0100
Subject: [PATCH 222/699] css: add note about `px` being the default unit

Fixes gh-656
Closes gh-657
---
 entries/css.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/entries/css.xml b/entries/css.xml
index 7778699f..53ae097d 100644
--- a/entries/css.xml
+++ b/entries/css.xml
@@ -143,6 +143,7 @@ $( "div" ).click(function() {
     
       
          As with the .prop() method, the .css() method makes setting properties of elements quick and easy. This method can take either a property name and value as separate parameters, or a single object of key-value pairs.
          
       
          Also, jQuery can equally interpret the CSS and DOM formatting of multiple-word properties. For example, jQuery understands and returns the correct value for both .css({ "background-color": "#ffe", "border-left": "5px solid #ccc" }) and .css({backgroundColor: "#ffe", borderLeft: "5px solid #ccc" }). Notice that with the DOM notation, quotation marks around the property names are optional, but with CSS notation they're required due to the hyphen in the name.
          
+      
          When a number is passed as the value, jQuery will convert it to a string and add px to the end of that string. If the property requires units other than px, convert the value to a string and add the appropriate units before calling the method.
          
       
          When using .css() as a setter, jQuery modifies the element's style property. For example,  $( "#mydiv" ).css( "color", "green" ) is equivalent to document.getElementById( "mydiv" ).style.color = "green". Setting the value of a style property to an empty string — e.g. $( "#mydiv" ).css( "color", "" ) — removes that property from an element if it has already been directly applied, whether in the HTML style attribute, through jQuery's .css() method, or through direct DOM manipulation of the style property. As a consequence, the element's style for that property will be restored to whatever value was applied. So, this method can be used to cancel any style modification you have previously performed. It does not, however, remove a style that has been applied with a CSS rule in a stylesheet or <style> element. Warning: one notable exception is that, for IE 8 and below, removing a shorthand property such as border or background will remove that style entirely from the element, regardless of what is set in a stylesheet or <style> element.
          
       
          As of jQuery 1.8, the .css() setter will automatically take care of prefixing the property name. For example, take .css( "user-select", "none" ) in Chrome/Safari will set it as -webkit-user-select, Firefox will use -moz-user-select, and IE10 will use -ms-user-select.
          
       
          As of jQuery 1.6, .css() accepts relative values similar to .animate(). Relative values are a string starting with += or -= to increment or decrement the current value. For example, if an element's padding-left was 10px, .css( "padding-left", "+=15" ) would result in a total padding-left of 25px.
          

From f896bf48e8b0898f6f9d6692f70e182f9abf8729 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Wed, 18 Feb 2015 17:16:39 +0100
Subject: [PATCH 223/699] 1.11.61

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 1c20ffa8..ea142389 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.60",
+  "version": "1.11.61",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 94cf3d4975bf01b78af2cef88fa71ccdda86c8e5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Tue, 24 Feb 2015 10:07:54 -0500
Subject: [PATCH 224/699] Effects: Don't refer to objects as maps

Closes gh-664
---
 includes/options-argument.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/includes/options-argument.xml b/includes/options-argument.xml
index 110456cd..f62a8585 100644
--- a/includes/options-argument.xml
+++ b/includes/options-argument.xml
@@ -15,7 +15,7 @@
 		
 	
 	
-		A map of one or more of the CSS properties defined by the properties argument and their corresponding easing functions.
+		An object containing one or more of the CSS properties defined by the properties argument and their corresponding easing functions.
 	
 
 	

From 241c51f4a1c6ada8054ac803f31e48348116b5ed Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Wed, 25 Feb 2015 13:38:11 +0100
Subject: [PATCH 225/699] 1.11.62

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index ea142389..4c8c48b8 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.61",
+  "version": "1.11.62",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 6ba2a3fb0e8583e223091a09c9f7644a1bded34f Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Mon, 23 Feb 2015 22:00:47 +0100
Subject: [PATCH 226/699] jQuery.extend: simplify way of logging objects

Fixes gh-658
Closes gh-661
---
 entries/jQuery.extend.xml | 43 ++++++++-------------------------------
 1 file changed, 8 insertions(+), 35 deletions(-)

diff --git a/entries/jQuery.extend.xml b/entries/jQuery.extend.xml
index 958e9d14..ee6fb4a7 100644
--- a/entries/jQuery.extend.xml
+++ b/entries/jQuery.extend.xml
@@ -56,17 +56,8 @@ var object2 = {
 // Merge object2 into object1
 $.extend( object1, object2 );
 
-var printObj = typeof JSON !== "undefined" ? JSON.stringify : function( obj ) {
-  var arr = [];
-  $.each( obj, function( key, val ) {
-    var next = key + ": ";
-    next += $.isPlainObject( val ) ? printObj( val ) : val;
-    arr.push( next );
-  });
-  return "{ " +  arr.join( ", " ) + " }";
-};
-
-$( "#log" ).append( printObj( object1 ) );
+// Assuming JSON.stringify - not available in IE<8
+$( "#log" ).append( JSON.stringify( object1 ) );
 ]]>          
     
@@ -88,17 +79,8 @@ var object2 = {
 // Merge object2 into object1, recursively
 $.extend( true, object1, object2 );
 
-var printObj = typeof JSON !== "undefined" ? JSON.stringify : function( obj ) {
-  var arr = [];
-  $.each( obj, function( key, val ) {
-    var next = key + ": ";
-    next += $.isPlainObject( val ) ? printObj( val ) : val;
-    arr.push( next );
-  });
-  return "{ " +  arr.join( ", " ) + " }";
-};
-
-$( "#log" ).append( printObj( object1 ) );
+// Assuming JSON.stringify - not available in IE<8
+$( "#log" ).append( JSON.stringify( object1 ) );
 ]]>          
     
@@ -113,19 +95,10 @@ var options = { validate: true, name: "bar" };
 // Merge defaults and options, without modifying defaults
 var settings = $.extend( {}, defaults, options );
 
-var printObj = typeof JSON !== "undefined" ? JSON.stringify : function( obj ) {
-  var arr = [];
-  $.each( obj, function( key, val ) {
-    var next = key + ": ";
-    next += $.isPlainObject( val ) ? printObj( val ) : val;
-    arr.push( next );
-  });
-  return "{ " +  arr.join( ", " ) + " }";
-};
-
-$( "#log" ).append( "
          defaults -- " + printObj( defaults ) + "
          " );
-$( "#log" ).append( "
          options -- " + printObj( options ) + "
          " );
-$( "#log" ).append( "
          settings -- " + printObj( settings ) + "
          " );
+// Assuming JSON.stringify - not available in IE<8
+$( "#log" ).append( "
          defaults -- " + JSON.stringify( defaults ) + "
          " );
+$( "#log" ).append( "
          options -- " + JSON.stringify( options ) + "
          " );
+$( "#log" ).append( "
          settings -- " + JSON.stringify( settings ) + "
          " );
 ]]>
     

From 9df96fb1a02a6e24a7f5a413b56a97704902358e Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Wed, 25 Feb 2015 14:08:08 +0100
Subject: [PATCH 227/699] toggle: rename toggle(setShown) to toggle(display)

Fixes gh-655
Closes gh-666
---
 entries/toggle.xml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/entries/toggle.xml b/entries/toggle.xml
index 8fe34ab7..87cc15ce 100644
--- a/entries/toggle.xml
+++ b/entries/toggle.xml
@@ -24,7 +24,7 @@
   
   
     1.3
-    
+    
       Use true to show the element or false to hide it.
     
   
@@ -75,13 +75,13 @@ $( "#clickme" ).click(function() {
     
          The second version of the method accepts a Boolean parameter. If this parameter is true, then the matched elements are shown; if false, the elements are hidden. In essence, the statement:
     
          
     
          
-$( "#foo" ).toggle( setShown );
+$( "#foo" ).toggle( display );
     
          
     
          is equivalent to:
          
     
          
-if ( setShown === true ) {
+if ( display === true ) {
   $( "#foo" ).show();
-} else if ( setShown === false ) {
+} else if ( display === false ) {
   $( "#foo" ).hide();
 }
     
          

From e196de1ce926b033de7b6f5a62df013f86b8807f Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Wed, 25 Feb 2015 14:38:45 +0100
Subject: [PATCH 228/699] 1.11.63

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 4c8c48b8..372ec0f5 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.62",
+  "version": "1.11.63",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 19b38fb1b3c736403313a31ae1fdb80d1650d6ab Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sat, 28 Feb 2015 23:29:08 +0000
Subject: [PATCH 229/699] data: Removed trailing space

Closes gh-672
---
 entries/data.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/data.xml b/entries/data.xml
index 944efa14..f54a229c 100644
--- a/entries/data.xml
+++ b/entries/data.xml
@@ -21,7 +21,7 @@
     Store arbitrary data associated with the matched elements.
     
       
          The .data() method allows us to attach data of any type to DOM elements in a way that is safe from circular references and therefore from memory leaks.
          
-      
           We can set several distinct values for a single element and retrieve them later:
          
+      
          We can set several distinct values for a single element and retrieve them later:
          
       
          
 $( "body" ).data( "foo", 52 );
 $( "body" ).data( "bar", { myType: "test", count: 40 } );

From 46bdad0e5d11d6925f7deb5c01f9c6841dce7fb6 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sun, 1 Mar 2015 11:56:34 +0100
Subject: [PATCH 230/699] css: add note about special meaning of mixed case

Fixes gh-357
Closes gh-674
---
 entries/css.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/css.xml b/entries/css.xml
index 53ae097d..e7a2891a 100644
--- a/entries/css.xml
+++ b/entries/css.xml
@@ -18,7 +18,7 @@
     Get the computed style properties for the first element in the set of matched elements.
     
       
          The .css() method is a convenient way to get a computed style property from the first matched element, especially in light of the different ways browsers access most of those properties (the getComputedStyle() method in standards-based browsers versus the currentStyle and runtimeStyle properties in Internet Explorer) and the different terms browsers use for certain properties. For example, Internet Explorer's DOM implementation refers to the float property as styleFloat, while W3C standards-compliant browsers refer to it as cssFloat. For consistency, you can simply use "float", and jQuery will translate it to the correct value for each browser.
          
-      
          Also, jQuery can equally interpret the CSS and DOM formatting of multiple-word properties. For example, jQuery understands and returns the correct value for both .css( "background-color" ) and .css( "backgroundColor" ).
          
+      
          Also, jQuery can equally interpret the CSS and DOM formatting of multiple-word properties. For example, jQuery understands and returns the correct value for both .css( "background-color" ) and .css( "backgroundColor" ). This means mixed case has a special meaning, .css( "WiDtH" ) won't do the same as .css( "width" ), for example.
          
 	  
          Note that the computed style of an element may not be the same as the value specified for that element in a style sheet. For example, computed styles of dimensions are almost always pixels, but they can be specified as em, ex, px or % in a style sheet. Different browsers may return CSS color values that are logically but not textually equal, e.g., #FFF, #ffffff, and rgb(255,255,255).
          
       
          Retrieval of shorthand CSS properties (e.g., margin, background, border), although functional with some browsers, is not guaranteed. For example, if you want to retrieve the rendered border-width, use: $( elem ).css( "borderTopWidth" ), $( elem ).css( "borderBottomWidth" ), and so on.
          
       
          As of jQuery 1.9, passing an array of style properties to .css() will result in an object of property-value pairs. For example, to retrieve all four rendered border-width values, you could use $( elem ).css([ "borderTopWidth", "borderRightWidth", "borderBottomWidth", "borderLeftWidth" ]). 
          

From 578de69a455656b63ad78ed161765532d89b7016 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sun, 1 Mar 2015 12:18:08 +0100
Subject: [PATCH 231/699] html: warn about using `.html()` to insert scripts

Fixes gh-618
Closes gh-675
---
 entries/html.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/entries/html.xml b/entries/html.xml
index 0e9f9dcc..2fb32ea1 100644
--- a/entries/html.xml
+++ b/entries/html.xml
@@ -119,6 +119,7 @@ $( "div.demo-container" ).html(function() {
       
          
       
          Given a document with six paragraphs, this example will set the HTML of <div class="demo-container"> to <p>All new content for <em>6 paragraphs!</em></p>.
          
       
          This method uses the browser's innerHTML property. Some browsers may not generate a DOM that exactly replicates the HTML source provided. For example, Internet Explorer prior to version 8 will convert all href properties on links to absolute URLs, and Internet Explorer prior to version 9 will not correctly handle HTML5 elements without the addition of a separate compatibility layer.
          
+      
          To set the content of a <script> element, which does not contain HTML, use the .text() method and not .html().
          
       
          Note: In Internet Explorer up to and including version 9, setting the text content of an HTML element may corrupt the text nodes of its children that are being removed from the document as a result of the operation. If you are keeping references to these DOM elements and need them to be unchanged, use .empty().html( string ) instead of .html(string) so that the elements are removed from the document before the new string is assigned to the element.
          
               
     

From a2672e88a587b5e5004cb2f9bec03135f94043d7 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sun, 1 Mar 2015 20:32:42 +0100
Subject: [PATCH 232/699] 1.11.64

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 372ec0f5..5083da11 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.63",
+  "version": "1.11.64",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From b6fb719f93aa932dcb95424b98a8e9115d93a866 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Mon, 23 Feb 2015 21:40:30 +0100
Subject: [PATCH 233/699] css: add note about retrieving styles for detached
 elements

Fixes gh-653
Closes gh-660
---
 entries/css.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/entries/css.xml b/entries/css.xml
index e7a2891a..8fe89b20 100644
--- a/entries/css.xml
+++ b/entries/css.xml
@@ -21,6 +21,7 @@
       
          Also, jQuery can equally interpret the CSS and DOM formatting of multiple-word properties. For example, jQuery understands and returns the correct value for both .css( "background-color" ) and .css( "backgroundColor" ). This means mixed case has a special meaning, .css( "WiDtH" ) won't do the same as .css( "width" ), for example.
          
 	  
          Note that the computed style of an element may not be the same as the value specified for that element in a style sheet. For example, computed styles of dimensions are almost always pixels, but they can be specified as em, ex, px or % in a style sheet. Different browsers may return CSS color values that are logically but not textually equal, e.g., #FFF, #ffffff, and rgb(255,255,255).
          
       
          Retrieval of shorthand CSS properties (e.g., margin, background, border), although functional with some browsers, is not guaranteed. For example, if you want to retrieve the rendered border-width, use: $( elem ).css( "borderTopWidth" ), $( elem ).css( "borderBottomWidth" ), and so on.
          
+      
          An element should be connected to the DOM when calling .css() on it. If it isn't, jQuery may throw an error.
          
       
          As of jQuery 1.9, passing an array of style properties to .css() will result in an object of property-value pairs. For example, to retrieve all four rendered border-width values, you could use $( elem ).css([ "borderTopWidth", "borderRightWidth", "borderBottomWidth", "borderLeftWidth" ]). 
          
               
     

From be016ae1d0785684f469f03948d680c874734455 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Mon, 2 Mar 2015 18:20:08 +0100
Subject: [PATCH 234/699] 1.11.65

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 5083da11..6808cf77 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.64",
+  "version": "1.11.65",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 65ccd2d874532abca8e23f2174bf02d126f40046 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sun, 1 Mar 2015 15:45:49 +0100
Subject: [PATCH 235/699] README: fix link for getting xmllint and xsltproc

Fixes gh-668
Closes gh-676
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 67260550..f720120c 100644
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@ To build and deploy your changes for previewing in a [`jquery-wp-content`](https
 * [libxml2](http://xmlsoft.org/)
 * [libxslt](http://xmlsoft.org/libxslt/)
 
-The `xmllint` and `xsltproc` utilities need to be in your path. If you are on Windows, you can get libxml2 and libxslt from GnuWin32.
+The `xmllint` and `xsltproc` utilities need to be in your path. If you are on Windows, you can get libxml2 and libxslt from zlatkovic.com.
 
 ## Style Guidelines
 

From ce0cb62258f149f8758583952aa3483967a13c2b Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Wed, 4 Mar 2015 07:02:33 +0100
Subject: [PATCH 236/699] 1.11.66

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 6808cf77..e369ba64 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.65",
+  "version": "1.11.66",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From f161bb0f3cd79ba4d00920dbb170e94bda57d86e Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sat, 28 Feb 2015 22:41:25 +0000
Subject: [PATCH 237/699] on: add note about removing a listener during the
 event

Fixes gh-665
Closes gh-670
---
 entries/on.xml | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/entries/on.xml b/entries/on.xml
index 0f2f9474..9a7e66ed 100644
--- a/entries/on.xml
+++ b/entries/on.xml
@@ -96,6 +96,21 @@ $( "button" ).on( "click", {
     
          The focus and blur events are specified by the W3C to not bubble, but jQuery defines cross-browser focusin and focusout events that do bubble. When focus and blur are used to attach delegated event handlers, jQuery maps the names and delivers them as focusin and focusout respectively. For consistency and clarity, use the bubbling event type names.
          
     
          In all browsers, the load, scroll, and error events (e.g., on an <img> element) do not bubble. In Internet Explorer 8 and lower, the paste and reset events do not bubble. Such events are not supported for use with delegation, but they can be used when the event handler is directly attached to the element generating the event.
          
     
          The error event on the window object uses nonstandard arguments and return value conventions, so it is not supported by jQuery. Instead, assign a handler function directly to the window.onerror property.
          
+    
          The handler list for an element is set when the event is first delivered. Adding or removing event handlers on the current element won't take effect until the next time the event is handled. To prevent any further event handlers from executing on an element within an event handler, call event.stopImmediatePropagation(). This behavior goes against the W3C events specification. To better understand this case, consider the following code:
          
+    
          var $test = $( "#test" );
+
+function handler1() {
+  console.log( "handler1" );
+  $test.off( "click", handler2 );
+}
+
+function handler2() {
+  console.log( "handler2" );
+}
+
+$test.on( "click", handler1 );
+$test.on( "click", handler2 );
          
+    
          In the code above, handler2 will be executed anyway the first time even if it's removed using .off(). However, the handler will not be executed the following times the click event is triggered.
          
   
   
     Display a paragraph's text in an alert when it is clicked:

From 2a93e015e81b8acd40357a094b2f6b036508a053 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Fri, 6 Mar 2015 22:39:58 +0100
Subject: [PATCH 238/699] 1.11.67

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index e369ba64..c2afc6fd 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.66",
+  "version": "1.11.67",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From ac8f3e1d1df5217f6e319aa624298fb92c5a2dee Mon Sep 17 00:00:00 2001
From: Chad Killingsworth 
Date: Thu, 15 Jan 2015 10:41:01 -0600
Subject: [PATCH 239/699] Deferred: Refer to the method as a factory, not a
 constructor.

Closes gh-625
---
 entries/jQuery.Deferred.xml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/entries/jQuery.Deferred.xml b/entries/jQuery.Deferred.xml
index fa9455c0..2884ad87 100644
--- a/entries/jQuery.Deferred.xml
+++ b/entries/jQuery.Deferred.xml
@@ -14,10 +14,10 @@
       
     
   
-   A constructor function that returns a chainable utility object with methods to register multiple callbacks into callback queues, invoke callback queues, and relay the success or failure state of any synchronous or asynchronous function.
+   A factory function that returns a chainable utility object with methods to register multiple callbacks into callback queues, invoke callback queues, and relay the success or failure state of any synchronous or asynchronous function.
   
-    
          The jQuery.Deferred() constructor creates a new Deferred object. The new operator is optional.
          
-    
          The jQuery.Deferred method can be passed an optional function, which is called just before the constructor returns and is passed the constructed deferred object as both the this object and as the first argument to the function. The called function can attach callbacks using deferred.then(), for example.
          
+    
          The jQuery.Deferred() factory creates a new deferred object.
          
+    
          The jQuery.Deferred method can be passed an optional function, which is called just before the method returns and is passed the new deferred object as both the this object and as the first argument to the function. The called function can attach callbacks using deferred.then(), for example.
          
     
          A Deferred object starts in the pending state. Any callbacks added to the object with deferred.then(), deferred.always(), deferred.done(), or deferred.fail() are queued to be executed later. Calling deferred.resolve() or deferred.resolveWith() transitions the Deferred into the resolved state and immediately executes any doneCallbacks that are set. Calling deferred.reject() or deferred.rejectWith() transitions the Deferred into the rejected state and immediately executes any failCallbacks that are set. Once the object has entered the resolved or rejected state, it stays in that state. Callbacks can still be added to the resolved or rejected Deferred — they will execute immediately.
          
     
          
       Enhanced Callbacks with jQuery Deferred

From 6ce2c3a69f17a3822c1c65853789b757444b7875 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Mon, 9 Mar 2015 07:09:38 +0100
Subject: [PATCH 240/699] 1.11.68

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index c2afc6fd..57b9de89 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.67",
+  "version": "1.11.68",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From cc962b2c26ef717f5440aa20c7e6640a0c16d21a Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sat, 28 Feb 2015 23:24:18 +0000
Subject: [PATCH 241/699] jQuery.ajax: add `method` option and update examples
 to use it

Fixes gh-609
Closes gh-671
---
 entries/jQuery.ajax.xml | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index af8c2cd7..428108d4 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -8,7 +8,7 @@
       A string containing the URL to which the request is sent.
     
     
-      A set of key/value pairs that configure the Ajax request. All settings are optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) below for a complete list of all settings. 
+      A set of key/value pairs that configure the Ajax request. All settings are optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) below for a complete list of all settings.
     
   
   
@@ -82,7 +82,7 @@ $.ajax({
         
         
         
-        A function to be called if the request fails. The function receives three arguments: The jqXHR (in jQuery 1.4.x, XMLHttpRequest) object, a string describing the type of error that occurred and an optional exception object, if one occurred. Possible values for the second argument (besides null) are "timeout", "error", "abort", and "parsererror". When an HTTP error occurs, errorThrown receives the textual portion of the HTTP status, such as "Not Found" or "Internal Server Error."  As of jQuery 1.5, the error setting can accept an array of functions. Each function will be called in turn.  Note: This handler is not called for cross-domain script and cross-domain JSONP requests. This is an Ajax Event. 
+        A function to be called if the request fails. The function receives three arguments: The jqXHR (in jQuery 1.4.x, XMLHttpRequest) object, a string describing the type of error that occurred and an optional exception object, if one occurred. Possible values for the second argument (besides null) are "timeout", "error", "abort", and "parsererror". When an HTTP error occurs, errorThrown receives the textual portion of the HTTP status, such as "Not Found" or "Internal Server Error."  As of jQuery 1.5, the error setting can accept an array of functions. Each function will be called in turn.  Note: This handler is not called for cross-domain script and cross-domain JSONP requests. This is an Ajax Event.
       
       
         Whether to trigger global Ajax event handlers for this request. The default is true. Set to false to prevent the global handlers like ajaxStart or ajaxStop from being triggered. This can be used to control various Ajax Events.
@@ -94,7 +94,7 @@ $.ajax({
         Allow the request to be successful only if the response has changed since the last request. This is done by checking the Last-Modified header. Default value is false, ignoring the header. In jQuery 1.4 this technique also checks the 'etag' specified by the server to catch unmodified data.
       
       
-        Allow the current environment to be recognized as "local," (e.g. the filesystem), even if jQuery does not recognize it as such by default. The following protocols are currently recognized as local: file, *-extension, and widget. If the isLocal setting needs modification, it is recommended to do so once in the $.ajaxSetup() method.  
+        Allow the current environment to be recognized as "local," (e.g. the filesystem), even if jQuery does not recognize it as such by default. The following protocols are currently recognized as local: file, *-extension, and widget. If the isLocal setting needs modification, it is recommended to do so once in the $.ajaxSetup() method.
       
       
         Override the callback function name in a JSONP request.  This value will be used instead of 'callback' in the 'callback=?' part of the query string in the url.  So {jsonp:'onJSONPLoad'} would result in 'onJSONPLoad=?' passed to the server. As of jQuery 1.5, setting the jsonp option to false prevents jQuery from adding the "?callback" string to the URL or attempting to use "=?" for transformation. In this case, you should also explicitly set the jsonpCallback setting. For example, { jsonp: false, jsonpCallback: "callbackName" }
@@ -102,7 +102,10 @@ $.ajax({
       
         
         
-        Specify the callback function name for a JSONP request.  This value will be used instead of the random name automatically generated by jQuery. It is preferable to let jQuery generate a unique name as it'll make it easier to manage the requests and provide callbacks and error handling. You may want to specify the callback when you want to enable better browser caching of GET requests. As of jQuery 1.5, you can also use a function for this setting, in which case the value of jsonpCallback is set to the return value of that function. 
+        Specify the callback function name for a JSONP request.  This value will be used instead of the random name automatically generated by jQuery. It is preferable to let jQuery generate a unique name as it'll make it easier to manage the requests and provide callbacks and error handling. You may want to specify the callback when you want to enable better browser caching of GET requests. As of jQuery 1.5, you can also use a function for this setting, in which case the value of jsonpCallback is set to the return value of that function.
+      
+      
+        The HTTP method to use for the request (e.g. "POST", "GET", "PUT").
       
       
         A mime type to override the XHR mime type.
@@ -144,7 +147,7 @@ $.ajax({
         Set this to true if you wish to use the traditional style of param serialization.
       
       
-        The type of request to make (e.g. "POST", "GET", "PUT"); default is "GET". 
+        An alias for method. You should use type if you're using versions of jQuery prior to 1.9.0.
       
       
          A string containing the URL to which the request is sent.
@@ -346,7 +349,7 @@ $.ajaxSetup({
     Save some data to the server and notify the user once it's complete.
     Load and execute a JavaScript file.
     
Date: Mon, 9 Mar 2015 21:14:06 +0100
Subject: [PATCH 242/699] 1.11.69

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 57b9de89..d58dae0e 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.68",
+  "version": "1.11.69",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 900c3ce12d4388b5a7f2b700d9a1895a3f267ef2 Mon Sep 17 00:00:00 2001
From: Evgeny Vereshchagin 
Date: Thu, 26 Mar 2015 12:22:19 +0000
Subject: [PATCH 243/699] deferred.resolve(): Add note about promise

Make consistent with other methods like:
* `resolveWith`
* `notify`, `notifyWith`
* `reject`, `rejectWith`

Closes gh-681
---
 entries/deferred.resolve.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/entries/deferred.resolve.xml b/entries/deferred.resolve.xml
index 8ed34680..3aea3599 100644
--- a/entries/deferred.resolve.xml
+++ b/entries/deferred.resolve.xml
@@ -11,6 +11,7 @@
   
    Resolve a Deferred object and call any doneCallbacks with the given args. 
   
+    
          Normally, only the creator of a Deferred should call this method; you can prevent other code from changing the Deferred's state by returning a restricted Promise object through deferred.promise().
          
     
          When the Deferred is resolved, any doneCallbacks added by deferred.then() or deferred.done() are called. Callbacks are executed in the order they were added. Each callback is passed the args from the deferred.resolve(). Any doneCallbacks added after the Deferred enters the resolved state are executed immediately when they are added, using the arguments that were passed to the deferred.resolve() call. For more information, see the documentation for jQuery.Deferred().
          
             
   

From 2e73a313c2a66bfeb7481400a178e271c28d0362 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 26 Mar 2015 14:04:44 +0100
Subject: [PATCH 244/699] 1.11.70

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index d58dae0e..9a17a4d8 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.69",
+  "version": "1.11.70",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 1f2d27ff76459385e6cf7bbeacfbfaa00f9731a9 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Thu, 17 Jul 2014 13:50:43 +0100
Subject: [PATCH 245/699] attr: fix note about changing the `type` of an input
 element in IE8 or older

Closes gh-533
---
 entries/attr.xml | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/entries/attr.xml b/entries/attr.xml
index f0f1408b..203c61c8 100644
--- a/entries/attr.xml
+++ b/entries/attr.xml
@@ -20,9 +20,6 @@
       
          
         
          Note: Attribute values are strings with the exception of a few attributes such as value and tabindex.
          
       
          
-      
          
-        
          Note: Attempting to change the type attribute (or property) of an input element created via HTML or already in an HTML document will result in an error being thrown by Internet Explorer 6, 7, or 8.
          
-      
          
       
          As of jQuery 1.6, the .attr() method returns undefined for attributes that have not been set. To retrieve and change DOM properties such as the checked, selected, or disabled state of form elements, use the .prop() method.
          
 
       
          Attributes vs. Properties
          
@@ -197,7 +194,9 @@ $( "#greatphoto" ).attr({
       
          
       
          When setting multiple attributes, the quotes around attribute names are optional.
          
       
          WARNING: When setting the 'class' attribute, you must always use quotes!
          
-      
          Note: jQuery prohibits changing the type attribute on an <input> or <button> element and will throw an error in all browsers. This is because the type attribute cannot be changed in Internet Explorer.
          
+      
          
+        
          Note: Attempting to change the type attribute on an input or button element created via document.createElement() will throw an exception on Internet Explorer 8 or older.
          
+      
          
       
          Computed attribute values
          
       
          By using a function to set attributes, you can compute the value based on other properties of the element. For example, to concatenate a new value with an existing value:
          
       
          

From 165bc3991a0150ec58dea238ee87608a3c23b151 Mon Sep 17 00:00:00 2001
From: Manuel Strehl 
Date: Wed, 18 Mar 2015 21:36:13 +0100
Subject: [PATCH 246/699] siblings: explain that original elements might be
 returned as well

Ref jquery/jquery#2149
Closes gh-678
---
 entries/siblings.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/siblings.xml b/entries/siblings.xml
index d6b1be02..cb9e6e0b 100644
--- a/entries/siblings.xml
+++ b/entries/siblings.xml
@@ -26,7 +26,7 @@
 $( "li.third-item" ).siblings().css( "background-color", "red" );
     
          
     
          The result of this call is a red background behind items 1, 2, 4, and 5. Since we do not supply a selector expression, all of the siblings are part of the object. If we had supplied one, only the matching items among these four would be included.
          
-    
          The original element is not included among the siblings, which is important to remember when we wish to find all elements at a particular level of the DOM tree.
          
+    
          The original element is not included among the siblings, which is important to remember when we wish to find all elements at a particular level of the DOM tree. However, if the original collection contains more than one element, they might be mutual siblings and will both be found. If you need an exclusive list of siblings, use $collection.siblings().not($collection).
          
   
   
     Find the unique siblings of all yellow li elements in the 3 lists (including other yellow li elements if appropriate).

From a91102507b0ce390261791f92e32c7a2ea822dc0 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 26 Mar 2015 14:37:54 +0100
Subject: [PATCH 247/699] 1.11.71

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 9a17a4d8..49f3155e 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.70",
+  "version": "1.11.71",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 26006aaf79d093784924b614414f1458bbf6af7c Mon Sep 17 00:00:00 2001
From: Evgeny Vereshchagin 
Date: Thu, 26 Mar 2015 14:13:22 +0000
Subject: [PATCH 248/699] jQuery.when: remove unnecessary `new` operator

This is more consistent with other entries.

Closes gh-683
---
 entries/deferred.promise.xml |  2 +-
 entries/jQuery.when.xml      | 10 +++++-----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/entries/deferred.promise.xml b/entries/deferred.promise.xml
index bcd18815..d2a4c12d 100644
--- a/entries/deferred.promise.xml
+++ b/entries/deferred.promise.xml
@@ -18,7 +18,7 @@
     Create a Deferred and set two timer-based functions to either resolve or reject the Deferred after a random interval. Whichever one fires first "wins" and will call one of the callbacks. The second timeout has no effect since the Deferred is already complete (in a resolved or rejected state) from the first timeout action. Also set a timer-based progress notification function, and call a progress handler that adds "working..." to the document body.
     
          
     
          In the case where multiple Deferred objects are passed to jQuery.when(), the method returns the Promise from a new "master" Deferred object that tracks the aggregate state of all the Deferreds it has been passed. The method will resolve its master Deferred as soon as all the Deferreds resolve, or reject the master Deferred as soon as one of the Deferreds is rejected. If the master Deferred is resolved, the doneCallbacks for the master Deferred are executed. The arguments passed to the doneCallbacks provide the resolved values for each of the Deferreds, and matches the order the Deferreds were passed to jQuery.when(). For example:
          
     
          
-var d1 = new $.Deferred();
-var d2 = new $.Deferred();
+var d1 = $.Deferred();
+var d2 = $.Deferred();
 
 $.when( d1, d2 ).done(function ( v1, v2 ) {
     console.log( v1 ); // "Fish"
@@ -36,9 +36,9 @@ d2.resolve( "Pizza" );
     
          
     
          In the event a Deferred was resolved with no value, the corresponding doneCallback argument will be undefined. If a Deferred resolved to a single value, the corresponding argument will hold that value. In the case where a Deferred resolved to multiple values, the corresponding argument will be an array of those values. For example:
          
     
          
-var d1 = new $.Deferred();
-var d2 = new $.Deferred();
-var d3 = new $.Deferred();
+var d1 = $.Deferred();
+var d2 = $.Deferred();
+var d3 = $.Deferred();
 
 $.when( d1, d2, d3 ).done(function ( v1, v2, v3 ) {
     console.log( v1 ); // v1 is undefined

From 7163b8c260c8317c1f4718bff1519ad18cb31168 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Fri, 27 Mar 2015 19:38:41 +0100
Subject: [PATCH 249/699] 1.11.72

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 49f3155e..1c36c822 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.71",
+  "version": "1.11.72",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 86f1bf10cb54cb651ad2322f00639b87b6b2bc96 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Fri, 27 Mar 2015 20:55:25 +0100
Subject: [PATCH 250/699] jQuery.when: passing no arguments returns a resolved
 promise

Fixes gh-342
Closes gh-684
---
 entries/jQuery.when.xml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/entries/jQuery.when.xml b/entries/jQuery.when.xml
index 7e88f37d..7f053618 100644
--- a/entries/jQuery.when.xml
+++ b/entries/jQuery.when.xml
@@ -19,6 +19,12 @@ $.when( $.ajax( "test.aspx" ) ).then(function( data, textStatus, jqXHR ) {
     
          
 $.when( { testing: 123 } ).done(function( x ) {
   alert( x.testing ); // Alerts "123"
+});
+    
          
+    
          If you don't pass it any arguments at all, jQuery.when() will return a resolved promise.
          
+    
          
+$.when().then(function( x ) {
+  alert( "I fired immediately" );
 });
     
          
     
          In the case where multiple Deferred objects are passed to jQuery.when(), the method returns the Promise from a new "master" Deferred object that tracks the aggregate state of all the Deferreds it has been passed. The method will resolve its master Deferred as soon as all the Deferreds resolve, or reject the master Deferred as soon as one of the Deferreds is rejected. If the master Deferred is resolved, the doneCallbacks for the master Deferred are executed. The arguments passed to the doneCallbacks provide the resolved values for each of the Deferreds, and matches the order the Deferreds were passed to jQuery.when(). For example:
          

From b73cf4bb20d3fdfb55dfa03fb9ea951f0f3cf103 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Fri, 27 Mar 2015 21:35:42 +0100
Subject: [PATCH 251/699] 1.11.73

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 1c36c822..e4b490ff 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.72",
+  "version": "1.11.73",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From b40db8ade7dd05de8e96d7048c3a5706edf8e428 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sat, 28 Mar 2015 14:46:54 +0100
Subject: [PATCH 252/699] appendTo/prependTo: correct note about appending
 multiple elements

Fixes gh-318
Closes gh-687
---
 entries/appendTo.xml  | 2 +-
 entries/prependTo.xml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/appendTo.xml b/entries/appendTo.xml
index f3e5da64..562b870d 100644
--- a/entries/appendTo.xml
+++ b/entries/appendTo.xml
@@ -53,7 +53,7 @@ $( "h2" ).appendTo( $( ".container" ) );
   <h2>Greetings</h2>
 </div>
     
          
-    
          If there is more than one target element, however, cloned copies of the inserted element will be created for each target after the first, and that new set (the original element plus clones) is returned.
          
+    
          If there is more than one target element, however, cloned copies of the inserted element will be created for each target except the last, and that new set (the original element plus clones) is returned.
          
 	
          Before jQuery 1.9, the append-to-single-element case did not create a new set, but instead returned the original set which made it difficult to use the .end() method reliably when being used with an unknown number of elements.
          
             
   
diff --git a/entries/prependTo.xml b/entries/prependTo.xml
index f51db248..5a8c66df 100644
--- a/entries/prependTo.xml
+++ b/entries/prependTo.xml
@@ -53,7 +53,7 @@ $( "h2" ).prependTo( $( ".container" ) );
   <div class="inner">Goodbye</div>
 </div>
     
          
-    
          If there is more than one target element, however, cloned copies of the inserted element will be created for each target after the first.
          
+    
          If there is more than one target element, however, cloned copies of the inserted element will be created for each target except the last.
          
   
   
   

From edb7aa3e8778d5f472b6317a340aa18b8567fe39 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sat, 28 Mar 2015 18:11:34 +0100
Subject: [PATCH 253/699] 1.11.74

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index e4b490ff..e7149716 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.73",
+  "version": "1.11.74",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From d0d0e0286fe9a263e1763bb84b23d88f45a12a9b Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sat, 28 Mar 2015 18:19:15 +0100
Subject: [PATCH 254/699] All: fix some broken links

Closes gh-688
---
 entries/contents.xml       |  2 +-
 entries/delay.xml          |  2 +-
 entries/html.xml           |  2 +-
 entries/id-selector.xml    |  2 +-
 entries/jQuery.ajax.xml    |  2 +-
 entries/odd-selector.xml   |  2 +-
 entries/triggerHandler.xml |  2 +-
 entries/val.xml            |  2 +-
 pages/Types.html           | 10 +++++-----
 9 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/entries/contents.xml b/entries/contents.xml
index d10defc0..9f4d8b2f 100644
--- a/entries/contents.xml
+++ b/entries/contents.xml
@@ -33,7 +33,7 @@ $( ".container" )
     .filter( "br" )
     .remove();
     
-    
          This code first retrieves the contents  of <div class="container"> and then filters it for text nodes, which are wrapped in paragraph tags. This is accomplished by testing the .nodeType property of the element. This DOM property holds a numeric code indicating the node's type; text nodes use the code 3. The contents are again filtered, this time for <br /> elements, and these elements are removed.
          
+    
          This code first retrieves the contents  of <div class="container"> and then filters it for text nodes, which are wrapped in paragraph tags. This is accomplished by testing the .nodeType property of the element. This DOM property holds a numeric code indicating the node's type; text nodes use the code 3. The contents are again filtered, this time for <br /> elements, and these elements are removed.
          
   
   
     Find all the text nodes inside a paragraph and wrap them with a bold tag.
diff --git a/entries/delay.xml b/entries/delay.xml
index 94c9d83d..c94b2a0b 100644
--- a/entries/delay.xml
+++ b/entries/delay.xml
@@ -21,7 +21,7 @@ $( "#foo" ).slideUp( 300 ).delay( 800 ).fadeIn( 400 );
     
          When this statement is executed, the element slides up for 300 milliseconds and then pauses for 800 milliseconds before fading in for 400 milliseconds.
          
     
          
       
          
-        The .delay() method is best for delaying between queued jQuery effects. Because it is limited—it doesn't, for example, offer a way to cancel the delay—.delay() is not a replacement for JavaScript's native setTimeout function, which may be more appropriate for certain use cases.
+        The .delay() method is best for delaying between queued jQuery effects. Because it is limited—it doesn't, for example, offer a way to cancel the delay—.delay() is not a replacement for JavaScript's native setTimeout function, which may be more appropriate for certain use cases.
       
          
     
          
   
diff --git a/entries/html.xml b/entries/html.xml
index 2fb32ea1..7a4f2594 100644
--- a/entries/html.xml
+++ b/entries/html.xml
@@ -119,7 +119,7 @@ $( "div.demo-container" ).html(function() {
       
       
          Given a document with six paragraphs, this example will set the HTML of <div class="demo-container"> to <p>All new content for <em>6 paragraphs!</em></p>.
          
       
          This method uses the browser's innerHTML property. Some browsers may not generate a DOM that exactly replicates the HTML source provided. For example, Internet Explorer prior to version 8 will convert all href properties on links to absolute URLs, and Internet Explorer prior to version 9 will not correctly handle HTML5 elements without the addition of a separate compatibility layer.
          
-      
          To set the content of a <script> element, which does not contain HTML, use the .text() method and not .html().
          
+      
          To set the content of a <script> element, which does not contain HTML, use the .text() method and not .html().
          
       
          Note: In Internet Explorer up to and including version 9, setting the text content of an HTML element may corrupt the text nodes of its children that are being removed from the document as a result of the operation. If you are keeping references to these DOM elements and need them to be unchanged, use .empty().html( string ) instead of .html(string) so that the elements are removed from the document before the new string is assigned to the element.
          
     
     
diff --git a/entries/id-selector.xml b/entries/id-selector.xml
index 0bff7166..20aab992 100644
--- a/entries/id-selector.xml
+++ b/entries/id-selector.xml
@@ -13,7 +13,7 @@
     
          For id selectors, jQuery uses the JavaScript function document.getElementById(), which is extremely efficient. When another selector is attached to the id selector, such as h2#pageTitle, jQuery performs an additional check before identifying the element as a match.
          
     
          Calling jQuery() (or $()) with an id selector as its argument will return a jQuery object containing a collection of either zero or one DOM element.
          
     
          Each id value must be used only once within a document. If more than one element has been assigned the same ID, queries that use that ID will only select the first matched element in the DOM. This behavior should not be relied on, however; a document with more than one element using the same ID is invalid.
          
-    
          If the id contains characters like periods or colons you have to escape those characters with backslashes.
          
+    
          If the id contains characters like periods or colons you have to escape those characters with backslashes.
          
   
   
     Select the element with the id "myDiv" and give it a red border.
diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index 428108d4..d7b49447 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -74,7 +74,7 @@ $.ajax({
                 
       
         The type of data that you're expecting back from the server. If none is specified, jQuery will try to infer it based on the MIME type of the response (an XML MIME type will yield XML, in 1.4 JSON will yield a JavaScript object, in 1.4 script will execute the script, and anything else will be returned as a string). The available types (and the result passed as the first argument to your success callback) are:
-          
          • "xml": Returns a XML document that can be processed via jQuery.
          • "html": Returns HTML as plain text; included script tags are evaluated when inserted in the DOM.
          • "script": Evaluates the response as JavaScript and returns it as plain text. Disables caching by appending a query string parameter, "_=[TIMESTAMP]", to the URL unless the cache option is set to true. Note: This will turn POSTs into GETs for remote-domain requests. 
          • "json": Evaluates the response as JSON and returns a JavaScript object. The JSON data is parsed in a strict manner; any malformed JSON is rejected and a parse error is thrown. As of jQuery 1.9, an empty response is also rejected; the server should return a response of null or {} instead. (See json.org for more information on proper JSON formatting.)
          • "jsonp": Loads in a JSON block using JSONP. Adds an extra "?callback=?" to the end of your URL to specify the callback. Disables caching by appending a query string parameter, "_=[TIMESTAMP]", to the URL unless the cache option is set to true.
          • "text": A plain text string.
          • multiple, space-separated values: As of jQuery 1.5, jQuery can convert a dataType from what it received in the Content-Type header to what you require. For example, if you want a text response to be treated as XML, use "text xml" for the dataType. You can also make a JSONP request, have it received as text, and interpreted by jQuery as XML: "jsonp text xml." Similarly, a shorthand string such as "jsonp xml" will first attempt to convert from jsonp to xml, and, failing that, convert from jsonp to text, and then from text to xml.
+          
            • "xml": Returns a XML document that can be processed via jQuery.
            • "html": Returns HTML as plain text; included script tags are evaluated when inserted in the DOM.
            • "script": Evaluates the response as JavaScript and returns it as plain text. Disables caching by appending a query string parameter, "_=[TIMESTAMP]", to the URL unless the cache option is set to true. Note: This will turn POSTs into GETs for remote-domain requests. 
            • "json": Evaluates the response as JSON and returns a JavaScript object. The JSON data is parsed in a strict manner; any malformed JSON is rejected and a parse error is thrown. As of jQuery 1.9, an empty response is also rejected; the server should return a response of null or {} instead. (See json.org for more information on proper JSON formatting.)
            • "jsonp": Loads in a JSON block using JSONP. Adds an extra "?callback=?" to the end of your URL to specify the callback. Disables caching by appending a query string parameter, "_=[TIMESTAMP]", to the URL unless the cache option is set to true.
            • "text": A plain text string.
            • multiple, space-separated values: As of jQuery 1.5, jQuery can convert a dataType from what it received in the Content-Type header to what you require. For example, if you want a text response to be treated as XML, use "text xml" for the dataType. You can also make a JSONP request, have it received as text, and interpreted by jQuery as XML: "jsonp text xml." Similarly, a shorthand string such as "jsonp xml" will first attempt to convert from jsonp to xml, and, failing that, convert from jsonp to text, and then from text to xml.
           
            
         
       
diff --git a/entries/odd-selector.xml b/entries/odd-selector.xml
index a2520812..12a75cb8 100644
--- a/entries/odd-selector.xml
+++ b/entries/odd-selector.xml
@@ -5,7 +5,7 @@
   
     1.0
   
-  Selects odd elements, zero-indexed.  See also even.
+  Selects odd elements, zero-indexed.  See also even.
   
     
            In particular, note that the 0-based indexing means that, counter-intuitively, :odd selects the second element, fourth element, and so on within the matched set.
            
               
diff --git a/entries/triggerHandler.xml b/entries/triggerHandler.xml
index e174311f..ac6c34ba 100644
--- a/entries/triggerHandler.xml
+++ b/entries/triggerHandler.xml
@@ -14,7 +14,7 @@
     
   
   
-    
            .triggerHandler( eventType ) executes all handlers bound with jQuery for the event type.  It will also execute any method called on{eventType}() found on the element.  The behavior of this method is similar to .trigger(), with the following exceptions:
            
+    
            .triggerHandler( eventType ) executes all handlers bound with jQuery for the event type.  It will also execute any method called on{eventType}() found on the element.  The behavior of this method is similar to .trigger(), with the following exceptions:
            
     
              
       
            • The .triggerHandler( "event" ) method will not call .event() on the element it is triggered on.  This means .triggerHandler( "submit" ) on a form will not call .submit() on the form.
              • 
       
            • While .trigger() will operate on all elements matched by the jQuery object, .triggerHandler() only affects the first matched element.
              • 
diff --git a/entries/val.xml b/entries/val.xml
index bb5f03e2..184abdad 100644
--- a/entries/val.xml
+++ b/entries/val.xml
@@ -12,7 +12,7 @@
     Get the current value of the first element in the set of matched elements.
     
       
              The .val() method is primarily used to get the values of form elements such as input, select and textarea. In the case of select elements, it returns null when no option is selected and an array containing the value of each selected option when there is at least one and it is possible to select more because the multiple attribute is present.
              
-      
              For selects and checkboxes, you can also use the :selected and :checked selectors to get at values, for example:
              
+      
              For selects and checkboxes, you can also use the :selected and :checked selectors to get at values, for example:
              
       
              
 // Get the value from a dropdown select
 $( "select.foo option:selected").val();
diff --git a/pages/Types.html b/pages/Types.html
index cd66dd4d..422f6bd6 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -11,7 +11,7 @@
 
 
              JavaScript provides several built-in datatypes. In addition to those, this page documents virtual types like Selectors, enhanced pseudo-types like Events and all and everything you wanted to know about Functions.
 
              
-
              You should be able to try out most of the examples below by just copying them to your browser's JavaScript Console (Chrome, Safari with Develop menu activated, IE 8+) or Firebug console (Firefox).
+
              You should be able to try out most of the examples below by just copying them to your browser's JavaScript Console (Chrome, Safari with Develop menu activated, IE 8+) or Firebug console (Firefox).
 
              
 
              Whenever an example mentions that a type defaults to a boolean value, the result is good to know when using that type in a boolean context:
 
              
@@ -296,7 +296,7 @@ 
               Iteration 
              
   alert( "key is " + [ key ] + ", value is " + obj[ key ] );
 }
 
              
-
              Note that for-in-loop can be spoiled by extending Object.prototype (see Object.prototype is verboten) so take care when using other libraries.
+
              Note that for-in-loop can be spoiled by extending Object.prototype (see Object.prototype is verboten) so take care when using other libraries.
 
              
 
              jQuery provides a generic each function to iterate over properties of objects, as well as elements of arrays:
 
              
@@ -412,7 +412,7 @@ 
               Array<Type> Notation 
              
 
              This indicates that the method doesn't only expect an array as the argument, but also specifies the expected type. The notation is borrowed from Java 5's generics notation (or C++ templates).
 
              
 
               PlainObject 
              
-
              The PlainObject type is a JavaScript object containing zero or more key-value pairs. The plain object is, in other words, an Object object. It is designated "plain" in jQuery documentation to distinguish it from other kinds of JavaScript objects: for example, null, user-defined arrays, and host objects such as document, all of which have a typeof value of "object." The jQuery.isPlainObject() method identifies whether the passed argument is a plain object or not, as demonstrated below:
+
              The PlainObject type is a JavaScript object containing zero or more key-value pairs. The plain object is, in other words, an Object object. It is designated "plain" in jQuery documentation to distinguish it from other kinds of JavaScript objects: for example, null, user-defined arrays, and host objects such as document, all of which have a typeof value of "object." The jQuery.isPlainObject() method identifies whether the passed argument is a plain object or not, as demonstrated below:
 
              
 
              
   var a = [];
@@ -621,7 +621,7 @@ 
               XMLHttpRequest 
              
 
              
 
@@ -641,4 +641,4 @@ 
              Callbacks Object
              
 
              XML Document
              
 
              A document object created by the browser's XML DOM parser, usually from a string representing XML. XML documents have different semantics than HTML documents, but most of the traversing and manipulation methods provided by jQuery will work with them.
              
 
              Assert
              
-
              A reference to or instance of the object holding all of QUnit's assertions. See the API documentation for QUnit.assert for details.
              
+
              A reference to or instance of the object holding all of QUnit's assertions. See the API documentation for QUnit.assert for details.
              

From 1d5f56a09a5f23e29bdb2a2a7986cfa0ad8db7cb Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sun, 29 Mar 2015 14:56:27 +0200
Subject: [PATCH 255/699] 1.11.75

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index e7149716..ea1c4f94 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.74",
+  "version": "1.11.75",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From e0fac2acfadd0d0f41ca88f43fa9ed23854755cc Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 26 Mar 2015 15:01:21 +0100
Subject: [PATCH 256/699] hidden/visible-selector: add note about performance

Fixes gh-679
Closes gh-682
---
 entries/hidden-selector.xml  | 1 +
 entries/visible-selector.xml | 1 +
 notes.xsl                    | 3 +++
 3 files changed, 5 insertions(+)

diff --git a/entries/hidden-selector.xml b/entries/hidden-selector.xml
index 2daf20e6..6712c736 100644
--- a/entries/hidden-selector.xml
+++ b/entries/hidden-selector.xml
@@ -20,6 +20,7 @@
     
              How :hidden is determined was changed in jQuery 1.3.2. An element is assumed to be hidden if it or any of its parents consumes no space in the document. CSS visibility isn't taken into account (therefore $( elem ).css( "visibility", "hidden" ).is( ":hidden" ) == false). The release notes outline the changes in more detail.
              
   
   
+  
   
     Shows all hidden divs and counts hidden inputs.
     How :visible is calculated was changed in jQuery 1.3.2. The release notes outline the changes in more detail.
              
   
   
+  
   
     Make all visible divs turn yellow on click.
     
 			By design, any jQuery constructor or method that accepts an HTML string — jQuery(), .append(), .after(), etc. — can potentially execute code. This can occur by injection of script tags or use of HTML attributes that execute code (for example, <img onload="">). Do not use these methods to insert strings obtained from untrusted sources such as URL query parameters, cookies, or form inputs. Doing so can introduce cross-site-scripting (XSS) vulnerabilities. Remove or escape any user input before adding content to the document.
 		
+		
+			Using this selector heavily can have performance implications, as it may force the browser to re-render the page before it can determine visibility. Tracking the visibility of elements via other methods, using a class for example, can provide better performance.
+		
 	
 
 

From 52920dc3973f7bbcf78971a2c01173b7f7e39361 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sun, 29 Mar 2015 14:59:58 +0200
Subject: [PATCH 257/699] 1.11.76

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index ea1c4f94..8d27acf4 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.75",
+  "version": "1.11.76",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 06fcf33200da10056b5e78ba58ca3b93f28257b4 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Fri, 27 Mar 2015 21:13:43 +0100
Subject: [PATCH 258/699] jQuery.parseHTML: add note about leading/trailing
 text nodes

Fixes gh-462
Closes gh-685
---
 entries/jQuery.parseHTML.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.parseHTML.xml b/entries/jQuery.parseHTML.xml
index b0d245e6..06f59937 100644
--- a/entries/jQuery.parseHTML.xml
+++ b/entries/jQuery.parseHTML.xml
@@ -15,7 +15,7 @@
     
   
   
-    
              jQuery.parseHTML uses a native DOM element creation function to convert the string to a set of DOM elements, which can then be inserted into the document.
              
+    
              jQuery.parseHTML uses native methods to convert the string to a set of DOM nodes, which can then be inserted into the document. These methods do render all trailing or leading text (even if that's just whitespace). To prevent trailing/leading whitespace from being converted to text nodes you can pass the HTML string through jQuery.trim.
              
     
              By default, the context is the current document if not specified or given as null or undefined. If the HTML was to be used in another document such as an iframe, that frame's document could be used.
              
 	
              Security Considerations
              
 	
              Most jQuery APIs that accept HTML strings will run scripts that are included in the HTML. jQuery.parseHTML does not run script in the parsed HTML unless keepScripts is explicitly true. However, it is still possible in most environments to execute script indirectly, for example via the <img onerror> attribute. The caller should be aware of this and guard against it by cleaning or escaping any untrusted inputs from sources such as the URL or cookies. For future compatibility, callers should not depend on the ability to run any script content when keepScripts is unspecified or false.
              

From e84239c26b2cee444ce25e6795f01fa487325b12 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Tue, 31 Mar 2015 17:15:42 +0200
Subject: [PATCH 259/699] 1.11.77

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 8d27acf4..322ee085 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.76",
+  "version": "1.11.77",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 1b2f86aa1984584fcbdb7dab6bc08c641813b8e4 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Tue, 31 Mar 2015 16:46:29 +0200
Subject: [PATCH 260/699] triggerHandler: add signature for `.triggerHandler(
 event, extra )`

Fixes gh-393
Closes gh-690
---
 entries/triggerHandler.xml | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/entries/triggerHandler.xml b/entries/triggerHandler.xml
index ac6c34ba..d72516a8 100644
--- a/entries/triggerHandler.xml
+++ b/entries/triggerHandler.xml
@@ -13,6 +13,17 @@
       Additional parameters to pass along to the event handler.
     
   
+  
+    1.3
+    
+      A jQuery.Event object.
+    
+    
+      
+      
+      Additional parameters to pass along to the event handler.
+    
+  
   
     
              .triggerHandler( eventType ) executes all handlers bound with jQuery for the event type.  It will also execute any method called on{eventType}() found on the element.  The behavior of this method is similar to .trigger(), with the following exceptions:
              
     
                

From c3dd5433f76802b0a1caef52d7c207343dcdf162 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Tue, 31 Mar 2015 17:38:07 +0200
Subject: [PATCH 261/699] 1.11.78

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 322ee085..159c7d10 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.77",
+  "version": "1.11.78",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 0c6b0fb6da443beed9b94a1e827d9863821652b4 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 2 Apr 2015 18:17:23 +0200
Subject: [PATCH 262/699] jQuery.cssNumber: add new entry

Fixes gh-164
Closes gh-693
---
 entries/jQuery.cssHooks.xml  |  2 +-
 entries/jQuery.cssNumber.xml | 33 +++++++++++++++++++++++++++++++++
 2 files changed, 34 insertions(+), 1 deletion(-)
 create mode 100644 entries/jQuery.cssNumber.xml

diff --git a/entries/jQuery.cssHooks.xml b/entries/jQuery.cssHooks.xml
index 8252bfa5..f7ecb170 100644
--- a/entries/jQuery.cssHooks.xml
+++ b/entries/jQuery.cssHooks.xml
@@ -163,7 +163,7 @@ if ( $.support.someCSSProp && $.support.someCSSProp !== "someCSSProp" )
 })( jQuery );
     
              
     
              Special units
              
-    
              By default, jQuery adds a "px" unit to the values passed to the .css() method. This behavior can be prevented by adding the property to the jQuery.cssNumber object
              
+    
              By default, jQuery adds a "px" unit to the values passed to the .css() method. This behavior can be prevented by adding the property to the jQuery.cssNumber object
              
     
              
 $.cssNumber.someCSSProp = true;
     
              
diff --git a/entries/jQuery.cssNumber.xml b/entries/jQuery.cssNumber.xml
new file mode 100644
index 00000000..ce5af886
--- /dev/null
+++ b/entries/jQuery.cssNumber.xml
@@ -0,0 +1,33 @@
+
+
+  jQuery.cssNumber
+  
+    1.4.3
+  
+  An object containing all CSS properties that may be used without a unit. The .css() method uses this object to see if it may append px to unitless values.
+  
+    
              You can think about jQuery.cssNumber as a list of all CSS properties you might use without a unit. It's used by .css() to determine if it needs to add px to unitless values.
              
+    
              The keys of the jQuery.cssNumber object are camel-cased and the values are all set to true. If you want to prevent the .css() method from automatically adding the px unit for a specific CSS property, you can add an extra property to the jQuery.cssNumber object.
              
+    
              
+jQuery.cssNumber.someCSSProp = true;
+    
              
+    
              By default the object contains the following properties:
              
+    
                
+      
              • zIndex
                • 
+      
              • fontWeight
                • 
+      
              • opacity
                • 
+      
              • zoom
                • 
+      
              • lineHeight
                • 
+      
              • widows (added in jQuery 1.6)
                • 
+      
              • orphans (added in jQuery 1.6)
                • 
+      
              • fillOpacity (added in jQuery 1.6.2)
                • 
+      
              • columnCount (added in jQuery 1.9)
                • 
+      
              • order (added in jQuery 1.10.2)
                • 
+      
              • flexGrow (added in jQuery 1.11.1)
                • 
+      
              • flexShrink (added in jQuery 1.11.1)
                • 
+    
              
+                
+  
+  
+  
+              

From 3b2f209c4b296781fa0e4f778cc0cb611e72c638 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 2 Apr 2015 19:50:11 +0200
Subject: [PATCH 263/699] 1.11.79

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 159c7d10..1f11b9f9 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.78",
+  "version": "1.11.79",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 043079ed01671d2893fd8a412143391f4a13b43a Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 5 Apr 2015 15:22:04 +0100
Subject: [PATCH 264/699] addClass: Minor description improvement

Closes gh-697
---
 entries/addClass.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/addClass.xml b/entries/addClass.xml
index 238d03e5..476251d8 100644
--- a/entries/addClass.xml
+++ b/entries/addClass.xml
@@ -16,7 +16,7 @@
       
     
   
-  Adds the specified class(es) to each of the set of matched elements.
+  Adds the specified class(es) to each element in the set of matched elements.
   
     
              It's important to note that this method does not replace a class. It simply adds the class, appending it to any which may already be assigned to the elements.
              
     
              More than one class may be added at a time, separated by a space, to the set of matched elements, like so:
              

From 55d856827e27b58c28a3b878062cc19d571e55d2 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sun, 5 Apr 2015 16:23:55 +0200
Subject: [PATCH 265/699] 1.11.80

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 1f11b9f9..c1e60b7e 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.79",
+  "version": "1.11.80",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 626b12bcaff2aa97513755cf1f4aba1563134f38 Mon Sep 17 00:00:00 2001
From: Eric Atienza 
Date: Mon, 6 Apr 2015 10:40:18 +0200
Subject: [PATCH 266/699] deferred.progress: Clarify that the second argument
 is optional

Closes gh-694
---
 entries/deferred.progress.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/deferred.progress.xml b/entries/deferred.progress.xml
index 3a827a24..d1f18cc7 100644
--- a/entries/deferred.progress.xml
+++ b/entries/deferred.progress.xml
@@ -10,7 +10,7 @@
         A function, or array of functions, to be called when the Deferred generates progress notifications.
       
     
-    
+    
       
       
       

From 36ebfed0363d9acc742dd4255872fbeb50abb5d1 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Mon, 6 Apr 2015 10:51:21 +0200
Subject: [PATCH 267/699] 1.11.81

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index c1e60b7e..1e29dc72 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.80",
+  "version": "1.11.81",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From a5faca00164c88eb6dd45d55fdd0c0721b38fd01 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Mon, 6 Apr 2015 10:57:30 +0200
Subject: [PATCH 268/699] Wrap: Clarify that passing a collection uses the
 first element

Fixes gh-698
Closes gh-700
---
 entries/wrap.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/wrap.xml b/entries/wrap.xml
index 02bce46c..1cd67a04 100644
--- a/entries/wrap.xml
+++ b/entries/wrap.xml
@@ -8,7 +8,7 @@
       
       
       
-      A selector, element, HTML string, or jQuery object specifying the structure to wrap around the matched elements.
+      A selector, element, HTML string, or jQuery object specifying the structure to wrap around the matched elements. When you pass a jQuery collection containing more than one element the first element will be used.
     
   
   

From e31c339f3e675b100470421280970b5eee81bbc9 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Mon, 6 Apr 2015 15:32:42 +0200
Subject: [PATCH 269/699] 1.11.82

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 1e29dc72..a2c4d4c8 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.81",
+  "version": "1.11.82",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 0a4b6fb89fac9d217a31d45681428e56d1ed0661 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 5 Apr 2015 23:18:33 +0100
Subject: [PATCH 270/699] wrapAll: Update return type of callback function

The return value of the the callback function can be a jQuery object
as well. This is the same as `wrap()`.

Closes gh-699
---
 entries/wrapAll.xml | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/entries/wrapAll.xml b/entries/wrapAll.xml
index 80112ca0..c6dc02ca 100644
--- a/entries/wrapAll.xml
+++ b/entries/wrapAll.xml
@@ -14,9 +14,12 @@
   
     1.4
     
-      A function that returns a structure to wrap around the matched elements. Receives the index position of the element in the set as an argument. Within the function, this refers to the current element in the set.
+      A callback function returning the HTML content or jQuery object to wrap around the matched elements. Receives the index position of the element in the set as an argument. Within the function, this refers to the current element in the set.
       
-      
+      
+        
+        
+      
     
   
   Wrap an HTML structure around all elements in the set of matched elements.

From d289cf47165e4371953b498322cbb87863b94175 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Mon, 6 Apr 2015 15:42:54 +0200
Subject: [PATCH 271/699] Wrap: correction to note about multiple elements

Ref gh-700
Closes gh-701
---
 entries/wrap.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/wrap.xml b/entries/wrap.xml
index 1cd67a04..d6258d70 100644
--- a/entries/wrap.xml
+++ b/entries/wrap.xml
@@ -8,7 +8,7 @@
       
       
       
-      A selector, element, HTML string, or jQuery object specifying the structure to wrap around the matched elements. When you pass a jQuery collection containing more than one element the first element will be used.
+      A selector, element, HTML string, or jQuery object specifying the structure to wrap around the matched elements. When you pass a jQuery collection containing more than one element, or a selector matching more than one element, the first element will be used.
     
   
   

From eefe1720ed78f5d85c21fb2edde5cffb5b2e3e8f Mon Sep 17 00:00:00 2001
From: Eric Lee Carraway 
Date: Mon, 6 Apr 2015 16:58:51 -0500
Subject: [PATCH 272/699] Ajax Events: Fix space before a comma

Closes gh-704
---
 pages/Ajax_Events.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pages/Ajax_Events.html b/pages/Ajax_Events.html
index 9ba25ff7..26a59f0f 100644
--- a/pages/Ajax_Events.html
+++ b/pages/Ajax_Events.html
@@ -33,7 +33,7 @@ 
              Global Events
              
  });
               
 
              Events
              
-
              This is the full list of Ajax events , and in the order in which they are triggered. The indented events are triggered for each and every Ajax request (unless a global option has been set). The ajaxStart and ajaxStop events are events that relate to all Ajax requests together.
+
              This is the full list of Ajax events, and in the order in which they are triggered. The indented events are triggered for each and every Ajax request (unless a global option has been set). The ajaxStart and ajaxStop events are events that relate to all Ajax requests together.
 
              
 
                
   
              •  ajaxStart (Global Event)
                This event is triggered if an Ajax request is started and no other Ajax requests are currently running.

From 2c4233f3eaaa9c38ee10967b1ce56da823f239d7 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Tue, 7 Apr 2015 09:30:59 +0200
Subject: [PATCH 273/699] 1.11.83

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index a2c4d4c8..6c18d258 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.82",
+  "version": "1.11.83",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From bad3340c8335505516f26f93ee8aaa0b72b75a18 Mon Sep 17 00:00:00 2001
From: Eric Lee Carraway 
Date: Tue, 7 Apr 2015 18:23:01 -0500
Subject: [PATCH 274/699] callbacks.fire: add a missing period

Closes gh-706
---
 entries/callbacks.fire.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/callbacks.fire.xml b/entries/callbacks.fire.xml
index 00ec03f3..daae9b1f 100644
--- a/entries/callbacks.fire.xml
+++ b/entries/callbacks.fire.xml
@@ -7,7 +7,7 @@
       The argument or list of arguments to pass back to the callback list.
     
   
-  Call all of the callbacks with the given arguments
+  Call all of the callbacks with the given arguments.
   
     
                This method returns the Callbacks object onto which it is attached (this).
                
                   

From d622e1244802cd55670265698f0d66383e3dedaa Mon Sep 17 00:00:00 2001
From: Eric Lee Carraway 
Date: Tue, 7 Apr 2015 18:13:18 -0500
Subject: [PATCH 275/699] jQuery.isFunction:  capitalize S in JavaScript

Closes gh-705
---
 entries/jQuery.isFunction.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.isFunction.xml b/entries/jQuery.isFunction.xml
index 2ceed224..689cdbf7 100644
--- a/entries/jQuery.isFunction.xml
+++ b/entries/jQuery.isFunction.xml
@@ -7,7 +7,7 @@
       Object to test whether or not it is a function.
     
   
-  Determine if the argument passed is a Javascript function object. 
+  Determine if the argument passed is a JavaScript function object. 
   
     
                Note: As of jQuery 1.3, functions provided by the browser like alert() and DOM element methods like getAttribute() are not guaranteed to be detected as functions in browsers such as Internet Explorer.
                
                   

From fdaa71085ce665d9a2d9d8129d2bcfee1e2a0f68 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 9 Apr 2015 12:53:32 +0200
Subject: [PATCH 276/699] 1.11.84

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 6c18d258..7085f9f6 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.83",
+  "version": "1.11.84",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From feac99a0174a071b20c1ab9b312c00c9c832d504 Mon Sep 17 00:00:00 2001
From: Alexander Robert Angas 
Date: Wed, 8 Apr 2015 14:57:42 +0930
Subject: [PATCH 277/699] focusin/focusout: use consistent categories

Fixes gh-619
Closes gh-707
---
 entries/focusin.xml  | 1 +
 entries/focusout.xml | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/entries/focusin.xml b/entries/focusin.xml
index dd273e67..251acaaf 100644
--- a/entries/focusin.xml
+++ b/entries/focusin.xml
@@ -42,6 +42,7 @@ $( "p" ).focusin(function() {
 ]]>
   
   
+  
   
   
 
diff --git a/entries/focusout.xml b/entries/focusout.xml
index b8ac4373..6161919b 100644
--- a/entries/focusout.xml
+++ b/entries/focusout.xml
@@ -62,8 +62,8 @@ $( "p" )
 
                blur fire
                
 ]]>
   
-  
-  
+  
+  
   
   
 

From 89d7028945cbf9a5898b8c986d9a7be1254ea2fb Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 9 Apr 2015 12:55:36 +0200
Subject: [PATCH 278/699] 1.11.85

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 7085f9f6..3b924585 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.84",
+  "version": "1.11.85",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 9f29995d4a2ba064f34474f627d96c867858f25c Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Tue, 31 Mar 2015 13:27:26 +0200
Subject: [PATCH 279/699] jQuery.get: note required callback arg if `dataType`
 is provided

Fixes gh-351
Closes gh-691
---
 entries/jQuery.get.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.get.xml b/entries/jQuery.get.xml
index aefc58fa..51b50c64 100644
--- a/entries/jQuery.get.xml
+++ b/entries/jQuery.get.xml
@@ -21,7 +21,7 @@
       
       
       
-      A callback function that is executed if the request succeeds.
+      A callback function that is executed if the request succeeds. Required if dataType is provided, but you can use null or jQuery.noop as a placeholder.
     
     
       The type of data expected from the server. Default: Intelligent Guess (xml, json, script, or html).

From 8517c54ce71cd59ce388a9914320d791886ddbcc Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 9 Apr 2015 14:14:16 +0200
Subject: [PATCH 280/699] 1.11.86

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 3b924585..00081c82 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.85",
+  "version": "1.11.86",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From a10fe84a0fde13164a87132e87938d6a55311d02 Mon Sep 17 00:00:00 2001
From: Eric Atienza 
Date: Mon, 6 Apr 2015 18:54:14 +0200
Subject: [PATCH 281/699] innerWidth: use `Number` return type

Closes gh-703
---
 entries/innerWidth.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/innerWidth.xml b/entries/innerWidth.xml
index 3356884d..a04640d4 100644
--- a/entries/innerWidth.xml
+++ b/entries/innerWidth.xml
@@ -1,7 +1,7 @@
 
 
   Get the current computed inner width (including padding but not border) for the first element in the set of matched elements or set the inner width of every matched element.
-
+
   .innerWidth()
   
     1.2.6

From c214dd395a7f9b73f892cec0e147a528f8f5a8e6 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 9 Apr 2015 19:11:13 +0200
Subject: [PATCH 282/699] 1.11.87

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 00081c82..982763b4 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.86",
+  "version": "1.11.87",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 14060437b8e6eae97b2fcb726c7afcb228d4a9e8 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sat, 11 Apr 2015 17:31:37 +0100
Subject: [PATCH 283/699] jQuery.ajax: Fixed a typo

Closes gh-713
---
 entries/jQuery.ajax.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index d7b49447..51bdb838 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -43,7 +43,7 @@
         When sending data to the server, use this content type. Default is "application/x-www-form-urlencoded; charset=UTF-8", which is fine for most cases.  If you explicitly pass in a content-type to $.ajax(), then it is always sent to the server (even if no data is sent).  As of jQuery 1.6 you can pass false to tell jQuery to not set any content type header.  Note: The W3C XMLHttpRequest specification dictates that the charset is always UTF-8; specifying another charset will not force the browser to change the encoding. Note: For cross-domain requests, setting the content type to anything other than application/x-www-form-urlencoded, multipart/form-data, or text/plain will trigger the browser to send a preflight OPTIONS request to the server.
       
       
-        This object will be the context of all Ajax-related callbacks. By default, the context is an object that represents the ajax settings used in the call ($.ajaxSettings merged with the settings passed to $.ajax). For example,  specifying a DOM element as the context will make that the context for the complete callback of a request, like so:
+        This object will be the context of all Ajax-related callbacks. By default, the context is an object that represents the Ajax settings used in the call ($.ajaxSettings merged with the settings passed to $.ajax). For example,  specifying a DOM element as the context will make that the context for the complete callback of a request, like so:
           
                
 $.ajax({
   url: "test.html",

From 21a91138b77737ca3019a203d5158e62b265677d Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sat, 11 Apr 2015 17:44:07 +0100
Subject: [PATCH 284/699] jQuery.ajax: surround `data` by ``

Closes gh-714
---
 entries/jQuery.ajax.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index 51bdb838..f2db327d 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -114,7 +114,7 @@ $.ajax({
         A password to be used with XMLHttpRequest in response to an HTTP access authentication request.
       
       
-        By default, data passed in to the data option as an object (technically, anything other than a string) will be processed and transformed into a query string, fitting to the default content-type "application/x-www-form-urlencoded". If you want to send a DOMDocument, or other non-processed data, set this option to false.
+        By default, data passed in to the data option as an object (technically, anything other than a string) will be processed and transformed into a query string, fitting to the default content-type "application/x-www-form-urlencoded". If you want to send a DOMDocument, or other non-processed data, set this option to false.
       
       
         Only applies when the "script" transport is used (e.g., cross-domain requests with "jsonp" or "script" dataType and "GET" type). Sets the charset attribute on the script tag used in the request. Used when the character set on the local page is not the same as the one on the remote script.

From 5b04f937be9e8df0dc93b32a3940721ad2b19469 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 12 Apr 2015 19:55:40 +0100
Subject: [PATCH 285/699] jQuery.animate: remove misplaced parenthesis

Closes gh-715
---
 entries/animate.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/animate.xml b/entries/animate.xml
index d05f366e..2cbec644 100644
--- a/entries/animate.xml
+++ b/entries/animate.xml
@@ -22,7 +22,7 @@
   
     
                The .animate() method allows us to create animation effects on any numeric CSS property. The only required parameter is a plain object of CSS properties. This object is similar to the one that can be sent to the .css() method, except that the range of properties is more restrictive.
                
     
                Animation Properties and Values
                
-    
                All animated properties should be animated to a single numeric value, except as noted below; most properties that are non-numeric cannot be animated using basic jQuery functionality (For example, width, height, or left can be animated but background-color cannot be, unless the jQuery.Color() plugin is used). Property values are treated as a number of pixels unless otherwise specified. The units em and % can be specified where applicable.
                
+    
                All animated properties should be animated to a single numeric value, except as noted below; most properties that are non-numeric cannot be animated using basic jQuery functionality (For example, width, height, or left can be animated but background-color cannot be, unless the jQuery.Color plugin is used). Property values are treated as a number of pixels unless otherwise specified. The units em and % can be specified where applicable.
                
     
                In addition to style properties, some non-style properties such as scrollTop and scrollLeft, as well as custom properties, can be animated.
                
     
                Shorthand CSS properties (e.g. font, background, border) are not fully supported. For example, if you want to animate the rendered border width, at least a border style and border width other than "auto" must be set in advance. Or, if you want to animate font size, you would use fontSize or the CSS equivalent 'font-size' rather than simply 'font'. 
                
     
                In addition to numeric values, each property can take the strings 'show', 'hide', and 'toggle'. These shortcuts allow for custom hiding and showing animations that take into account the display type of the element. In order to use jQuery's built-in toggle state tracking, the 'toggle' keyword must be consistently given as the value of the property being animated.
                

From 473613debe97676a56853453bde5c382625af9f4 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 16 Apr 2015 10:29:34 +0200
Subject: [PATCH 286/699] 1.11.88

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 982763b4..d184215d 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.87",
+  "version": "1.11.88",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 929f9e2472ec0da31446860f3e6a34f35321a6a2 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 9 Apr 2015 14:30:44 +0200
Subject: [PATCH 287/699] Types: add new type `array-like object`

Fixes gh-708
Closes gh-710
---
 pages/Types.html | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/pages/Types.html b/pages/Types.html
index 422f6bd6..feab0a76 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -73,6 +73,7 @@
       
              • Array<Type> Notation
                • 
     
              
   
+  
            • Array-Like Objects
              • 
   
            • PlainObject
              • 
   
            • Date
              • 
   
            • Function
@@ -411,6 +412,9 @@ 
               Array<Type> Notation 
              
 
 
              This indicates that the method doesn't only expect an array as the argument, but also specifies the expected type. The notation is borrowed from Java 5's generics notation (or C++ templates).
 
              
+
              Array-Like Objects
              
+
              Either a true JavaScript Array or a JavaScript Object that contains a nonnegative integer length property and index properties from 0 up to length - 1. This latter case includes array-like objects commonly encountered in web-based code such as the arguments object and the NodeList object returned by many DOM methods.
              
+
              When a jQuery API accepts either plain Objects or Array-Like objects, a plain Object with a numeric length property will trigger the Array-Like behavior.
              
 
               PlainObject 
              
 
              The PlainObject type is a JavaScript object containing zero or more key-value pairs. The plain object is, in other words, an Object object. It is designated "plain" in jQuery documentation to distinguish it from other kinds of JavaScript objects: for example, null, user-defined arrays, and host objects such as document, all of which have a typeof value of "object." The jQuery.isPlainObject() method identifies whether the passed argument is a plain object or not, as demonstrated below:
 
              

From e0f1e222950c9dcf9e64805318fccafe1025d8be Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 16 Apr 2015 22:54:55 +0200
Subject: [PATCH 288/699] 1.11.89

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index d184215d..713b6127 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.88",
+  "version": "1.11.89",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From c0e5d54c16713fe39f93d4ca8276ada8723d8fe2 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Tue, 31 Mar 2015 16:33:29 +0200
Subject: [PATCH 289/699] jQuery.merge: accept array-like objects instead of
 arrays

Fixes gh-686
Closes gh-692
---
 entries/jQuery.merge.xml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/entries/jQuery.merge.xml b/entries/jQuery.merge.xml
index ef43c770..053fff03 100644
--- a/entries/jQuery.merge.xml
+++ b/entries/jQuery.merge.xml
@@ -4,15 +4,15 @@
   Merge the contents of two arrays together into the first array. 
   
     1.0
-    
-      The first array to merge, the elements of second added.
+    
+      The first array-like object to merge, the elements of second added.
     
-    
-      The second array to merge into the first, unaltered.
+    
+      The second array-like object to merge into the first, unaltered.
     
   
   
-    
              The $.merge() operation forms an array that contains all elements from the two arrays. The orders of items in the arrays are preserved, with items from the second array appended. The $.merge() function is destructive. It alters the first parameter to add the items from the second.  
              
+    
              The $.merge() operation forms an array that contains all elements from the two arrays. The orders of items in the arrays are preserved, with items from the second array appended. The $.merge() function is destructive. It alters the length and numeric index properties of the first object to include items from the second.
              
     
              If you need the original first array, make a copy of it before calling $.merge(). Fortunately, $.merge() itself can be used for this duplication:
              
     
              
 var newArray = $.merge([], oldArray);

From 11636011aa377d1af31527afa1c40919aff8d0a7 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 16 Apr 2015 23:14:15 +0200
Subject: [PATCH 290/699] Types: rename `array-like objects` to `array-like
 object`

---
 entries/jQuery.merge.xml | 4 ++--
 pages/Types.html         | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/entries/jQuery.merge.xml b/entries/jQuery.merge.xml
index 053fff03..b122635e 100644
--- a/entries/jQuery.merge.xml
+++ b/entries/jQuery.merge.xml
@@ -4,10 +4,10 @@
   Merge the contents of two arrays together into the first array. 
   
     1.0
-    
+    
       The first array-like object to merge, the elements of second added.
     
-    
+    
       The second array-like object to merge into the first, unaltered.
     
   
diff --git a/pages/Types.html b/pages/Types.html
index feab0a76..5cd81ca6 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -73,7 +73,7 @@
       
            • Array<Type> Notation
              • 
     
            
   
            • 
-  
          • Array-Like Objects
            • 
+  
          • Array-Like Object
            • 
   
          • PlainObject
            • 
   
          • Date
            • 
   
          • Function
@@ -412,7 +412,7 @@ 
             Array<Type> Notation 
            
 
 
            This indicates that the method doesn't only expect an array as the argument, but also specifies the expected type. The notation is borrowed from Java 5's generics notation (or C++ templates).
 
            
-
            Array-Like Objects
            
+
            Array-Like Object
            
 
            Either a true JavaScript Array or a JavaScript Object that contains a nonnegative integer length property and index properties from 0 up to length - 1. This latter case includes array-like objects commonly encountered in web-based code such as the arguments object and the NodeList object returned by many DOM methods.
            
 
            When a jQuery API accepts either plain Objects or Array-Like objects, a plain Object with a numeric length property will trigger the Array-Like behavior.
            
 
             PlainObject 
            

From 424bea3fa4b9d65707485e5d9de7bdb37cd91afd Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Fri, 17 Apr 2015 17:37:40 +0200
Subject: [PATCH 291/699] 1.11.90

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 713b6127..d5ea4af1 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.89",
+  "version": "1.11.90",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From e420da6cacea0f08c528b7a5eeb376ad64c52f32 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Fri, 17 Apr 2015 17:22:25 +0200
Subject: [PATCH 292/699] Events: add note about detaching to all shorthand
 methods

Fixes gh-717
Closes gh-719
---
 entries/blur.xml       | 1 +
 entries/change.xml     | 1 +
 entries/click.xml      | 1 +
 entries/dblclick.xml   | 1 +
 entries/error.xml      | 1 +
 entries/focus.xml      | 1 +
 entries/focusin.xml    | 1 +
 entries/focusout.xml   | 1 +
 entries/keydown.xml    | 1 +
 entries/keypress.xml   | 1 +
 entries/keyup.xml      | 1 +
 entries/mousedown.xml  | 1 +
 entries/mouseenter.xml | 1 +
 entries/mouseleave.xml | 1 +
 entries/mousemove.xml  | 1 +
 entries/mouseout.xml   | 1 +
 entries/mouseover.xml  | 1 +
 entries/mouseup.xml    | 1 +
 entries/resize.xml     | 1 +
 entries/scroll.xml     | 1 +
 entries/select.xml     | 1 +
 entries/submit.xml     | 1 +
 entries/unload.xml     | 1 +
 notes.xsl              | 3 +++
 24 files changed, 26 insertions(+)

diff --git a/entries/blur.xml b/entries/blur.xml
index 747a7d1e..11afbd6a 100644
--- a/entries/blur.xml
+++ b/entries/blur.xml
@@ -52,6 +52,7 @@ $( "#other" ).click(function() {
     
            After this code executes, clicks on Trigger the handler will also alert the message.
            
     
            The blur event does not bubble in Internet Explorer. Therefore, scripts that rely on event delegation with the blur event will not work consistently across browsers. As of version 1.4.2, however, jQuery works around this limitation by mapping blur to the focusout event in its event delegation methods, .live() and .delegate().
            
   
+  
   
     To trigger the blur event on all paragraphs:
     Note: Changing the value of an input element using JavaScript, using .val() for example, won't fire the event.
            
     
   
+  
   
     Attaches a change event to the select that gets the text for each selected option and writes them in the div.  It then triggers the event for the initial text draw.
     
     
            This is usually the desired sequence before taking an action. If this is not required, the mousedown or mouseup event may be more suitable.
            
   
+  
   
     Hide paragraphs on a page when they are clicked:
     It is inadvisable to bind handlers to both the click and dblclick events for the same element. The sequence of events triggered varies from browser to browser, with some receiving two click events before the dblclick and others only one. Double-click sensitivity (maximum time between clicks that is detected as a double click) can vary by operating system and browser, and is often user-configurable.
     
            
   
+  
   
     To bind a "Hello World!" alert box the dblclick event on every paragraph on the page:
     
     
            Note: A jQuery error event handler should not be attached to the window object. The browser fires the window's error event when a script error occurs. However, the window error event receives different arguments and has different return value requirements than conventional event handlers. Use window.onerror instead.
            
   
+  
   
     To hide the "broken image" icons for IE users, you can try:
     After this code executes, clicks on Trigger the handler will also alert the message.
            
     
            The focus event does not bubble in Internet Explorer. Therefore, scripts that rely on event delegation with the focus event will not work consistently across browsers. As of version 1.4.2, however, jQuery works around this limitation by mapping focus to the focusin event in its event delegation methods, .live() and .delegate().
            
   
+  
   
     Fire focus.
     The focusin event is sent to an element when it, or any element inside of it, gains focus. This is distinct from the focus event in that it supports detecting the focus event on parent elements (in other words, it supports event bubbling).
            
     
            This event will likely be used together with the focusout event.
            
   
+  
   
     Watch for a focus to occur within the paragraphs on the page.
     The focusout event is sent to an element when it, or any element inside of it, loses focus. This is distinct from the blur event in that it supports detecting the loss of focus on descendant elements (in other words, it supports event bubbling).
            
     
            This event will likely be used together with the focusin event.
            
   
+  
   
     Watch for a loss of focus to occur inside paragraphs and note the difference between the focusout count and the blur count. (The blur count does not change because those events do not bubble.)
     If key presses anywhere need to be caught (for example, to implement global shortcut keys on a page), it is useful to attach this behavior to the document object. Because of event bubbling, all key presses will make their way up the DOM to the document object unless explicitly stopped.
            
     
            To determine which key was pressed, examine the event object that is passed to the handler function. While browsers use differing properties to store this information, jQuery normalizes the .which property so you can reliably use it to retrieve the key code. This code corresponds to a key on the keyboard, including codes for special keys such as arrows. For catching actual text entry, .keypress() may be a better choice.
            
   
+  
   
     Show the event object for the keydown handler when a key is pressed in the input.
     To determine which character was entered, examine the event object that is passed to the handler function. While browsers use differing properties to store this information, jQuery normalizes the .which property so you can reliably use it to retrieve the character code.
            
     
            Note that keydown and keyup provide a code indicating which key is pressed, while keypress indicates which character was entered. For example, a lowercase "a" will be reported as 65 by keydown and keyup, but as 97 by keypress. An uppercase "A" is reported as 65 by all events. Because of this distinction, when catching special keystrokes such as arrow keys, .keydown() or .keyup() is a better choice.
            
   
+  
   
     Show the event object when a key is pressed in the input. Note: This demo relies on a simple $.print() plugin (http://api.jquery.com/resources/events.js) for the event object's output.
     If key presses anywhere need to be caught (for example, to implement global shortcut keys on a page), it is useful to attach this behavior to the document object. Because of event bubbling, all key presses will make their way up the DOM to the document object unless explicitly stopped.
            
     
            To determine which key was pressed, examine the event object that is passed to the handler function. While browsers use differing properties to store this information, jQuery normalizes the .which property so you can reliably use it to retrieve the key code. This code corresponds to a key on the keyboard, including codes for special keys such as arrows. For catching actual text entry, .keypress() may be a better choice.
            
   
+  
   
     Show the event object for the keyup handler (using a simple $.print plugin) when a key is released in the input.
     This event is primarily useful for ensuring that the primary button was used to begin a drag operation; if ignored, strange results can occur when the user attempts to use a context menu. While the middle and right buttons can be detected with these properties, this is not reliable. In Opera and Safari, for example, right mouse button clicks are not detectable by default.
            
     
            If the user clicks on an element, drags away from it, and releases the button, this is still counted as a mousedown event. This sequence of actions is treated as a "canceling" of the button press in most user interfaces, so it is usually better to use the click event unless we know that the mousedown event is preferable for a particular situation.
            
   
+  
   
     Show texts when mouseup and mousedown event triggering.
     After this code executes, clicks on Trigger the handler will also append the message.
            
     
            The mouseenter event differs from mouseover in the way it handles event bubbling. If mouseover were used in this example, then when the mouse pointer moved over the Inner element, the handler would be triggered. This is usually undesirable behavior. The mouseenter event, on the other hand, only triggers its handler when the mouse enters the element it is bound to, not a descendant. So in this example, the handler is triggered when the mouse enters the Outer element, but not the Inner element.
            
   
+  
   
     Show texts when mouseenter and mouseout event triggering.
     mouseover fires when the pointer moves into the child element as well, while mouseenter fires only when the pointer moves into the bound element.
diff --git a/entries/mouseleave.xml b/entries/mouseleave.xml
index 25ed2dc7..56adcb65 100644
--- a/entries/mouseleave.xml
+++ b/entries/mouseleave.xml
@@ -55,6 +55,7 @@ $( "#other" ).click(function() {
     
            After this code executes, clicks on Trigger the handler will also append the message.
            
     
            The mouseleave event differs from mouseout in the way it handles event bubbling. If mouseout were used in this example, then when the mouse pointer moved out of the Inner element, the handler would be triggered. This is usually undesirable behavior. The mouseleave event, on the other hand, only triggers its handler when the mouse leaves the element it is bound to, not a descendant. So in this example, the handler is triggered when the mouse leaves the Outer element, but not the Inner element.
            
   
+  
   
     Show number of times mouseout and mouseleave events are triggered. mouseout fires when the pointer moves out of child element as well, while mouseleave fires only when the pointer moves out of the bound element.
     Keep in mind that the mousemove event is triggered whenever the mouse pointer moves, even for a pixel. This means that hundreds of events can be generated over a very small amount of time. If the handler has to do any significant processing, or if multiple handlers for the event exist, this can be a serious performance drain on the browser. It is important, therefore, to optimize mousemove handlers as much as possible, and to unbind them as soon as they are no longer needed.
            
     
            A common pattern is to bind the mousemove handler from within a mousedown hander, and to unbind it from a corresponding mouseup handler. If implementing this sequence of events, remember that the mouseup event might be sent to a different HTML element than the mousemove event was. To account for this, the mouseup handler should typically be bound to an element high up in the DOM tree, such as <body>.
            
   
+  
   
     Show the mouse coordinates when the mouse is moved over the yellow div.  Coordinates are relative to the window, which in this case is the iframe.
     After this code executes, clicks on Trigger the handler will also append the message.
            
     
            This event type can cause many headaches due to event bubbling. For instance, when the mouse pointer moves out of the Inner element in this example, a mouseout event will be sent to that, then trickle up to Outer. This can trigger the bound mouseout handler at inopportune times. See the discussion for .mouseleave() for a useful alternative.
            
   
+  
   
     Show the number of times mouseout and mouseleave events are triggered.
   mouseout fires when the pointer moves out of the child element as well, while mouseleave fires only when the pointer moves out of the bound element.
diff --git a/entries/mouseover.xml b/entries/mouseover.xml
index d8e8b0b0..f2ca8c02 100644
--- a/entries/mouseover.xml
+++ b/entries/mouseover.xml
@@ -56,6 +56,7 @@ $( "#other" ).click(function() {
     
            After this code executes, clicks on Trigger the handler will also append the message.
            
     
            This event type can cause many headaches due to event bubbling. For instance, when the mouse pointer moves over the Inner element in this example, a mouseover event will be sent to that, then trickle up to Outer. This can trigger our bound mouseover handler at inopportune times. See the discussion for .mouseenter() for a useful alternative.
            
   
+  
   
     Show the number of times mouseover and mouseenter events are triggered.
 mouseover fires when the pointer moves into the child element as well, while mouseenter fires only when the pointer moves into the bound element.
diff --git a/entries/mouseup.xml b/entries/mouseup.xml
index 80d0f619..31640a96 100644
--- a/entries/mouseup.xml
+++ b/entries/mouseup.xml
@@ -56,6 +56,7 @@ $( "#other" ).click(function() {
     
            After this code executes, clicks on Trigger the handler will also alert the message.
            
     
            If the user clicks outside an element, drags onto it, and releases the button, this is still counted as a mouseup event. This sequence of actions is not treated as a button press in most user interfaces, so it is usually better to use the click event unless we know that the mouseup event is preferable for a particular situation.
            
   
+  
   
     Show texts when mouseup and mousedown event triggering.
     Now whenever the browser window's size is changed, the message is appended to <div id="log"> one or more times, depending on the browser.
            
     
            Code in a resize handler should never rely on the number of times the handler is called. Depending on implementation, resize events can be sent continuously as the resizing is in progress (the typical behavior in Internet Explorer and WebKit-based browsers such as Safari and Chrome), or only once at the end of the resize operation (the typical behavior in some other browsers such as Opera).
            
   
+  
   
     To see the window width while (or after) it is resized, try:
     After this code executes, clicks on Trigger the handler will also append the message.
            
     
            A scroll event is sent whenever the element's scroll position changes, regardless of the cause. A mouse click or drag on the scroll bar, dragging inside the element, pressing the arrow keys, or using the mouse's scroll wheel could cause this event.
            
   
+  
   
     To do something when your page is scrolled:
     The method for retrieving the current selected text differs from one browser to another. A number of jQuery plug-ins offer cross-platform solutions.
            
     
   
+  
   
     To do something when text in input boxes is selected:
     After this code executes, clicks on Trigger the handler will also display the message. In addition, the default submit action on the form will be fired, so the form will be submitted.
            
     
            The JavaScript submit event does not bubble in Internet Explorer. However, scripts that rely on event delegation with the submit event will work consistently across browsers as of jQuery 1.4, which has normalized the event's behavior. 
            
   
+  
   
   
     If you'd like to prevent forms from being submitted unless a flag variable is set, try:
diff --git a/entries/unload.xml b/entries/unload.xml
index e33dc639..493e631f 100644
--- a/entries/unload.xml
+++ b/entries/unload.xml
@@ -33,6 +33,7 @@ $( window ).unload(function() {
                 
     
            This event is available so that scripts can perform cleanup when the user leaves the page. Most browsers will ignore calls to alert(), confirm() and prompt() inside the event handler. The string you return may be used in a confirmation dialog, but not all browsers support this. It is not possible to cancel the unload event with .preventDefault().
            
   
+  
   
     To display an alert when a page is unloaded:
     
 			Using this selector heavily can have performance implications, as it may force the browser to re-render the page before it can determine visibility. Tracking the visibility of elements via other methods, using a class for example, can provide better performance.
 		
+		
+			As the .() method is just a shorthand for .on( "", handler ), detaching is possible using .off( "" ).
+		
 	
 
 

From 85581c0adfc2e5a38e8d17c7a8a1510781d5ee05 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Fri, 17 Apr 2015 21:06:17 +0200
Subject: [PATCH 293/699] 1.11.91

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index d5ea4af1..edffe6e3 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.90",
+  "version": "1.11.91",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 4f0a6f3dd7ff96580b5f466bad9b59cc4ca1525e Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sat, 28 Feb 2015 23:34:56 +0000
Subject: [PATCH 294/699] jQuery.data: correct info on `.data( "name",
 undefined )`

Fixes gh-586
Closes gh-673
---
 entries/jQuery.data.xml | 2 +-
 notes.xsl               | 5 ++++-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/entries/jQuery.data.xml b/entries/jQuery.data.xml
index 193cae70..bc1bab43 100644
--- a/entries/jQuery.data.xml
+++ b/entries/jQuery.data.xml
@@ -25,7 +25,7 @@ jQuery.data( document.body, "bar", "test" );
       
     
     
-    
+    
     
       Store then retrieve a value from the div element.
       
 	
 		
-			undefined is not recognised as a data value. Calls such as ( , undefined ) will return the corresponding data for "name", and is therefore the same as (  ).
+			undefined is not recognized as a data value. Calls such as ( , undefined ) will return the jQuery object that it was called on, allowing for chaining.
+		
+		
+			undefined is not recognized as a data value. Calls such as ( , undefined ) will return the corresponding data for "name", and is therefore the same as (  ).
 		
 		
 			The number returned by dimensions-related APIs, including , may be fractional in some cases. Code should not assume it is an integer. Also, dimensions may be incorrect when the page is zoomed by the user; browsers do not expose an API to detect this condition.

From 9840ff0919dce92b3fe1e3b9de771daba54c3032 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Fri, 17 Apr 2015 21:09:58 +0200
Subject: [PATCH 295/699] 1.11.92

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index edffe6e3..3df6c618 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.91",
+  "version": "1.11.92",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From bb4da5ebf10b684002838a5fd4bbd18014a4edef Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 16 Apr 2015 11:15:18 +0200
Subject: [PATCH 296/699] Trigger: add note about objects with a `length`
 property

Fixes gh-377
Closes gh-716
---
 entries/trigger.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/entries/trigger.xml b/entries/trigger.xml
index c840b058..91e3c26a 100644
--- a/entries/trigger.xml
+++ b/entries/trigger.xml
@@ -46,6 +46,7 @@ $( "#foo").trigger( "custom", [ "Custom", "Event" ] );
     
            The .trigger() method can be used on jQuery collections that wrap plain JavaScript objects similar to a pub/sub mechanism; any event handlers bound to the object will be called when the event is triggered. 
            
     
            Note: For both plain objects and DOM objects other than window, if a triggered event name matches the name of a property on the object, jQuery will attempt to invoke the property as a method if no event handler calls event.preventDefault(). If this behavior is not desired, use .triggerHandler() instead.
            
     
            Note: As with .triggerHandler(), when calling .trigger() with an event name matches the name of a property on the object, prefixed by on (e.g. triggering click on window that has a non null onclick method), jQuery will attempt to invoke that property as a method.
            
+    
            Note: When triggering with a plain object that is not array-like but still contains a length property, you should pass the object in an array (e.g. [ { length: 1 } ]).
            
   
   
     Clicks to button #2 also trigger a click for button #1.

From c0c72c680d146a750a42cf966368a7e3beaa35be Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sun, 19 Apr 2015 15:04:11 +0200
Subject: [PATCH 297/699] 1.11.93

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 3df6c618..5d9f7f24 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.92",
+  "version": "1.11.93",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 225389fb6aeb14bbe9c2ee290d7617a45801cfef Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Sat, 28 Mar 2015 08:44:51 -0400
Subject: [PATCH 298/699] jQuery.parseHTML: Fix a couple typos

---
 entries/jQuery.parseHTML.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/jQuery.parseHTML.xml b/entries/jQuery.parseHTML.xml
index 06f59937..930d60a2 100644
--- a/entries/jQuery.parseHTML.xml
+++ b/entries/jQuery.parseHTML.xml
@@ -18,10 +18,10 @@
     
            jQuery.parseHTML uses native methods to convert the string to a set of DOM nodes, which can then be inserted into the document. These methods do render all trailing or leading text (even if that's just whitespace). To prevent trailing/leading whitespace from being converted to text nodes you can pass the HTML string through jQuery.trim.
            
     
            By default, the context is the current document if not specified or given as null or undefined. If the HTML was to be used in another document such as an iframe, that frame's document could be used.
            
 	
            Security Considerations
            
-	
            Most jQuery APIs that accept HTML strings will run scripts that are included in the HTML. jQuery.parseHTML does not run script in the parsed HTML unless keepScripts is explicitly true. However, it is still possible in most environments to execute script indirectly, for example via the <img onerror> attribute. The caller should be aware of this and guard against it by cleaning or escaping any untrusted inputs from sources such as the URL or cookies. For future compatibility, callers should not depend on the ability to run any script content when keepScripts is unspecified or false.
            
+	
            Most jQuery APIs that accept HTML strings will run scripts that are included in the HTML. jQuery.parseHTML does not run scripts in the parsed HTML unless keepScripts is explicitly true. However, it is still possible in most environments to execute scripts indirectly, for example via the <img onerror> attribute. The caller should be aware of this and guard against it by cleaning or escaping any untrusted inputs from sources such as the URL or cookies. For future compatibility, callers should not depend on the ability to run any script content when keepScripts is unspecified or false.
            
   
   
-    Create an array of Dom nodes using an HTML string and insert it into a div.
+    Create an array of DOM nodes using an HTML string and insert it into a div.
     
   
            Content:
            

From 2365251f90e9fd5f183dad30d169fe92517ef12e Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Tue, 21 Apr 2015 09:16:13 -0400
Subject: [PATCH 299/699] Release 1.11.94

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 5d9f7f24..6cc2c945 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.93",
+  "version": "1.11.94",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From c6565eb34e45a07b9c1fb8acd88e6fdd5ec05d37 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Wed, 22 Apr 2015 20:23:23 +0200
Subject: [PATCH 300/699] next-adjacent: rename file to
 `next-adjacent-selector.xml`

Ref gh-722
Closes gh-723
---
 .../{next-adjacent-Selector.xml => next-adjacent-selector.xml}    | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename entries/{next-adjacent-Selector.xml => next-adjacent-selector.xml} (100%)

diff --git a/entries/next-adjacent-Selector.xml b/entries/next-adjacent-selector.xml
similarity index 100%
rename from entries/next-adjacent-Selector.xml
rename to entries/next-adjacent-selector.xml

From 484615071377dfcb1c3a57e27e0a76704ac78a94 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Wed, 29 Apr 2015 20:08:58 +0200
Subject: [PATCH 301/699] 1.11.95

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 6cc2c945..b86e0850 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.94",
+  "version": "1.11.95",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 1344eb35fb792ea0d7a148be96bbb81e84f08fea Mon Sep 17 00:00:00 2001
From: Dave Methvin 
Date: Mon, 20 Apr 2015 15:37:41 -0400
Subject: [PATCH 302/699] Dimensions: Update hidden element note

Add information about it being bad practice, inaccurate, and subject to removal
in a future version of jQuery. It probably causes cancer too.

Fixes gh-197
Closes gh-721
---
 entries/height.xml      | 2 +-
 entries/innerHeight.xml | 2 +-
 entries/innerWidth.xml  | 2 +-
 entries/outerHeight.xml | 2 +-
 entries/outerWidth.xml  | 2 +-
 entries/width.xml       | 2 +-
 notes.xsl               | 4 ++--
 7 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/entries/height.xml b/entries/height.xml
index 9d4b86bc..7efdf312 100644
--- a/entries/height.xml
+++ b/entries/height.xml
@@ -26,7 +26,7 @@ $( document ).height();
       
     
     
-    
+    
     
       Show various heights.  Note the values are from the iframe so might be smaller than you expected.  The yellow highlight shows the iframe body.
       
   
 	
-  
+  
   
     Get the innerHeight of a paragraph.
     
   
 	
-  
+  
   
     Get the innerWidth of a paragraph.
     
   
 	
-  
+  
   
     Get the outerHeight of a paragraph.
     
   
 	
-  
+  
   
     Get the outerWidth of a paragraph.
     
     
   	
-    
+    
     
       Show various widths.  Note the values are from the iframe so might be smaller than you expected.  The yellow highlight shows the iframe body.
       
 			Forms and their child elements should not use input names or ids that conflict with properties of a form, such as submit, length, or method. Name conflicts can cause confusing failures. For a complete list of rules and to check your markup for these problems, see DOMLint.
 		            
-		
-			The value reported by  is not guaranteed to be accurate when the element's parent is hidden. To get an accurate value, you should show the parent first, before using .
+		
+			The value reported by  is not guaranteed to be accurate when the element or its parent is hidden. To get an accurate value, ensure the element is visible before using . jQuery will attempt to temporarily show and then re-hide an element in order to measure its dimensions, but this is unreliable and (even when accurate) can significantly impact page performance. This show-and-rehide measurement feature may be removed in a future version of jQuery.
 		
 		
 			Because  is a jQuery extension and not part of the CSS specification, queries using  cannot take advantage of the performance boost provided by the native DOM querySelectorAll() method. To achieve the best performance when using  to select elements, first select the elements using a pure CSS selector, then use .filter("").

From 1af8d45cc1ab347e0adaa316375f0d571128a4bb Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Wed, 29 Apr 2015 20:21:19 +0200
Subject: [PATCH 303/699] 1.11.96

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index b86e0850..bc0c4a63 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.95",
+  "version": "1.11.96",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 32ffc61e968401c2e791ffc688010431a62c243e Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Wed, 29 Apr 2015 20:11:27 +0200
Subject: [PATCH 304/699] jQuery.post: change order of signatures

Closes gh-726
Fixes gh-725
---
 entries/jQuery.post.xml | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/entries/jQuery.post.xml b/entries/jQuery.post.xml
index 2300cbe7..8a1bdc43 100644
--- a/entries/jQuery.post.xml
+++ b/entries/jQuery.post.xml
@@ -1,12 +1,6 @@
 
 
   jQuery.post()
-  
-    3.0
-    
-      A set of key/value pairs that configure the Ajax request. All properties except for url are optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) for a complete list of all settings. Type will automatically be set to POST.
-    
-  
   
     1.0
     
@@ -27,6 +21,12 @@
       The type of data expected from the server. Default: Intelligent Guess (xml, json, script, text, html).
     
   
+  
+    3.0
+    
+      A set of key/value pairs that configure the Ajax request. All properties except for url are optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) for a complete list of all settings. Type will automatically be set to POST.
+    
+  
   Load data from the server using a HTTP POST request.
   
     
            This is a shorthand Ajax function, which is equivalent to:
            

From 74d690ffc8af49cace4785e52eec70668a43068c Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Wed, 22 Apr 2015 20:34:58 +0200
Subject: [PATCH 305/699] offsetParent: Add correct ``

Fixes gh-722
Closes gh-724
---
 entries/offsetParent.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/entries/offsetParent.xml b/entries/offsetParent.xml
index 363c3208..c49a7044 100644
--- a/entries/offsetParent.xml
+++ b/entries/offsetParent.xml
@@ -59,4 +59,5 @@ $( "li.item-a" ).offsetParent().css( "background-color", "red" );
               
   
   
+  
 

From 31d2ab4182a33ecd6a54c6b5ed3cad42fb0ebca5 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Fri, 1 May 2015 09:18:42 +0200
Subject: [PATCH 306/699] 1.11.97

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index bc0c4a63..8ba1dd52 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.96",
+  "version": "1.11.97",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 699e63f1b8c74b428bf2e2b0115db7441e3a2f85 Mon Sep 17 00:00:00 2001
From: Chris Rebert 
Date: Thu, 7 May 2015 12:50:10 -0700
Subject: [PATCH 307/699] event.metaKey: Explain which key is `META` on common
 platforms

Sources:
* https://w3c.github.io/uievents/#widl-KeyboardEvent-metaKey
* https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/metaKey

Closes gh-735
---
 entries/event.metaKey.xml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/entries/event.metaKey.xml b/entries/event.metaKey.xml
index bca1b7b2..b83eeadd 100644
--- a/entries/event.metaKey.xml
+++ b/entries/event.metaKey.xml
@@ -8,6 +8,8 @@
   
     
            Returns a boolean value (true or false) that indicates whether or not the META key was pressed at the time the event fired.
     This key might map to an alternative key name on some platforms.
            
+    
            On Macintosh keyboards, the META key maps to the Command key (⌘).
            
+    
            On Windows keyboards, the META key maps to the Windows key.
            
               
   
     Determine whether the META key was pressed when the event fired.

From 7ecff5dd61e6137858e063d5d352ee50ba8f127d Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Mon, 11 May 2015 06:56:16 +0200
Subject: [PATCH 308/699] 1.11.98

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 8ba1dd52..d75c90bd 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.97",
+  "version": "1.11.98",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From ae3a65efea000b267ef67d63343dc29453ad68e4 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sat, 23 May 2015 19:54:22 +0100
Subject: [PATCH 309/699] jQuery(): Wrap code using the `code` element

Closes gh-743
---
 entries/jQuery.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.xml b/entries/jQuery.xml
index fc13219d..287d0f0a 100644
--- a/entries/jQuery.xml
+++ b/entries/jQuery.xml
@@ -174,7 +174,7 @@ $( myForm.elements ).hide();
       
            $( "<p id='test'>My <em>new</em> text</p>" ).appendTo( "body" );
            
       
            For explicit parsing of a string to HTML, use the $.parseHTML() method.
            
       
            By default, elements are created with an .ownerDocument matching the document into which the jQuery library was loaded. Elements being injected into a different document should be created using that document, e.g., $("<p>hello iframe</p>", $("#myiframe").prop("contentWindow").document).
            
-      
            If the HTML is more complex than a single tag without attributes, as it is in the above example, the actual creation of the elements is handled by the browser's .innerHTML mechanism. In most cases, jQuery creates a new <div> element and sets the innerHTML property of the element to the HTML snippet that was passed in. When the parameter has a single tag (with optional closing tag or quick-closing) — $( "<img />" ) or $( "<img>" ), $( "<a></a>" ) or $( "<a>" ) — jQuery creates the element using the native JavaScript .createElement() function.
            
+      
            If the HTML is more complex than a single tag without attributes, as it is in the above example, the actual creation of the elements is handled by the browser's .innerHTML mechanism. In most cases, jQuery creates a new <div> element and sets the innerHTML property of the element to the HTML snippet that was passed in. When the parameter has a single tag (with optional closing tag or quick-closing) — $( "<img />" ) or $( "<img>" ), $( "<a></a>" ) or $( "<a>" ) — jQuery creates the element using the native JavaScript .createElement() function.
            
       
            When passing in complex HTML, some browsers may not generate a DOM that exactly replicates the HTML source provided. As mentioned, jQuery uses the browser's .innerHTML property to parse the passed HTML and insert it into the current document. During this process, some browsers filter out certain elements such as <html>, <title>, or <head> elements. As a result, the elements inserted may not be representative of the original string passed.
            
       
            Filtering isn't, however, limited to these tags. For example, Internet Explorer prior to version 8 will also convert all href properties on links to absolute URLs, and Internet Explorer prior to version 9 will not correctly handle HTML5 elements without the addition of a separate compatibility layer.
            
       
            To ensure cross-platform compatibility, the snippet must be well-formed. Tags that can contain other elements should be paired with a closing tag:
            

From 66e94294b81748b66230005cc71c02de9755c78f Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sat, 23 May 2015 22:19:57 +0200
Subject: [PATCH 310/699] 1.11.99

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index d75c90bd..97ddf8c0 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.98",
+  "version": "1.11.99",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From be83880bcfed80ffe87771e5835a690d6216bbe8 Mon Sep 17 00:00:00 2001
From: Yuval Greenfield 
Date: Sun, 19 Apr 2015 09:18:41 -0700
Subject: [PATCH 311/699] jQuery.ajax: Clarify information regarding
 cross-domain `jsonp` usage

Closes gh-329
---
 entries/jQuery.ajax.xml | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index f2db327d..4c8f6686 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -74,8 +74,15 @@ $.ajax({
       
       
         The type of data that you're expecting back from the server. If none is specified, jQuery will try to infer it based on the MIME type of the response (an XML MIME type will yield XML, in 1.4 JSON will yield a JavaScript object, in 1.4 script will execute the script, and anything else will be returned as a string). The available types (and the result passed as the first argument to your success callback) are:
-          
            • "xml": Returns a XML document that can be processed via jQuery.
            • "html": Returns HTML as plain text; included script tags are evaluated when inserted in the DOM.
            • "script": Evaluates the response as JavaScript and returns it as plain text. Disables caching by appending a query string parameter, "_=[TIMESTAMP]", to the URL unless the cache option is set to true. Note: This will turn POSTs into GETs for remote-domain requests. 
            • "json": Evaluates the response as JSON and returns a JavaScript object. The JSON data is parsed in a strict manner; any malformed JSON is rejected and a parse error is thrown. As of jQuery 1.9, an empty response is also rejected; the server should return a response of null or {} instead. (See json.org for more information on proper JSON formatting.)
            • "jsonp": Loads in a JSON block using JSONP. Adds an extra "?callback=?" to the end of your URL to specify the callback. Disables caching by appending a query string parameter, "_=[TIMESTAMP]", to the URL unless the cache option is set to true.
            • "text": A plain text string.
            • multiple, space-separated values: As of jQuery 1.5, jQuery can convert a dataType from what it received in the Content-Type header to what you require. For example, if you want a text response to be treated as XML, use "text xml" for the dataType. You can also make a JSONP request, have it received as text, and interpreted by jQuery as XML: "jsonp text xml." Similarly, a shorthand string such as "jsonp xml" will first attempt to convert from jsonp to xml, and, failing that, convert from jsonp to text, and then from text to xml.
-          
            
+          
              
+            
            • "xml": Returns a XML document that can be processed via jQuery.
              • 
+            
            • "html": Returns HTML as plain text; included script tags are evaluated when inserted in the DOM.
              • 
+            
            • "script": Evaluates the response as JavaScript and returns it as plain text. Disables caching by appending a query string parameter, _=[TIMESTAMP], to the URL unless the cache option is set to true. Note: This will turn POSTs into GETs for remote-domain requests.
              • 
+            
            • "json": Evaluates the response as JSON and returns a JavaScript object. Cross-domain "json" requests are converted to "jsonp" unless the request includes jsonp: false in its request options. The JSON data is parsed in a strict manner; any malformed JSON is rejected and a parse error is thrown. As of jQuery 1.9, an empty response is also rejected; the server should return a response of null or {} instead. (See json.org for more information on proper JSON formatting.)
              • 
+            
            • "jsonp": Loads in a JSON block using JSONP. Adds an extra "?callback=?" to the end of your URL to specify the callback. Disables caching by appending a query string parameter, "_=[TIMESTAMP]", to the URL unless the cache option is set to true.
              • 
+            
            • "text": A plain text string.
              • 
+            
            • multiple, space-separated values: As of jQuery 1.5, jQuery can convert a dataType from what it received in the Content-Type header to what you require. For example, if you want a text response to be treated as XML, use "text xml" for the dataType. You can also make a JSONP request, have it received as text, and interpreted by jQuery as XML: "jsonp text xml". Similarly, a shorthand string such as "jsonp xml" will first attempt to convert from jsonp to xml, and, failing that, convert from jsonp to text, and then from text to xml.
              • 
+          
            
                     
                   
       

From 4bd46e4374437abb815dcac54438f61c66f93e92 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sun, 24 May 2015 19:45:23 +0200
Subject: [PATCH 312/699] 1.11.100

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 97ddf8c0..0cda4e6d 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.99",
+  "version": "1.11.100",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 87d3f60d6634bf5d63ee7fd599a25a50000d32a2 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Wed, 27 May 2015 21:54:26 +0200
Subject: [PATCH 313/699] Selector: correct `removed` version

Fixes gh-746
Closes gh-747
---
 entries/selector.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/selector.xml b/entries/selector.xml
index 971a2535..76a0ea5e 100644
--- a/entries/selector.xml
+++ b/entries/selector.xml
@@ -1,5 +1,5 @@
 
-
+
   .selector
   
     1.3

From fd5e89de6a79d9314cd4d27d517c374e659e6eab Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 28 May 2015 06:49:53 +0200
Subject: [PATCH 314/699] 1.11.101

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 0cda4e6d..f428e95f 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.100",
+  "version": "1.11.101",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 2fbd82b48db4c5387f4f6d68084486fff8d4bf83 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sat, 9 May 2015 22:19:50 +0200
Subject: [PATCH 315/699] jQuery(): add note about support of text nodes

Fixes gh-709
Close gh-738
---
 entries/contents.xml | 2 +-
 entries/jQuery.xml   | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/entries/contents.xml b/entries/contents.xml
index 9f4d8b2f..6f348b9b 100644
--- a/entries/contents.xml
+++ b/entries/contents.xml
@@ -6,7 +6,7 @@
   
   Get the children of each element in the set of matched elements, including text and comment nodes.
   
-    
            Given a jQuery object that represents a set of DOM elements, the .contents() method allows us to search through the immediate children of these elements in the DOM tree and construct a new jQuery object from the matching elements. The .contents() and .children() methods are similar, except that the former includes text nodes as well as HTML elements in the resulting jQuery object.
            
+    
            Given a jQuery object that represents a set of DOM elements, the .contents() method allows us to search through the immediate children of these elements in the DOM tree and construct a new jQuery object from the matching elements. The .contents() and .children() methods are similar, except that the former includes text nodes and comment nodes as well as HTML elements in the resulting jQuery object. Please note that most jQuery operations don't support text nodes and comment nodes. The few that do will have an explicit note on their API documentation page.
            
     
            The .contents() method can also be used to get the content document of an iframe, if the iframe is on the same domain as the main page.
            
     
            Consider a simple <div> with a number of text nodes, each of which is separated by two line break elements (<br>):
            
     
            
diff --git a/entries/jQuery.xml b/entries/jQuery.xml
index 287d0f0a..80e5bf19 100644
--- a/entries/jQuery.xml
+++ b/entries/jQuery.xml
@@ -57,7 +57,8 @@ $( "div.foo" ).click(function() {
       
            Internally, selector context is implemented with the .find() method, so  $( "span", this ) is equivalent to  $( this ).find( "span" ).
            
 
       
            Using DOM elements
            
-      
            The second and third formulations of this function create a jQuery object using one or more DOM elements that were already selected in some other way. When passing an array, each element must be a DOM element; mixed data is not supported. A jQuery object is created from the array elements in the order they appeared in the array; unlike most other multi-element jQuery operations, the elements are not sorted in DOM order.
            
+      
            The second and third formulations of this function create a jQuery object using one or more DOM elements that were already selected in some other way. A jQuery object is created from the array elements in the order they appeared in the array; unlike most other multi-element jQuery operations, the elements are not sorted in DOM order. Elements will be copied from the array as-is and won't be unwrapped if they're already jQuery collections.
            
+      
            Please note that although you can pass text nodes and comment nodes into a jQuery collection this way, most operations don't support them. The few that do will have an explicit note on their API documentation page.
            
       
            A common use of single-DOM-element construction is to call jQuery methods on an element that has been passed to a callback function through the keyword this:
            
       
            
 $( "div.foo" ).click(function() {

From 2519ef6e70285e92d2a89db062e47a7e40182efc Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sat, 30 May 2015 15:41:58 +0200
Subject: [PATCH 316/699] 1.11.102

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index f428e95f..c850d7e1 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.101",
+  "version": "1.11.102",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From cc4cc30698bc19ebe075c8838b2da31b65d5b89d Mon Sep 17 00:00:00 2001
From: Chad Killingsworth 
Date: Mon, 8 Jun 2015 09:14:43 -0500
Subject: [PATCH 317/699] deferred.promise: promise objects also have the
 .promise() method

Closes gh-753
---
 entries/deferred.promise.xml | 2 +-
 pages/Types.html             | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/deferred.promise.xml b/entries/deferred.promise.xml
index d2a4c12d..db6550bd 100644
--- a/entries/deferred.promise.xml
+++ b/entries/deferred.promise.xml
@@ -9,7 +9,7 @@
   
    Return a Deferred's Promise object. 
   
-    
            The deferred.promise() method allows an asynchronous function to prevent other code from interfering with the progress or status of its internal request. The Promise exposes only the Deferred methods needed to attach additional handlers or determine the state (then, done, fail, always, pipe, progress, and state), but not ones that change the state (resolve, reject, notify, resolveWith, rejectWith, and notifyWith).
            
+    
            The deferred.promise() method allows an asynchronous function to prevent other code from interfering with the progress or status of its internal request. The Promise exposes only the Deferred methods needed to attach additional handlers or determine the state (then, done, fail, always, pipe, progress, state and promise), but not ones that change the state (resolve, reject, notify, resolveWith, rejectWith, and notifyWith).
            
     
            If target is provided, deferred.promise() will attach the methods onto it and then return this object rather than create a new one. This can be useful to attach the Promise behavior to an object that already exists.
            
     
            If you are creating a Deferred, keep a reference to the Deferred so that it can be resolved or rejected at some point. Return only the Promise object via deferred.promise() so other code can register callbacks or inspect the current state.
            
     
            For more information, see the documentation for Deferred object.
            
diff --git a/pages/Types.html b/pages/Types.html
index 5cd81ca6..18e0ee5b 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -638,7 +638,7 @@ 
             Deferred Object
            
 
            As of jQuery 1.5, the Deferred object provides a way to register multiple callbacks into self-managed callback queues, invoke callback queues as appropriate, and relay the success or failure state of any synchronous or asynchronous function.
 
            
 
             Promise Object
            
-
            This object provides a subset of the methods of the Deferred object (then, done, fail, always, pipe, progress, and state) to prevent users from changing the state of the Deferred.
+
            This object provides a subset of the methods of the Deferred object (then, done, fail, always, pipe, progress, state and promise) to prevent users from changing the state of the Deferred.
 
            
 
            Callbacks Object
            
 
            A multi-purpose object that provides a powerful way to manage callback lists. It supports adding, removing, firing, and disabling callbacks. The Callbacks object is created and returned by the $.Callbacks function and subsequently returned by most of that function's methods. 
            

From 3a277ccdd8f767fffe85a698867abe3223134780 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Tue, 9 Jun 2015 06:52:34 +0200
Subject: [PATCH 318/699] 1.11.103

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index c850d7e1..b788fab7 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.102",
+  "version": "1.11.103",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From f389f0e279fc05bbcb3d7c9979a4a6cb16bb73fd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Tue, 9 Jun 2015 22:36:49 -0400
Subject: [PATCH 319/699] Build: Run `grunt lint` on Travis

Fixes jquery/api.jquery.com#749
---
 .travis.yml  | 5 +++++
 Gruntfile.js | 7 ++++++-
 package.json | 3 +++
 3 files changed, 14 insertions(+), 1 deletion(-)
 create mode 100644 .travis.yml

diff --git a/.travis.yml b/.travis.yml
new file mode 100644
index 00000000..86929762
--- /dev/null
+++ b/.travis.yml
@@ -0,0 +1,5 @@
+language: node_js
+node_js:
+  - "0.12"
+before_script:
+  - npm install -g grunt-cli
diff --git a/Gruntfile.js b/Gruntfile.js
index cc71e7be..05990732 100644
--- a/Gruntfile.js
+++ b/Gruntfile.js
@@ -22,7 +22,12 @@ grunt.initConfig({
 		all: "resources/**"
 	},
 	wordpress: (function() {
-		var config = require( "./config" );
+
+		// There's no config for CI, but we don't need one for basic testing
+		var config = {};
+		try {
+			config = require( "./config" );
+		} catch ( error ) {}
 		config.dir = "dist/wordpress";
 		return config;
 	})()
diff --git a/package.json b/package.json
index b788fab7..c1eda129 100644
--- a/package.json
+++ b/package.json
@@ -20,6 +20,9 @@
       "url": "https://github.com/jquery/api.jquery.com/blob/master/LICENSE.txt"
     }
   ],
+  "scripts": {
+    "test": "grunt lint"
+  },
   "dependencies": {
     "grunt": "0.4.5",
     "grunt-jquery-content": "2.0.0"

From bb24ed6b6f4e3d1983296cdd1960ce87cfad7cf2 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 21 Jun 2015 18:47:17 +0100
Subject: [PATCH 320/699] focusout: Added missing signature

Closes gh-761
---
 entries/focusout.xml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/entries/focusout.xml b/entries/focusout.xml
index 1029a9e5..6b633c89 100644
--- a/entries/focusout.xml
+++ b/entries/focusout.xml
@@ -19,6 +19,9 @@
       
     
   
+  
+    1.0
+  
   
     
            This method is a shortcut for .on( "focusout", handler ) when passed arguments, and .trigger( "focusout" ) when no arguments are passed.
            
     
            The focusout event is sent to an element when it, or any element inside of it, loses focus. This is distinct from the blur event in that it supports detecting the loss of focus on descendant elements (in other words, it supports event bubbling).
            

From 1f816046f94cceed3c2aaf7f6749b8b01af56489 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 21 Jun 2015 18:46:35 +0100
Subject: [PATCH 321/699] focusin: Added missing signature

Closes gh-760
---
 entries/focusin.xml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/entries/focusin.xml b/entries/focusin.xml
index 13c62fa5..aaff429d 100644
--- a/entries/focusin.xml
+++ b/entries/focusin.xml
@@ -19,8 +19,11 @@
       
     
   
+  
+    1.0
+  
   
-    
            This method is a shortcut for .on('focusin', handler).
            
+    
            This method is a shortcut for .on( "focusin", handler ) in the first two variations, and .trigger( "focusin" ) in the third.
            
     
            The focusin event is sent to an element when it, or any element inside of it, gains focus. This is distinct from the focus event in that it supports detecting the focus event on parent elements (in other words, it supports event bubbling).
            
     
            This event will likely be used together with the focusout event.
            
               

From 6b02de00cb399d3bad6f0035224227e09eaf38e9 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 29 Jun 2015 18:36:33 +0100
Subject: [PATCH 322/699] 1.11.104

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index c1eda129..82e98ffd 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.103",
+  "version": "1.11.104",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From b337509696d5af5185cb69f1882cbd070133fa0e Mon Sep 17 00:00:00 2001
From: Eric Lee Carraway 
Date: Fri, 3 Jul 2015 11:41:47 -0500
Subject: [PATCH 323/699] README: fix two typos

possesive => possessive
Authoritive => Authoritative

Closes gh-768
---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index f720120c..0ded6592 100644
--- a/README.md
+++ b/README.md
@@ -32,7 +32,7 @@ The `xmllint` and `xsltproc` utilities need to be in your path. If you are on Wi
 #### Pronoun Usage
 
 * Use second-person pronoun ("you") when necessary, but try to avoid it.
-* Favor the definite article ("the") over second-person possesive ("your").
+* Favor the definite article ("the") over second-person possessive ("your").
   * **Yes**: Insert the paragraph after the unordered list.
   * **No**: Insert your paragraph after the unordered list.
 * When editing current entries, change first-person plural pronouns ("we," "our," "us") to second-person.
@@ -83,5 +83,5 @@ Code in the API documentation should follow the [jQuery Core Style Guide](http:/
   * Strong in English writing
 * Tone
   * Middle ground between formal and familiar. Err on the side of formality.
-  * Authoritive
+  * Authoritative
   * Tactful

From 14b0978b44062c443e879f31fe1dfa146453e631 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Fri, 3 Jul 2015 18:52:18 +0200
Subject: [PATCH 324/699] 1.11.105

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 82e98ffd..0876a658 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.104",
+  "version": "1.11.105",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From cd61b061ce6509930e4842eca21b1b4c409ec627 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Tue, 7 Jul 2015 12:22:44 +0200
Subject: [PATCH 325/699] Event.which: fix a typo

Fixes jquery/jquery.com#105
Closes gh-769
---
 entries/event.which.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/event.which.xml b/entries/event.which.xml
index efa9cddf..1d36d527 100644
--- a/entries/event.which.xml
+++ b/entries/event.which.xml
@@ -6,7 +6,7 @@
   
   For key or mouse events, this property indicates the specific key or button that was pressed.
   
-    
            The event.which property normalizes event.keyCode and event.charCode. It is recommended to watch event.which for keyboard key input. For more detail, read about event.charCode on the MDC. 
            
+    
            The event.which property normalizes event.keyCode and event.charCode. It is recommended to watch event.which for keyboard key input. For more detail, read about event.charCode on the MDN. 
            
     
            event.which also normalizes button presses (mousedown and mouseupevents), reporting 1 for left button, 2 for middle, and 3 for right. Use event.which instead of event.button.  
            
               
   

From a4e5e98b129923067bb1c0d8d659423acca89398 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Wed, 8 Jul 2015 13:37:44 +0200
Subject: [PATCH 326/699] 1.11.106

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 0876a658..b9290c76 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.105",
+  "version": "1.11.106",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 37fe85787de8def42f220419f9cc27c8fc7d49f4 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 24 May 2015 00:08:32 +0100
Subject: [PATCH 327/699] val: Updated description for the setter version

Fixes #712
Closes gh-744
---
 entries/val.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/val.xml b/entries/val.xml
index 184abdad..52f2023f 100644
--- a/entries/val.xml
+++ b/entries/val.xml
@@ -123,7 +123,7 @@ $( "input" )
     Set the value of each element in the set of matched elements.
     
       
            This method is typically used to set the values of form fields. 
            
-      
            Passing an array of element values allows matching  <input type="checkbox">, <input type="radio"> and <option>s inside of n <select multiple="multiple"> to be selected. In the case of <input type="radio">s that are part of a radio group and <select multiple="multiple"> the other elements will be deselected.
            
+      
            val() allows you to pass an array of element values. This is useful when working on a jQuery object containing elements like <input type="checkbox">, <input type="radio">, and <option>s inside of a <select>. In this case, the inputs and the options having a value that matches one of the elements of the array will be checked or selected while those having a value that don't match one of the elements of the array will be unchecked or unselected, depending on the type. In case of <input type="radio">s that are part of a radio group and <select>s, any previously selected element will be deselected.
            
       
            The .val() method allows us to set the value by passing in a function. As of jQuery 1.4, the function is passed two arguments, the current element's index and its current value: 
            
       
            
 $( "input:text.items" ).val(function( index, value ) {

From bd14b435882735362b117690683cda631a634f65 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sat, 28 Feb 2015 15:28:10 +0000
Subject: [PATCH 328/699] README: Added note for the build process

Added a note to troubleshoot a possible issue when running the build
process on Windows.

Closes gh-669
---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index 0ded6592..805e0442 100644
--- a/README.md
+++ b/README.md
@@ -11,6 +11,8 @@ To build and deploy your changes for previewing in a [`jquery-wp-content`](https
 
 The `xmllint` and `xsltproc` utilities need to be in your path. If you are on Windows, you can get libxml2 and libxslt from zlatkovic.com.
 
+**Note**: If you're using Windows and you receive the error "Error" when executing the task `build-xml-entries:all`, try to add the DLL `libwinpthread-1.dll` in the root of the project.
+
 ## Style Guidelines
 
 ### Prose Style & Grammar

From 039224281affcc9d64d2475b98ac413cf5aa0217 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 20 Jul 2015 00:53:24 +0100
Subject: [PATCH 329/699] 1.11.107

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index b9290c76..e572fd50 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.106",
+  "version": "1.11.107",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 96dd835e4d2d0d67b27116223d015afbc8ebea32 Mon Sep 17 00:00:00 2001
From: Annika Backstrom 
Date: Fri, 24 Jul 2015 11:50:57 -0400
Subject: [PATCH 330/699] jQuery.Callbacks: fix a typo

Closes gh-783
---
 entries/jQuery.Callbacks.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.Callbacks.xml b/entries/jQuery.Callbacks.xml
index 8443476b..c31de063 100644
--- a/entries/jQuery.Callbacks.xml
+++ b/entries/jQuery.Callbacks.xml
@@ -38,7 +38,7 @@ callbacks.fire( "bar!" );
     
            
     
            The result of this is that it becomes simple to construct complex lists of callbacks where input values can be passed through to as many functions as needed with ease.
            
     
            Two specific methods were being used above: .add() and .fire(). The .add() method supports adding new callbacks to the callback list, while the .fire() method executes the added functions and provides a way to pass arguments to be processed by the callbacks in the same list.
            
-    
            Another method supported by $.Callbacks is .remove(), which has the ability to remove a particular callback from the callback list. Here"s a practical example of .remove() being used:
            
+    
            Another method supported by $.Callbacks is .remove(), which has the ability to remove a particular callback from the callback list. Here's a practical example of .remove() being used:
            
     
            
 var callbacks = $.Callbacks();
 callbacks.add( fn1 );

From 5e0f6fa2d650ee8f88cf666064fa7dd519adcb04 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Fri, 24 Jul 2015 17:56:58 +0200
Subject: [PATCH 331/699] 1.11.108

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index e572fd50..656ec6e2 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.107",
+  "version": "1.11.108",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 00c2ddc345c81d44b244f50e94381e3fcad22b9c Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 20 Jul 2015 01:06:12 +0100
Subject: [PATCH 332/699] deferred.always: Added note for parameters changing
 order

Fixes gh-763
Closes gh-779
---
 entries/deferred.always.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/entries/deferred.always.xml b/entries/deferred.always.xml
index 57b3cf7f..30e92193 100644
--- a/entries/deferred.always.xml
+++ b/entries/deferred.always.xml
@@ -17,6 +17,7 @@
    Add handlers to be called when the Deferred object is either resolved or rejected. 
   
     
            The argument can be either a single function or an array of functions. When the Deferred is resolved or rejected, the alwaysCallbacks are called. Since deferred.always() returns the Deferred object, other methods of the Deferred object can be chained to this one, including additional .always() methods. When the Deferred is resolved or rejected, callbacks are executed in the order they were added, using the arguments provided to the resolve, reject, resolveWith or rejectWith method calls. For more information, see the documentation for Deferred object.
            
+    
            Note: The deferred.always() method receives the arguments that were used to .resolve() or .reject() the Deferred object, which are often very different. For this reason, it's best to use it only for actions that do not require inspecting the arguments. In all other cases, use explicit .done() or .fail() handlers since the arguments will have well-known orders.
            
               
   
     Since the jQuery.get() method returns a jqXHR object, which is derived from a Deferred object, we can attach a callback for both success and error using the deferred.always() method.

From 30eb320cc1007335e05e446738769449cfcca605 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 27 Jul 2015 22:07:12 +0100
Subject: [PATCH 333/699] 1.11.109

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 656ec6e2..b1480c49 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.108",
+  "version": "1.11.109",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 7021a1202ef6cb5bc02838bb2bbbcd87e1e599d4 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 23 Jul 2015 23:06:37 +0200
Subject: [PATCH 334/699] Build: move redirects from the infrastucture repo

Closes gh-782
---
 package.json   | 2 +-
 redirects.json | 3 +++
 2 files changed, 4 insertions(+), 1 deletion(-)
 create mode 100644 redirects.json

diff --git a/package.json b/package.json
index b1480c49..83004b42 100644
--- a/package.json
+++ b/package.json
@@ -25,6 +25,6 @@
   },
   "dependencies": {
     "grunt": "0.4.5",
-    "grunt-jquery-content": "2.0.0"
+    "grunt-jquery-content": "2.3.0"
   }
 }
diff --git a/redirects.json b/redirects.json
new file mode 100644
index 00000000..2aa9b056
--- /dev/null
+++ b/redirects.json
@@ -0,0 +1,3 @@
+{
+	"/api/": "/resources/api.xml"
+}

From a32c847d29a6458331246aa259f055206b2a095f Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 30 Jul 2015 22:47:49 +0200
Subject: [PATCH 335/699] 1.11.110

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 83004b42..7a8d53d4 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.109",
+  "version": "1.11.110",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 07b3ad769f45c0206981c51f7b2a7f8a1d54b146 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 16 Aug 2015 23:33:26 +0100
Subject: [PATCH 336/699] Added note for Global Ajax Event Handlers

Fixes gh-479
Closes gh-797
---
 entries/ajaxComplete.xml | 1 +
 entries/ajaxError.xml    | 1 +
 entries/ajaxSend.xml     | 1 +
 entries/ajaxStart.xml    | 1 +
 entries/ajaxStop.xml     | 1 +
 entries/ajaxSuccess.xml  | 1 +
 notes.xsl                | 3 +++
 7 files changed, 9 insertions(+)

diff --git a/entries/ajaxComplete.xml b/entries/ajaxComplete.xml
index 7f045973..7481f97b 100644
--- a/entries/ajaxComplete.xml
+++ b/entries/ajaxComplete.xml
@@ -44,6 +44,7 @@ $( document ).ajaxComplete(function( event, xhr, settings ) {
     
            
     
            Note: You can get the returned ajax contents by looking at xhr.responseText.
            
               
+  
   
   
     Show a message when an Ajax request completes.
diff --git a/entries/ajaxError.xml b/entries/ajaxError.xml
index d13f71e6..f674df42 100644
--- a/entries/ajaxError.xml
+++ b/entries/ajaxError.xml
@@ -42,6 +42,7 @@ $( document ).ajaxError(function( event, jqxhr, settings, thrownError ) {
   }
 });
            
   
+  
   
   
     Show a message when an Ajax request fails.
diff --git a/entries/ajaxSend.xml b/entries/ajaxSend.xml
index 2d609b71..0678622c 100644
--- a/entries/ajaxSend.xml
+++ b/entries/ajaxSend.xml
@@ -42,6 +42,7 @@ $( document ).ajaxSend(function( event, jqxhr, settings ) {
 });
     
            
   
+  
   
   
     Show a message before an Ajax request is sent.
diff --git a/entries/ajaxStart.xml b/entries/ajaxStart.xml
index 7747e5b6..92e6cc70 100644
--- a/entries/ajaxStart.xml
+++ b/entries/ajaxStart.xml
@@ -31,6 +31,7 @@ $( ".trigger" ).click(function() {
     
            When the user clicks the element with class trigger and the Ajax request is sent, the log message is displayed.
            
     
            As of jQuery 1.8, the .ajaxStart() method should only be attached to document.
            
   
+  
   
   
     Show a loading message whenever an Ajax request starts (and none is already active).
diff --git a/entries/ajaxStop.xml b/entries/ajaxStop.xml
index 76b3bffc..fc0781f6 100644
--- a/entries/ajaxStop.xml
+++ b/entries/ajaxStop.xml
@@ -31,6 +31,7 @@ $( ".trigger" ).click(function() {
     
            When the user clicks the element with class trigger and the Ajax request completes, the log message is displayed.
            
     
            As of jQuery 1.8, the .ajaxStop() method should only be attached to document.
            
   
+  
   
   
     Hide a loading message after all the Ajax requests have stopped.
diff --git a/entries/ajaxSuccess.xml b/entries/ajaxSuccess.xml
index 26583e2e..8972b24d 100644
--- a/entries/ajaxSuccess.xml
+++ b/entries/ajaxSuccess.xml
@@ -45,6 +45,7 @@ $( document ).ajaxSuccess(function( event, xhr, settings ) {
     
     
            Note: You can get the returned ajax contents by looking at xhr.responseXML or xhr.responseText for xml and html respectively.
            
   
+  
   
   
     Show a message when an Ajax request completes successfully.
diff --git a/notes.xsl b/notes.xsl
index 33a2c073..eb5a9c61 100644
--- a/notes.xsl
+++ b/notes.xsl
@@ -67,6 +67,9 @@
 		
 			As the .() method is just a shorthand for .on( "", handler ), detaching is possible using .off( "" ).
 		
+		
+			As of jQuery 1.9, all the handlers for the jQuery global Ajax events, including those added with the  method, must be attached to document.
+		
 	
 
 

From 2902fc21eebd928065e34e0292d4d034ba2b247b Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Thu, 20 Aug 2015 23:34:29 +0100
Subject: [PATCH 337/699] 1.11.111

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 7a8d53d4..dc74663e 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.110",
+  "version": "1.11.111",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From b6116995a775e0666d40adf4b121aa85ba72d754 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 21 Sep 2015 20:48:26 +0100
Subject: [PATCH 338/699] Fixed many typos of the name Ajax

Closes gh-810
---
 entries/ajaxComplete.xml         | 2 +-
 entries/ajaxSuccess.xml          | 4 ++--
 entries/jQuery.Callbacks.xml     | 2 +-
 entries/jQuery.ajaxPrefilter.xml | 2 +-
 entries/jQuery.ajaxTransport.xml | 4 ++--
 entries/jQuery.get.xml           | 2 +-
 entries/jQuery.getJSON.xml       | 2 +-
 entries/jQuery.post.xml          | 4 ++--
 entries/jQuery.when.xml          | 4 ++--
 9 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/entries/ajaxComplete.xml b/entries/ajaxComplete.xml
index 7481f97b..2c26aea3 100644
--- a/entries/ajaxComplete.xml
+++ b/entries/ajaxComplete.xml
@@ -42,7 +42,7 @@ $( document ).ajaxComplete(function( event, xhr, settings ) {
   }
 });
     
-    
            Note: You can get the returned ajax contents by looking at xhr.responseText.
            
+    
            Note: You can get the returned Ajax contents by looking at xhr.responseText.
            
   
   
   
diff --git a/entries/ajaxSuccess.xml b/entries/ajaxSuccess.xml
index 8972b24d..40dabc01 100644
--- a/entries/ajaxSuccess.xml
+++ b/entries/ajaxSuccess.xml
@@ -38,12 +38,12 @@ $( ".trigger" ).on( "click", function() {
     
            
 $( document ).ajaxSuccess(function( event, xhr, settings ) {
   if ( settings.url == "ajax/test.html" ) {
-    $( ".log" ).text( "Triggered ajaxSuccess handler. The ajax response was: " +
+    $( ".log" ).text( "Triggered ajaxSuccess handler. The Ajax response was: " +
       xhr.responseText );
   }
 });
     
            
-    
            Note: You can get the returned ajax contents by looking at xhr.responseXML or xhr.responseText for xml and html respectively.
            
+    
            Note: You can get the returned Ajax contents by looking at xhr.responseXML or xhr.responseText for xml and html respectively.
            
   
   
   
diff --git a/entries/jQuery.Callbacks.xml b/entries/jQuery.Callbacks.xml
index c31de063..251bc111 100644
--- a/entries/jQuery.Callbacks.xml
+++ b/entries/jQuery.Callbacks.xml
@@ -259,7 +259,7 @@ dfd.done( topic.publish );
 // Here the Deferred is being resolved with a message
 // that will be passed back to subscribers. It's possible to
 // easily integrate this into a more complex routine
-// (eg. waiting on an ajax call to complete) so that
+// (eg. waiting on an Ajax call to complete) so that
 // messages are only published once the task has actually
 // finished.
 dfd.resolve( "it's been published!" );
diff --git a/entries/jQuery.ajaxPrefilter.xml b/entries/jQuery.ajaxPrefilter.xml
index eb762dfb..f82d8d02 100644
--- a/entries/jQuery.ajaxPrefilter.xml
+++ b/entries/jQuery.ajaxPrefilter.xml
@@ -24,7 +24,7 @@ $.ajaxPrefilter(function( options, originalOptions, jqXHR ) {
     
            where:
            
     
              
       
            • options are the request options
              • 
-      
            • originalOptions are the options as provided to the ajax method, unmodified and, thus, without defaults from ajaxSettings
              • 
+      
            • originalOptions are the options as provided to the $.ajax() method, unmodified and, thus, without defaults from ajaxSettings
              • 
       
            • jqXHR is the jqXHR object of the request
              • 
     
            
     
            Prefilters are a perfect fit when custom options need to be handled.  Given the following code, for example, a call to $.ajax() would automatically abort a request to the same URL if the custom abortOnRetry option is set to true:
            
diff --git a/entries/jQuery.ajaxTransport.xml b/entries/jQuery.ajaxTransport.xml
index ab8e4d9b..93bcbf77 100644
--- a/entries/jQuery.ajaxTransport.xml
+++ b/entries/jQuery.ajaxTransport.xml
@@ -35,10 +35,10 @@ $.ajaxTransport( dataType, function( options, originalOptions, jqXHR ) {
     
            where:
            
     
              
       
            • options are the request options
              • 
-      
            • originalOptions are the options as provided to the ajax method, unmodified and, thus, without defaults from ajaxSettings
              • 
+      
            • originalOptions are the options as provided to the $.ajax() method, unmodified and, thus, without defaults from ajaxSettings
              • 
       
            • jqXHR is the jqXHR object of the request
              • 
       
            • headers is an object of (key-value) request headers that the transport can transmit if it supports it
              • 
-      
            • completeCallback is the callback used to notify ajax of the completion of the request
              • 
+      
            • completeCallback is the callback used to notify Ajax of the completion of the request
              • 
     
            
     
            completeCallback has the following signature:
            
     
            
diff --git a/entries/jQuery.get.xml b/entries/jQuery.get.xml
index 51b50c64..c3f18cac 100644
--- a/entries/jQuery.get.xml
+++ b/entries/jQuery.get.xml
@@ -49,7 +49,7 @@ $.get( "ajax/test.html", function( data ) {
     
            
     
            This example fetches the requested HTML snippet and inserts it on the page.
            
     
            The jqXHR Object
            
-    
            As of jQuery 1.5, all of jQuery's Ajax methods return  a superset of the XMLHTTPRequest object. This jQuery XHR object, or "jqXHR," returned by $.get() implements the Promise interface, giving it all the properties, methods, and behavior of a Promise (see Deferred object for more information). The jqXHR.done() (for success), jqXHR.fail() (for error), and jqXHR.always() (for completion, whether success or error) methods take a function argument that is called when the request terminates. For information about the arguments this function receives, see the jqXHR Object section of the $.ajax() documentation.
            
+    
            As of jQuery 1.5, all of jQuery's Ajax methods return  a superset of the XMLHTTPRequest object. This jQuery XHR object, or "jqXHR," returned by $.get() implements the Promise interface, giving it all the properties, methods, and behavior of a Promise (see Deferred object for more information). The jqXHR.done() (for success), jqXHR.fail() (for error), and jqXHR.always() (for completion, whether success or error) methods take a function argument that is called when the request terminates. For information about the arguments this function receives, see the jqXHR Object section of the $.ajax() documentation.
            
     
            The Promise interface also allows jQuery's Ajax methods, including $.get(), to chain multiple .done(), .fail(), and .always() callbacks on a single request, and even to assign these callbacks after the request may have completed. If the request is already complete, the callback is fired immediately.
            
     
            
 // Assign handlers immediately after making the request,
diff --git a/entries/jQuery.getJSON.xml b/entries/jQuery.getJSON.xml
index 97c8b0a9..23ad5c2d 100644
--- a/entries/jQuery.getJSON.xml
+++ b/entries/jQuery.getJSON.xml
@@ -61,7 +61,7 @@ $.getJSON( "ajax/test.json", function( data ) {
     
            JSONP
            
     
            If the URL includes the string "callback=?" (or similar, as defined by the server-side API), the request is treated as JSONP instead. See the discussion of the jsonp data type in $.ajax() for more details.
            
     
            The jqXHR Object
            
-    
            As of jQuery 1.5, all of jQuery's Ajax methods return  a superset of the XMLHTTPRequest object. This jQuery XHR object, or "jqXHR," returned by $.getJSON() implements the Promise interface, giving it all the properties, methods, and behavior of a Promise (see Deferred object for more information). The jqXHR.done() (for success), jqXHR.fail() (for error), and jqXHR.always() (for completion, whether success or error) methods take a function argument that is called when the request terminates. For information about the arguments this function receives, see the jqXHR Object section of the $.ajax() documentation.
            
+    
            As of jQuery 1.5, all of jQuery's Ajax methods return  a superset of the XMLHTTPRequest object. This jQuery XHR object, or "jqXHR," returned by $.getJSON() implements the Promise interface, giving it all the properties, methods, and behavior of a Promise (see Deferred object for more information). The jqXHR.done() (for success), jqXHR.fail() (for error), and jqXHR.always() (for completion, whether success or error) methods take a function argument that is called when the request terminates. For information about the arguments this function receives, see the jqXHR Object section of the $.ajax() documentation.
            
     
            The Promise interface in jQuery 1.5 also allows jQuery's Ajax methods, including $.getJSON(), to chain multiple .done(), .always(), and .fail() callbacks on a single request, and even to assign these callbacks after the request may have completed. If the request is already complete, the callback is fired immediately.
            
     
            
 // Assign handlers immediately after making the request,
diff --git a/entries/jQuery.post.xml b/entries/jQuery.post.xml
index 8a1bdc43..982b28c7 100644
--- a/entries/jQuery.post.xml
+++ b/entries/jQuery.post.xml
@@ -100,7 +100,7 @@ $.post( "test.php", { 'choices[]': [ "Jon", "Susan" ] } );
 ]]>
   
   
-    Send form data using ajax requests
+    Send form data using Ajax requests
     
@@ -132,7 +132,7 @@ $.post( "test.php", { func: "getNameAndTime" }, function( data ) {
 ]]>
   
   
-    Post a form using ajax and put results in a div
+    Post a form using Ajax and put results in a div
     
            
-    
            In the multiple-Deferreds case where one of the Deferreds is rejected, jQuery.when() immediately fires the failCallbacks for its master Deferred. Note that some of the Deferreds may still be unresolved at that point. The arguments passed to the failCallbacks match the signature of the failCallback for the Deferred that was rejected. If you need to perform additional processing for this case, such as canceling any unfinished ajax requests, you can keep references to the underlying jqXHR objects in a closure and inspect/cancel them in the failCallback.
            
+    
            In the multiple-Deferreds case where one of the Deferreds is rejected, jQuery.when() immediately fires the failCallbacks for its master Deferred. Note that some of the Deferreds may still be unresolved at that point. The arguments passed to the failCallbacks match the signature of the failCallback for the Deferred that was rejected. If you need to perform additional processing for this case, such as canceling any unfinished Ajax requests, you can keep references to the underlying jqXHR objects in a closure and inspect/cancel them in the failCallback.
            
   
   
-    Execute a function after two ajax requests are successful. (See the jQuery.ajax() documentation for a complete description of success and error cases for an ajax request).
+    Execute a function after two Ajax requests are successful. (See the jQuery.ajax() documentation for a complete description of success and error cases for an ajax request).
     
Date: Mon, 21 Sep 2015 01:49:40 +0100
Subject: [PATCH 339/699] Dblclick: Fixed a code style issue

Closes gh-809
---
 entries/dblclick.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/dblclick.xml b/entries/dblclick.xml
index f91e85da..6287b4cb 100644
--- a/entries/dblclick.xml
+++ b/entries/dblclick.xml
@@ -23,7 +23,7 @@
     1.0
   
   
-    
            This method is a shortcut for .on( "dblclick", handler) in the first two variations, and .trigger( "dblclick" ) in the third.
+    
            This method is a shortcut for .on( "dblclick", handler ) in the first two variations, and .trigger( "dblclick" ) in the third.
     The dblclick event is sent to an element when the element is double-clicked. Any HTML element can receive this event.
     For example, consider the HTML:
            
     
            

From 51383334dcb3b53107ceea3cc5674bc72eee718e Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 21 Sep 2015 01:48:21 +0100
Subject: [PATCH 340/699] Dblclick: Minor improvements to wording

Closes gh-808
---
 entries/dblclick.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/dblclick.xml b/entries/dblclick.xml
index 6287b4cb..df7a5ae4 100644
--- a/entries/dblclick.xml
+++ b/entries/dblclick.xml
@@ -47,7 +47,7 @@ $( "#target" ).dblclick(function() {
     
            
       Handler for .dblclick() called.
     
            
-    
            To trigger the event manually, apply .dblclick() without an argument:
            
+    
            To trigger the event manually, call .dblclick() without an argument:
            
     
            
 $( "#other" ).click(function() {
   $( "#target" ).dblclick();
@@ -66,7 +66,7 @@ $( "#other" ).click(function() {
   
   
   
-    To bind a "Hello World!" alert box the dblclick event on every paragraph on the page:
+    To bind a "Hello World!" alert box to the dblclick event on every paragraph on the page:
     
Date: Wed, 9 Sep 2015 12:32:34 -0400
Subject: [PATCH 341/699] Effects: Clarify that callbacks are per-element

Fixes gh-803
Closes gh-804
---
 entries/animate.xml            |  4 ++--
 includes/complete-argument.xml |  2 +-
 includes/options-argument.xml  | 10 +++++-----
 3 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/entries/animate.xml b/entries/animate.xml
index 2cbec644..11477c2a 100644
--- a/entries/animate.xml
+++ b/entries/animate.xml
@@ -32,8 +32,8 @@
     
     
            Duration
            
     
            Durations are given in milliseconds; higher values indicate slower animations, not faster ones. The default duration is 400 milliseconds. The strings 'fast' and 'slow' can be supplied to indicate durations of 200 and 600 milliseconds, respectively.
            
-    
            Complete Function
            
-    
            If supplied, the complete callback function is fired once the animation is complete. This can be useful for stringing different animations together in sequence. The callback is not sent any arguments, but this is set to the DOM element being animated. If multiple elements are animated, the callback is executed once per matched element, not once for the animation as a whole.
            
+    
            Callback Functions
            
+    
            If supplied, the start, step, progress, complete, done, fail, and always callbacks are called on a per-element basis; this is set to the DOM element being animated. If no elements are in the set, no callbacks are called. If multiple elements are animated, the callback is executed once per matched element, not once for the animation as a whole. Use the .promise() method to obtain a promise to which you can attach callbacks that fire once for an animated set of any size, including zero elements.
            
     
            Basic Usage
            
     
            To animate any element, such as a simple image:
            
     
            
diff --git a/includes/complete-argument.xml b/includes/complete-argument.xml
index 042fdf45..5d109f39 100644
--- a/includes/complete-argument.xml
+++ b/includes/complete-argument.xml
@@ -1,4 +1,4 @@
 
 
-	A function to call once the animation is complete.
+	A function to call once the animation is complete, called once per matched element.
 
diff --git a/includes/options-argument.xml b/includes/options-argument.xml
index f62a8585..168e8648 100644
--- a/includes/options-argument.xml
+++ b/includes/options-argument.xml
@@ -41,17 +41,17 @@
 		
 	
 	
-		A function to call once the animation is complete.
+		A function that is called once the animation on an element is complete.
 		
 	
 	
-		A function to call when the animation begins.
+		A function to call when the animation on an element begins.
 		
 			An enhanced Promise object with additional properties for the animation
 		
 	
 	
-		A function to be called when the animation completes (its Promise object is resolved).
+		A function to be called when the animation on an element completes (its Promise object is resolved).
 		
 			An enhanced Promise object with additional properties for the animation
 		
@@ -60,7 +60,7 @@
 		
 	
 	
-		A function to be called when the animation fails to complete (its Promise object is rejected).
+		A function to be called when the animation on an element fails to complete (its Promise object is rejected).
 		
 			An enhanced Promise object with additional properties for the animation
 		
@@ -69,7 +69,7 @@
 		
 	
 	
-		A function to be called when the animation completes or stops without completing (its Promise object is either resolved or rejected).
+		A function to be called when the animation on an element completes or stops without completing (its Promise object is either resolved or rejected).
 		
 			An enhanced Promise object with additional properties for the animation
 		

From be7c028a49986e94cec51481b06fcac1a23191bb Mon Sep 17 00:00:00 2001
From: Andy Li 
Date: Mon, 7 Sep 2015 17:29:27 +0800
Subject: [PATCH 342/699] Events: Completed the list of copied properties

Closes gh-802
---
 categories.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/categories.xml b/categories.xml
index d4941b0e..d43d8929 100644
--- a/categories.xml
+++ b/categories.xml
@@ -143,7 +143,7 @@ jQuery( "body" ).trigger( e );
             
            • 
           
          
           
          The following properties are also copied to the event object, though some of their values may be undefined depending on the event:
          
-          
          altKey, bubbles, button, cancelable, charCode, clientX, clientY, ctrlKey, currentTarget, data, detail, eventPhase, metaKey, offsetX, offsetY, originalTarget, pageX, pageY, relatedTarget, screenX, screenY, shiftKey, target, view, which
          
+          
          altKey, bubbles, button, buttons, cancelable, char, charCode, clientX, clientY, ctrlKey, currentTarget, data, detail, eventPhase, key, keyCode, metaKey, offsetX, offsetY, originalTarget, pageX, pageY, relatedTarget, screenX, screenY, shiftKey, target, toElement, view, which
          
           
          OtherProperties
          
           
          Certain events may have properties specific to them. Those can be accessed as properties of the event.originalEvent object.
          
           
          Example:
          

From 4746900942a4ccc7bd2463c1913aedc18bc03905 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 21 Sep 2015 23:36:00 +0100
Subject: [PATCH 343/699] 1.11.112

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index dc74663e..ca35e147 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.111",
+  "version": "1.11.112",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From ea616380521f9e47a222a1179218308a26068f21 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Thu, 22 Jan 2015 06:39:04 +0000
Subject: [PATCH 344/699] Error: Improved image example

Fixes gh-413
Closes gh-630
---
 entries/error.xml | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/entries/error.xml b/entries/error.xml
index 2b3ba94c..0fcb1810 100644
--- a/entries/error.xml
+++ b/entries/error.xml
@@ -34,22 +34,23 @@ $( "#book" )
   })
   .attr( "src", "missing.png" );
               
-    
          If the image cannot be loaded (for example, because it is not present at the supplied URL), the alert  is displayed:
          
+    
          If the image cannot be loaded (for example, because it is not present at the supplied URL), the alert is displayed:
          
     
          
       Handler for .error() called.
     
          
     
          
-      
          The event handler must be attached before the browser fires the error event, which is why the example sets the src attribute after attaching the handler. Also, the error event may not be correctly fired when the page is served locally; error relies on HTTP status codes and will generally not be triggered if the URL uses the file: protocol.
          
+      
          The event handler must be attached before the browser fires the error event, which is why the example sets the src attribute after attaching the handler. Also, the error event may not be correctly fired when the page is served locally; error relies on HTTP status codes and will generally not be triggered if the URL uses the file: protocol.
          
     
          
-    
          Note: A jQuery error event handler should not be attached to the window object. The browser fires the window's error event when a script error occurs. However, the window error event receives different arguments and has different return value requirements than conventional event handlers. Use window.onerror instead.
          
+    
          Note: A jQuery error event handler should not be attached to the window object. The browser fires the window's error event when a script error occurs. However, the window error event receives different arguments and has different return value requirements than conventional event handlers. Use window.onerror instead.
          
   
   
   
-    To hide the "broken image" icons for IE users, you can try:
+    To replace all the missing images with another, you can update the src attribute inside the callback passed to .error(). Be sure that the replacement image exists; otherwise the error event will be triggered indefinitely.
     

From e25e39538f0dfa6cd46e33255fb99252254d176b Mon Sep 17 00:00:00 2001
From: Dmitry Gorelenkov 
Date: Fri, 28 Aug 2015 19:34:30 +0200
Subject: [PATCH 345/699] jQuery.grep: Argument can be an Array-like object

Closes gh-801
---
 entries/jQuery.grep.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/jQuery.grep.xml b/entries/jQuery.grep.xml
index 245a672d..5195ffdd 100644
--- a/entries/jQuery.grep.xml
+++ b/entries/jQuery.grep.xml
@@ -4,8 +4,8 @@
   Finds the elements of an array which satisfy a filter function. The original array is not affected.
   
     1.0
-    
-      The array to search through.
+    
+      The array-like object to search through.
     
     
       

From f7e567fac4cbfbce6764f106df29203c65105c1a Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 19 Oct 2015 00:32:12 +0100
Subject: [PATCH 346/699] isNumeric: argument can be anything

Closes gh-818
---
 entries/jQuery.isNumeric.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.isNumeric.xml b/entries/jQuery.isNumeric.xml
index 80edc02d..c6ec81e8 100644
--- a/entries/jQuery.isNumeric.xml
+++ b/entries/jQuery.isNumeric.xml
@@ -4,7 +4,7 @@
   Determines whether its argument is a number.
   
     1.7
-    
+    
       The value to be tested.
     
   

From da5ec3328c7d9929df5ab488dfe4a504eb75d696 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 21 Sep 2015 01:44:34 +0100
Subject: [PATCH 347/699] Added page about the contextmenu() alias

Fixes gh-806
Closes gh-807
---
 entries/contextmenu.xml | 86 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 86 insertions(+)
 create mode 100644 entries/contextmenu.xml

diff --git a/entries/contextmenu.xml b/entries/contextmenu.xml
new file mode 100644
index 00000000..0c846169
--- /dev/null
+++ b/entries/contextmenu.xml
@@ -0,0 +1,86 @@
+
+
+  .contextmenu()
+  Bind an event handler to the "contextmenu" JavaScript event, or trigger that event on an element.
+  
+    1.0
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.4.3
+    
+      An object containing data that will be passed to the event handler.
+    
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.0
+  
+  
+    
          This method is a shortcut for .on( "contextmenu", handler ) in the first two variations, and .trigger( "contextmenu" ) in the third.
+    The contextmenu event is sent to an element when the right button of the mouse is clicked on it, but before the context menu is displayed. In case the context menu key is pressed, the event is triggered on the html element. Any HTML element can receive this event.
+    For example, consider the HTML:
          
+    
          
+<div id="target">
+  Right-click here
+</div>
+    
          
+    
          The event handler can be bound to the <div> as follows:
          
+    
          
+$( "#target" ).contextmenu(function() {
+  alert( "Handler for .contextmenu() called." );
+});
+    
          
+    
          Now right-clicking on this element displays the alert:
          
+    
          
+      Handler for .contextmenu() called.
+    
          
+    
          To trigger the event manually, call .contextmenu() without an argument:
          
+    
          
+$( "#target" ).contextmenu();
+    
          
+            
+  
+  
+    To show a "Hello World!" alert box when the contextmenu event is triggered on a paragraph on the page:
+    
+  
+  
+    Right click to toggle background color.
+    
+    
+    
+Right click the block
+]]>
+  
+  
+  
+  
+          

From d347186c65f26e5432649498202b954297b501b2 Mon Sep 17 00:00:00 2001
From: Eric Lee Carraway 
Date: Tue, 3 Nov 2015 21:30:47 -0500
Subject: [PATCH 348/699] Docs(entries): Fix typos.

Closes gh-827.
---
 entries/contents.xml             | 2 +-
 entries/jQuery.ajax.xml          | 4 ++--
 entries/jQuery.ajaxTransport.xml | 2 +-
 entries/on.xml                   | 2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/entries/contents.xml b/entries/contents.xml
index 6f348b9b..5bfe9fc6 100644
--- a/entries/contents.xml
+++ b/entries/contents.xml
@@ -50,7 +50,7 @@ $( "p" )
 ]]>
             
   
-    Change the background colour of links inside of an iframe.
+    Change the background color of links inside of an iframe.
     
diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index 4c8f6686..81e3e42c 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -318,7 +318,7 @@ jqxhr.always(function() {
     
          As of jQuery 1.5, jQuery's Ajax implementation includes prefilters, transports, and converters that allow you to extend Ajax with a great deal of flexibility.
          
 
     
          Using Converters
          
-    
          $.ajax() converters support mapping data types to other data types. If, however, you want to map a custom data type to a known type (e.g json), you must add a correspondance between the response Content-Type and the actual data type using the contents option:
          
+    
          $.ajax() converters support mapping data types to other data types. If, however, you want to map a custom data type to a known type (e.g json), you must add a correspondence between the response Content-Type and the actual data type using the contents option:
          
     
          
 $.ajaxSetup({
   contents: {
@@ -332,7 +332,7 @@ $.ajaxSetup({
   }
 });
     
          
-    
          This extra object is necessary because the response Content-Types and data types never have a strict one-to-one correspondance (hence the regular expression).
          
+    
          This extra object is necessary because the response Content-Types and data types never have a strict one-to-one correspondence (hence the regular expression).
          
     
          To convert from a supported type (e.g text, json) to a custom data type and back again, use another pass-through converter:
          
     
          
 $.ajaxSetup({
diff --git a/entries/jQuery.ajaxTransport.xml b/entries/jQuery.ajaxTransport.xml
index 93bcbf77..ccc73ce8 100644
--- a/entries/jQuery.ajaxTransport.xml
+++ b/entries/jQuery.ajaxTransport.xml
@@ -48,7 +48,7 @@ function( status, statusText, responses, headers ) {}
     
            
       
          • status is the HTTP status code of the response, like  200 for a typical success, or 404 for when the resource is not found.
            • 
       
          • statusText is the statusText of the response.
            • 
-      
          • responses (Optional) is An object containing dataType/value that contains the response in all the formats the transport could provide (for instance, a native XMLHttpRequest object would set reponses to { xml: XMLData, text: textData } for a response that is an XML document)
            • 
+      
          • responses (Optional) is An object containing dataType/value that contains the response in all the formats the transport could provide (for instance, a native XMLHttpRequest object would set responses to { xml: XMLData, text: textData } for a response that is an XML document)
            • 
       
          • headers (Optional) is a string containing all the response headers if the transport has access to them (akin to what XMLHttpRequest.getAllResponseHeaders() would provide).
            • 
     
          
     
          Just like prefilters, a transport's factory function can be attached to a specific dataType:
          
diff --git a/entries/on.xml b/entries/on.xml
index 9a7e66ed..34d14f4e 100644
--- a/entries/on.xml
+++ b/entries/on.xml
@@ -34,7 +34,7 @@
   
     
          The .on() method attaches event handlers to the currently selected set of elements in the jQuery object. As of jQuery 1.7, the .on() method provides all functionality required for attaching event handlers. For help in converting from older jQuery event methods, see .bind(),  .delegate(), and .live(). To remove events bound with .on(), see .off(). To attach an event that runs only once and then removes itself, see .one()
          
     
          Event names and namespaces
          
-    
          Any event names can be used for the events argument. jQuery will pass through the browser's standard JavaScript event types, calling the handler function when the browser generates events due to user actions such as click. In addition, the .trigger() method can trigger both standard browser event names and custom event names to call attached handlers. Event names should only contain alphanumerics, underscore, and colon chraracters.
          
+    
          Any event names can be used for the events argument. jQuery will pass through the browser's standard JavaScript event types, calling the handler function when the browser generates events due to user actions such as click. In addition, the .trigger() method can trigger both standard browser event names and custom event names to call attached handlers. Event names should only contain alphanumerics, underscore, and colon characters.
          
     
          An event name can be qualified by event namespaces that simplify removing or triggering the event. For example, "click.myPlugin.simple" defines both the myPlugin and simple namespaces for this particular click event. A click event handler attached via that string could be removed with .off("click.myPlugin") or .off("click.simple") without disturbing other click handlers attached to the elements. Namespaces are similar to CSS classes in that they are not hierarchical; only one name needs to match. Namespaces beginning with an underscore are reserved for jQuery's use.
          
     
          In the second form of .on(), the events argument is a plain object. The keys are strings in the same form as the events argument with space-separated event type names and optional namespaces. The value for each key is a function (or false value) that is used as the handler instead of the final argument to the method. In other respects, the two forms are identical in their behavior as described below.
          
     
          Direct and delegated events
          

From 320265a67851969e02837b88f14802d93ef8e7fc Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Tue, 3 Nov 2015 21:39:51 -0500
Subject: [PATCH 349/699] Release 1.11.113

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index ca35e147..f9206b26 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.112",
+  "version": "1.11.113",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 1cb336132d804c87f8a580c65e9d79b45e3730c9 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sat, 31 Oct 2015 13:15:53 +0000
Subject: [PATCH 350/699] Error: Added deprecation note

Closes gh-824
---
 entries/error.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/entries/error.xml b/entries/error.xml
index 0fcb1810..872ff70d 100644
--- a/entries/error.xml
+++ b/entries/error.xml
@@ -21,6 +21,7 @@
   
   
     
          This method is a shortcut for .on( "error", handler ).
          
+    
          As of jQuery 1.8, the .error() method is deprecated. Use .on( "error", handler ) to attach event handlers to the error event instead.
          
     
          The error event is sent to elements, such as images, that are referenced by a document and loaded by the browser. It is called if the element was not loaded correctly.
          
     
          For example, consider a page with a simple image element:
          
     
          

From 306ec8135a911c0b925ad4397f550864cf7e193c Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Wed, 2 Dec 2015 10:01:39 -0500
Subject: [PATCH 351/699] Add 
           and 
           for longdesc imgs

---
 entries/animate.xml     | 10 ++++++++--
 entries/click.xml       |  5 +++--
 entries/dblclick.xml    |  5 +++--
 entries/fadeIn.xml      | 13 +++++++------
 entries/fadeOut.xml     | 13 +++++++------
 entries/fadeTo.xml      | 13 +++++++------
 entries/height.xml      |  5 +++--
 entries/hide.xml        | 12 ++++++------
 entries/innerHeight.xml |  5 +++--
 entries/innerWidth.xml  |  5 +++--
 entries/mousedown.xml   |  5 +++--
 entries/mouseenter.xml  |  5 +++--
 entries/mouseleave.xml  |  5 +++--
 entries/mouseout.xml    |  5 +++--
 entries/mouseover.xml   |  5 +++--
 entries/mouseup.xml     |  5 +++--
 entries/outerHeight.xml |  5 +++--
 entries/outerWidth.xml  |  9 +++++----
 entries/scroll.xml      |  5 +++--
 entries/show.xml        | 13 +++++++------
 entries/slideDown.xml   | 13 +++++++------
 entries/slideToggle.xml | 26 ++++++++++++++------------
 entries/slideUp.xml     | 13 +++++++------
 entries/toggle.xml      | 26 ++++++++++++++------------
 entries/width.xml       |  5 +++--
 25 files changed, 131 insertions(+), 100 deletions(-)

diff --git a/entries/animate.xml b/entries/animate.xml
index 11477c2a..f138bc4d 100644
--- a/entries/animate.xml
+++ b/entries/animate.xml
@@ -56,12 +56,18 @@ $( "#clickme" ).click(function() {
 });
     
          
     
          
-      
+      
          
+        
+        
          figure 1
          
+      
          
     
          
     
          Note that the target value of the height property is 'toggle'. Since the image was visible before, the animation shrinks the height to 0 to hide it. A second click then reverses this transition:
     
          
     
          
-      
+      
          
+        
+        
          figure 2
          
+      
          
     
          
     
          The opacity of the image is already at its target value, so this property is not animated by the second click. Since the target value for left is a relative value, the image moves even farther to the right during this second animation.
          
     
          Directional properties (top, right, bottom, left) have no discernible effect on elements if their  position style property is static, which it is by default.
          
diff --git a/entries/click.xml b/entries/click.xml
index 206edf99..c6e9b168 100644
--- a/entries/click.xml
+++ b/entries/click.xml
@@ -34,9 +34,10 @@
   Trigger the handler
 </div>
     
          
-    
          
+    
          
       
-    
          
+      
          figure 1
          
+    
          
     
          The event handler can be bound to any <div>:
          
     
          
 $( "#target" ).click(function() {
diff --git a/entries/dblclick.xml b/entries/dblclick.xml
index df7a5ae4..54962191 100644
--- a/entries/dblclick.xml
+++ b/entries/dblclick.xml
@@ -34,9 +34,10 @@
   Trigger the handler
 </div>
     
          
-    
          
+    
          
       
-    
          
+      
          figure 1
          
+    
          
     
          The event handler can be bound to any <div>:
          
     
          
 $( "#target" ).dblclick(function() {
diff --git a/entries/fadeIn.xml b/entries/fadeIn.xml
index 819e663e..628e7e73 100644
--- a/entries/fadeIn.xml
+++ b/entries/fadeIn.xml
@@ -35,12 +35,13 @@ $( "#clickme" ).click(function() {
   });
 });
     
          
-    
          
-      
-      
-      
-      
-    
          
+    
          
+      
+      
+      
+      
+      
          figure 1
          
+    
          
     
          Easing
          
     
          As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
          
     
          Callback Function
          
diff --git a/entries/fadeOut.xml b/entries/fadeOut.xml
index 28228979..cfd1c6ae 100644
--- a/entries/fadeOut.xml
+++ b/entries/fadeOut.xml
@@ -36,12 +36,13 @@ $( "#clickme" ).click(function() {
   });
 });
               
-    
          
-      
-      
-      
-      
-    
          
+    
          
+      
+      
+      
+      
+      
          figure 1
          
+    
          
     
          
       
          Note: To avoid unnecessary DOM manipulation, .fadeOut() will not hide an element that is already considered hidden. For information on which elements jQuery considers hidden, see  :hidden Selector.
          
     
          
diff --git a/entries/fadeTo.xml b/entries/fadeTo.xml
index 5ce98458..ca382b0c 100644
--- a/entries/fadeTo.xml
+++ b/entries/fadeTo.xml
@@ -50,12 +50,13 @@ $( "#clickme" ).click(function() {
   });
 });
               
-    
          
-      
-      
-      
-      
-    
          
+    
          
+      
+      
+      
+      
+      
          figure 1
          
+    
          
     
          With duration set to 0, this method just changes the opacity CSS property, so .fadeTo( 0, opacity ) is the same as .css( "opacity", opacity ).
          
   
   
diff --git a/entries/height.xml b/entries/height.xml
index 7efdf312..548af238 100644
--- a/entries/height.xml
+++ b/entries/height.xml
@@ -9,9 +9,10 @@
     Get the current computed height for the first element in the set of matched elements.
     
       
          The difference between .css( "height" ) and .height() is that the latter returns a unit-less pixel value (for example, 400) while the former returns a value with units intact (for example, 400px). The .height() method is recommended when an element's height needs to be used in a mathematical calculation.
          
-      
          
+      
          
         
-      
          
+        
          figure 1
          
+      
          
       
          This method is also able to find the height of the window and document.
          
       
          
 // Returns height of browser viewport
diff --git a/entries/hide.xml b/entries/hide.xml
index cfe38a29..1a0093d5 100644
--- a/entries/hide.xml
+++ b/entries/hide.xml
@@ -52,12 +52,12 @@ $( "#clickme" ).click(function() {
   });
 });
     
          
-    
          
-      
-      
-      
-      
-    
          
+    
          
+      
+      
+      
+      
+    
          
             
   
   
diff --git a/entries/innerHeight.xml b/entries/innerHeight.xml
index 294666c2..b962c231 100644
--- a/entries/innerHeight.xml
+++ b/entries/innerHeight.xml
@@ -11,9 +11,10 @@
   
     
          This method returns the height of the element, including top and bottom padding, in pixels.
          
     
          This method is not applicable to window and document objects; for these, use .height() instead.
          
-    
          
+    
          
       
-    
          
+      
          figure 1
          
+    
          
             
 	
   
diff --git a/entries/innerWidth.xml b/entries/innerWidth.xml
index e98529d3..fbfd5df5 100644
--- a/entries/innerWidth.xml
+++ b/entries/innerWidth.xml
@@ -10,9 +10,10 @@
   
     
          This method returns the width of the element, including left and right padding, in pixels.
          
     
          This method is not applicable to window and document objects; for these, use .width() instead.
          
-    
          
+    
          
       
-    
          
+      
          figure 1
          
+    
          
             
 	
   
diff --git a/entries/mousedown.xml b/entries/mousedown.xml
index 9b1105d0..6217be54 100644
--- a/entries/mousedown.xml
+++ b/entries/mousedown.xml
@@ -33,9 +33,10 @@
   Trigger the handler
 </div>
     
-    
          
+    
          
       
-    
          
+      
          figure 1
          
+    
          
     
          The event handler can be bound to any <div>:
          
     
          
 $( "#target" ).mousedown(function() {
diff --git a/entries/mouseenter.xml b/entries/mouseenter.xml
index 6985f396..de72455d 100644
--- a/entries/mouseenter.xml
+++ b/entries/mouseenter.xml
@@ -37,9 +37,10 @@
   Trigger the handler
 </div>
 <div id="log"></div>
          
-    
          
+    
          
       
-    
          
+      
          figure 1
          
+    
          
     
          The event handler can be bound to any element:
          
     
          
 $( "#outer" ).mouseenter(function() {
diff --git a/entries/mouseleave.xml b/entries/mouseleave.xml
index 56adcb65..23508900 100644
--- a/entries/mouseleave.xml
+++ b/entries/mouseleave.xml
@@ -37,9 +37,10 @@
   Trigger the handler
 </div>
 <div id="log"></div>
          
-    
          
+    
          
       
-    
          
+      
          figure 1
          
+    
          
     
          The event handler can be bound to any element:
          
     
          
 $( "#outer" ).mouseleave(function() {
diff --git a/entries/mouseout.xml b/entries/mouseout.xml
index bcdece5b..09c63aab 100644
--- a/entries/mouseout.xml
+++ b/entries/mouseout.xml
@@ -38,9 +38,10 @@
 </div>
 <div id="log"></div>
     
          
-    
          
+    
          
       
-    
          
+      
          figure 1
          
+    
          
     
          The event handler can be bound to any element:
          
     
          
 $( "#outer" ).mouseout(function() {
diff --git a/entries/mouseover.xml b/entries/mouseover.xml
index f2ca8c02..5d4415da 100644
--- a/entries/mouseover.xml
+++ b/entries/mouseover.xml
@@ -38,9 +38,10 @@
 </div>
 <div id="log"></div>
     
          
-    
          
+    
          
       
-    
          
+      
          figure 1
          
+    
          
     
          The event handler can be bound to any element:
          
     
          
 $( "#outer" ).mouseover(function() {
diff --git a/entries/mouseup.xml b/entries/mouseup.xml
index 31640a96..8fb2122b 100644
--- a/entries/mouseup.xml
+++ b/entries/mouseup.xml
@@ -34,9 +34,10 @@
   Trigger the handler
 </div>
 
          
-    
          
+    
          
       
-    
          
+      
          figure 1
          
+    
          
     
          The event handler can be bound to any <div>:
          
     
          
 $( "#target" ).mouseup(function() {
diff --git a/entries/outerHeight.xml b/entries/outerHeight.xml
index bdd1bd7f..6a14fd7d 100644
--- a/entries/outerHeight.xml
+++ b/entries/outerHeight.xml
@@ -13,9 +13,10 @@
   
     
          The top and bottom padding and border are always included in the .outerHeight() calculation; if the includeMargin argument is set to true, the margin (top and bottom) is also included.
          
     
          This method is not applicable to window and document objects; for these, use .height() instead.
          
-    
          
+    
          
       
-    
          
+      
          figure 1
          
+    
          
             
 	
   
diff --git a/entries/outerWidth.xml b/entries/outerWidth.xml
index a6ab2247..f39fe926 100644
--- a/entries/outerWidth.xml
+++ b/entries/outerWidth.xml
@@ -14,9 +14,10 @@
     
          Returns the width of the element, along with left and right padding, border, and optionally margin, in pixels.
          
     
          If includeMargin is omitted or false, the padding and border are included in the calculation; if true, the margin is also included.
          
     
          This method is not applicable to window and document objects; for these, use .width() instead. Although .outerWidth() can be used on table elements, it may give unexpected results on tables using the border-collapse: collapse CSS property.
          
-    
          
+    
          
       
-    
          
+      
          figure 1
          
+    
          
   
 	
   
@@ -63,7 +64,7 @@ $( "p:last" ).text(
   
     
          When calling .outerWidth(value), the value can be either a string (number and unit) or a number. If only a number is provided for the value, jQuery assumes a pixel unit. If a string is provided, however, any valid CSS measurement may be used (such as 100px, 50%, or auto).
          
             
-  
+
   
     Change the outer width of each div the first time it is clicked (and change its color).
     d
 ]]>
   
-  
+
   
   
   
diff --git a/entries/scroll.xml b/entries/scroll.xml
index 8597018b..1a0e9cbd 100644
--- a/entries/scroll.xml
+++ b/entries/scroll.xml
@@ -43,9 +43,10 @@
 <div id="log"></div>
 
          
     
          The style definition is present to make the target element small enough to be scrollable:
          
-    
          
+    
          
       
-    
          
+      
          figure 1
          
+    
          
     
          The scroll event handler can be bound to this element:
          
     
          
 $( "#target" ).scroll(function() {
diff --git a/entries/show.xml b/entries/show.xml
index f0745958..60974469 100644
--- a/entries/show.xml
+++ b/entries/show.xml
@@ -53,12 +53,13 @@ $( "#clickme" ).click(function() {
   });
 });
     
          
-    
          
-      
-      
-      
-      
-    
          
+    
          
+      
+      
+      
+      
+      
          figure 1
          
+    
          
   
   
   
diff --git a/entries/slideDown.xml b/entries/slideDown.xml
index 01a14e03..204a9372 100644
--- a/entries/slideDown.xml
+++ b/entries/slideDown.xml
@@ -36,12 +36,13 @@ $( "#clickme" ).click(function() {
   });
 });
               
-    
          
-      
-      
-      
-      
-    
          
+    
          
+      
+      
+      
+      
+      
          figure 1
          
+    
          
     
          Easing
          
     
          As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
          
     
          Callback Function
          
diff --git a/entries/slideToggle.xml b/entries/slideToggle.xml
index e3c3d474..d6cd26b0 100644
--- a/entries/slideToggle.xml
+++ b/entries/slideToggle.xml
@@ -37,19 +37,21 @@ $( "#clickme" ).click(function() {
 });
     
     
          With the element initially shown, we can hide it slowly with the first click:
          
-    
          
-      
-      
-      
-      
-    
          
+    
          
+      
+      
+      
+      
+      
          figure 1
          
+    
          
     
          A second click will show the element once again:
          
-    
          
-      
-      
-      
-      
-    
          
+    
          
+      
+      
+      
+      
+      
          figure 2
          
+    
          
     
          Easing
          
     
          As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
          
     
          Callback Function
          
diff --git a/entries/slideUp.xml b/entries/slideUp.xml
index 345d3c4f..3ecc8feb 100644
--- a/entries/slideUp.xml
+++ b/entries/slideUp.xml
@@ -36,12 +36,13 @@ $( "#clickme" ).click(function() {
   });
 });
     
-    
          
-      
-      
-      
-      
-    
          
+    
          
+      
+      
+      
+      
+      
          figure 1
          
+    
          
     
          Easing
          
     
          As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
          
     
          Callback Function
          
diff --git a/entries/toggle.xml b/entries/toggle.xml
index 87cc15ce..26f85aa0 100644
--- a/entries/toggle.xml
+++ b/entries/toggle.xml
@@ -59,19 +59,21 @@ $( "#clickme" ).click(function() {
     
     
          With the element initially shown, we can hide it slowly with the first click:
     
          
-    
          
-      
-      
-      
-      
-    
          
+    
          
+      
+      
+      
+      
+      
          figure 1
          
+    
          
     
          A second click will show the element once again:
          
-    
          
-      
-      
-      
-      
-    
          
+    
          
+      
+      
+      
+      
+      
          figure 2
          
+    
          
     
          The second version of the method accepts a Boolean parameter. If this parameter is true, then the matched elements are shown; if false, the elements are hidden. In essence, the statement:
     
          
     
          
diff --git a/entries/width.xml b/entries/width.xml
index 11fc2ebf..abc8aff3 100644
--- a/entries/width.xml
+++ b/entries/width.xml
@@ -9,9 +9,10 @@
     Get the current computed width for the first element in the set of matched elements.
     
       
          The difference between .css(width) and .width() is that the latter returns a unit-less pixel value (for example, 400) while the former returns a value with units intact (for example, 400px). The .width() method is recommended when an element's width needs to be used in a mathematical calculation.
          
-      
          
+      
          
         
-      
          
+        
          figure 1
          
+      
          
       
          This method is also able to find the width of the window and document.
          
       
          
 // Returns width of browser viewport

From 69e0e2ac4b9f19433c8d491b3772eec8c558111b Mon Sep 17 00:00:00 2001
From: Anne-Gaelle Colom 
Date: Wed, 2 Dec 2015 21:08:32 +0000
Subject: [PATCH 352/699] 1.11.114

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index f9206b26..673192ac 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.113",
+  "version": "1.11.114",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 8e70d52f767f2ffb92beb884752579db6483ceda Mon Sep 17 00:00:00 2001
From: Andy Li 
Date: Sun, 13 Dec 2015 01:10:38 +0800
Subject: [PATCH 353/699] index: Document return value as integer

Closes gh-845
---
 entries/index.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/index.xml b/entries/index.xml
index ecd46243..efcde43c 100644
--- a/entries/index.xml
+++ b/entries/index.xml
@@ -1,5 +1,5 @@
 
-
+
   .index()
   
     1.4

From d1e8d47ea5089aa88768568adce4d11c8db7c1f5 Mon Sep 17 00:00:00 2001
From: Nabil Kadimi 
Date: Sun, 6 Dec 2015 22:11:13 +0000
Subject: [PATCH 354/699] event.stopPropagation: Minor improvement

Closes gh-844
---
 entries/event.stopPropagation.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/event.stopPropagation.xml b/entries/event.stopPropagation.xml
index 923b9587..adf4ea10 100644
--- a/entries/event.stopPropagation.xml
+++ b/entries/event.stopPropagation.xml
@@ -7,7 +7,7 @@
   Prevents the event from bubbling up the DOM tree, preventing any parent handlers from being notified of the event.
   
     
          We can use event.isPropagationStopped() to determine if this method was ever called (on that event object). 
          
-    
          This method works for custom events triggered with trigger(), as well.
          
+    
          This method works for custom events triggered with trigger() as well.
          
     
          Note that this will not prevent other handlers on the same element from running. 
          
             
   

From b023cc01bb213ca3bd15dff6c4bcfc07c9664125 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Tue, 6 Oct 2015 21:20:20 +0100
Subject: [PATCH 355/699] Document that addClass and removeClass change the
 property

Fixes gh-312
Closes gh-813
---
 entries/addClass.xml    | 1 +
 entries/removeClass.xml | 1 +
 2 files changed, 2 insertions(+)

diff --git a/entries/addClass.xml b/entries/addClass.xml
index 476251d8..69274708 100644
--- a/entries/addClass.xml
+++ b/entries/addClass.xml
@@ -19,6 +19,7 @@
   Adds the specified class(es) to each element in the set of matched elements.
   
     
          It's important to note that this method does not replace a class. It simply adds the class, appending it to any which may already be assigned to the elements.
          
+    
          The .addClass() method manipulates the className property of the selected elements, not the class attribute. Once the property is changed, it's the browser that updates the attribute accordingly. An implication of this behavior is that this method only works for documents with HTML DOM semantics (e.g., not pure XML documents).
          
     
          More than one class may be added at a time, separated by a space, to the set of matched elements, like so:
          
     
          
 $( "p" ).addClass( "myClass yourClass" );
diff --git a/entries/removeClass.xml b/entries/removeClass.xml
index 8bb11196..3263e3a3 100644
--- a/entries/removeClass.xml
+++ b/entries/removeClass.xml
@@ -19,6 +19,7 @@
   Remove a single class, multiple classes, or all classes from each element in the set of matched elements.
   
     
          If a class name is included as a parameter, then only that class will be removed from the set of matched elements. If no class names are specified in the parameter, all classes will be removed.
          
+    
          The .removeClass() method manipulates the className property of the selected elements, not the class attribute. Once the property is changed, it's the browser that updates the attribute accordingly. This means that when the class attribute is updated and the last class name is removed, the browser may set the attribute's value to an empty string instead of removing the attribute completely. An implication of this behavior is that this method only works for documents with HTML DOM semantics (e.g., not pure XML documents).
          
     
          More than one class may be removed at a time, separated by a space, from the set of matched elements, like so:
          
     
          
 $( "p" ).removeClass( "myClass yourClass" )

From 6f9531167072d3e39aafb32804f8cb94c1d39634 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 21 Sep 2015 00:57:52 +0100
Subject: [PATCH 356/699] Moved note about Global Ajax events to notes.xsl

Fixes gh-798
Closes gh-805
---
 entries/ajaxComplete.xml | 1 -
 entries/ajaxError.xml    | 1 -
 entries/ajaxSend.xml     | 1 -
 entries/ajaxStart.xml    | 1 -
 entries/ajaxStop.xml     | 1 -
 entries/ajaxSuccess.xml  | 1 -
 6 files changed, 6 deletions(-)

diff --git a/entries/ajaxComplete.xml b/entries/ajaxComplete.xml
index 2c26aea3..33705e53 100644
--- a/entries/ajaxComplete.xml
+++ b/entries/ajaxComplete.xml
@@ -32,7 +32,6 @@ $( ".trigger" ).click(function() {
 });
     
          
     
          When the user clicks the element with class trigger and the Ajax request completes, the log message is displayed.
          
-    
          As of jQuery 1.8, the .ajaxComplete() method should only be attached to document.
          
     
          All ajaxComplete handlers are invoked, regardless of what Ajax request was completed. If you must differentiate between the requests, use the parameters passed to the handler. Each time an ajaxComplete handler is executed, it is passed the event object, the XMLHttpRequest object, and the settings object that was used in the creation of the request. For example, you can restrict the callback to only handling events dealing with a particular URL:
          
     
          
 $( document ).ajaxComplete(function( event, xhr, settings ) {
diff --git a/entries/ajaxError.xml b/entries/ajaxError.xml
index f674df42..19abee09 100644
--- a/entries/ajaxError.xml
+++ b/entries/ajaxError.xml
@@ -33,7 +33,6 @@ $( "button.trigger" ).on( "click", function() {
 });
     
          
     
          When the user clicks the button and the Ajax request fails, because the requested file is missing, the log message is displayed.
          
-    
          As of jQuery 1.8, the .ajaxError() method should only be attached to document.
          
     
          All ajaxError handlers are invoked, regardless of what Ajax request was completed. To differentiate between the requests, use the parameters passed to the handler. Each time an ajaxError handler is executed, it is passed the event object, the jqXHR object (prior to jQuery 1.5, the XHR object), and the settings object that was used in the creation of the request. When an HTTP error occurs, the fourth argument (thrownError) receives the textual portion of the HTTP status, such as "Not Found" or "Internal Server Error." For example, to restrict the error callback to only handling events dealing with a particular URL:
          
     
          
 $( document ).ajaxError(function( event, jqxhr, settings, thrownError ) {
diff --git a/entries/ajaxSend.xml b/entries/ajaxSend.xml
index 0678622c..db814fee 100644
--- a/entries/ajaxSend.xml
+++ b/entries/ajaxSend.xml
@@ -32,7 +32,6 @@ $( ".trigger" ).click(function() {
 });
     
          
     
          When the user clicks the element with class trigger and the Ajax request is about to begin, the log message is displayed.
          
-    
          As of jQuery 1.8, the .ajaxSend() method should only be attached to document.
          
     
          All ajaxSend handlers are invoked, regardless of what Ajax request is to be sent. If you must differentiate between the requests, use the parameters passed to the handler. Each time an ajaxSend handler is executed, it is passed the event object, the jqXHR object (in version 1.4, XMLHttpRequestobject), and the settings object that was used in the creation of the Ajax request. For example, you can restrict the callback to only handling events dealing with a particular URL:
          
     
          
 $( document ).ajaxSend(function( event, jqxhr, settings ) {
diff --git a/entries/ajaxStart.xml b/entries/ajaxStart.xml
index 92e6cc70..bf7fc14a 100644
--- a/entries/ajaxStart.xml
+++ b/entries/ajaxStart.xml
@@ -29,7 +29,6 @@ $( ".trigger" ).click(function() {
 });
     
          
     
          When the user clicks the element with class trigger and the Ajax request is sent, the log message is displayed.
          
-    
          As of jQuery 1.8, the .ajaxStart() method should only be attached to document.
          
             
   
   
diff --git a/entries/ajaxStop.xml b/entries/ajaxStop.xml
index fc0781f6..073dd208 100644
--- a/entries/ajaxStop.xml
+++ b/entries/ajaxStop.xml
@@ -29,7 +29,6 @@ $( ".trigger" ).click(function() {
 });
     
          
     
          When the user clicks the element with class trigger and the Ajax request completes, the log message is displayed.
          
-    
          As of jQuery 1.8, the .ajaxStop() method should only be attached to document.
          
             
   
   
diff --git a/entries/ajaxSuccess.xml b/entries/ajaxSuccess.xml
index 40dabc01..840ec028 100644
--- a/entries/ajaxSuccess.xml
+++ b/entries/ajaxSuccess.xml
@@ -33,7 +33,6 @@ $( ".trigger" ).on( "click", function() {
 });
     
          
     
          When the user clicks the element with class trigger and the Ajax request completes successfully, the log message is displayed.
          
-    
          As of jQuery 1.8, the .ajaxSuccess() method should only be attached to document.
          
     
          All ajaxSuccess handlers are invoked, regardless of what Ajax request was completed. If you must differentiate between the requests, you can use the parameters passed to the handler. Each time an ajaxSuccess handler is executed, it is passed the event object, the XMLHttpRequest object, and the settings object that was used in the creation of the request. For example, you can restrict the callback to only handling events dealing with a particular URL:
          
     
          
 $( document ).ajaxSuccess(function( event, xhr, settings ) {

From db305e638f5142decaa4e962e70cd8de89cbca8b Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Tue, 15 Dec 2015 10:26:52 +0000
Subject: [PATCH 357/699] Note that Types page is not a comprehensive guide

Fixes gh-832
Closes gh-850
---
 pages/Types.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pages/Types.html b/pages/Types.html
index 18e0ee5b..fbf2bf80 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -9,7 +9,7 @@
 ol ul li { font-size: 1em !important; }
 ol ul { margin-left: 1.5em !important; }
 
-
          JavaScript provides several built-in datatypes. In addition to those, this page documents virtual types like Selectors, enhanced pseudo-types like Events and all and everything you wanted to know about Functions.
+
          JavaScript provides several built-in datatypes. In addition to those, this page documents virtual types like Selectors, enhanced pseudo-types like Events and some concepts you need to know about Functions. If you want to study these concepts in depth, take a look at MDN.
 
          
 
          You should be able to try out most of the examples below by just copying them to your browser's JavaScript Console (Chrome, Safari with Develop menu activated, IE 8+) or Firebug console (Firefox).
 
          

From 4cd3452c32196332fd72c03f571b6a8afdc91e43 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Wed, 16 Dec 2015 00:22:40 +0000
Subject: [PATCH 358/699] Added performance warning to show and hide

Fixes gh-816
Closes gh-852
---
 entries/hide.xml | 3 +++
 entries/show.xml | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/entries/hide.xml b/entries/hide.xml
index 1a0093d5..91916a8e 100644
--- a/entries/hide.xml
+++ b/entries/hide.xml
@@ -37,6 +37,9 @@ $( ".target" ).hide();
     
          Note that .hide() is fired immediately and will override the animation queue if no duration or a duration of 0 is specified.
          
     
          As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
          
     
          If supplied, the callback is fired once the animation is complete. This can be useful for stringing different animations together in sequence. The callback is not sent any arguments, but this is set to the DOM element being animated. If multiple elements are animated, it is important to note that the callback is executed once per matched element, not once for the animation as a whole.
          
+    
          
+      
          Note: This method may cause performance issues, especially when used on many elements. If you're encountering such issues, use performance testing tools to determine whether this method is causing them. Moreover, this method can cause problems with responsive layouts if the display value differs at different viewport sizes.
          
+    
          
     
          We can animate any element, such as a simple image:
          
     
          
 <div id="clickme">
diff --git a/entries/show.xml b/entries/show.xml
index 60974469..b6f38e13 100644
--- a/entries/show.xml
+++ b/entries/show.xml
@@ -40,6 +40,9 @@ $( ".target" ).show();
     
          Durations are given in milliseconds; higher values indicate slower animations, not faster ones. The strings 'fast' and 'slow' can be supplied to indicate durations of 200 and 600 milliseconds, respectively.
          
     
          As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
          
     
          If supplied, the callback is fired once the animation is complete. This can be useful for stringing different animations together in sequence. The callback is not sent any arguments, but this is set to the DOM element being animated. If multiple elements are animated, it is important to note that the callback is executed once per matched element, not once for the animation as a whole.
          
+    
          
+      
          Note: This method may cause performance issues, especially when used on many elements. If you're encountering such issues, use performance testing tools to determine whether this method is causing them. Moreover, this method can cause problems with responsive layouts if the display value differs at different viewport sizes.
          
+    
          
     
          We can animate any element, such as a simple image:
          
     
          
 <div id="clickme">

From c000f3fb055f7f6611802c1a78b1221ed30791cb Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 14 Dec 2015 20:56:49 +0000
Subject: [PATCH 359/699] Note that :visible is the opposite of :hidden

Fixes gh-838
Closes gh-848
---
 entries/hidden-selector.xml  | 1 +
 entries/visible-selector.xml | 1 +
 2 files changed, 2 insertions(+)

diff --git a/entries/hidden-selector.xml b/entries/hidden-selector.xml
index 6712c736..2c2e6e2c 100644
--- a/entries/hidden-selector.xml
+++ b/entries/hidden-selector.xml
@@ -16,6 +16,7 @@
     
     
          Elements with visibility: hidden or opacity: 0 are considered to be visible, since they still consume space in the layout. During animations that hide an element, the element is considered to be visible until the end of the animation.
          
     
          Elements that are not in a document are not considered to be visible; jQuery does not have a way to know if they will be visible when appended to a document since it depends on the applicable styles.
          
+    
          This selector is the opposite of the :visible selector. So, every element selected by :hidden isn't selected by :visible and vice versa.
          
     
          During animations to show an element, the element is considered to be visible at the start of the animation.
          
     
          How :hidden is determined was changed in jQuery 1.3.2. An element is assumed to be hidden if it or any of its parents consumes no space in the document. CSS visibility isn't taken into account (therefore $( elem ).css( "visibility", "hidden" ).is( ":hidden" ) == false). The release notes outline the changes in more detail.
          
   
diff --git a/entries/visible-selector.xml b/entries/visible-selector.xml
index c1050ab5..25df8ee7 100644
--- a/entries/visible-selector.xml
+++ b/entries/visible-selector.xml
@@ -10,6 +10,7 @@
     
          Elements are considered visible if they consume space in the document. Visible elements have a width or height that is greater than zero.
          
     
          Elements with visibility: hidden or opacity: 0 are considered visible, since they still consume space in the layout.
          
     
          Elements that are not in a document are considered hidden; jQuery does not have a way to know if they will be visible when appended to a document since it depends on the applicable styles.
          
+    
          This selector is the opposite of the :hidden selector. So, every element selected by :visible isn't selected by :hidden and vice versa.
          
     
          All option elements are considered hidden, regardless of their selected state.
          
     
          During animations that hide an element, the element is considered visible until the end of the animation. During animations to show an element, the element is considered visible at the start at the animation.
          
     
          How :visible is calculated was changed in jQuery 1.3.2. The release notes outline the changes in more detail.
          

From 68cb1c6ef1ba835486ef0e9e664a72e3fa9f21f2 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Wed, 16 Dec 2015 18:27:07 +0000
Subject: [PATCH 360/699] 1.11.116

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 673192ac..14b6ded5 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.114",
+  "version": "1.11.116",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From aab36ba0238c3c6f48ffcbc164da2789ccb55e3f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Thu, 17 Dec 2015 13:24:04 -0500
Subject: [PATCH 361/699] Build: Upgrade to grunt-jquery-content 3.0.0

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 14b6ded5..fc919412 100644
--- a/package.json
+++ b/package.json
@@ -25,6 +25,6 @@
   },
   "dependencies": {
     "grunt": "0.4.5",
-    "grunt-jquery-content": "2.3.0"
+    "grunt-jquery-content": "3.0.0"
   }
 }

From b49f84466b890e476f4427a0b9029e22302fd175 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
Date: Thu, 17 Dec 2015 13:24:13 -0500
Subject: [PATCH 362/699] 1.11.117

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index fc919412..25fab7fc 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.116",
+  "version": "1.11.117",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From a232f008344f25ce53b9f1b8a217890f6009d13b Mon Sep 17 00:00:00 2001
From: Mike Pennisi 
Date: Sat, 19 Dec 2015 15:33:53 -0500
Subject: [PATCH 363/699] attr: Document attr(key, null) to remove attribute

Fixes gh-523
Closes gh-853
---
 entries/attr.xml | 3 ++-
 pages/Types.html | 3 +++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/entries/attr.xml b/entries/attr.xml
index 203c61c8..40c94de1 100644
--- a/entries/attr.xml
+++ b/entries/attr.xml
@@ -147,7 +147,8 @@ The title of the emphasis is:
          
       
         
         
-        A value to set for the attribute.
+        
+        A value to set for the attribute. If null, the specified attribute will be removed (as in .removeAttr()).
       
     
     
diff --git a/pages/Types.html b/pages/Types.html
index fbf2bf80..4890df38 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -432,6 +432,9 @@ 
           PlainObject 
          
   jQuery.isPlainObject( o ); // true
 
          
 
+
          Null
          
+
          The null keyword is a JavaScript literal that is commonly used to express the absence of an intentional value.
          
+
 
           Date 
          
 
          The Date type is a JavaScript object that represents a single moment in time. Date objects are instantiated using their constructor function, which by default creates an object that represents the current date and time.
 
          

From 8868adde30a83bcef6e63f83f06e8c0a0c446780 Mon Sep 17 00:00:00 2001
From: Anne-Gaelle Colom 
Date: Thu, 3 Dec 2015 08:39:59 +0000
Subject: [PATCH 364/699] Entries: Added description to Figures

Closes gh-842
---
 entries/animate.xml     | 4 ++--
 entries/click.xml       | 2 +-
 entries/dblclick.xml    | 2 +-
 entries/fadeIn.xml      | 2 +-
 entries/fadeOut.xml     | 2 +-
 entries/fadeTo.xml      | 2 +-
 entries/height.xml      | 2 +-
 entries/hide.xml        | 1 +
 entries/innerHeight.xml | 2 +-
 entries/innerWidth.xml  | 2 +-
 entries/mousedown.xml   | 2 +-
 entries/mouseenter.xml  | 2 +-
 entries/mouseleave.xml  | 2 +-
 entries/mouseout.xml    | 2 +-
 entries/mouseover.xml   | 2 +-
 entries/mouseup.xml     | 2 +-
 entries/outerHeight.xml | 2 +-
 entries/outerWidth.xml  | 2 +-
 entries/scroll.xml      | 2 +-
 entries/show.xml        | 2 +-
 entries/slideDown.xml   | 2 +-
 entries/slideToggle.xml | 4 ++--
 entries/slideUp.xml     | 2 +-
 entries/toggle.xml      | 4 ++--
 entries/width.xml       | 2 +-
 25 files changed, 28 insertions(+), 27 deletions(-)

diff --git a/entries/animate.xml b/entries/animate.xml
index f138bc4d..5db2dcf6 100644
--- a/entries/animate.xml
+++ b/entries/animate.xml
@@ -58,7 +58,7 @@ $( "#clickme" ).click(function() {
     
          
       
          
         
-        
          figure 1
          
+        
          Figure 1 - Illustration of the specified animation effect
          
       
          
     
          
     
          Note that the target value of the height property is 'toggle'. Since the image was visible before, the animation shrinks the height to 0 to hide it. A second click then reverses this transition:
@@ -66,7 +66,7 @@ $( "#clickme" ).click(function() {
     
          
       
          
         
-        
          figure 2
          
+        
          Figure 2  - Illustration of the specified animation effect
          
       
          
     
          
     
          The opacity of the image is already at its target value, so this property is not animated by the second click. Since the target value for left is a relative value, the image moves even farther to the right during this second animation.
          
diff --git a/entries/click.xml b/entries/click.xml
index c6e9b168..56475da4 100644
--- a/entries/click.xml
+++ b/entries/click.xml
@@ -36,7 +36,7 @@
     
          
     
          
       
-      
          figure 1
          
+      
          Figure 1 - Illustration of the rendered HTML
          
     
          
     
          The event handler can be bound to any <div>:
          
     
          
diff --git a/entries/dblclick.xml b/entries/dblclick.xml
index 54962191..c5ffe14b 100644
--- a/entries/dblclick.xml
+++ b/entries/dblclick.xml
@@ -36,7 +36,7 @@
     
          
     
          
       
-      
          figure 1
          
+      
          Figure 1 - Illustration of the rendered HTML
          
     
          
     
          The event handler can be bound to any <div>:
          
     
          
diff --git a/entries/fadeIn.xml b/entries/fadeIn.xml
index 628e7e73..f3b2e9e2 100644
--- a/entries/fadeIn.xml
+++ b/entries/fadeIn.xml
@@ -40,7 +40,7 @@ $( "#clickme" ).click(function() {
       
       
       
-      
          figure 1
          
+      
          Figure 1 - Illustration of the fadeIn() effect
          
     
     
          Easing
          
     
          As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
          
diff --git a/entries/fadeOut.xml b/entries/fadeOut.xml
index cfd1c6ae..1bdddaf6 100644
--- a/entries/fadeOut.xml
+++ b/entries/fadeOut.xml
@@ -41,7 +41,7 @@ $( "#clickme" ).click(function() {
       
       
       
-      
          figure 1
          
+      
          Figure 1 - Illustration of the fadeOut() effect
          
     
     
          
       
          Note: To avoid unnecessary DOM manipulation, .fadeOut() will not hide an element that is already considered hidden. For information on which elements jQuery considers hidden, see  :hidden Selector.
          
diff --git a/entries/fadeTo.xml b/entries/fadeTo.xml
index ca382b0c..4bf38be1 100644
--- a/entries/fadeTo.xml
+++ b/entries/fadeTo.xml
@@ -55,7 +55,7 @@ $( "#clickme" ).click(function() {
       
       
       
-      
          figure 1
          
+      
          Figure 1 - Illustration of the fadeTo() effect
          
     
     
          With duration set to 0, this method just changes the opacity CSS property, so .fadeTo( 0, opacity ) is the same as .css( "opacity", opacity ).
          
   
diff --git a/entries/height.xml b/entries/height.xml
index 548af238..2bbe55a0 100644
--- a/entries/height.xml
+++ b/entries/height.xml
@@ -11,7 +11,7 @@
       
          The difference between .css( "height" ) and .height() is that the latter returns a unit-less pixel value (for example, 400) while the former returns a value with units intact (for example, 400px). The .height() method is recommended when an element's height needs to be used in a mathematical calculation.
          
       
          
         
-        
          figure 1
          
+        
          Figure 1 - Illustration of the measured height
          
       
          
       
          This method is also able to find the height of the window and document.
          
       
          
diff --git a/entries/hide.xml b/entries/hide.xml
index 91916a8e..3a68ca15 100644
--- a/entries/hide.xml
+++ b/entries/hide.xml
@@ -60,6 +60,7 @@ $( "#clickme" ).click(function() {
       
       
       
+      
          Figure 1 - Illustration of the hide() effect
          
     
   
   
diff --git a/entries/innerHeight.xml b/entries/innerHeight.xml
index b962c231..b8c5654e 100644
--- a/entries/innerHeight.xml
+++ b/entries/innerHeight.xml
@@ -13,7 +13,7 @@
     
          This method is not applicable to window and document objects; for these, use .height() instead.
          
     
          
       
-      
          figure 1
          
+      
          Figure 1 - Illustration of the measured height
          
     
          
   
 	
diff --git a/entries/innerWidth.xml b/entries/innerWidth.xml
index fbfd5df5..6e9fd0d3 100644
--- a/entries/innerWidth.xml
+++ b/entries/innerWidth.xml
@@ -12,7 +12,7 @@
     
          This method is not applicable to window and document objects; for these, use .width() instead.
          
     
          
       
-      
          figure 1
          
+      
          Figure 1 - Illustration of the measured width
          
     
          
   
 	
diff --git a/entries/mousedown.xml b/entries/mousedown.xml
index 6217be54..dc1626fd 100644
--- a/entries/mousedown.xml
+++ b/entries/mousedown.xml
@@ -35,7 +35,7 @@
     
          
     
          
       
-      
          figure 1
          
+      
          Figure 1 - Illustration of the rendered HTML
          
     
          
     
          The event handler can be bound to any <div>:
          
     
          
diff --git a/entries/mouseenter.xml b/entries/mouseenter.xml
index de72455d..f9c39697 100644
--- a/entries/mouseenter.xml
+++ b/entries/mouseenter.xml
@@ -39,7 +39,7 @@
 <div id="log"></div>
          
     
          
       
-      
          figure 1
          
+      
          Figure 1 - Illustration of the rendered HTML
          
     
          
     
          The event handler can be bound to any element:
          
     
          
diff --git a/entries/mouseleave.xml b/entries/mouseleave.xml
index 23508900..edb8fa44 100644
--- a/entries/mouseleave.xml
+++ b/entries/mouseleave.xml
@@ -39,7 +39,7 @@
 <div id="log"></div>
          
     
          
       
-      
          figure 1
          
+      
          Figure 1 - Illustration of the rendered HTML
          
     
          
     
          The event handler can be bound to any element:
          
     
          
diff --git a/entries/mouseout.xml b/entries/mouseout.xml
index 09c63aab..57304cb1 100644
--- a/entries/mouseout.xml
+++ b/entries/mouseout.xml
@@ -40,7 +40,7 @@
     
          
     
          
       
-      
          figure 1
          
+      
          Figure 1 - Illustration of the rendered HTML
          
     
          
     
          The event handler can be bound to any element:
          
     
          
diff --git a/entries/mouseover.xml b/entries/mouseover.xml
index 5d4415da..88ddb981 100644
--- a/entries/mouseover.xml
+++ b/entries/mouseover.xml
@@ -40,7 +40,7 @@
     
          
     
          
       
-      
          figure 1
          
+      
          Figure 1 - Illustration of the rendered HTML
          
     
          
     
          The event handler can be bound to any element:
          
     
          
diff --git a/entries/mouseup.xml b/entries/mouseup.xml
index 8fb2122b..e18080a6 100644
--- a/entries/mouseup.xml
+++ b/entries/mouseup.xml
@@ -36,7 +36,7 @@
 
          
     
          
       
-      
          figure 1
          
+      
          Figure 1 - Illustration of the rendered HTML
          
     
          
     
          The event handler can be bound to any <div>:
          
     
          
diff --git a/entries/outerHeight.xml b/entries/outerHeight.xml
index 6a14fd7d..95df451f 100644
--- a/entries/outerHeight.xml
+++ b/entries/outerHeight.xml
@@ -15,7 +15,7 @@
     
          This method is not applicable to window and document objects; for these, use .height() instead.
          
     
          
       
-      
          figure 1
          
+      
          Figure 1 - Illustration of the measured height
          
     
          
   
 	
diff --git a/entries/outerWidth.xml b/entries/outerWidth.xml
index f39fe926..24861c8e 100644
--- a/entries/outerWidth.xml
+++ b/entries/outerWidth.xml
@@ -16,7 +16,7 @@
     
          This method is not applicable to window and document objects; for these, use .width() instead. Although .outerWidth() can be used on table elements, it may give unexpected results on tables using the border-collapse: collapse CSS property.
          
     
          
       
-      
          figure 1
          
+      
          Figure 1 - Illustration of the measured width
          
     
          
   
 	
diff --git a/entries/scroll.xml b/entries/scroll.xml
index 1a0e9cbd..8529cb0c 100644
--- a/entries/scroll.xml
+++ b/entries/scroll.xml
@@ -45,7 +45,7 @@
     
          The style definition is present to make the target element small enough to be scrollable:
          
     
          
       
-      
          figure 1
          
+      
          Figure 1 - Illustration of the rendered HTML
          
     
          
     
          The scroll event handler can be bound to this element:
          
     
          
diff --git a/entries/show.xml b/entries/show.xml
index b6f38e13..fb150631 100644
--- a/entries/show.xml
+++ b/entries/show.xml
@@ -61,7 +61,7 @@ $( "#clickme" ).click(function() {
       
       
       
-      
          figure 1
          
+      
          Figure 1 - Illustration of the show() effect
          
     
   
   
diff --git a/entries/slideDown.xml b/entries/slideDown.xml
index 204a9372..7ca77825 100644
--- a/entries/slideDown.xml
+++ b/entries/slideDown.xml
@@ -41,7 +41,7 @@ $( "#clickme" ).click(function() {
       
       
       
-      
          figure 1
          
+      
          Figure 1 - Illustration of the slideDown() effect
          
     
     
          Easing
          
     
          As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
          
diff --git a/entries/slideToggle.xml b/entries/slideToggle.xml
index d6cd26b0..12b97ad1 100644
--- a/entries/slideToggle.xml
+++ b/entries/slideToggle.xml
@@ -42,7 +42,7 @@ $( "#clickme" ).click(function() {
       
       
       
-      
          figure 1
          
+      
          Figure 1 - Illustration of the slideToggle() effect when hiding the image
          
     
     
          A second click will show the element once again:
          
     
          
@@ -50,7 +50,7 @@ $( "#clickme" ).click(function() {
       
       
       
-      
          figure 2
          
+      
          Figure 2 - Illustration of the slideToggle() effect when showing the image
          
     
          
     
          Easing
          
     
          As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
          
diff --git a/entries/slideUp.xml b/entries/slideUp.xml
index 3ecc8feb..8db63468 100644
--- a/entries/slideUp.xml
+++ b/entries/slideUp.xml
@@ -41,7 +41,7 @@ $( "#clickme" ).click(function() {
       
       
       
-      
          figure 1
          
+      
          Figure 1 - Illustration of the slideUp() effect
          
     
     
          Easing
          
     
          As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
          
diff --git a/entries/toggle.xml b/entries/toggle.xml
index 26f85aa0..6c290220 100644
--- a/entries/toggle.xml
+++ b/entries/toggle.xml
@@ -64,7 +64,7 @@ $( "#clickme" ).click(function() {
       
       
       
-      
          figure 1
          
+      
          Figure 1 - Illustration of the toggle() effect when hiding the image
          
     
     
          A second click will show the element once again:
          
     
          
@@ -72,7 +72,7 @@ $( "#clickme" ).click(function() {
       
       
       
-      
          figure 2
          
+      
          Figure 2 - Illustration of the toggle() effect when showing the image
          
     
          
     
          The second version of the method accepts a Boolean parameter. If this parameter is true, then the matched elements are shown; if false, the elements are hidden. In essence, the statement:
     
          
diff --git a/entries/width.xml b/entries/width.xml
index abc8aff3..f073145a 100644
--- a/entries/width.xml
+++ b/entries/width.xml
@@ -11,7 +11,7 @@
       
          The difference between .css(width) and .width() is that the latter returns a unit-less pixel value (for example, 400) while the former returns a value with units intact (for example, 400px). The .width() method is recommended when an element's width needs to be used in a mathematical calculation.
          
       
          
         
-        
          figure 1
          
+        
          Figure 1 - Illustration of the measured width
          
       
          
       
          This method is also able to find the width of the window and document.
          
       
          

From 9560239d82c44ec98bcf5137ade9fb7e6f5eef9d Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 14 Dec 2015 23:53:26 +0000
Subject: [PATCH 365/699] jQuery.speed: Created entry

Fixes gh-830
Closes gh-849
---
 entries/jQuery.speed.xml | 46 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 entries/jQuery.speed.xml

diff --git a/entries/jQuery.speed.xml b/entries/jQuery.speed.xml
new file mode 100644
index 00000000..cb5ea916
--- /dev/null
+++ b/entries/jQuery.speed.xml
@@ -0,0 +1,46 @@
+
+
+  jQuery.speed
+  Creates an object containing a set of properties ready to be used in the definition of custom animations.
+  
+    1.0
+    
+    
+        
+            A string indicating which easing function to use for the transition.
+        
+        
+            A function to call once the animation is complete.
+        
+    
+  
+  
+    1.1
+    
+    
+    
+  
+  
+    1.1
+    
+        
+            A string or number determining how long the animation will run.
+            
+            
+        
+        
+            A string indicating which easing function to use for the transition.
+        
+        
+            A function to call once the animation is complete.
+        
+    
+  
+  
+    
          The $.speed() method provides a way to define properties, such as duration, easing, and queue, to use in a custom animation. By using it, you don't have to implement the logic that deals with default values and optional parameters.
          
+    
          This method is meant for plugin developers who are creating new animation methods. Letting $.speed() do all the parameter hockey and normalization for you, rather than duplicating the logic yourself, makes your work simpler. An example of use can be found in the animated form of .addClass() of jQuery UI. 
          
+            
+  
+  
+  
+          

From 0811e8f152a3e3665af696dd308940189d6f6339 Mon Sep 17 00:00:00 2001
From: Timmy Willison 
Date: Thu, 7 Jan 2016 16:02:35 -0500
Subject: [PATCH 366/699] Manipulation: fix after/before xml parsing

Closes gh-859
---
 entries/after.xml  | 4 ++--
 entries/before.xml | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/entries/after.xml b/entries/after.xml
index 1e195510..ee63cbf7 100644
--- a/entries/after.xml
+++ b/entries/after.xml
@@ -30,9 +30,9 @@
       
     
   
-   
+  
     1.10
-    
+    
       A function that returns an HTML string, DOM element(s), or jQuery object to insert after each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, this refers to the current element in the set.
       
       
diff --git a/entries/before.xml b/entries/before.xml
index cba817a9..6a388ca4 100644
--- a/entries/before.xml
+++ b/entries/before.xml
@@ -33,7 +33,7 @@
   
    
     1.10
-    
+    
       
       
       

From cd7119b5d423e91b92594ebb99b2e8483a91c3f6 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 7 May 2015 21:55:42 +0200
Subject: [PATCH 367/699] jQuery.uniqueSort: add new entry, deprecate
 `jQuery.unique()`

Fixes gh-731
Closes gh-736
---
 entries/jQuery.unique.xml     |  3 ++-
 entries/jQuery.uniqueSort.xml | 45 +++++++++++++++++++++++++++++++++++
 2 files changed, 47 insertions(+), 1 deletion(-)
 create mode 100644 entries/jQuery.uniqueSort.xml

diff --git a/entries/jQuery.unique.xml b/entries/jQuery.unique.xml
index 0546cfa7..b31ce023 100644
--- a/entries/jQuery.unique.xml
+++ b/entries/jQuery.unique.xml
@@ -1,5 +1,5 @@
 
-
+
   jQuery.unique()
   
     1.1.3
@@ -9,6 +9,7 @@
   
   Sorts an array of DOM elements, in place, with the duplicates removed. Note that this only works on arrays of DOM elements, not strings or numbers.
   
+    
          As of jQuery 3.0, this method is deprecated and just an alias of jQuery.uniqueSort(). Please use that method instead.
          
     
          The $.unique() function searches through an array of objects, sorting the array, and removing any duplicate nodes. A node is considered a duplicate if it is the exact same node as one already in the array; two different nodes with identical attributes are not considered to be duplicates. This function only works on plain JavaScript arrays of DOM elements, and is chiefly used internally by jQuery. You probably will never need to use it.
          
     
          As of jQuery 1.4 the results will always be returned in document order.
          
             
diff --git a/entries/jQuery.uniqueSort.xml b/entries/jQuery.uniqueSort.xml
new file mode 100644
index 00000000..0bccb245
--- /dev/null
+++ b/entries/jQuery.uniqueSort.xml
@@ -0,0 +1,45 @@
+
+
+  jQuery.uniqueSort()
+  
+    3.0
+    
+      The Array of DOM elements.
+    
+  
+  Sorts an array of DOM elements, in place, with the duplicates removed. Note that this only works on arrays of DOM elements, not strings or numbers.
+  
+    
          The $.uniqueSort() function searches through an array of objects, sorting the array, and removing any duplicate nodes. A node is considered a duplicate if it is the exact same node as one already in the array; two different nodes with identical attributes are not considered to be duplicates. This function only works on plain JavaScript arrays of DOM elements, and is chiefly used internally by jQuery. You probably will never need to use it.
          
+    
          Prior to jQuery 3.0, this method was called jQuery.unique().
          
+    
          As of jQuery 1.4 the results will always be returned in document order.
          
+            
+  
+    Removes any duplicate elements from the array of divs.
+    
+    
+    There are 6 divs in this document.
          
+
          
+
          
+
          
+
          
+
          
+]]>
+  
+  
+

From 4a2f3836f5a02501fc32d7c946b8ca35530cebe9 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 14 Dec 2015 02:04:06 +0000
Subject: [PATCH 368/699] Document that addClass and removeClass change the
 attribute

Fixes gh-814
Closes gh-846
---
 entries/addClass.xml    | 3 ++-
 entries/removeClass.xml | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/entries/addClass.xml b/entries/addClass.xml
index 69274708..5dd99ec5 100644
--- a/entries/addClass.xml
+++ b/entries/addClass.xml
@@ -19,7 +19,8 @@
   Adds the specified class(es) to each element in the set of matched elements.
   
     
          It's important to note that this method does not replace a class. It simply adds the class, appending it to any which may already be assigned to the elements.
          
-    
          The .addClass() method manipulates the className property of the selected elements, not the class attribute. Once the property is changed, it's the browser that updates the attribute accordingly. An implication of this behavior is that this method only works for documents with HTML DOM semantics (e.g., not pure XML documents).
          
+    
          Before jQuery version 1.12/2.2, the .addClass() method manipulated the className property of the selected elements, not the class attribute. Once the property was changed, it was the browser that updated the attribute accordingly. An implication of this behavior was that this method only worked for documents with HTML DOM semantics (e.g., not pure XML documents).
          
+    
          As of jQuery 1.12/2.2, this behavior is changed to improve the support for XML documents, including SVG. Starting from this version, the class attribute is used instead. So, .addClass() can be used on XML or SVG documents.
          
     
          More than one class may be added at a time, separated by a space, to the set of matched elements, like so:
          
     
          
 $( "p" ).addClass( "myClass yourClass" );
diff --git a/entries/removeClass.xml b/entries/removeClass.xml
index 3263e3a3..a35954e9 100644
--- a/entries/removeClass.xml
+++ b/entries/removeClass.xml
@@ -19,7 +19,8 @@
   Remove a single class, multiple classes, or all classes from each element in the set of matched elements.
   
     
          If a class name is included as a parameter, then only that class will be removed from the set of matched elements. If no class names are specified in the parameter, all classes will be removed.
          
-    
          The .removeClass() method manipulates the className property of the selected elements, not the class attribute. Once the property is changed, it's the browser that updates the attribute accordingly. This means that when the class attribute is updated and the last class name is removed, the browser may set the attribute's value to an empty string instead of removing the attribute completely. An implication of this behavior is that this method only works for documents with HTML DOM semantics (e.g., not pure XML documents).
          
+    
          Before jQuery version 1.12/2.2, the .removeClass() method manipulated the className property of the selected elements, not the class attribute. Once the property was changed, it was the browser that updated the attribute accordingly. This means that when the class attribute was updated and the last class name was removed, the browser might have set the attribute's value to an empty string instead of removing the attribute completely. An implication of this behavior was that this method only worked for documents with HTML DOM semantics (e.g., not pure XML documents).
          
+    
          As of jQuery 1.12/2.2, this behavior is changed to improve the support for XML documents, including SVG. Starting from this version, the class attribute is used instead. So, .removeClass() can be used on XML or SVG documents.
          
     
          More than one class may be removed at a time, separated by a space, from the set of matched elements, like so:
          
     
          
 $( "p" ).removeClass( "myClass yourClass" )

From 9ddc0201846c229e8cf9adb81a8b96b9c53e67bd Mon Sep 17 00:00:00 2001
From: Timmy Willison 
Date: Mon, 28 Dec 2015 11:09:49 -0500
Subject: [PATCH 369/699] Ajax: new signature for post/get was added in
 1.12/2.2

---
 entries/jQuery.get.xml  | 14 +++++++-------
 entries/jQuery.post.xml |  6 +++---
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/entries/jQuery.get.xml b/entries/jQuery.get.xml
index c3f18cac..a4e2bcdb 100644
--- a/entries/jQuery.get.xml
+++ b/entries/jQuery.get.xml
@@ -1,12 +1,6 @@
 
 
   jQuery.get()
-  
-    3.0
-    
-      A set of key/value pairs that configure the Ajax request. All properties except for url are optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) for a complete list of all settings. The type option will automatically be set to GET.
-    
-  
   
     1.0
     
@@ -24,7 +18,13 @@
       A callback function that is executed if the request succeeds. Required if dataType is provided, but you can use null or jQuery.noop as a placeholder.
     
     
-      The type of data expected from the server. Default: Intelligent Guess (xml, json, script, or html).
+      The type of data expected from the server. Default: Intelligent Guess (xml, json, script, text, html).
+    
+  
+  
+    1.12/2.2
+    
+      A set of key/value pairs that configure the Ajax request. All properties except for url are optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) for a complete list of all settings. The type option will automatically be set to GET.
     
   
   Load data from the server using a HTTP GET request.
diff --git a/entries/jQuery.post.xml b/entries/jQuery.post.xml
index 982b28c7..0ca6c139 100644
--- a/entries/jQuery.post.xml
+++ b/entries/jQuery.post.xml
@@ -12,9 +12,9 @@
       A plain object or string that is sent to the server with the request.
     
     
-      
+      
       
-              
+      
       A callback function that is executed if the request succeeds. Required if dataType is provided, but can be null in that case.
     
     
@@ -22,7 +22,7 @@
     
   
   
-    3.0
+    1.12/2.2
     
       A set of key/value pairs that configure the Ajax request. All properties except for url are optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) for a complete list of all settings. Type will automatically be set to POST.
     

From 82c1f4c57d31142a4851d50cad4a0233a8c27036 Mon Sep 17 00:00:00 2001
From: Timmy Willison 
Date: Mon, 28 Dec 2015 11:10:25 -0500
Subject: [PATCH 370/699] Uniquesort: added in 1.12/2.2

---
 entries/jQuery.uniqueSort.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.uniqueSort.xml b/entries/jQuery.uniqueSort.xml
index 0bccb245..a1927bda 100644
--- a/entries/jQuery.uniqueSort.xml
+++ b/entries/jQuery.uniqueSort.xml
@@ -2,7 +2,7 @@
 
   jQuery.uniqueSort()
   
-    3.0
+    1.12/2.2
     
       The Array of DOM elements.
     

From cc0604bb4d075031d083ca3fd27c0a0aac2df80f Mon Sep 17 00:00:00 2001
From: Timmy Willison 
Date: Thu, 7 Jan 2016 16:01:45 -0500
Subject: [PATCH 371/699] jQuery.htmlPrefilter: add new entry

Fixes gh-727
Close gh-858
---
 entries/jQuery.htmlPrefilter.xml | 77 ++++++++++++++++++++++++++++++++
 1 file changed, 77 insertions(+)
 create mode 100644 entries/jQuery.htmlPrefilter.xml

diff --git a/entries/jQuery.htmlPrefilter.xml b/entries/jQuery.htmlPrefilter.xml
new file mode 100644
index 00000000..3682ed5b
--- /dev/null
+++ b/entries/jQuery.htmlPrefilter.xml
@@ -0,0 +1,77 @@
+
+
+  jQuery.htmlPrefilter()
+  Modify and filter HTML strings passed through jQuery manipulation methods.
+  
+    1.12/2.2
+    
+      The HTML string on which to operate.
+    
+  
+  
+    
          This method rarely needs to be called directly. Instead, use it as an entry point to modify existing jQuery manipulation methods. For instance, to remove all <del> tags from incoming HTML strings, do this:
          
+    
          
+var htmlPrefilter = $.htmlPrefilter,
+  rdel = /<(del)(?=[\s>])[\w\W]*?<\/\1\s*>/gi;
+
+$.htmlPrefilter = function( html ) {
+  return htmlPrefilter.call( this, html ).replace( rdel, "" );
+};
+    
          
+    
          This function can also be overwritten in order to bypass certain edge case issues. The default htmlPrefilter function in jQuery will greedily ensure that all tags are XHTML-compliant. This includes anything that looks like an HTML tag, but is actually within a string (e.g. 
          <a title="<div />"><>
          ). The jQuery.htmlPrefilter() function can be used to bypass this:
          
+    
          
+$.htmlPrefilter = function( html ) {
+  // Return HTML strings unchanged
+  return html;
+};
+    
          
+    
          However, while the above fix is short and simple, it puts the burden on you to ensure XHTML-compliant tags in any HTML strings. A more thorough fix for this issue would be this:
          
+    
          
+var panything = "[\\w\\W]*?",
+
+  // Whitespace
+  // https://html.spec.whatwg.org/multipage/infrastructure.html#space-character
+  pspace = "[\\x20\\t\\r\\n\\f]",
+
+  // End of tag name (whitespace or greater-than)
+  pnameEnd = pspace.replace( "]", ">]" ),
+
+  // Tag name (a leading letter, then almost anything)
+  // https://html.spec.whatwg.org/multipage/syntax.html#tag-open-state
+  // https://html.spec.whatwg.org/multipage/syntax.html#tag-name-state
+  pname = "[a-z]" + pnameEnd.replace( "[", "[^/\\0" ) + "*",
+
+  // Void element (end tag prohibited)
+  // https://html.spec.whatwg.org/multipage/syntax.html#void-elements
+  pvoidName = "(?:area|base|br|col|embed|hr|img|input|keygen|link|menuitem|meta|param|" +
+    "source|track|wbr)(?=" + pnameEnd + ")",
+
+  // Attributes (double-quoted value, single-quoted value, unquoted value, or no value)
+  // https://html.spec.whatwg.org/multipage/syntax.html#attributes-2
+  pattrs = "(?:" + pspace + "+[^\\0-\\x20\\x7f-\\x9f=\"'/>]+(?:" + pspace + "*=" + pspace +
+    "*(?:\"" + panything + "\"|'" + panything + "'|" +
+    pnameEnd.replace( "[", "[^" ) + "*(?!/)" +
+    ")|))*" + pspace + "*",
+
+  // Trailing content of a close tag
+  pcloseTail = "(?:" + pspace + panything + "|)",
+
+  rspecialHtml = new RegExp(
+    // Non-void element that self-closes: $1–$5
+    "(<)(?!" + pvoidName + ")(" + pname + ")(" + pattrs + ")(\\/)(>)|" +
+      // No-innerHTML container (element, comment, or CDATA): $6
+      "(<(script|style|textarea)" + pattrs + ">" + panything + "<\\/\\7" + pcloseTail + ">|" +
+      "<!--" + panything + "--)",
+    "gi"
+  ),
+
+  // "<"; element name; attributes; ">"; "<"; "/"; element name; ">"; no-innerHTML container
+  pspecialReplacement = "$1$2$3$5$1$4$2$5$6";
+
+$.htmlPrefilter = function( html ) {
+  return ( html + "" ).replace( rspecialHtml, pspecialReplacement );
+};
+    
          
+            
+  
+          

From af5264bdfd64581ba5f2a05e906d6178ce5977d5 Mon Sep 17 00:00:00 2001
From: Matthew Flaschen 
Date: Fri, 15 Jan 2016 14:23:27 -0800
Subject: [PATCH 372/699] jQuery.when: Returns a resolved promise for no
 arguments

Closes gh-868
---
 entries/jQuery.when.xml | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/entries/jQuery.when.xml b/entries/jQuery.when.xml
index bcb12dc1..09c8393e 100644
--- a/entries/jQuery.when.xml
+++ b/entries/jQuery.when.xml
@@ -4,11 +4,12 @@
   
     1.5
     
-      One or more Deferred objects, or plain JavaScript objects.
+      Zero or more Deferred objects, or plain JavaScript objects.
     
   
-  Provides a way to execute callback functions based on one or more objects, usually Deferred objects that represent asynchronous events.
+  Provides a way to execute callback functions based on zero or more objects, usually Deferred objects that represent asynchronous events.
   
+    
          If no arguments are passed to jQuery.when(), it will return a resolved Promise.
          
     
          If a single Deferred is passed to jQuery.when(), its Promise object (a subset of the Deferred methods) is returned by the method. Additional methods of the Promise object can be called to attach callbacks, such as deferred.then. When the Deferred is resolved or rejected, usually by the code that created the Deferred originally, the appropriate callbacks will be called. For example, the jqXHR object returned by jQuery.ajax() is a Promise-compatible object and can be used this way:
          
     
          
 $.when( $.ajax( "test.aspx" ) ).then(function( data, textStatus, jqXHR ) {

From 4ee55d3af232574735a8f2433497e784c5fb3a8a Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sat, 16 Jan 2016 17:01:08 +0000
Subject: [PATCH 373/699] jQuery.css: Clarified that currentStyle and
 runtimeStyle belong to IE9-

Fixes gh-867
Closes gh-869
---
 entries/css.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/css.xml b/entries/css.xml
index 8fe89b20..0658d754 100644
--- a/entries/css.xml
+++ b/entries/css.xml
@@ -17,7 +17,7 @@
     
     Get the computed style properties for the first element in the set of matched elements.
     
-      
          The .css() method is a convenient way to get a computed style property from the first matched element, especially in light of the different ways browsers access most of those properties (the getComputedStyle() method in standards-based browsers versus the currentStyle and runtimeStyle properties in Internet Explorer) and the different terms browsers use for certain properties. For example, Internet Explorer's DOM implementation refers to the float property as styleFloat, while W3C standards-compliant browsers refer to it as cssFloat. For consistency, you can simply use "float", and jQuery will translate it to the correct value for each browser.
          
+      
          The .css() method is a convenient way to get a computed style property from the first matched element, especially in light of the different ways browsers access most of those properties (the getComputedStyle() method in standards-based browsers versus the currentStyle and runtimeStyle properties in Internet Explorer prior to version 9) and the different terms browsers use for certain properties. For example, Internet Explorer's DOM implementation refers to the float property as styleFloat, while W3C standards-compliant browsers refer to it as cssFloat. For consistency, you can simply use "float", and jQuery will translate it to the correct value for each browser.
          
       
          Also, jQuery can equally interpret the CSS and DOM formatting of multiple-word properties. For example, jQuery understands and returns the correct value for both .css( "background-color" ) and .css( "backgroundColor" ). This means mixed case has a special meaning, .css( "WiDtH" ) won't do the same as .css( "width" ), for example.
          
 	  
          Note that the computed style of an element may not be the same as the value specified for that element in a style sheet. For example, computed styles of dimensions are almost always pixels, but they can be specified as em, ex, px or % in a style sheet. Different browsers may return CSS color values that are logically but not textually equal, e.g., #FFF, #ffffff, and rgb(255,255,255).
          
       
          Retrieval of shorthand CSS properties (e.g., margin, background, border), although functional with some browsers, is not guaranteed. For example, if you want to retrieve the rendered border-width, use: $( elem ).css( "borderTopWidth" ), $( elem ).css( "borderBottomWidth" ), and so on.
          

From 1fd8912c31a18307627e25d9bd55e87e2844f934 Mon Sep 17 00:00:00 2001
From: Vihan Bhargava 
Date: Sat, 16 Jan 2016 08:23:38 -0800
Subject: [PATCH 374/699] Types: Clarified where to use parenthesis in numbers
 to strings convertion

Fixes gh-870
---
 pages/Types.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pages/Types.html b/pages/Types.html
index 4890df38..4dc65e34 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -205,7 +205,7 @@ 
           Parsing Numbers 
          
 parseFloat( "10.10" ) = 10.1
 
          
 
           Numbers to Strings 
          
-
          When appending numbers to string, the result is always a string. The operator is the same, so be careful: If you want to add numbers and then append them to a string, put parentheses around them:
+
          When appending numbers to string, the result is always a string. The operator is the same, so be careful: If you want to add numbers and then append them to a string, put parentheses around the numbers:
 
          
 
          "" + 1 + 2; // "12"
 "" + ( 1 + 2 ); // "3"

From d75ba72649954e6d1a92bc8c7cf5eff85c8e4069 Mon Sep 17 00:00:00 2001
From: Vihan Bhargava 
Date: Sat, 16 Jan 2016 08:30:23 -0800
Subject: [PATCH 375/699] Types: Changed occurrences of == to ===

Fixes gh-871
Closes gh-854
---
 pages/Types.html | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/pages/Types.html b/pages/Types.html
index 4dc65e34..3ab98753 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -234,11 +234,11 @@ 
           NaN and Infinity 
          
 
          
 
          Note that NaN compares in a strange way:
 
          
-
          NaN == NaN // false (!)
+
          NaN === NaN // false (!)
 
          
 
          But:
 
          
-
          Infinity == Infinity // true
+
          Infinity === Infinity // true
 
          
 
           Integer 
          
 
          An integer is a plain Number type, but whenever explicitly mentioned, indicates that a non-floating-point number is expected.
@@ -320,7 +320,7 @@ 
           Prototype 
          
 
          var form = $("#myform");
 console.log( form.clearForm ); // undefined
 
-// jQuery.fn == jQuery.prototype
+// jQuery.fn === jQuery.prototype
 jQuery.fn.clearForm = function() {
   return this.find( ":input" ).each(function() {
     this.value = "";
@@ -477,7 +477,7 @@ 
           Arguments 
          
 
          The arguments object also has a callee property, which refers to the function you're inside of. For instance:
 
          
 
          var awesome = function() { return arguments.callee; }
-awesome() == awesome // true
+awesome() === awesome // true
 
          
 
           Context, Call and Apply 
          
 
          In JavaScript, the variable "this" always refers to the current context. By default, "this" refers to the window object. Within a function this context can change, depending on how the function is called.

From fc260f6ecda27e5ded15114ea75023d1dae750b2 Mon Sep 17 00:00:00 2001
From: Richard Gibson 
Date: Mon, 11 Jan 2016 23:50:26 -0500
Subject: [PATCH 376/699] jQuery.isNumber: Clarify purpose and behavior

Fixes gh-862
Closes gh-864
Ref jquery/jquery/issues/2781
---
 entries/jQuery.isNumeric.xml | 39 ++++++++++++++++++++----------------
 1 file changed, 22 insertions(+), 17 deletions(-)

diff --git a/entries/jQuery.isNumeric.xml b/entries/jQuery.isNumeric.xml
index c6ec81e8..7a4e7f6c 100644
--- a/entries/jQuery.isNumeric.xml
+++ b/entries/jQuery.isNumeric.xml
@@ -1,7 +1,7 @@
 
 
   jQuery.isNumeric()
-  Determines whether its argument is a number.
+  Determines whether its argument represents a JavaScript number.
   
     1.7
     
@@ -9,26 +9,31 @@
     
   
   
-    
          The $.isNumeric() method checks whether its argument represents a numeric value. If so, it returns true. Otherwise it returns false. The argument can be of any type.
          
+    
          The $.isNumeric() method checks whether a value is a finite number, or would be cast to one by Number. If so, it returns true. Otherwise it returns false. The argument can be of any type.
          
   
   
     Sample return values of $.isNumeric with various inputs.
     
   
   

From 6eece50ee318333de81e834475d5cd48f784799b Mon Sep 17 00:00:00 2001
From: David Bazile 
Date: Wed, 23 Sep 2015 12:46:31 -0400
Subject: [PATCH 377/699] jQuery.ajax: Added example for the accepts property

Closes gh-811
---
 entries/jQuery.ajax.xml | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index 81e3e42c..65f5b544 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -16,7 +16,27 @@
     
       A set of key/value pairs that configure the Ajax request. All settings are optional. A default can be set for any option with $.ajaxSetup().
       
-        The content type sent in the request header that tells the server what kind of response it will accept in return.
+        A set of key/value pairs that map a given dataType to its MIME type, which gets sent in the Accept request header. This header tells the server what kind of response it will accept in return. For example, the following defines a custom type mycustomtype to be sent with the request:
+          
          
+$.ajax({
+  accepts: {
+    mycustomtype: 'application/x-some-custom-type'
+  },
+
+  // Instructions for how to deserialize a `mycustomtype`
+  converters: {
+    'text mycustomtype': function(result) {
+      // Do Stuff
+      return newresult;
+    }
+  },
+
+  // Expect a `mycustomtype` back from server
+  dataType: 'mycustomtype'
+});
+          
          
+          Note: You will need to specify a complementary entry for this type in converters for this to work properly.
+                  
                 
       
         By default, all requests are sent asynchronously (i.e. this is set to true by default). If you need synchronous requests, set this option to false. Cross-domain requests and dataType: "jsonp" requests do not support synchronous operation. Note that synchronous requests may temporarily lock the browser, disabling any actions while the request is active. As of jQuery 1.8, the use of async: false with jqXHR ($.Deferred) is deprecated; you must use the success/error/complete callback options instead of the corresponding methods of the jqXHR object such as jqXHR.done() or the deprecated jqXHR.success().

From 674b7514dd46be08c75f8e38d60a90a724729159 Mon Sep 17 00:00:00 2001
From: Callum Kerr 
Date: Mon, 18 Jan 2016 12:03:05 -0700
Subject: [PATCH 378/699] jQuery.offset: Add a link to .position()

Closes gh-875
---
 entries/offset.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/offset.xml b/entries/offset.xml
index 9b1a0093..e626ac5a 100644
--- a/entries/offset.xml
+++ b/entries/offset.xml
@@ -8,7 +8,7 @@
     
     Get the current coordinates of the first element in the set of matched elements, relative to the document.
     
-      
          The .offset() method allows us to retrieve the current position of an element relative to the document. Contrast this with .position(), which retrieves the current position relative to the offset parent. When positioning a new element on top of an existing one for global manipulation (in particular, for implementing drag-and-drop), .offset() is more useful.
          
+      
          The .offset() method allows us to retrieve the current position of an element relative to the document. Contrast this with .position(), which retrieves the current position relative to the offset parent. When positioning a new element on top of an existing one for global manipulation (in particular, for implementing drag-and-drop), .offset() is more useful.
          
       
          .offset() returns an object containing the properties top and left.
          
       
          
         
          Note: jQuery does not support getting the offset coordinates of hidden elements or accounting for borders, margins, or padding set on the body element.
          

From 5b90d81484b50366ca27510ba032117b606060b1 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Thu, 11 Feb 2016 00:20:54 +0000
Subject: [PATCH 379/699] Noted support of SVG documents for class methods

Fixes gh-885
Closes gh-886
---
 entries/hasClass.xml    | 1 +
 entries/toggleClass.xml | 2 ++
 2 files changed, 3 insertions(+)

diff --git a/entries/hasClass.xml b/entries/hasClass.xml
index 37b52f79..ddf5d893 100644
--- a/entries/hasClass.xml
+++ b/entries/hasClass.xml
@@ -25,6 +25,7 @@ $( "#mydiv" ).hasClass( "bar" )
     
          
 $( "#mydiv" ).hasClass( "quux" )
     
          
+    
          As of jQuery 1.12/2.2, this method supports XML documents, including SVG.
          
   
   
     Looks for the paragraph that contains 'selected' as a class.
diff --git a/entries/toggleClass.xml b/entries/toggleClass.xml
index 1d034d86..f14cb8ed 100644
--- a/entries/toggleClass.xml
+++ b/entries/toggleClass.xml
@@ -37,6 +37,8 @@
   
   Add or remove one or more classes from each element in the set of matched elements, depending on either the class's presence or the value of the state argument.
   
+    
          Before jQuery version 1.12/2.2, the .toggleClass() method manipulated the className property of the selected elements, not the class attribute. Once the property was changed, it was the browser that updated the attribute accordingly. An implication of this behavior was that this method only worked for documents with HTML DOM semantics (e.g., not pure XML documents).
          
+    
          As of jQuery 1.12/2.2, this behavior is changed to improve the support for XML documents, including SVG. Starting from this version, the class attribute is used instead. So, .toggleClass() can be used on XML or SVG documents.
          
     
          This method takes one or more class names as its parameter. In the first version, if an element in the matched set of elements already has the class, then it is removed; if an element does not have the class, then it is added. For example, we can apply .toggleClass() to a simple <div>: 
          
     
          
 <div class="tumble">Some text.</div>

From b985c8eb6a33980366f6ddc73b8205e74229d372 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Thu, 11 Feb 2016 00:24:19 +0000
Subject: [PATCH 380/699] stop: Specified default values

Closes gh-887
---
 entries/stop.xml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/entries/stop.xml b/entries/stop.xml
index ce38bd01..b66c0bcc 100644
--- a/entries/stop.xml
+++ b/entries/stop.xml
@@ -4,22 +4,22 @@
   Stop the currently-running animation on the matched elements.
   
     1.2
-    
+    
       A Boolean indicating whether to remove queued animation as well. Defaults to false.
     
-    
+    
       A Boolean indicating whether to complete the current animation immediately. Defaults to false.
     
   
   
     1.7
-    
+    
       The name of the queue in which to stop animations.
     
     
       A Boolean indicating whether to remove queued animation as well. Defaults to false.
     
-    
+    
       A Boolean indicating whether to complete the current animation immediately. Defaults to false.
     
   

From fb8d4da0b4002833ec2363a812e90ac019b07b05 Mon Sep 17 00:00:00 2001
From: Ian Kemp 
Date: Wed, 10 Feb 2016 12:47:41 +0200
Subject: [PATCH 381/699] Specified defaults for outerWidth and outerHeight

Fixes gh-882
Closes gh-883
---
 entries/outerHeight.xml | 2 +-
 entries/outerWidth.xml  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/outerHeight.xml b/entries/outerHeight.xml
index 95df451f..ab497404 100644
--- a/entries/outerHeight.xml
+++ b/entries/outerHeight.xml
@@ -5,7 +5,7 @@
   .outerHeight()
   
     1.2.6
-    
+    
       A Boolean indicating whether to include the element's margin in the calculation.
     
   
diff --git a/entries/outerWidth.xml b/entries/outerWidth.xml
index 24861c8e..64687fb9 100644
--- a/entries/outerWidth.xml
+++ b/entries/outerWidth.xml
@@ -5,7 +5,7 @@
   .outerWidth()
   
     1.2.6
-    
+    
       A Boolean indicating whether to include the element's margin in the calculation.
     
   

From 3a5b4cb769b43d379f1900cd8b089d855e723dee Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 18 Jan 2016 00:33:20 +0000
Subject: [PATCH 382/699] jQuery.closest: Removed reference to deprecated
 context property

Fixes gh-857
Closes gh-874
---
 entries/closest.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/closest.xml b/entries/closest.xml
index 5f1bb2b4..14c10a80 100644
--- a/entries/closest.xml
+++ b/entries/closest.xml
@@ -14,7 +14,7 @@
         A string containing a selector expression to match elements against.
       
       
-        A DOM element within which a matching element may be found. If no context is passed in then the context of the jQuery set will be used instead.
+        A DOM element within which a matching element may be found.
       
     
     
@@ -166,7 +166,7 @@ $( document ).on( "click", function( event ) {
         An array or string containing a selector expression to match elements against (can also be a jQuery object).
       
       
-        A DOM element within which a matching element may be found. If no context is passed in then the context of the jQuery set will be used instead.
+        A DOM element within which a matching element may be found.
       
     
     Get an array of all the elements and selectors matched against the current element up through the DOM tree.

From 5f397052be4613689274b6a2db185225443872ef Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sat, 16 Jan 2016 17:39:22 +0000
Subject: [PATCH 383/699] jQuery.css: Specified that important declarations are
 ignored

Fixes gh-866
Closes gh-872
---
 entries/css.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/entries/css.xml b/entries/css.xml
index 0658d754..34fc7237 100644
--- a/entries/css.xml
+++ b/entries/css.xml
@@ -146,6 +146,7 @@ $( "div" ).click(function() {
       
          Also, jQuery can equally interpret the CSS and DOM formatting of multiple-word properties. For example, jQuery understands and returns the correct value for both .css({ "background-color": "#ffe", "border-left": "5px solid #ccc" }) and .css({backgroundColor: "#ffe", borderLeft: "5px solid #ccc" }). Notice that with the DOM notation, quotation marks around the property names are optional, but with CSS notation they're required due to the hyphen in the name.
          
       
          When a number is passed as the value, jQuery will convert it to a string and add px to the end of that string. If the property requires units other than px, convert the value to a string and add the appropriate units before calling the method.
          
       
          When using .css() as a setter, jQuery modifies the element's style property. For example,  $( "#mydiv" ).css( "color", "green" ) is equivalent to document.getElementById( "mydiv" ).style.color = "green". Setting the value of a style property to an empty string — e.g. $( "#mydiv" ).css( "color", "" ) — removes that property from an element if it has already been directly applied, whether in the HTML style attribute, through jQuery's .css() method, or through direct DOM manipulation of the style property. As a consequence, the element's style for that property will be restored to whatever value was applied. So, this method can be used to cancel any style modification you have previously performed. It does not, however, remove a style that has been applied with a CSS rule in a stylesheet or <style> element. Warning: one notable exception is that, for IE 8 and below, removing a shorthand property such as border or background will remove that style entirely from the element, regardless of what is set in a stylesheet or <style> element.
          
+      
          Note: .css() ignores !important declarations. So, the statement $( "p" ).css( "color", "red !important" ) does not turn the color of all paragraphs in the page to red. It's strongly advised to use classes instead; otherwise use a jQuery plugin.
          
       
          As of jQuery 1.8, the .css() setter will automatically take care of prefixing the property name. For example, take .css( "user-select", "none" ) in Chrome/Safari will set it as -webkit-user-select, Firefox will use -moz-user-select, and IE10 will use -ms-user-select.
          
       
          As of jQuery 1.6, .css() accepts relative values similar to .animate(). Relative values are a string starting with += or -= to increment or decrement the current value. For example, if an element's padding-left was 10px, .css( "padding-left", "+=15" ) would result in a total padding-left of 25px.
          
       
          As of jQuery 1.4, .css() allows us to pass a function as the property value:
          

From 6142f8693cba08be3372d71f9b75cf80190cbb24 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 18 Jan 2016 00:11:06 +0000
Subject: [PATCH 384/699] jQuery.prev: Clarified its behavior

Fixes gh-861
Closes gh-873
---
 entries/prev.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/prev.xml b/entries/prev.xml
index bfa4fa2f..7ee31594 100644
--- a/entries/prev.xml
+++ b/entries/prev.xml
@@ -7,7 +7,7 @@
       A string containing a selector expression to match elements against.
     
   
-  Get the immediately preceding sibling of each element in the set of matched elements, optionally filtered by a selector.
+  Get the immediately preceding sibling of each element in the set of matched elements. If a selector is provided, it retrieves the previous sibling only if it matches that selector.
   
     
          Given a jQuery object that represents a set of DOM elements, the .prev() method searches for the predecessor of each of these elements in the DOM tree and constructs a new jQuery object from the matching elements.
          
     
          The method optionally accepts a selector expression of the same type that can be passed to the $() function. If the selector is supplied, the preceding element will be filtered by testing whether it match the selector.
          

From a6eecc290676b5301c58e327ce52060555767f4b Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 14 Feb 2016 22:03:36 +0000
Subject: [PATCH 385/699] jQuery.hasData: Clarified when it returns false

Fixes gh-889
Closes gh-891
---
 entries/jQuery.hasData.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.hasData.xml b/entries/jQuery.hasData.xml
index af081d41..ece74c75 100644
--- a/entries/jQuery.hasData.xml
+++ b/entries/jQuery.hasData.xml
@@ -9,7 +9,7 @@
   
   Determine whether an element has any jQuery data associated with it.
   
-    
          The jQuery.hasData() method provides a way to determine if an element currently has any values that were set using jQuery.data(). If no data is associated with an element (there is no data object at all or the data object is empty), the method returns false; otherwise it returns true.
          
+    
          The jQuery.hasData() method provides a way to determine if an element currently has any values that were set using jQuery.data(). If there is no data object associated with an element, the method returns false; otherwise it returns true.
          
     
          The primary advantage of jQuery.hasData(element) is that it does not create and associate a data object with the element if none currently exists. In contrast, jQuery.data(element) always returns a data object to the caller, creating one if no data object previously existed.
 
          
     
          Note that jQuery's event system uses the jQuery data API to store event handlers. Therefore, binding an event to an element using .on(), .bind(), .live(), .delegate(), or one of the shorthand event methods also associates a data object with that element.

From 5e6a5a00cbd4ea9fe905a8fb90619b7741d0f808 Mon Sep 17 00:00:00 2001
From: Vitaly Zdanevich 
Date: Fri, 5 Feb 2016 19:34:55 +0300
Subject: [PATCH 386/699] jQuery.on: Added example with multiple events

Closes gh-888
---
 entries/on.xml | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/entries/on.xml b/entries/on.xml
index 34d14f4e..18a17cae 100644
--- a/entries/on.xml
+++ b/entries/on.xml
@@ -265,11 +265,19 @@ $( "body" ).on( "click", "p", function() {
 ]]>
   
   
-    Cancel a link's default action using the .preventDefault() method.
+    Cancel a link's default action using the .preventDefault() method:
     
+  
+  
+    Attach multiple events—one on mouseenter and one on mouseleave to the same element:
+    
   
   

From a465962f7b40c719c763d5f770e8eb36b76600df Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Tue, 16 Feb 2016 21:11:09 +0000
Subject: [PATCH 387/699] Clarified when the keydown event is fired

Fixes gh-876
Closes gh-892
---
 entries/keydown.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/keydown.xml b/entries/keydown.xml
index 50f83b57..f21ae4e0 100644
--- a/entries/keydown.xml
+++ b/entries/keydown.xml
@@ -24,7 +24,7 @@
   Bind an event handler to the "keydown" JavaScript event, or trigger that event on an element.
   
     
          This method is a shortcut for .on( "keydown", handler ) in the first and second variations, and .trigger( "keydown" ) in the third.
          
-    
          The keydown event is sent to an element when the user first presses a key on the keyboard. It can be attached to any element, but the event is only sent to the element that has the focus. Focusable elements can vary between browsers, but form elements can always get focus so are reasonable candidates for this event type.
          
+    
          The keydown event is sent to an element when the user presses a key on the keyboard. If the key is kept pressed, the event is sent every time the operating system repeats the key. It can be attached to any element, but the event is only sent to the element that has the focus. Focusable elements can vary between browsers, but form elements can always get focus so are reasonable candidates for this event type.
          
     
          For example, consider the HTML:
          
     
          
 <form>

From 5a9497eb0b6a99cdd579c5d68bffd1551ac90ea7 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Wed, 17 Feb 2016 23:28:02 +0000
Subject: [PATCH 388/699] 1.12.0

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 25fab7fc..5fb4ca99 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.11.117",
+  "version": "1.12.0",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 01824acfe979e7507952086b947015bf42840143 Mon Sep 17 00:00:00 2001
From: Jeromy French 
Date: Tue, 12 May 2015 17:47:07 -0400
Subject: [PATCH 389/699] checked selector: Added link :selected

Fixes gh-558
Closes gh-740
---
 entries/checked-selector.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/entries/checked-selector.xml b/entries/checked-selector.xml
index ebf96c2b..5d49ebcd 100644
--- a/entries/checked-selector.xml
+++ b/entries/checked-selector.xml
@@ -7,7 +7,8 @@
   
   Matches all elements that are checked or selected.
   
-    
          The :checked selector works for checkboxes, radio buttons, and select elements. For select elements only, use the :selected selector.
          
+    
          The :checked selector works for checkboxes, radio buttons, and options of select elements.
          
+    
          To retrieve only the selected options of select elements, use the :selected selector.
          
             
   
     Determine how many input elements are checked.

From 28a7fe628643e15470bc18d1657d187c865a581b Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Wed, 24 Feb 2016 23:47:33 +0000
Subject: [PATCH 390/699] First selector: Clarified behavior

Fixes gh-894
Closes gh-895
---
 entries/first-selector.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/first-selector.xml b/entries/first-selector.xml
index a0371809..0676d85f 100644
--- a/entries/first-selector.xml
+++ b/entries/first-selector.xml
@@ -5,7 +5,7 @@
   
     1.0
   
-  Selects the first matched element.
+  Selects the first matched DOM element.
   
     
          The :first pseudo-class is equivalent to :eq( 0 ). It could also be written as :lt( 1 ). While this matches only a single element, :first-child can match more than one: One for each parent.
          
             

From f606cecd6ad1a6ca524787b80c19af72700f5330 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Thu, 25 Feb 2016 23:33:18 +0000
Subject: [PATCH 391/699] Added note about support for SVG documents

Fixes gh-884
Closes gh-896
---
 entries/append.xml       | 3 ++-
 entries/appendTo.xml     | 1 +
 entries/attr.xml         | 1 +
 entries/filter.xml       | 1 +
 entries/find.xml         | 1 +
 entries/insertAfter.xml  | 1 +
 entries/insertBefore.xml | 1 +
 entries/prepend.xml      | 1 +
 entries/prependTo.xml    | 1 +
 entries/removeAttr.xml   | 1 +
 notes.xsl                | 3 +++
 11 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/entries/append.xml b/entries/append.xml
index c1de1420..07acacf1 100644
--- a/entries/append.xml
+++ b/entries/append.xml
@@ -33,7 +33,7 @@
   
   Insert content, specified by the parameter, to the end of each element in the set of matched elements.
   
-    
          The .append() method inserts the  specified content as the last child of each element in the jQuery collection (To insert it as the first child, use .prepend()). 
          
+    
          The .append() method inserts the  specified content as the last child of each element in the jQuery collection (To insert it as the first child, use .prepend()).
          
     
          The .append() and .appendTo() methods perform the same task. The major difference is in the syntax-specifically, in the placement of the content and target. With .append(), the selector expression preceding the method is the container into which the content is inserted. With .appendTo(), on the other hand, the content precedes the method, either as a selector expression or as markup created on the fly, and it is inserted into the target container.
          
     
          Consider the following HTML:
          
     
          
@@ -87,6 +87,7 @@ $( "body" ).append( $newdiv1, [ newdiv2, existingdiv1 ] );
     
          Since .append() can accept any number of additional arguments, the same result can be achieved by passing in the three <div>s as three separate arguments, like so: $('body').append( $newdiv1, newdiv2, existingdiv1 ). The type and number of arguments will largely depend on how you collect the elements in your code.
          
   
   
+  
   
     Appends some HTML to all paragraphs.
     Before jQuery 1.9, the append-to-single-element case did not create a new set, but instead returned the original set which made it difficult to use the .end() method reliably when being used with an unknown number of elements.
          
   
   
+  
   
     Append all spans to the element with the ID "foo" (Check append() documentation for more examples)
     Note: Attribute values are strings with the exception of a few attributes such as value and tabindex.
          
       
          
       
          As of jQuery 1.6, the .attr() method returns undefined for attributes that have not been set. To retrieve and change DOM properties such as the checked, selected, or disabled state of form elements, use the .prop() method.
          
+      
 
       
          Attributes vs. Properties
          
       
          The difference between attributes and properties can be important in specific situations. Before jQuery 1.6, the .attr() method sometimes took property values into account when retrieving some attributes, which could cause inconsistent behavior. As of jQuery 1.6, the .prop() method provides a way to explicitly retrieve property values, while .attr() retrieves attributes.
          
diff --git a/entries/filter.xml b/entries/filter.xml
index 440b4277..831672aa 100644
--- a/entries/filter.xml
+++ b/entries/filter.xml
@@ -76,6 +76,7 @@ $( "li" )
     .css( "background-color", "red" );
     
          
     
          This alteration to the code will cause the third and sixth list items to be highlighted, as it uses the modulus operator (%) to select every item with an index value that, when divided by 3, has a remainder of 2.
          
+    
   
   
     Change the color of all divs; then add a border to those with a "middle" class.
diff --git a/entries/find.xml b/entries/find.xml
index b6a82654..0a080a05 100644
--- a/entries/find.xml
+++ b/entries/find.xml
@@ -63,6 +63,7 @@ var item1 = $( "li.item-1" )[ 0 ];
 $( "li.item-ii" ).find( item1 ).css( "background-color", "red" );
     
          
     
          The result of this call would be a red background on item 1.
          
+    
   
   
     Starts with all paragraphs and searches for descendant span elements, same as $( "p span" )
diff --git a/entries/insertAfter.xml b/entries/insertAfter.xml
index 7e3435f8..9065d305 100644
--- a/entries/insertAfter.xml
+++ b/entries/insertAfter.xml
@@ -53,6 +53,7 @@ $( "h2" ).insertAfter( $( ".container" ) );
     
          Before jQuery 1.9, the append-to-single-element case did not create a new set, but instead returned the original set which made it difficult to use the .end() method reliably when being used with an unknown number of elements.
          
   
   
+  
   
     Insert all paragraphs after an element with id of "foo". Same as $( "#foo" ).after( "p" )
     Before jQuery 1.9, the append-to-single-element case did not create a new set, but instead returned the original set which made it difficult to use the .end() method reliably when being used with an unknown number of elements.
          
   
   
+  
   
     Insert all paragraphs before an element with id of "foo". Same as $( "#foo" ).before( "p" )
     Since .prepend() can accept any number of additional arguments, the same result can be achieved by passing in the three <div>s as three separate arguments, like so: $( "body" ).prepend( $newdiv1, newdiv2, existingdiv1 ). The type and number of arguments will largely depend on how you collect the elements in your code.
          
   
   
+  
   
     Prepends some HTML to all paragraphs.
     If there is more than one target element, however, cloned copies of the inserted element will be created for each target except the last.
          
   
   
+  
   
     Prepend all spans to the element with the ID "foo" (Check .prepend() documentation for more examples)
     
          
+    
             
   
     Clicking the button changes the title of the input next to it. Move the mouse pointer over the text input to see the effect of adding and removing the title attribute.
diff --git a/notes.xsl b/notes.xsl
index eb5a9c61..50f94fc0 100644
--- a/notes.xsl
+++ b/notes.xsl
@@ -70,6 +70,9 @@
 		
 			As of jQuery 1.9, all the handlers for the jQuery global Ajax events, including those added with the  method, must be attached to document.
 		
+		
+			jQuery doesn't officially support SVG. Using jQuery methods on SVG documents, unless explicitly documented for that method, might cause unexpected behaviors. Examples of methods that support SVG as of jQuery 3.0 are addClass and removeClass.
+		
 	
 
 

From 6cbf6b787db3631a4e797bd0c5cfb82046db2f82 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Fri, 26 Feb 2016 22:03:41 +0000
Subject: [PATCH 392/699] 1.12.1

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 5fb4ca99..d8865dc2 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.0",
+  "version": "1.12.1",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 075661471fc1b49c52cd27afe5d0af04c0177f21 Mon Sep 17 00:00:00 2001
From: Richard Gibson 
Date: Thu, 3 Mar 2016 15:23:41 -0500
Subject: [PATCH 393/699] val: Document empty-context behavior

Fixes gh-893
Ref https://github.com/jquery/jquery/issues/2319
Closes gh-897
---
 entries/val.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/val.xml b/entries/val.xml
index 52f2023f..2c78771f 100644
--- a/entries/val.xml
+++ b/entries/val.xml
@@ -11,7 +11,7 @@
               
     Get the current value of the first element in the set of matched elements.
     
-      
          The .val() method is primarily used to get the values of form elements such as input, select and textarea. In the case of select elements, it returns null when no option is selected and an array containing the value of each selected option when there is at least one and it is possible to select more because the multiple attribute is present.
          
+      
          The .val() method is primarily used to get the values of form elements such as input, select and textarea. When the first element in the collection is a select-multiple (i.e., a select element with the multiple attribute set), it returns an array containing the value of each selected option, or null if no options are selected. When called on an empty collection, it returns undefined.
          
       
          For selects and checkboxes, you can also use the :selected and :checked selectors to get at values, for example:
          
       
          
 // Get the value from a dropdown select

From e98feb7a5c4b88391a5667045f197e2ce450e7f4 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sat, 12 Mar 2016 11:26:11 +0000
Subject: [PATCH 394/699] jQuery.ajax: Added note for jsonp and untrusted
 sources

Ref gh-756
Closes gh-900
---
 entries/jQuery.ajax.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index 65f5b544..d1d0e4d8 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -124,7 +124,7 @@ $.ajax({
         Allow the current environment to be recognized as "local," (e.g. the filesystem), even if jQuery does not recognize it as such by default. The following protocols are currently recognized as local: file, *-extension, and widget. If the isLocal setting needs modification, it is recommended to do so once in the $.ajaxSetup() method.
       
       
-        Override the callback function name in a JSONP request.  This value will be used instead of 'callback' in the 'callback=?' part of the query string in the url.  So {jsonp:'onJSONPLoad'} would result in 'onJSONPLoad=?' passed to the server. As of jQuery 1.5, setting the jsonp option to false prevents jQuery from adding the "?callback" string to the URL or attempting to use "=?" for transformation. In this case, you should also explicitly set the jsonpCallback setting. For example, { jsonp: false, jsonpCallback: "callbackName" }
+        Override the callback function name in a JSONP request. This value will be used instead of 'callback' in the 'callback=?' part of the query string in the url. So {jsonp:'onJSONPLoad'} would result in 'onJSONPLoad=?' passed to the server. As of jQuery 1.5, setting the jsonp option to false prevents jQuery from adding the "?callback" string to the URL or attempting to use "=?" for transformation. In this case, you should also explicitly set the jsonpCallback setting. For example, { jsonp: false, jsonpCallback: "callbackName" }. If you don't trust the target of your Ajax requests, consider setting the jsonp property to false for security reasons.
       
       
         

From 75d59a317552b4978bbd27ee50dad8bb27a5cb15 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sat, 12 Mar 2016 11:29:09 +0000
Subject: [PATCH 395/699] jQuery.ajax: Specified that jsonp accepts a Boolean

---
 entries/jQuery.ajax.xml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index d1d0e4d8..33ce8b72 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -123,7 +123,9 @@ $.ajax({
       
         Allow the current environment to be recognized as "local," (e.g. the filesystem), even if jQuery does not recognize it as such by default. The following protocols are currently recognized as local: file, *-extension, and widget. If the isLocal setting needs modification, it is recommended to do so once in the $.ajaxSetup() method.
       
-      
+      
+        
+        
         Override the callback function name in a JSONP request. This value will be used instead of 'callback' in the 'callback=?' part of the query string in the url. So {jsonp:'onJSONPLoad'} would result in 'onJSONPLoad=?' passed to the server. As of jQuery 1.5, setting the jsonp option to false prevents jQuery from adding the "?callback" string to the URL or attempting to use "=?" for transformation. In this case, you should also explicitly set the jsonpCallback setting. For example, { jsonp: false, jsonpCallback: "callbackName" }. If you don't trust the target of your Ajax requests, consider setting the jsonp property to false for security reasons.
       
       

From 67996d7aa733c1b34cb699198f0cce3abe05eaf1 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sat, 12 Mar 2016 14:34:11 +0000
Subject: [PATCH 396/699] scrollTop: Updated the return value to Number

Fixes gh-608
Closes gh-901
---
 entries/scrollTop.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/scrollTop.xml b/entries/scrollTop.xml
index 027d3db0..9f0ec14e 100644
--- a/entries/scrollTop.xml
+++ b/entries/scrollTop.xml
@@ -1,6 +1,6 @@
 
 
-  
+  
     .scrollTop()
     
       1.2.6
@@ -35,7 +35,7 @@ $( "p:last" ).text( "scrollTop:" + p.scrollTop() );
     
       1.2.6
       
-        An integer indicating the new position to set the scroll bar to.
+        A number indicating the new position to set the scroll bar to.
       
     
     Set the current vertical position of the scroll bar for each of the set of matched elements.

From 82c278e15cf114a90a50d9801b074311b0e11150 Mon Sep 17 00:00:00 2001
From: Kris Borchers 
Date: Wed, 23 Mar 2016 14:28:08 -0400
Subject: [PATCH 397/699] jQuery.speed: Fix incorrect custom-effects slug

Closes gh-902
---
 entries/jQuery.speed.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.speed.xml b/entries/jQuery.speed.xml
index cb5ea916..75cd1e68 100644
--- a/entries/jQuery.speed.xml
+++ b/entries/jQuery.speed.xml
@@ -40,7 +40,7 @@
     
          The $.speed() method provides a way to define properties, such as duration, easing, and queue, to use in a custom animation. By using it, you don't have to implement the logic that deals with default values and optional parameters.
          
     
          This method is meant for plugin developers who are creating new animation methods. Letting $.speed() do all the parameter hockey and normalization for you, rather than duplicating the logic yourself, makes your work simpler. An example of use can be found in the animated form of .addClass() of jQuery UI. 
          
   
-  
+  
   
   
           

From 8905818402b717b4a172ed38dcae673d5085044a Mon Sep 17 00:00:00 2001
From: Anne-Gaelle Colom 
Date: Wed, 30 Mar 2016 15:21:37 +0100
Subject: [PATCH 398/699] Build: Update grunt-jquery-content to 3.0.1

Closes gh-905
Fixes gh-890
---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index d8865dc2..f49874de 100644
--- a/package.json
+++ b/package.json
@@ -25,6 +25,6 @@
   },
   "dependencies": {
     "grunt": "0.4.5",
-    "grunt-jquery-content": "3.0.0"
+    "grunt-jquery-content": "3.0.1"
   }
 }

From b41fe9c94602ab17c956344854f4a3d242606f1c Mon Sep 17 00:00:00 2001
From: Anne-Gaelle Colom 
Date: Thu, 31 Mar 2016 14:29:32 +0100
Subject: [PATCH 399/699] 1.12.2

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index f49874de..9f714af3 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.1",
+  "version": "1.12.2",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 33508ae0af0dbb7162466bcd3548090f66401939 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski?= 
Date: Thu, 31 Mar 2016 16:08:16 +0200
Subject: [PATCH 400/699] Build: Add grunt-cli to dependencies

---
 package.json | 1 +
 1 file changed, 1 insertion(+)

diff --git a/package.json b/package.json
index 9f714af3..e4bfc203 100644
--- a/package.json
+++ b/package.json
@@ -25,6 +25,7 @@
   },
   "dependencies": {
     "grunt": "0.4.5",
+    "grunt-cli": "1.1.0",
     "grunt-jquery-content": "3.0.1"
   }
 }

From 068d23efa1cc35abc076bd11206ecb6684ad7dbd Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Tue, 12 Apr 2016 21:35:02 +0100
Subject: [PATCH 401/699] val(): Specified that it does not fire the change
 event

Fixes gh-79
Closes gh-909
---
 entries/val.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/entries/val.xml b/entries/val.xml
index 2c78771f..1ba0c365 100644
--- a/entries/val.xml
+++ b/entries/val.xml
@@ -124,6 +124,7 @@ $( "input" )
     
       
          This method is typically used to set the values of form fields. 
          
       
          val() allows you to pass an array of element values. This is useful when working on a jQuery object containing elements like <input type="checkbox">, <input type="radio">, and <option>s inside of a <select>. In this case, the inputs and the options having a value that matches one of the elements of the array will be checked or selected while those having a value that don't match one of the elements of the array will be unchecked or unselected, depending on the type. In case of <input type="radio">s that are part of a radio group and <select>s, any previously selected element will be deselected.
          
+      
          Setting values using this method (or using the native value property) does not cause the dispatch of the change event. For this reason, the relevant event handlers will not be executed. If you want to execute them, you should call .trigger( "change" ) after setting the value.
          
       
          The .val() method allows us to set the value by passing in a function. As of jQuery 1.4, the function is passed two arguments, the current element's index and its current value: 
          
       
          
 $( "input:text.items" ).val(function( index, value ) {

From 8c1b6078749786878fe70f55927f6e9c251e13b3 Mon Sep 17 00:00:00 2001
From: Aaron Jorbin 
Date: Wed, 13 Apr 2016 22:45:12 -0400
Subject: [PATCH 402/699] Link to W3C for unquoted single word

Unquoted single word has a specific definition in this case that is not
succinct. A link to the spec helps developers understand what is meant.

Fixes gh-910
Ref jquery/jquery#2824
Closes gh-911
---
 entries/attribute-contains-prefix-selector.xml | 2 +-
 entries/attribute-contains-selector.xml        | 2 +-
 entries/attribute-contains-word-selector.xml   | 2 +-
 entries/attribute-ends-with-selector.xml       | 2 +-
 entries/attribute-equals-selector.xml          | 2 +-
 entries/attribute-not-equal-selector.xml       | 2 +-
 entries/attribute-starts-with-selector.xml     | 2 +-
 7 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/entries/attribute-contains-prefix-selector.xml b/entries/attribute-contains-prefix-selector.xml
index 4b706bc6..81856a8c 100644
--- a/entries/attribute-contains-prefix-selector.xml
+++ b/entries/attribute-contains-prefix-selector.xml
@@ -8,7 +8,7 @@
       An attribute name.
     
     
-      An attribute value. Can be either an unquoted single word or a quoted string.
+      An attribute value. Can be either an unquoted single word or a quoted string.
     
   
   Selects elements that have the specified attribute with a value either equal to a given string or starting with that string followed by a hyphen (-).
diff --git a/entries/attribute-contains-selector.xml b/entries/attribute-contains-selector.xml
index 8cb21dfc..9974ab80 100644
--- a/entries/attribute-contains-selector.xml
+++ b/entries/attribute-contains-selector.xml
@@ -8,7 +8,7 @@
       An attribute name.
     
     
-      An attribute value. Can be either an unquoted single word or a quoted string.
+      An attribute value. Can be either an unquoted single word or a quoted string.
     
   
   Selects elements that have the specified attribute with a value containing a given substring.
diff --git a/entries/attribute-contains-word-selector.xml b/entries/attribute-contains-word-selector.xml
index 18df4cbc..08553983 100644
--- a/entries/attribute-contains-word-selector.xml
+++ b/entries/attribute-contains-word-selector.xml
@@ -8,7 +8,7 @@
       An attribute name.
     
     
-      An attribute value. Can be either an unquoted single word or a quoted string.
+      An attribute value. Can be either an unquoted single word or a quoted string.
     
   
   Selects elements that have the specified attribute with a value containing a given word, delimited by spaces.
diff --git a/entries/attribute-ends-with-selector.xml b/entries/attribute-ends-with-selector.xml
index 0febbde7..cb0f3344 100644
--- a/entries/attribute-ends-with-selector.xml
+++ b/entries/attribute-ends-with-selector.xml
@@ -8,7 +8,7 @@
       An attribute name.
     
     
-      An attribute value. Can be either an unquoted single word or a quoted string.
+      An attribute value. Can be either an unquoted single word or a quoted string.
     
   
   Selects elements that have the specified attribute with a value ending exactly with a given string. The comparison is case sensitive.
diff --git a/entries/attribute-equals-selector.xml b/entries/attribute-equals-selector.xml
index 555cf7c9..b29d733e 100644
--- a/entries/attribute-equals-selector.xml
+++ b/entries/attribute-equals-selector.xml
@@ -8,7 +8,7 @@
       An attribute name.
     
     
-      An attribute value. Can be either an unquoted single word or a quoted string.
+      An attribute value. Can be either an unquoted single word or a quoted string.
     
   
   Selects elements that have the specified attribute with a value exactly equal to a certain value.
diff --git a/entries/attribute-not-equal-selector.xml b/entries/attribute-not-equal-selector.xml
index fabb6a2e..6736dd70 100644
--- a/entries/attribute-not-equal-selector.xml
+++ b/entries/attribute-not-equal-selector.xml
@@ -8,7 +8,7 @@
       An attribute name.
     
     
-      An attribute value. Can be either an unquoted single word or a quoted string.
+      An attribute value. Can be either an unquoted single word or a quoted string.
     
   
   Select elements that either don't have the specified attribute, or do have the specified attribute but not with a certain value.
diff --git a/entries/attribute-starts-with-selector.xml b/entries/attribute-starts-with-selector.xml
index 3c2f6912..41485c85 100644
--- a/entries/attribute-starts-with-selector.xml
+++ b/entries/attribute-starts-with-selector.xml
@@ -8,7 +8,7 @@
       An attribute name.
     
     
-      An attribute value. Can be either an unquoted single word or a quoted string.
+      An attribute value. Can be either an unquoted single word or a quoted string.
     
   
   Selects elements that have the specified attribute with a value beginning exactly with a given string.

From e45384e612f2378f3a875e5b20a99bd62179c1c7 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Tue, 19 Apr 2016 02:44:07 +0100
Subject: [PATCH 403/699] Types: Added Text

---
 pages/Types.html | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/pages/Types.html b/pages/Types.html
index 3ab98753..6e75a12f 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -88,6 +88,7 @@
   
        • Selector
          • 
   
        • Event
          • 
   
        • Element
          • 
+  
        • Text
          • 
   
        • jQuery
          • 
   
        • XMLHttpRequest
          • 
   
        • jqXHR
          • 
@@ -604,6 +605,17 @@ 
           Element 
          
 
          
 
          You could replace this.value with $(this).val() to access the value of the text input via jQuery, but in that case you wouldn't gain anything.
 
          
+
           Text 
          
+
          Text is a node of the Document Object Model (DOM) that represents the textual content of an element or an attribute. Consider the following code:
+
          
+
          <p id="target"><b>Hello</b> world</p>
+
          
+
          If you retrieve the children of the paragraph of the example as follows:
+
          
+
          var children = document.getElementById( "target" ).childNodes;
+
          
+you obtain two children. The first one is the element representing the b tag. The second child is a text node containing the string " world".
+
          
 
           jQuery 
          
 
          A jQuery object contains a collection of Document Object Model (DOM) elements that have been created from an HTML string or selected from a document. Since jQuery methods often use CSS selectors to match elements from a document, the set of elements in a jQuery object is often called a set of "matched elements" or "selected elements".
 
          

From 9bf395aeb56299b05c84fda632865260d054ca8e Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Tue, 19 Apr 2016 02:44:12 +0100
Subject: [PATCH 404/699] append: Documented that it accepts text nodes

Fixes gh-879
Closes gh-914
---
 entries/after.xml   | 12 ++++++++----
 entries/append.xml  |  9 ++++++---
 entries/before.xml  | 12 ++++++++----
 entries/prepend.xml |  9 ++++++---
 4 files changed, 28 insertions(+), 14 deletions(-)

diff --git a/entries/after.xml b/entries/after.xml
index ee63cbf7..4d2c477c 100644
--- a/entries/after.xml
+++ b/entries/after.xml
@@ -4,16 +4,18 @@
   
     1.0
     
-      HTML string, DOM element, array of elements, or jQuery object to insert after each element in the set of matched elements.
+      HTML string, DOM element, text node, array of elements and text nodes, or jQuery object to insert after each element in the set of matched elements.
       
       
+      
       
       
     
     
-      One or more additional DOM elements, arrays of elements, HTML strings, or jQuery objects to insert after each element in the set of matched elements.
+      One or more additional DOM elements, text nodes, arrays of elements and text nodes, HTML strings, or jQuery objects to insert after each element in the set of matched elements.
       
       
+      
       
       
     
@@ -21,11 +23,12 @@
   
     1.4
     
-      A function that returns an HTML string, DOM element(s), or jQuery object to insert after each element in the set of matched elements. Receives the index position of the element in the set as an argument. Within the function, this refers to the current element in the set.
+      A function that returns an HTML string, DOM element(s), text node(s), or jQuery object to insert after each element in the set of matched elements. Receives the index position of the element in the set as an argument. Within the function, this refers to the current element in the set.
       
       
         
         
+        
         
       
     
@@ -33,12 +36,13 @@
   
     1.10
     
-      A function that returns an HTML string, DOM element(s), or jQuery object to insert after each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, this refers to the current element in the set.
+      A function that returns an HTML string, DOM element(s), text node(s), or jQuery object to insert after each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, this refers to the current element in the set.
       
       
       
         
         
+        
         
       
     
diff --git a/entries/append.xml b/entries/append.xml
index 07acacf1..acdd1b11 100644
--- a/entries/append.xml
+++ b/entries/append.xml
@@ -4,16 +4,18 @@
   
     1.0
     
-      DOM element, array of elements, HTML string, or jQuery object to insert at the end of each element in the set of matched elements.
+      DOM element, text node, array of elements and text nodes, HTML string, or jQuery object to insert at the end of each element in the set of matched elements.
       
       
+      
       
       
     
     
-      One or more additional DOM elements, arrays of elements, HTML strings, or jQuery objects to insert at the end of each element in the set of matched elements.
+      One or more additional DOM elements, text nodes, arrays of elements and text nodes, HTML strings, or jQuery objects to insert at the end of each element in the set of matched elements.
       
       
+      
       
       
     
@@ -21,12 +23,13 @@
   
     1.4
     
-      A function that returns an HTML string, DOM element(s), or jQuery object to insert at the end of each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, this refers to the current element in the set.
+      A function that returns an HTML string, DOM element(s), text node(s), or jQuery object to insert at the end of each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, this refers to the current element in the set.
       
       
       
         
         
+        
                 
       
     
diff --git a/entries/before.xml b/entries/before.xml
index 6a388ca4..ae958dc1 100644
--- a/entries/before.xml
+++ b/entries/before.xml
@@ -4,16 +4,18 @@
   
     1.0
     
-      HTML string, DOM element, array of elements, or jQuery object to insert before each element in the set of matched elements.
+      HTML string, DOM element, text node, array of elements and text nodes, or jQuery object to insert before each element in the set of matched elements.
       
       
+      
       
       
     
     
-      One or more additional DOM elements, arrays of elements, HTML strings, or jQuery objects to insert before each element in the set of matched elements.
+      One or more additional DOM elements, text nodes, arrays of elements and text nodes, HTML strings, or jQuery objects to insert before each element in the set of matched elements.
       
       
+      
       
       
     
@@ -25,9 +27,10 @@
       
         
         
+        
         
       
-      A function that returns an HTML string, DOM element(s), or jQuery object to insert before each element in the set of matched elements. Receives the index position of the element in the set as an argument. Within the function, this refers to the current element in the set.
+      A function that returns an HTML string, DOM element(s), text node(s), or jQuery object to insert before each element in the set of matched elements. Receives the index position of the element in the set as an argument. Within the function, this refers to the current element in the set.
       
     
   
@@ -39,9 +42,10 @@
       
         
         
+        
         
       
-      A function that returns an HTML string, DOM element(s), or jQuery object to insert before each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, this refers to the current element in the set.
+      A function that returns an HTML string, DOM element(s), text node(s), or jQuery object to insert before each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, this refers to the current element in the set.
       
     
   
diff --git a/entries/prepend.xml b/entries/prepend.xml
index 4e12fcb8..912dd6fc 100644
--- a/entries/prepend.xml
+++ b/entries/prepend.xml
@@ -4,18 +4,20 @@
   
     1.0
     
-      DOM element, array of elements, HTML string, or jQuery object to insert at the beginning of each element in the set of matched elements.
+      DOM element, text node, array of elements and text nodes, HTML string, or jQuery object to insert at the beginning of each element in the set of matched elements.
       
       
+      
       
       
     
     
       
       
+      
       
       
-      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.
+      One or more additional DOM elements, text nodes, arrays of elements and text nodes, HTML strings, or jQuery objects to insert at the beginning of each element in the set of matched elements.
     
   
   
@@ -26,9 +28,10 @@
       
         
         
+        
                 
            
-      A function that returns an HTML string, DOM element(s), or jQuery object to insert at the beginning of each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, this refers to the current element in the set.
+      A function that returns an HTML string, DOM element(s), text node(s), or jQuery object to insert at the beginning of each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, this refers to the current element in the set.
     
   
   Insert content, specified by the parameter, to the beginning of each element in the set of matched elements.

From 8b3b088c76c1e23d96bea3b54079f33e6f5a1afe Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Thu, 21 Apr 2016 08:12:39 -0400
Subject: [PATCH 405/699] Types page: Add missing opening 
           and remove
 data-lang="html"

---
 pages/Types.html | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/pages/Types.html b/pages/Types.html
index 6e75a12f..2deff771 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -608,13 +608,12 @@ 
           Element 
          
 
           Text 
          
 
          Text is a node of the Document Object Model (DOM) that represents the textual content of an element or an attribute. Consider the following code:
 
          
-
          <p id="target"><b>Hello</b> world</p>
-
          
+
          <p id="target"><b>Hello</b> world</p>
          
 
          If you retrieve the children of the paragraph of the example as follows:
 
          
 
          var children = document.getElementById( "target" ).childNodes;
 
          
-you obtain two children. The first one is the element representing the b tag. The second child is a text node containing the string " world".
+
          you obtain two children. The first one is the element representing the b tag. The second child is a text node containing the string " world".
 
          
 
           jQuery 
          
 
          A jQuery object contains a collection of Document Object Model (DOM) elements that have been created from an HTML string or selected from a document. Since jQuery methods often use CSS selectors to match elements from a document, the set of elements in a jQuery object is often called a set of "matched elements" or "selected elements".

From 0d78b3ae6411ece043df1c7ae57bc42a58ec4516 Mon Sep 17 00:00:00 2001
From: Connor Cartwright 
Date: Thu, 5 May 2016 23:04:32 +0100
Subject: [PATCH 406/699] one: Clarified its behavior

Fixes gh-796
Closes gh-923
---
 entries/one.xml | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/entries/one.xml b/entries/one.xml
index 1327dbf0..588f1d55 100644
--- a/entries/one.xml
+++ b/entries/one.xml
@@ -44,7 +44,7 @@
     
   
   
-    
          The  .one() method is identical to  .on(), except that the handler is unbound after its first invocation. For example:
          
+    
          The .one() method is identical to .on(), except that the handler for a given element and event type is unbound after its first invocation. For example:
          
     
          
 $( "#foo" ).one( "click", function() {
   alert( "This will be displayed only once." );
@@ -59,6 +59,12 @@ $( "#foo" ).on( "click", function( event ) {
     
          
     
          In other words, explicitly calling .off() from within a regularly-bound handler has exactly the same effect.
          
     
          If the first argument contains more than one space-separated event types, the event handler is called once for each event type.
          
+    
          
+$( "#foo" ).one( "click mouseover", function() {
+  alert( "The " + event.type + " event happened!" );
+});
+    
          
+    
          In the example above the alert could be displayed twice due to the two event types (click and mouseover).
          
             
   
     Tie a one-time click to each div.

From a16c3b4b139e41d3910de153b8daa3c5a31e2fe7 Mon Sep 17 00:00:00 2001
From: Connor Cartwright 
Date: Thu, 5 May 2016 21:54:23 +0100
Subject: [PATCH 407/699] disabled: Described when an element is actually
 disabled

Fixes gh-734
Closes gh-920
---
 entries/disabled-selector.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/disabled-selector.xml b/entries/disabled-selector.xml
index f018318c..812c8f57 100644
--- a/entries/disabled-selector.xml
+++ b/entries/disabled-selector.xml
@@ -9,9 +9,9 @@
   
     
          As with other pseudo-class selectors (those that begin with a ":"), it is recommended to precede it with a tag name or some other selector; otherwise, the universal selector ("*") is implied. In other words, the bare $(':disabled') is equivalent to $('*:disabled'), so $('input:disabled') or similar should be used instead. 
          
 
-    
          Although their resulting selections are usually the same, the :disabled selector is subtly different from the [disabled] attribute selector; :disabled checks the boolean (true/false) value of the element's disabled property while [disabled] checks for the existence of the disabled attribute.
          
+    
          Although their resulting selections are usually the same, the :disabled selector is subtly different from the [disabled] attribute selector;:disabled matches elements that are actually disabled while [disabled] only checks for the existence of the disabled attribute.
          
 
-    
          The :disabled selector should only be used for selecting HTML elements that support the disabled attribute (<button>, <input>, <optgroup>, <option>, <select>, and <textarea>).
          
+    
          The :disabled selector should only be used for selecting HTML elements that support the disabled attribute (<button>, <input>, <optgroup>, <option>, <select>, <textarea>, <menuitem>, and <fieldset>).
          
 
             
   

From d24fc66ed6998a03ccda9a69b4db005a9676c6b0 Mon Sep 17 00:00:00 2001
From: Connor Cartwright 
Date: Sun, 8 May 2016 20:27:36 +0100
Subject: [PATCH 408/699] Changed "unquoted single word" in "valid identifier"

Fixes gh-918
Closes gh-927
---
 entries/attribute-contains-prefix-selector.xml | 2 +-
 entries/attribute-contains-selector.xml        | 2 +-
 entries/attribute-contains-word-selector.xml   | 2 +-
 entries/attribute-ends-with-selector.xml       | 2 +-
 entries/attribute-equals-selector.xml          | 2 +-
 entries/attribute-not-equal-selector.xml       | 2 +-
 entries/attribute-starts-with-selector.xml     | 2 +-
 7 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/entries/attribute-contains-prefix-selector.xml b/entries/attribute-contains-prefix-selector.xml
index 81856a8c..3465e6c2 100644
--- a/entries/attribute-contains-prefix-selector.xml
+++ b/entries/attribute-contains-prefix-selector.xml
@@ -8,7 +8,7 @@
       An attribute name.
     
     
-      An attribute value. Can be either an unquoted single word or a quoted string.
+      An attribute value. Can be either a valid identifier or a quoted string.
     
   
   Selects elements that have the specified attribute with a value either equal to a given string or starting with that string followed by a hyphen (-).
diff --git a/entries/attribute-contains-selector.xml b/entries/attribute-contains-selector.xml
index 9974ab80..15e7778d 100644
--- a/entries/attribute-contains-selector.xml
+++ b/entries/attribute-contains-selector.xml
@@ -8,7 +8,7 @@
       An attribute name.
     
     
-      An attribute value. Can be either an unquoted single word or a quoted string.
+      An attribute value. Can be either a valid identifier or a quoted string.
     
   
   Selects elements that have the specified attribute with a value containing a given substring.
diff --git a/entries/attribute-contains-word-selector.xml b/entries/attribute-contains-word-selector.xml
index 08553983..8a71f37b 100644
--- a/entries/attribute-contains-word-selector.xml
+++ b/entries/attribute-contains-word-selector.xml
@@ -8,7 +8,7 @@
       An attribute name.
     
     
-      An attribute value. Can be either an unquoted single word or a quoted string.
+      An attribute value. Can be either a valid identifier or a quoted string.
     
   
   Selects elements that have the specified attribute with a value containing a given word, delimited by spaces.
diff --git a/entries/attribute-ends-with-selector.xml b/entries/attribute-ends-with-selector.xml
index cb0f3344..cbdfe808 100644
--- a/entries/attribute-ends-with-selector.xml
+++ b/entries/attribute-ends-with-selector.xml
@@ -8,7 +8,7 @@
       An attribute name.
     
     
-      An attribute value. Can be either an unquoted single word or a quoted string.
+      An attribute value. Can be either a valid identifier or a quoted string.
     
   
   Selects elements that have the specified attribute with a value ending exactly with a given string. The comparison is case sensitive.
diff --git a/entries/attribute-equals-selector.xml b/entries/attribute-equals-selector.xml
index b29d733e..faa6e513 100644
--- a/entries/attribute-equals-selector.xml
+++ b/entries/attribute-equals-selector.xml
@@ -8,7 +8,7 @@
       An attribute name.
     
     
-      An attribute value. Can be either an unquoted single word or a quoted string.
+      An attribute value. Can be either a valid identifier or a quoted string.
     
   
   Selects elements that have the specified attribute with a value exactly equal to a certain value.
diff --git a/entries/attribute-not-equal-selector.xml b/entries/attribute-not-equal-selector.xml
index 6736dd70..38531ffc 100644
--- a/entries/attribute-not-equal-selector.xml
+++ b/entries/attribute-not-equal-selector.xml
@@ -8,7 +8,7 @@
       An attribute name.
     
     
-      An attribute value. Can be either an unquoted single word or a quoted string.
+      An attribute value. Can be either a valid identifier or a quoted string.
     
   
   Select elements that either don't have the specified attribute, or do have the specified attribute but not with a certain value.
diff --git a/entries/attribute-starts-with-selector.xml b/entries/attribute-starts-with-selector.xml
index 41485c85..54067652 100644
--- a/entries/attribute-starts-with-selector.xml
+++ b/entries/attribute-starts-with-selector.xml
@@ -8,7 +8,7 @@
       An attribute name.
     
     
-      An attribute value. Can be either an unquoted single word or a quoted string.
+      An attribute value. Can be either a valid identifier or a quoted string.
     
   
   Selects elements that have the specified attribute with a value beginning exactly with a given string.

From e378db8ca39758fc5cfeea3913a0eea3731edd61 Mon Sep 17 00:00:00 2001
From: silverwind 
Date: Tue, 10 May 2016 22:50:04 +0200
Subject: [PATCH 409/699] Event: Suggest event.originalEvent usage

jQuery.event.props has been removed, so it necessary to access
event.originalEvent for non-common properties.

Fixes #405
Closes #928
---
 categories.xml | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/categories.xml b/categories.xml
index d43d8929..c181a548 100644
--- a/categories.xml
+++ b/categories.xml
@@ -120,7 +120,7 @@ var e = jQuery.Event( "keydown", { keyCode: 64 } );
 // trigger an artificial keydown event with keyCode 64
 jQuery( "body" ).trigger( e );
 
          
-          
          Event Properties
          
+          
          Common Event Properties
          
           
          jQuery normalizes the following properties for cross-browser consistency:
          
           
            
             
          • 
@@ -144,13 +144,12 @@ jQuery( "body" ).trigger( e );
           
          
           
          The following properties are also copied to the event object, though some of their values may be undefined depending on the event:
          
           
          altKey, bubbles, button, buttons, cancelable, char, charCode, clientX, clientY, ctrlKey, currentTarget, data, detail, eventPhase, key, keyCode, metaKey, offsetX, offsetY, originalTarget, pageX, pageY, relatedTarget, screenX, screenY, shiftKey, target, toElement, view, which
          
-          
          OtherProperties
          
-          
          Certain events may have properties specific to them. Those can be accessed as properties of the event.originalEvent object.
          
-          
          Example:
          
+          
          Other Properties
          
+          
          To access event properties not listed above, use the event.originalEvent object:
          
           
          
-// add the dataTransfer property for use with the native `drop` event
-// to capture information about files dropped into the browser window
-jQuery.event.props.push( "dataTransfer" );
+// Access the `dataTransfer` property from the `drop` event which
+// holds the files dropped into the browser window.
+var files = event.originalEvent.dataTransfer.files;
 
          
         
       ]]>

From b6ec0a6a338223db3a893b2aac309a3b8eead473 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski?= 
Date: Wed, 11 May 2016 10:16:47 +0200
Subject: [PATCH 410/699] 1.12.3

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index e4bfc203..20678798 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.2",
+  "version": "1.12.3",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 3aa37612b3601f86c571e1058cf951c7d2ce6611 Mon Sep 17 00:00:00 2001
From: Dennis Byrne 
Date: Mon, 16 May 2016 22:30:37 -0700
Subject: [PATCH 411/699] Replaced self closing divs with correct version

Closes gh-929
---
 entries/after.xml   | 2 +-
 entries/append.xml  | 2 +-
 entries/before.xml  | 2 +-
 entries/prepend.xml | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/entries/after.xml b/entries/after.xml
index 4d2c477c..210ad7c8 100644
--- a/entries/after.xml
+++ b/entries/after.xml
@@ -96,7 +96,7 @@ $( "p" ).after(function() {
     
          Similar to other content-adding methods such as .prepend() and .before(), .after() also supports passing in multiple arguments as input. Supported input includes DOM elements, jQuery objects, HTML strings, and arrays of DOM elements.
          
     
          For example, the following will insert two new <div>s and an existing <div> after the first paragraph:
          
     
          
-var $newdiv1 = $( "<div id='object1'/>" ),
+var $newdiv1 = $( "<div id='object1'></div>" ),
   newdiv2 = document.createElement( "div" ),
   existingdiv1 = document.getElementById( "foo" );
 
diff --git a/entries/append.xml b/entries/append.xml
index acdd1b11..b45c50ea 100644
--- a/entries/append.xml
+++ b/entries/append.xml
@@ -81,7 +81,7 @@ $( ".container" ).append( $( "h2" ) );
     
          Similar to other content-adding methods such as .prepend() and .before(), .append() also supports passing in multiple arguments as input. Supported input includes DOM elements, jQuery objects, HTML strings, and arrays of DOM elements.
          
     
          For example, the following will insert two new <div>s and an existing <div> as the last three child nodes of the body:
          
     
          
-var $newdiv1 = $( "<div id='object1'/>" ),
+var $newdiv1 = $( "<div id='object1'></div>" ),
   newdiv2 = document.createElement( "div" ),
   existingdiv1 = document.getElementById( "foo" );
 
diff --git a/entries/before.xml b/entries/before.xml
index ae958dc1..1a1fcdea 100644
--- a/entries/before.xml
+++ b/entries/before.xml
@@ -91,7 +91,7 @@ $( ".container" ).before( $( "h2" ) );
     
          Similar to other content-adding methods such as .prepend() and .after(), .before() also supports passing in multiple arguments as input. Supported input includes DOM elements, jQuery objects, HTML strings, and arrays of DOM elements.
          
     
          For example, the following will insert two new <div>s and an existing <div> before the first paragraph:
          
     
          
-var newdiv1 = $( "<div id='object1'/>" ),
+var newdiv1 = $( "<div id='object1'></div>" ),
   newdiv2 = document.createElement( "div" ),
   existingdiv1 = document.getElementById( "foo" );
 
diff --git a/entries/prepend.xml b/entries/prepend.xml
index 912dd6fc..0b7edd46 100644
--- a/entries/prepend.xml
+++ b/entries/prepend.xml
@@ -81,7 +81,7 @@ $( ".container" ).prepend( $( "h2" ) );
     
          Similar to other content-adding methods such as .append() and .before(), .prepend() also supports passing in multiple arguments as input. Supported input includes DOM elements, jQuery objects, HTML strings, and arrays of DOM elements.
          
     
          For example, the following will insert two new <div>s and an existing <div> as the first three child nodes of the body:
          
     
          
-var $newdiv1 = $( "<div id='object1'/>"),
+var $newdiv1 = $( "<div id='object1'></div>"),
   newdiv2 = document.createElement( "div" ),
   existingdiv1 = document.getElementById( "foo" );
 

From 0c57bf7efcfcc29a3fd4ba2dbed6d7e3fc8ed6b6 Mon Sep 17 00:00:00 2001
From: Connor Cartwright 
Date: Sun, 8 May 2016 01:11:52 +0100
Subject: [PATCH 412/699] beforeunload event: Updated wording

Fixes gh-364
Closes gh-925
---
 entries/unload.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/unload.xml b/entries/unload.xml
index 493e631f..173d560e 100644
--- a/entries/unload.xml
+++ b/entries/unload.xml
@@ -23,7 +23,7 @@
     
          This method is a shortcut for .on( "unload", handler ).
          
     
          The unload event is sent to the window element when the user navigates away from the page. This could mean one of many things. The user could have clicked on a link to leave the page, or typed in a new URL in the address bar. The forward and back buttons will trigger the event. Closing the browser window will cause the event to be triggered. Even a page reload will first create an unload event.
          
     
          
-      
          The exact handling of the unload event has varied from version to version of browsers. For example, some versions of Firefox trigger the event when a link is followed, but not when the window is closed. In practical usage, behavior should be tested on all supported browsers, and contrasted with the proprietary beforeunload event.
          
+      
          The exact handling of the unload event has varied from version to version of browsers. For example, some versions of Firefox trigger the event when a link is followed, but not when the window is closed. In practical usage, behavior should be tested on all supported browsers and contrasted with the similar beforeunload event.
          
     
          
     
          Any unload event handler should be bound to the window object:
          
     
          

From f77c9596a541f4fbe2413ce6db656603bf24c7f7 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Fri, 6 May 2016 10:12:50 +0100
Subject: [PATCH 413/699] jQuery.param: Removed details about traditional flag

Fixes gh-919
Closes gh-924
---
 entries/jQuery.param.xml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/entries/jQuery.param.xml b/entries/jQuery.param.xml
index 468b6db9..2127f55b 100644
--- a/entries/jQuery.param.xml
+++ b/entries/jQuery.param.xml
@@ -27,7 +27,6 @@
     
          This function is used internally to convert form element values into a serialized string representation (See .serialize() for more information).
          
     
          As of jQuery 1.3, the return value of a function is used instead of the function as a String.
          
     
          As of jQuery 1.4, the $.param() method serializes deep objects recursively to accommodate modern scripting languages and frameworks such as PHP and Ruby on Rails. You can disable this functionality globally by setting jQuery.ajaxSettings.traditional = true;.
          
-    
          As of jQuery 1.8, the $.param() method no longer uses jQuery.ajaxSettings.traditional as its default setting and will default to false. For best compatibility across versions, call $.param() with an explicit value for the second argument and do not use defaults.
          
     
          If the object passed is in an Array, it must be an array of objects in the format returned by .serializeArray()
          
     
          
 [

From 32c9e324659aa57f1fc8e4a024622609f0144fa2 Mon Sep 17 00:00:00 2001
From: Tom Delmas 
Date: Sun, 29 May 2016 15:50:25 +0200
Subject: [PATCH 414/699] Deferred.progress: Document it can take more than 2
 arguments

More conform with the .fail and .done doc

Closes gh-933
---
 entries/deferred.progress.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/deferred.progress.xml b/entries/deferred.progress.xml
index d1f18cc7..87189af9 100644
--- a/entries/deferred.progress.xml
+++ b/entries/deferred.progress.xml
@@ -14,7 +14,7 @@
       
       
       
-        Optional additional function, or array of functions, to be called when the Deferred generates progress notifications.
+        Optional additional functions, or arrays of functions, to be called when the Deferred generates progress notifications.
       
     
   

From 353fb32196bc5dae3efe12ed624b5b4a3cfdd4f1 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Wed, 11 Feb 2015 20:20:56 +0100
Subject: [PATCH 415/699] removeAttr: update note on support in IE

Fixes gh-642
Closes gh-652
---
 entries/removeAttr.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/removeAttr.xml b/entries/removeAttr.xml
index 778e328b..92a92b22 100644
--- a/entries/removeAttr.xml
+++ b/entries/removeAttr.xml
@@ -10,7 +10,7 @@
   Remove an attribute from each element in the set of matched elements.
   
     
          The .removeAttr() method uses the JavaScript removeAttribute() function, but it has the advantage of being able to be called directly on a jQuery object and it accounts for different attribute naming across browsers.
          
-    
          Note: Removing an inline onclick event handler using .removeAttr() doesn't achieve the desired effect in Internet Explorer 6, 7, or 8. To avoid potential problems, use .prop() instead:
          
+    
          Note: Removing an inline onclick event handler using .removeAttr() doesn't achieve the desired effect in Internet Explorer 8, 9 and 11. To avoid potential problems, use .prop() instead:
          
     
          
 $element.prop( "onclick", null );
 console.log( "onclick property: ", $element[ 0 ].onclick );

From 3185657bf889d3913118581a57bcd690c0265def Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Tue, 24 Feb 2015 07:27:16 +0100
Subject: [PATCH 416/699] child-selector: remove sentence about browser support

Closes gh-662
---
 entries/child-selector.xml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/entries/child-selector.xml b/entries/child-selector.xml
index 5016a1b3..1b1b27c2 100644
--- a/entries/child-selector.xml
+++ b/entries/child-selector.xml
@@ -13,7 +13,6 @@
   
   Selects all direct child elements specified by "child" of elements specified by "parent".
   
-    
          As a CSS selector, the child combinator is supported by all modern web browsers including Safari, Firefox, Opera, Chrome, and Internet Explorer 7 and above, but notably not by Internet Explorer versions 6 and below. However, in jQuery, this selector (along with all others) works across all supported browsers, including IE6.
          
     
          The child combinator (E > F) can be thought of as a more specific form of the descendant combinator (E F) in that it selects only first-level descendants.
          
             
   

From 34b96edacf16dc09f75b7b62ce1f1dc8030a0df7 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Mon, 2 Mar 2015 17:52:39 +0100
Subject: [PATCH 417/699] Ajax: Update notes about jqXHR.success(), .error()
 and .complete()

Fixes gh-650
Closes gh-677
---
 entries/jQuery.ajax.xml    | 6 +++---
 entries/jQuery.get.xml     | 2 +-
 entries/jQuery.getJSON.xml | 2 +-
 entries/jQuery.post.xml    | 2 +-
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index 33ce8b72..d5e6a33c 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -39,7 +39,7 @@ $.ajax({
         
       
       
-        By default, all requests are sent asynchronously (i.e. this is set to true by default). If you need synchronous requests, set this option to false. Cross-domain requests and dataType: "jsonp" requests do not support synchronous operation. Note that synchronous requests may temporarily lock the browser, disabling any actions while the request is active. As of jQuery 1.8, the use of async: false with jqXHR ($.Deferred) is deprecated; you must use the success/error/complete callback options instead of the corresponding methods of the jqXHR object such as jqXHR.done() or the deprecated jqXHR.success().
+        By default, all requests are sent asynchronously (i.e. this is set to true by default). If you need synchronous requests, set this option to false. Cross-domain requests and dataType: "jsonp" requests do not support synchronous operation. Note that synchronous requests may temporarily lock the browser, disabling any actions while the request is active. As of jQuery 1.8, the use of async: false with jqXHR ($.Deferred) is deprecated; you must use the success/error/complete callback options instead of the corresponding methods of the jqXHR object such as jqXHR.done().
       
       
         
@@ -232,7 +232,7 @@ $.ajax({
     
            
       
          • 
         jqXHR.done(function( data, textStatus, jqXHR ) {});
-        
            An alternative construct to the success callback option, the .done() method replaces the deprecated jqXHR.success() method. Refer to deferred.done() for implementation details.
            
+        
            An alternative construct to the success callback option, refer to deferred.done() for implementation details.
            
       
            • 
       
          • 
         jqXHR.fail(function( jqXHR, textStatus, errorThrown ) {});
@@ -251,7 +251,7 @@ $.ajax({
       
            • 
     
          
     
          
-      
          Deprecation Notice: The jqXHR.success(), jqXHR.error(), and jqXHR.complete() callbacks are deprecated as of jQuery 1.8. To prepare your code for their eventual removal, use jqXHR.done(), jqXHR.fail(), and jqXHR.always() instead.
          
+      
          Deprecation Notice: The jqXHR.success(), jqXHR.error(), and jqXHR.complete() callbacks are removed as of jQuery 3.0. You can use jqXHR.done(), jqXHR.fail(), and jqXHR.always() instead.
          
     
          
     
          
 // Assign handlers immediately after making the request,
diff --git a/entries/jQuery.get.xml b/entries/jQuery.get.xml
index a4e2bcdb..87707e51 100644
--- a/entries/jQuery.get.xml
+++ b/entries/jQuery.get.xml
@@ -75,7 +75,7 @@ jqxhr.always(function() {
 });
     
          
     
          Deprecation Notice
          
-    
          The jqXHR.success(), jqXHR.error(), and jqXHR.complete() callback methods introduced in jQuery 1.5 are deprecated as of jQuery 1.8. To prepare your code for their eventual removal, use jqXHR.done(), jqXHR.fail(), and jqXHR.always() instead.
          
+    
          The jqXHR.success(), jqXHR.error(), and jqXHR.complete() callback methods are removed as of jQuery 3.0. You can use jqXHR.done(), jqXHR.fail(), and jqXHR.always() instead.
          
   
   
   
diff --git a/entries/jQuery.getJSON.xml b/entries/jQuery.getJSON.xml
index 23ad5c2d..7d5e08b6 100644
--- a/entries/jQuery.getJSON.xml
+++ b/entries/jQuery.getJSON.xml
@@ -87,7 +87,7 @@ jqxhr.complete(function() {
 });
     
          
     
          Deprecation Notice
          
-    
          The jqXHR.success(), jqXHR.error(), and jqXHR.complete() callback methods introduced in jQuery 1.5 are deprecated as of jQuery 1.8. To prepare your code for their eventual removal, use jqXHR.done(), jqXHR.fail(), and jqXHR.always() instead.
          
+    
          The jqXHR.success(), jqXHR.error(), and jqXHR.complete() callback methods are removed as of jQuery 3.0. You can use jqXHR.done(), jqXHR.fail(), and jqXHR.always() instead.
          
             
   
   
diff --git a/entries/jQuery.post.xml b/entries/jQuery.post.xml
index 0ca6c139..91382759 100644
--- a/entries/jQuery.post.xml
+++ b/entries/jQuery.post.xml
@@ -77,7 +77,7 @@ jqxhr.always(function() {
     
          
 
     
          Deprecation Notice
          
-    
          The jqXHR.success(), jqXHR.error(), and jqXHR.complete() callback methods introduced in jQuery 1.5 are deprecated as of jQuery 1.8. To prepare your code for their eventual removal, use jqXHR.done(), jqXHR.fail(), and jqXHR.always() instead.
          
+    
          The jqXHR.success(), jqXHR.error(), and jqXHR.complete() callback methods are removed as of jQuery 3.0. You can use jqXHR.done(), jqXHR.fail(), and jqXHR.always() instead.
          
   
   
   

From 5fe9b733eaa5de2f2e8beb3752272212961dec49 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 9 Apr 2015 15:15:12 +0200
Subject: [PATCH 418/699] unwrap: add `selector` argument

Fixes gh-689
Closes gh-711
---
 entries/unwrap.xml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/entries/unwrap.xml b/entries/unwrap.xml
index d966952c..d3a7b405 100644
--- a/entries/unwrap.xml
+++ b/entries/unwrap.xml
@@ -4,6 +4,12 @@
   
     1.4
   
+  
+    3.0
+    
+      A selector to check the parent element against. If an element's parent does not match the selector, the element won't be unwrapped.
+    
+  
   Remove the parents of the set of matched elements from the DOM, leaving the matched elements in their place.
   
     
          The .unwrap() method removes the element's parent. This is effectively the inverse of the .wrap() method. The matched elements (and their siblings, if any) replace their parents within the DOM structure.
          

From d19cd776a38e23d2bc66e6bf09ec51c0fc2707b0 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Mon, 6 Apr 2015 16:06:09 +0200
Subject: [PATCH 419/699] Selector: correct `removed` version number

Fixes gh-696
Ref gh-702
---
 entries/selector.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/selector.xml b/entries/selector.xml
index 76a0ea5e..e9e61c1e 100644
--- a/entries/selector.xml
+++ b/entries/selector.xml
@@ -1,5 +1,5 @@
 
-
+
   .selector
   
     1.3

From ad85901ab2cc3ab72351c5a1e7c3a1a4491a1340 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Thu, 9 Apr 2015 19:19:50 +0200
Subject: [PATCH 420/699] Context: removed in 3.0

Closes gh-702
---
 entries/context.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/context.xml b/entries/context.xml
index a7377fa1..0cf0f7b4 100644
--- a/entries/context.xml
+++ b/entries/context.xml
@@ -1,5 +1,5 @@
 
-
+
   .context
   
     1.3

From b642f08baf04b2c92655a29e41227399765510f8 Mon Sep 17 00:00:00 2001
From: Arthur Verschaeve 
Date: Sun, 24 May 2015 22:06:17 +0200
Subject: [PATCH 421/699] wrapAll: change description of function argument

Fixes gh-605
Closes gh-745
---
 entries/wrapAll.xml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/entries/wrapAll.xml b/entries/wrapAll.xml
index c6dc02ca..7d8c741d 100644
--- a/entries/wrapAll.xml
+++ b/entries/wrapAll.xml
@@ -14,8 +14,7 @@
   
     1.4
     
-      A callback function returning the HTML content or jQuery object to wrap around the matched elements. Receives the index position of the element in the set as an argument. Within the function, this refers to the current element in the set.
-      
+      A callback function returning the HTML content or jQuery object to wrap around all the matched elements. Within the function, this refers to the first element in the set. Prior to jQuery 3.0, the callback was incorrectly called for every element in the set and received the index position of the element in the set as an argument.
       
         
         

From 870eb805664a36257ac6f7761e7ead3ec34b51fa Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 14 Jun 2015 14:55:40 +0100
Subject: [PATCH 422/699] data: Document behavior changes

Document changes that align the method to the Dataset API's behavior

Fixes gh-730
Closes gh-758
---
 entries/data.xml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/entries/data.xml b/entries/data.xml
index f54a229c..80ccee99 100644
--- a/entries/data.xml
+++ b/entries/data.xml
@@ -31,6 +31,7 @@ $( "body" ).data(); // { foo: 52, bar: { myType: "test", count: 40 }, baz: [ 1,
       
          
       
          In jQuery 1.4.3 setting an element's data object with .data(obj) extends the data previously stored with that element.
          
       
          Prior to jQuery 1.4.3 (starting in jQuery 1.4) the .data() method completely replaced all data, instead of just extending the data object. If you are using third-party plugins it may not be advisable to completely replace the element's data object, since plugins may have also set data.
          
+      
          jQuery 3 changes the behavior of this method to align it to the Dataset API specifications. Specifically, jQuery 3 transforms every two-character sequence of "-" (U+002D) followed by a lowercase ASCII letter by the uppercase version of the letter as per definition of [the algorithm of the Dataset API](http://www.w3.org/TR/html5/dom.html#dom-dataset). Writing a statement like $( "body" ).data( { "my-name": "aValue" } ).data(); will return { myName: "aValue" }.
          
       
          Due to the way browsers interact with plugins and external code, the .data() method cannot be used on <object> (unless it's a Flash plugin), <applet> or <embed> elements.
          
     
     
@@ -88,6 +89,7 @@ alert( $( "body" ).data( "foo" ) ); // undefined
 $( "body" ).data( "bar", "foobar" );
 alert( $( "body" ).data( "bar" ) ); // foobar
       
          
+      
          jQuery 3 changes the behavior of this method to align it to the Dataset API specifications. Specifically, jQuery 3 transforms every two-character sequence of "-" (U+002D) followed by a lowercase ASCII letter by the uppercase version of the letter as per definition of [the algorithm of the Dataset API](http://www.w3.org/TR/html5/dom.html#dom-dataset). Writing a statement like $( "body" ).data( { "my-name": "aValue" } ).data(); will return { myName: "aValue" }.
          
       
          
         HTML5 data-* Attributes
       
          

From 025e1fcd02b5a9841c974a2fe82b8c3614a53013 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 27 Jul 2015 14:03:43 +0100
Subject: [PATCH 423/699] Visibility filters: Specified new behavior

Fixes gh-737
Closes gh-789
---
 entries/hidden-selector.xml  | 1 +
 entries/visible-selector.xml | 1 +
 2 files changed, 2 insertions(+)

diff --git a/entries/hidden-selector.xml b/entries/hidden-selector.xml
index 2c2e6e2c..47c0bf6c 100644
--- a/entries/hidden-selector.xml
+++ b/entries/hidden-selector.xml
@@ -19,6 +19,7 @@
     
          This selector is the opposite of the :visible selector. So, every element selected by :hidden isn't selected by :visible and vice versa.
          
     
          During animations to show an element, the element is considered to be visible at the start of the animation.
          
     
          How :hidden is determined was changed in jQuery 1.3.2. An element is assumed to be hidden if it or any of its parents consumes no space in the document. CSS visibility isn't taken into account (therefore $( elem ).css( "visibility", "hidden" ).is( ":hidden" ) == false). The release notes outline the changes in more detail.
          
+    
          jQuery 3 slightly modifies the meaning of :hidden (and therefore of :visible). Starting with this version, elements will be considered :hidden if they don't have any layout boxes. For example, br elements and inline elements with no content will not be selected by the :hidden selector.
          
   
   
   
diff --git a/entries/visible-selector.xml b/entries/visible-selector.xml
index 25df8ee7..6b159740 100644
--- a/entries/visible-selector.xml
+++ b/entries/visible-selector.xml
@@ -14,6 +14,7 @@
     
          All option elements are considered hidden, regardless of their selected state.
          
     
          During animations that hide an element, the element is considered visible until the end of the animation. During animations to show an element, the element is considered visible at the start at the animation.
          
     
          How :visible is calculated was changed in jQuery 1.3.2. The release notes outline the changes in more detail.
          
+    
          jQuery 3 slightly modifies the meaning of :visible (and therefore of :hidden). Starting with this version, elements will be considered :visible if they have any layout boxes, including those of zero width and/or height. For example, br elements and inline elements with no content will be selected by the :visible selector.
          
   
   
   

From 5854b44ba5f6afd8b356e5c2417eadc3cf29a118 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 19 Oct 2015 00:47:01 +0100
Subject: [PATCH 424/699] isNumeric: Updated description based on new behavior

Fixes gh-817
Closes gh-819
---
 entries/jQuery.isNumeric.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/entries/jQuery.isNumeric.xml b/entries/jQuery.isNumeric.xml
index 7a4e7f6c..b51eb84d 100644
--- a/entries/jQuery.isNumeric.xml
+++ b/entries/jQuery.isNumeric.xml
@@ -9,7 +9,8 @@
     
   
   
-    
          The $.isNumeric() method checks whether a value is a finite number, or would be cast to one by Number. If so, it returns true. Otherwise it returns false. The argument can be of any type.
          
+    
          The $.isNumeric() method checks whether its argument represents a numeric value. If so, it returns true. Otherwise it returns false. The argument can be of any type.
          
+    
          As of jQuery 3.0 $.isNumeric() returns true only if the argument is of type number, or if it's of type string and it can be coerced into finite numbers. In all other cases, it returns false.
          
             
   
     Sample return values of $.isNumeric with various inputs.

From d6d3e7a8f8d7de252ab721989f96f7425ae50231 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Fri, 8 Jan 2016 00:33:39 +0000
Subject: [PATCH 425/699] toggleClass: Document deprecation of a signature

Fixes gh-851
Closes gh-860
---
 entries/toggleClass.xml | 176 ++++++++++++++++++++--------------------
 1 file changed, 90 insertions(+), 86 deletions(-)

diff --git a/entries/toggleClass.xml b/entries/toggleClass.xml
index f14cb8ed..5a18aa05 100644
--- a/entries/toggleClass.xml
+++ b/entries/toggleClass.xml
@@ -1,69 +1,62 @@
 
-
-  .toggleClass()
-  
-    1.0
-    
-      One or more class names (separated by spaces) to be toggled for each element in the matched set.
-    
-  
-  
-    1.3
-    
-      One or more class names (separated by spaces) to be toggled for each element in the matched set.
-    
-    
-      A Boolean (not just truthy/falsy) value to determine whether the class should be added or removed.
-    
-  
-  
-    1.4
-    
-      A boolean value to determine whether the class should be added or removed.
-    
-  
-  
-    1.4
-    
-      
-      
-      
-        
-      A function that returns class names to be toggled in the class attribute of each element in the matched set. Receives the index position of the element in the set, the old class value, and the state as arguments.
-    
-    
-      A boolean value to determine whether the class should be added or removed.
-    
-  
-  Add or remove one or more classes from each element in the set of matched elements, depending on either the class's presence or the value of the state argument.
-  
-    
          Before jQuery version 1.12/2.2, the .toggleClass() method manipulated the className property of the selected elements, not the class attribute. Once the property was changed, it was the browser that updated the attribute accordingly. An implication of this behavior was that this method only worked for documents with HTML DOM semantics (e.g., not pure XML documents).
          
-    
          As of jQuery 1.12/2.2, this behavior is changed to improve the support for XML documents, including SVG. Starting from this version, the class attribute is used instead. So, .toggleClass() can be used on XML or SVG documents.
          
-    
          This method takes one or more class names as its parameter. In the first version, if an element in the matched set of elements already has the class, then it is removed; if an element does not have the class, then it is added. For example, we can apply .toggleClass() to a simple <div>: 
          
-    
          
+
+  
+    .toggleClass()
+    
+      1.0
+      
+        One or more class names (separated by spaces) to be toggled for each element in the matched set.
+      
+    
+    
+      1.3
+      
+        One or more class names (separated by spaces) to be toggled for each element in the matched set.
+      
+      
+        A Boolean (not just truthy/falsy) value to determine whether the class should be added or removed.
+      
+    
+    
+      1.4
+      
+        
+        
+        
+        
+        A function that returns class names to be toggled in the class attribute of each element in the matched set. Receives the index position of the element in the set, the old class value, and the state as arguments.
+      
+      
+        A boolean value to determine whether the class should be added or removed.
+      
+    
+    Add or remove one or more classes from each element in the set of matched elements, depending on either the class's presence or the value of the state argument.
+    
+      
          This method takes one or more class names as its parameter. In the first version, if an element in the matched set of elements already has the class, then it is removed; if an element does not have the class, then it is added. For example, we can apply .toggleClass() to a simple <div>: 
          
+      
          
 <div class="tumble">Some text.</div>
-    
          
-    
          The first time we apply $( "div.tumble" ).toggleClass( "bounce" ), we get the following:
          
-    
          
+      
          
+      
          The first time we apply $( "div.tumble" ).toggleClass( "bounce" ), we get the following:
          
+      
          
 <div class="tumble bounce">Some text.</div>
-    
          
-    
          The second time we apply $( "div.tumble" ).toggleClass( "bounce" ), the <div> class is returned to the single tumble value:
          
-    
          <div class="tumble">Some text.</div>
          
-    
          Applying .toggleClass( "bounce spin" ) to the same <div> alternates between <div class="tumble bounce spin"> and <div class="tumble">.
          
-    
          The second version of .toggleClass() uses the second parameter for determining whether the class should be added or removed. If this parameter's value is true, then the class is added; if false, the class is removed. In essence, the statement:
          
-    
          
+      
          
+      
          The second time we apply $( "div.tumble" ).toggleClass( "bounce" ), the <div> class is returned to the single tumble value:
          
+      
          <div class="tumble">Some text.</div>
          
+      
          Applying .toggleClass( "bounce spin" ) to the same <div> alternates between <div class="tumble bounce spin"> and <div class="tumble">.
          
+      
          The second version of .toggleClass() uses the second parameter for determining whether the class should be added or removed. If this parameter's value is true, then the class is added; if false, the class is removed. In essence, the statement:
          
+      
          
 $( "#foo" ).toggleClass( className, addOrRemove );
-    
          
-    
          is equivalent to:
          
-    
          
+      
          
+      
          is equivalent to:
          
+      
          
 if ( addOrRemove ) {
   $( "#foo" ).addClass( className );
 } else {
   $( "#foo" ).removeClass( className );
 }
-    
          
-    
          As of jQuery 1.4, if no arguments are passed to .toggleClass(), all class names on the element the first time .toggleClass() is called will be toggled. Also as of jQuery 1.4, the class name to be toggled can be determined by passing in a function.
          
-    
          
+      
          
+      
          As of jQuery 1.4, if no arguments are passed to .toggleClass(), all class names on the element the first time .toggleClass() is called will be toggled. Also as of jQuery 1.4, the class name to be toggled can be determined by passing in a function.
          
+      
          
 $( "div.foo" ).toggleClass(function() {
   if ( $( this ).parent().is( ".bar" ) ) {
     return "happy";
@@ -71,17 +64,17 @@ $( "div.foo" ).toggleClass(function() {
     return "sad";
   }
 });
-
          
-    
          This example will toggle the happy class for <div class="foo"> elements if their parent element has a class of bar; otherwise, it will toggle the sad class.
          
-            
-  
-    Toggle the class 'highlight' when a paragraph is clicked.
-    
          
+      
          This example will toggle the happy class for <div class="foo"> elements if their parent element has a class of bar; otherwise, it will toggle the sad class.
          
+              
+    
+      Toggle the class 'highlight' when a paragraph is clicked.
+      
-    
-    Click to toggle
          
 
          highlight
          
 
          on these
          
 
          paragraphs
          
 ]]>
-            
-  
-    Add the "highlight" class to the clicked paragraph on every third click of that paragraph, remove it every first and second click.
-    
+    
+      Add the "highlight" class to the clicked paragraph on every third click of that paragraph, remove it every first and second click.
+      
-    
-    Click to toggle (clicks: 0)
          
 
          highlight (clicks: 0)
          
 
          on these (clicks: 0)
          
 
          paragraphs (clicks: 0)
          
 ]]>
-            
-  
-    Toggle the class name(s) indicated on the buttons for each div.
-  
-    
+    
+      Toggle the class name(s) indicated on the buttons for each div.
+       div {
     float: left;
     width: 100px;
@@ -158,7 +150,7 @@ $( "p" ).each(function() {
     background-color: cornsilk;
   }
 ]]>
-    
   
   
@@ -173,7 +165,7 @@ $( "p" ).each(function() {
   
          
 
 ]]>
-    
-            
-  
-  
-  
-  
-  
-  
-          
+              
+    
+    
+    
+    
+    
+    
+  
+  
+    
+      1.4
+      
+        A boolean value to determine whether the class should be added or removed.
+      
+    
+    
+      
          This signature (only!) is deprecated as of jQuery 3.0.
          
+              
+            
+
\ No newline at end of file

From 956f186173eb35bf1f8ac9b5d3fd19679d1ca257 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Fri, 11 Mar 2016 01:12:46 +0000
Subject: [PATCH 426/699] jQuery.parseJSON: Added deprecation note for jQuery 3

Fixes gh-898
Closes gh-899
---
 entries/jQuery.parseJSON.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/entries/jQuery.parseJSON.xml b/entries/jQuery.parseJSON.xml
index bc9dcc78..d0965e41 100644
--- a/entries/jQuery.parseJSON.xml
+++ b/entries/jQuery.parseJSON.xml
@@ -1,5 +1,5 @@
 
-
+
   
   
   
@@ -26,6 +26,7 @@
     
          The JSON standard does not permit "control characters" such as a tab or newline. An example like $.parseJSON( '{ "testing":"1\t2\n3" }' ) will throw an error in most implementations because the JavaScript parser converts the string's tab and newline escapes into literal tab and newline; doubling the backslashes like "1\\t2\\n3" yields expected results. This problem is often seen when injecting JSON into a JavaScript file from a server-side language such as PHP.
          
     
          Where the browser provides a native implementation of JSON.parse, jQuery uses it to parse the string. For details on the JSON format, see http://json.org/.
          
     
          Prior to jQuery 1.9, $.parseJSON returned null instead of throwing an error if it was passed an empty string, null, or undefined, even though those are not valid JSON.
          
+    
          As of jQuery 3.0, $.parseJSON is deprecated. To parse JSON objects, use the native JSON.parse method instead.
          
   
   
     Parse a JSON string.

From 0d09c6a70ae16ec2098c8a9d67fb5c92fb53624b Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Thu, 7 Apr 2016 01:03:27 +0100
Subject: [PATCH 427/699] jQuery.parseHTML: Specified behavior of version 3

Fixes gh-903
Closes gh-907
---
 entries/jQuery.parseHTML.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/entries/jQuery.parseHTML.xml b/entries/jQuery.parseHTML.xml
index 930d60a2..5354627a 100644
--- a/entries/jQuery.parseHTML.xml
+++ b/entries/jQuery.parseHTML.xml
@@ -17,6 +17,7 @@
   
     
          jQuery.parseHTML uses native methods to convert the string to a set of DOM nodes, which can then be inserted into the document. These methods do render all trailing or leading text (even if that's just whitespace). To prevent trailing/leading whitespace from being converted to text nodes you can pass the HTML string through jQuery.trim.
          
     
          By default, the context is the current document if not specified or given as null or undefined. If the HTML was to be used in another document such as an iframe, that frame's document could be used.
          
+    
          As of 3.0 the default behavior is changed. If the context is not specified or given as null or undefined, a new document is used. This can potentially improve security because inline events will not execute when the HTML is parsed. Once the parsed HTML is injected into a document it does execute, but this gives tools a chance to traverse the created DOM and remove anything deemed unsafe. This improvement does not apply to internal uses of jQuery.parseHTML as they usually pass in the current document. Therefore, a statement like $( "#log" ).append( $( htmlString ) ) is still subject to the injection of malicious code.
          
 	
          Security Considerations
          
 	
          Most jQuery APIs that accept HTML strings will run scripts that are included in the HTML. jQuery.parseHTML does not run scripts in the parsed HTML unless keepScripts is explicitly true. However, it is still possible in most environments to execute scripts indirectly, for example via the <img onerror> attribute. The caller should be aware of this and guard against it by cleaning or escaping any untrusted inputs from sources such as the URL or cookies. For future compatibility, callers should not depend on the ability to run any script content when keepScripts is unspecified or false.
          
             

From a062f9fc82c3a24789d157fc0508d07ab198edb8 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Fri, 20 May 2016 01:28:05 +0100
Subject: [PATCH 428/699] jQuery.param: Updated version for traditional flag

Ref gh-924
Closes gh-932
---
 entries/jQuery.param.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/entries/jQuery.param.xml b/entries/jQuery.param.xml
index 2127f55b..9a80fc2b 100644
--- a/entries/jQuery.param.xml
+++ b/entries/jQuery.param.xml
@@ -27,6 +27,7 @@
     
          This function is used internally to convert form element values into a serialized string representation (See .serialize() for more information).
          
     
          As of jQuery 1.3, the return value of a function is used instead of the function as a String.
          
     
          As of jQuery 1.4, the $.param() method serializes deep objects recursively to accommodate modern scripting languages and frameworks such as PHP and Ruby on Rails. You can disable this functionality globally by setting jQuery.ajaxSettings.traditional = true;.
          
+    
          As of jQuery 3.0, the $.param() method no longer uses jQuery.ajaxSettings.traditional as its default setting and will default to false. For best compatibility across versions, call $.param() with an explicit value for the second argument and do not use defaults.
          
     
          If the object passed is in an Array, it must be an array of objects in the format returned by .serializeArray()
          
     
          
 [

From b2e0296987e67e431caf0c5df2af869ee9702e8e Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Wed, 1 Jun 2016 01:04:58 +0100
Subject: [PATCH 429/699] jQuery.escapeSelector: Created entry

Fixes gh-880
Closes gh-934
---
 entries/jQuery.escapeSelector.xml | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 entries/jQuery.escapeSelector.xml

diff --git a/entries/jQuery.escapeSelector.xml b/entries/jQuery.escapeSelector.xml
new file mode 100644
index 00000000..9e9a91d1
--- /dev/null
+++ b/entries/jQuery.escapeSelector.xml
@@ -0,0 +1,29 @@
+
+
+  jQuery.escapeSelector()
+  Escapes any character that has a special meaning in a CSS selector.
+  
+    3.0
+    
+      A string containing a selector expression to escape.
+    
+  
+  
+    
          This method is useful for situations where a class name or an ID contains characters that have a special meaning in CSS, such as the dot or the semicolon.
          
+    
          The method is essentially a shim for the CSS Working Group's CSS.escape() method. The main difference is that $.escapeSelector() can be reliably used in all of jQuery's supported browsers.
          
+            
+  
+    Escape an ID containing a hash.
+    
+  
+  
+    Select all the elements having a class name of .box inside a div.
+    
+  
+  
+  
+          

From a6452420b248ac519a93084ff9a539a3d0a954f5 Mon Sep 17 00:00:00 2001
From: Timmy Willison 
Date: Thu, 9 Jun 2016 17:26:02 -0400
Subject: [PATCH 430/699] 1.12.4

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 20678798..5703775b 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.3",
+  "version": "1.12.4",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 2dcad72a2f3eed7e0e1d37efc16b8424f9a7f8aa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Fri, 10 Jun 2016 00:07:34 +0200
Subject: [PATCH 431/699] categories: Change links from http to https

---
 categories.xml | 56 +++++++++++++++++++++++++-------------------------
 1 file changed, 28 insertions(+), 28 deletions(-)

diff --git a/categories.xml b/categories.xml
index c181a548..dd4b277a 100644
--- a/categories.xml
+++ b/categories.xml
@@ -38,7 +38,7 @@
     
     
       For more information, see the jQuery 1.3 Release Notes.
          
+        
          For more information, see the jQuery 1.3 Release Notes.
          
       ]]>          
               
     
@@ -48,22 +48,22 @@
     
     
       For more information, see the Release Notes/Changelog at http://blog.jquery.com/2011/11/03/jquery-1-7-released/
          
+        
          For more information, see the Release Notes/Changelog at https://blog.jquery.com/2011/11/03/jquery-1-7-released/
          
       ]]>          
               
     
       For more information, see the Release Notes/Changelog at http://blog.jquery.com/2012/08/09/jquery-1-8-released/
          
+        
          For more information, see the Release Notes/Changelog at https://blog.jquery.com/2012/08/09/jquery-1-8-released/
          
       ]]>          
               
     
       For more information, see the Release Notes/Changelog at http://blog.jquery.com/2013/01/15/jquery-1-9-final-jquery-2-0-beta-migrate-final-released/
          
+        
          For more information, see the Release Notes/Changelog at https://blog.jquery.com/2013/01/15/jquery-1-9-final-jquery-2-0-beta-migrate-final-released/
          
       ]]>          
               
     
       For more information, see the Release Notes/Changelog at http://blog.jquery.com/2013/05/24/jquery-1-10-0-and-2-0-1-released/
          
+        
          For more information, see the Release Notes/Changelog at https://blog.jquery.com/2013/05/24/jquery-1-10-0-and-2-0-1-released/
          
       ]]>          
               
   
@@ -98,7 +98,7 @@
     
     
       jQuery's event system normalizes the event object according to W3C standards. The event object is guaranteed to be passed to the event handler. Most properties from the original event are copied over and normalized to the new event object.
          
+        
          jQuery's event system normalizes the event object according to W3C standards. The event object is guaranteed to be passed to the event handler. Most properties from the original event are copied over and normalized to the new event object.
          
         
          
           
          jQuery.Event Constructor
          
           
          The jQuery.Event constructor is exposed and can be used when calling trigger. The new operator is optional.
          
@@ -238,13 +238,13 @@ var files = event.originalEvent.dataTransfer.files;
   
     Borrowing from CSS 1–3, and then adding its own, jQuery offers a powerful set of tools for matching a set of elements in a document.
          
-      
          To use any of the meta-characters ( such as  !"#$%&'()*+,./:;<=>?@[\]^`{|}~ ) as a literal part of a name, it must be escaped with with two backslashes: \\. For example, an element with id="foo.bar", can use the selector $("#foo\\.bar"). The W3C CSS specification contains the complete set of rules regarding valid CSS selectors. Also useful is the blog entry by Mathias Bynens on CSS character escape sequences for identifiers.
          
+      
          To use any of the meta-characters ( such as  !"#$%&'()*+,./:;<=>?@[\]^`{|}~ ) as a literal part of a name, it must be escaped with with two backslashes: \\. For example, an element with id="foo.bar", can use the selector $("#foo\\.bar"). The W3C CSS specification contains the complete set of rules regarding valid CSS selectors. Also useful is the blog entry by Mathias Bynens on CSS character escape sequences for identifiers.
          
     ]]>          
     
       The CSS specification allows elements to be identified by their attributes. While not supported by some older browsers for the purpose of styling documents, jQuery allows you to employ them regardless of the browser being used.
          
         
          When using any of the following attribute selectors, you should account for attributes that have multiple, space-separated values. Since these selectors see attribute values as a single string, this selector, for example, $("a[rel='nofollow']"), will select <a href="example.html" rel="nofollow">Some text</a> but not <a href="example.html" rel="nofollow foe">Some text</a>.
          
-        
          Attribute values in selector expressions must follow the rules for W3C CSS selectors; in general, that means anything other than a valid identifier should be surrounded by quotation marks.
          
+        
          Attribute values in selector expressions must follow the rules for W3C CSS selectors; in general, that means anything other than a valid identifier should be surrounded by quotation marks.
          
         
            
           
          • double quotes inside single quotes: $('a[rel="nofollow self"]')
            • 
           
          • single quotes inside double quotes: $("a[rel='nofollow self']")
            • 
@@ -258,7 +258,7 @@ var files = event.originalEvent.dataTransfer.files;
       
     
     
-      http://www.w3.org/Style/CSS/#specs. ]]>
+      https://www.w3.org/Style/CSS/#specs. ]]>
     
     
       
@@ -276,7 +276,7 @@ var files = event.originalEvent.dataTransfer.files;
       
     
     
-      querySelectorAll()             method. To achieve the best performance when using these selectors, first select some elements using a pure CSS selector, then use .filter().]]>
+      querySelectorAll()             method. To achieve the best performance when using these selectors, first select some elements using a pure CSS selector, then use .filter().]]>
     
     
       
@@ -302,52 +302,52 @@ var files = event.originalEvent.dataTransfer.files;
     
     
       jQuery 1.0 Release Notes.
+				jQuery 1.0 Release Notes.
 			]]>
     
     
       1.0.1, 1.0.2, 1.0.3, 1.0.4.
+				Release Notes: 1.0.1, 1.0.2, 1.0.3, 1.0.4.
 			]]>
     
     
       jQuery 1.1 Release Notes.
+				jQuery 1.1 Release Notes.
 			]]>
     
     
       jQuery 1.1.2 Release Notes.
+				jQuery 1.1.2 Release Notes.
 			]]>
     
     
       jQuery 1.1.3 Release Notes
+				jQuery 1.1.3 Release Notes
 			]]>
     
     
       jQuery 1.1.4 Release Notes.
+				jQuery 1.1.4 Release Notes.
 			]]>
     
     
       jQuery 1.2 Release Notes
+				jQuery 1.2 Release Notes
 			]]>
     
     
       1.2.1, 1.2.2, 1.2.3.
+				Release Notes: 1.2.1, 1.2.2, 1.2.3.
 			]]>
     
     
       jQuery 1.2.6 Release Notes.
+				jQuery 1.2.6 Release Notes.
 			]]>
     
     
       1.3, 1.3.1, 1.3.2
+				Release Notes: 1.3, 1.3.1, 1.3.2
 			]]>
     
     
@@ -362,22 +362,22 @@ var files = event.originalEvent.dataTransfer.files;
     
     
       jQuery 1.4.2 Release Notes.
+				jQuery 1.4.2 Release Notes.
 			]]>
     
     
       jQuery 1.4.3 Release Notes.
+				jQuery 1.4.3 Release Notes.
 			]]>
     
     
-      jQuery 1.4.4 Release Notes.]]>
+      jQuery 1.4.4 Release Notes.]]>
     
     
       All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
            
-        
            jQuery 1.5 also includes a large rewrite of the Ajax module, which has a number of extensibility improvements. You can find out more about those improvements in the Extending Ajax documentation.
            
-        
            Additionally jQuery 1.5 includes a new Deferred callback management system you can learn more about in in the Deferred Object documentation.
            
+        
            jQuery 1.5 also includes a large rewrite of the Ajax module, which has a number of extensibility improvements. You can find out more about those improvements in the Extending Ajax documentation.
            
+        
            Additionally jQuery 1.5 includes a new Deferred callback management system you can learn more about in in the Deferred Object documentation.
            
       ]]>            
                 
     
@@ -394,7 +394,7 @@ var files = event.originalEvent.dataTransfer.files;
 				jQuery.Callbacks()
 				Toggling Animations Work Intuitively
 				
            
-        
            For more information, see the Release Notes/Changelog at http://blog.jquery.com/2011/11/03/jquery-1-7-released/
            
+        
            For more information, see the Release Notes/Changelog at https://blog.jquery.com/2011/11/03/jquery-1-7-released/
            
         
            
       ]]>            
                 
@@ -402,7 +402,7 @@ var files = event.originalEvent.dataTransfer.files;
       Aspects of the API that were changed in the corresponding version of jQuery. API changes in jQuery 1.8.0 dealt primarily with animations and the removal of some methods such as deferred.isResolved(), deferred.isRejected(), $.curCSS(), $.attrFn(), and $(element).closest(Array) returning Array.
         
            
-        
            For more information, see the Release Notes/Changelog at http://blog.jquery.com/2012/08/09/jquery-1-8-released/
            
+        
            For more information, see the Release Notes/Changelog at https://blog.jquery.com/2012/08/09/jquery-1-8-released/
            
         
            
       ]]>            
     
@@ -410,7 +410,7 @@ var files = event.originalEvent.dataTransfer.files;
       Aspects of the API that were changed in the corresponding version of jQuery. Changes in jQuery 1.9 dealt primarily removal or modification of several APIs that behaved inconsistently or inefficiently in the past. A jQuery Migrate Plugin was offered to help developers with a transitional upgrade path.
         
            
-        
            For more information, see the jQuery Core 1.9 Upgrade guide and the Release Notes/Changelog
            
+        
            For more information, see the jQuery Core 1.9 Upgrade guide and the Release Notes/Changelog
            
         
            
       ]]>            
     

From cdb0c5ba6b3af574134acc13b10144e0a9dc2107 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Fri, 10 Jun 2016 00:08:50 +0200
Subject: [PATCH 432/699] categories: Correct a typo

---
 categories.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/categories.xml b/categories.xml
index dd4b277a..937f6ab5 100644
--- a/categories.xml
+++ b/categories.xml
@@ -408,7 +408,7 @@ var files = event.originalEvent.dataTransfer.files;
     
     
       Aspects of the API that were changed in the corresponding version of jQuery. Changes in jQuery 1.9 dealt primarily removal or modification of several APIs that behaved inconsistently or inefficiently in the past. A jQuery Migrate Plugin was offered to help developers with a transitional upgrade path.
+        
            Aspects of the API that were changed in the corresponding version of jQuery. Changes in jQuery 1.9 dealt primarily with removal or modification of several APIs that behaved inconsistently or inefficiently in the past. A jQuery Migrate Plugin was offered to help developers with a transitional upgrade path.
         
            
         
            For more information, see the jQuery Core 1.9 Upgrade guide and the Release Notes/Changelog
            
         
            

From 55946446c4971a2f10f21af65847ef9358b57af4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Fri, 10 Jun 2016 00:13:45 +0200
Subject: [PATCH 433/699] categories: Add the 3.0 section

Fixes #937
Closes #938
---
 categories.xml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/categories.xml b/categories.xml
index 937f6ab5..a7190a24 100644
--- a/categories.xml
+++ b/categories.xml
@@ -414,6 +414,14 @@ var files = event.originalEvent.dataTransfer.files;
         
            
       ]]>            
                 
+    
+      Aspects of the API that were changed in the corresponding version of jQuery. Changes in jQuery 3.0 dealt primarily with deferreds, data, show/hide and removal of some deprecated APIs. A jQuery Migrate Plugin was offered to help developers with a transitional upgrade path.
+        
            
+        
            For more information, see the jQuery Core 3.0 Upgrade guide and the Release Notes/Changelog
            
+        
            
+      ]]>            
+                
     
   
 

From 93110b7fd8824a467b6e585d520d29c9d51b0092 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Sat, 11 Jun 2016 00:56:16 +0200
Subject: [PATCH 434/699] 1.12.5

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 5703775b..2c0fb08a 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.4",
+  "version": "1.12.5",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 7af26e3158e68415a1b5f28cf7b96dcc1515d2c3 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Fri, 1 Jul 2016 17:19:15 +0100
Subject: [PATCH 435/699] data: Replaced URL markdown syntax with HTML

Fixes gh-943
Closes gh-944
---
 entries/data.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/data.xml b/entries/data.xml
index 80ccee99..3606395d 100644
--- a/entries/data.xml
+++ b/entries/data.xml
@@ -31,7 +31,7 @@ $( "body" ).data(); // { foo: 52, bar: { myType: "test", count: 40 }, baz: [ 1,
       
          
       
          In jQuery 1.4.3 setting an element's data object with .data(obj) extends the data previously stored with that element.
          
       
          Prior to jQuery 1.4.3 (starting in jQuery 1.4) the .data() method completely replaced all data, instead of just extending the data object. If you are using third-party plugins it may not be advisable to completely replace the element's data object, since plugins may have also set data.
          
-      
          jQuery 3 changes the behavior of this method to align it to the Dataset API specifications. Specifically, jQuery 3 transforms every two-character sequence of "-" (U+002D) followed by a lowercase ASCII letter by the uppercase version of the letter as per definition of [the algorithm of the Dataset API](http://www.w3.org/TR/html5/dom.html#dom-dataset). Writing a statement like $( "body" ).data( { "my-name": "aValue" } ).data(); will return { myName: "aValue" }.
          
+      
          jQuery 3 changes the behavior of this method to align it to the Dataset API specifications. Specifically, jQuery 3 transforms every two-character sequence of "-" (U+002D) followed by a lowercase ASCII letter by the uppercase version of the letter as per definition of the algorithm of the Dataset API. Writing a statement like $( "body" ).data( { "my-name": "aValue" } ).data(); will return { myName: "aValue" }.
          
       
          Due to the way browsers interact with plugins and external code, the .data() method cannot be used on <object> (unless it's a Flash plugin), <applet> or <embed> elements.
          
     
     

From ef3cc87ef771de72853f8f73118e02605a3ac82b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Wed, 6 Jul 2016 11:11:55 +0200
Subject: [PATCH 436/699] 1.12.6

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 2c0fb08a..28ef474a 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.5",
+  "version": "1.12.6",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From abe47693da490850e3c545c74a6ebcc14989c9fc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Wed, 6 Jul 2016 11:36:39 +0200
Subject: [PATCH 437/699] jQuery.readyException: Add the page, add the 3.1
 category

Fixes #942
Closes #946
---
 categories.xml                    |  6 ++++++
 entries/jQuery.readyException.xml | 24 ++++++++++++++++++++++++
 2 files changed, 30 insertions(+)
 create mode 100644 entries/jQuery.readyException.xml

diff --git a/categories.xml b/categories.xml
index a7190a24..55038248 100644
--- a/categories.xml
+++ b/categories.xml
@@ -422,6 +422,12 @@ var files = event.originalEvent.dataTransfer.files;
         
          
       ]]>
     
+    
+      jQuery.readyException was added.
          
+        
          
+      ]]>          
+              
     
   
 
diff --git a/entries/jQuery.readyException.xml b/entries/jQuery.readyException.xml
new file mode 100644
index 00000000..2c534ea9
--- /dev/null
+++ b/entries/jQuery.readyException.xml
@@ -0,0 +1,24 @@
+
+
+  jQuery.readyException()
+  Handles errors thrown synchronously in functions wrapped in jQuery().
+  
+    3.1
+    
+      An error thrown in the function wrapped in jQuery().
+    
+  
+  
+    
          This method is fired when an error is thrown synchronously in a function wrapped in jQuery() or jQuery( document ).ready(), or equivalent. By default it re-throws the error in a timeout so that it's logged in the console and passed to window.onerror instead of being swallowed. Overwrite this method if you want to handle such errors differently.
          
+            
+  
+    Pass the received error to console.error.
+    
+  
+  
+  
+          

From d143a116554e8a70267dfe38453a7398b5e3463f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Fri, 8 Jul 2016 01:01:41 +0200
Subject: [PATCH 438/699] 1.12.7

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 28ef474a..266fe856 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.6",
+  "version": "1.12.7",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 2b3ebc617f525a1b7c7f6c89e8fe5e97c54534f7 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Thu, 14 Jul 2016 08:34:39 -0400
Subject: [PATCH 439/699] val(): Update select multiple no selected statement
 for 3.0. Fixes #828

---
 entries/val.xml | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/entries/val.xml b/entries/val.xml
index 1ba0c365..7ab00ff3 100644
--- a/entries/val.xml
+++ b/entries/val.xml
@@ -11,7 +11,8 @@
     
     Get the current value of the first element in the set of matched elements.
     
-      
          The .val() method is primarily used to get the values of form elements such as input, select and textarea. When the first element in the collection is a select-multiple (i.e., a select element with the multiple attribute set), it returns an array containing the value of each selected option, or null if no options are selected. When called on an empty collection, it returns undefined.
          
+      
          The .val() method is primarily used to get the values of form elements such as input, select and textarea. When called on an empty collection, it returns undefined.
          
+      
          When the first element in the collection is a select-multiple (i.e., a select element with the multiple attribute set), .val() returns an array containing the value of each selected option. As of jQuery 3.0, if no options are selected, it returns an empty array; prior to jQuery 3.0, it returns null.
          
       
          For selects and checkboxes, you can also use the :selected and :checked selectors to get at values, for example:
          
       
          
 // Get the value from a dropdown select
@@ -27,7 +28,7 @@ $( "input:checkbox:checked" ).val();
 $( "input:radio[name=bar]:checked" ).val();
       
          
       
          
-        
          Note:  At present, using .val() on textarea elements strips carriage return characters from the browser-reported value. When this value is sent to the server via XHR however, carriage returns are preserved (or added by browsers which do not include them in the raw value). A workaround for this issue can be achieved using a valHook as follows:
          
+        
          Note:  At present, using .val() on textarea elements strips carriage return characters from the browser-reported value. When this value is sent to the server via XHR, however, carriage returns are preserved (or added by browsers which do not include them in the raw value). A workaround for this issue can be achieved using a valHook as follows:
          
       
          
       
          
 $.valHooks.textarea = {
@@ -115,17 +116,17 @@ $( "input" )
       1.4
       
         
-             
-                 
+        
+        
         A function returning the value to set. this is the current element. Receives the index position of the element in the set and the old value as arguments.
       
     
     Set the value of each element in the set of matched elements.
     
       
          This method is typically used to set the values of form fields. 
          
-      
          val() allows you to pass an array of element values. This is useful when working on a jQuery object containing elements like <input type="checkbox">, <input type="radio">, and <option>s inside of a <select>. In this case, the inputs and the options having a value that matches one of the elements of the array will be checked or selected while those having a value that don't match one of the elements of the array will be unchecked or unselected, depending on the type. In case of <input type="radio">s that are part of a radio group and <select>s, any previously selected element will be deselected.
          
+      
          val() allows you to pass an array of element values. This is useful when working on a jQuery object containing elements like <input type="checkbox">, <input type="radio">, and <option>s inside of a <select>. In this case, the inputs and the options having a value that matches one of the elements of the array will be checked or selected while those having a value that doesn't match one of the elements of the array will be unchecked or unselected, depending on the type. In the case of <input type="radio">s that are part of a radio group and <select>s, any previously selected element will be deselected.
          
       
          Setting values using this method (or using the native value property) does not cause the dispatch of the change event. For this reason, the relevant event handlers will not be executed. If you want to execute them, you should call .trigger( "change" ) after setting the value.
          
-      
          The .val() method allows us to set the value by passing in a function. As of jQuery 1.4, the function is passed two arguments, the current element's index and its current value: 
          
+      
          The .val() method allows settting the value by passing in a function. As of jQuery 1.4, the function is passed two arguments, the current element's index and its current value: 
          
       
          
 $( "input:text.items" ).val(function( index, value ) {
   return value + " " + this.className;

From da62fdd3250f71ecec1ccf5d2d66ee1a3337ed03 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 17 Jul 2016 17:17:50 +0100
Subject: [PATCH 440/699] Updated methods removed in jQuery 3

Fixes gh-956
Closes gh-957
---
 entries/andSelf.xml    | 3 ++-
 entries/context.xml    | 1 +
 entries/error.xml      | 3 ++-
 entries/load-event.xml | 3 ++-
 entries/size.xml       | 3 ++-
 entries/unload.xml     | 3 ++-
 6 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/entries/andSelf.xml b/entries/andSelf.xml
index 6870b479..5adfd1ae 100644
--- a/entries/andSelf.xml
+++ b/entries/andSelf.xml
@@ -1,5 +1,5 @@
 
-
+
   .andSelf()
   
     1.2
@@ -75,4 +75,5 @@ $( "div.after-andself" ).find( "p" ).andSelf().addClass( "background" );
   
   
   
+  
 
diff --git a/entries/context.xml b/entries/context.xml
index 0cf0f7b4..5fc5362a 100644
--- a/entries/context.xml
+++ b/entries/context.xml
@@ -26,4 +26,5 @@ Context: 
            
   
   
   
+  
             
diff --git a/entries/error.xml b/entries/error.xml
index 872ff70d..6f646aa2 100644
--- a/entries/error.xml
+++ b/entries/error.xml
@@ -1,5 +1,5 @@
 
-
+
   .error()
   Bind an event handler to the "error" JavaScript event.
   
@@ -60,4 +60,5 @@ $( "img" )
   
   
   
+  
 
diff --git a/entries/load-event.xml b/entries/load-event.xml
index d95f81bc..e3739cb7 100644
--- a/entries/load-event.xml
+++ b/entries/load-event.xml
@@ -1,5 +1,5 @@
 
-
+
   .load()
   Bind an event handler to the "load" JavaScript event.
   
@@ -76,4 +76,5 @@ $( "img.userIcon" ).load(function() {
   
   
   
+  
 
diff --git a/entries/size.xml b/entries/size.xml
index 2d092a37..e7dd1223 100644
--- a/entries/size.xml
+++ b/entries/size.xml
@@ -1,5 +1,5 @@
 
-
+
   .size()
   
     1.0
@@ -66,4 +66,5 @@ $( document.body )
   
   
   
+  
 
diff --git a/entries/unload.xml b/entries/unload.xml
index 173d560e..1306ddd6 100644
--- a/entries/unload.xml
+++ b/entries/unload.xml
@@ -1,5 +1,5 @@
 
-
+
   .unload()
   
     1.0
@@ -46,4 +46,5 @@ $( window ).unload(function() {
   
   
   
+  
 

From d5398a69edf4a97a44b49333e7ddefba36edc981 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Tue, 19 Apr 2016 02:12:21 +0100
Subject: [PATCH 441/699] jQuery.uniqueSort: Fixed category name

Fixes gh-908
Closes gh-913
---
 categories.xml                | 8 ++++++++
 entries/jQuery.uniqueSort.xml | 3 ++-
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/categories.xml b/categories.xml
index 55038248..d4d31106 100644
--- a/categories.xml
+++ b/categories.xml
@@ -414,6 +414,14 @@ var files = event.originalEvent.dataTransfer.files;
         
            
       ]]>
     
+    
+      Aspects of the API that were changed in the corresponding versions of jQuery. Changes in jQuery 1.12 and 2.2 includes performance improvements of the selector engine, manipulation of class names for SVG elements, support for the Symbol type and iterators added in ES2015, and a new hook has been added for filtering HTML. A jQuery Migrate Plugin was offered to help developers with a transitional upgrade path.
+        
            
+        
            For more information, see the Release Notes/Changelog
            
+        
            
+      ]]>            
+                
     
       Aspects of the API that were changed in the corresponding version of jQuery. Changes in jQuery 3.0 dealt primarily with deferreds, data, show/hide and removal of some deprecated APIs. A jQuery Migrate Plugin was offered to help developers with a transitional upgrade path.
diff --git a/entries/jQuery.uniqueSort.xml b/entries/jQuery.uniqueSort.xml
index a1927bda..88735af9 100644
--- a/entries/jQuery.uniqueSort.xml
+++ b/entries/jQuery.uniqueSort.xml
@@ -2,7 +2,7 @@
 
   jQuery.uniqueSort()
   
-    1.12/2.2
+    1.12-2.2
     
       The Array of DOM elements.
     
@@ -42,4 +42,5 @@ $( "div:eq(2)" ).text( "Post-unique there are " + divs.length + " elements." )
 ]]>
   
   
+  
 

From 3f3b61896c67f1bbef499e2135ebfb534ed86684 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Sun, 17 Jul 2016 13:19:35 -0400
Subject: [PATCH 442/699] Fix typo

---
 entries/val.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/val.xml b/entries/val.xml
index 7ab00ff3..d2e9dbfd 100644
--- a/entries/val.xml
+++ b/entries/val.xml
@@ -126,7 +126,7 @@ $( "input" )
       
            This method is typically used to set the values of form fields. 
            
       
            val() allows you to pass an array of element values. This is useful when working on a jQuery object containing elements like <input type="checkbox">, <input type="radio">, and <option>s inside of a <select>. In this case, the inputs and the options having a value that matches one of the elements of the array will be checked or selected while those having a value that doesn't match one of the elements of the array will be unchecked or unselected, depending on the type. In the case of <input type="radio">s that are part of a radio group and <select>s, any previously selected element will be deselected.
            
       
            Setting values using this method (or using the native value property) does not cause the dispatch of the change event. For this reason, the relevant event handlers will not be executed. If you want to execute them, you should call .trigger( "change" ) after setting the value.
            
-      
            The .val() method allows settting the value by passing in a function. As of jQuery 1.4, the function is passed two arguments, the current element's index and its current value: 
            
+      
            The .val() method allows setting the value by passing in a function. As of jQuery 1.4, the function is passed two arguments, the current element's index and its current value: 
            
       
            
 $( "input:text.items" ).val(function( index, value ) {
   return value + " " + this.className;

From c0cd6b2d045ea2b8b481c424849f1107a8074549 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 17 Jul 2016 17:17:50 +0100
Subject: [PATCH 443/699] Updated methods removed in jQuery 3

Fixes gh-956
Closes gh-957
---
 entries/andSelf.xml    | 3 ++-
 entries/context.xml    | 1 +
 entries/error.xml      | 3 ++-
 entries/load-event.xml | 3 ++-
 entries/size.xml       | 3 ++-
 entries/unload.xml     | 3 ++-
 6 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/entries/andSelf.xml b/entries/andSelf.xml
index 6870b479..5adfd1ae 100644
--- a/entries/andSelf.xml
+++ b/entries/andSelf.xml
@@ -1,5 +1,5 @@
 
-
+
   .andSelf()
   
     1.2
@@ -75,4 +75,5 @@ $( "div.after-andself" ).find( "p" ).andSelf().addClass( "background" );
   
   
   
+  
 
diff --git a/entries/context.xml b/entries/context.xml
index 0cf0f7b4..5fc5362a 100644
--- a/entries/context.xml
+++ b/entries/context.xml
@@ -26,4 +26,5 @@ Context: 
              
   
   
   
+  
               
diff --git a/entries/error.xml b/entries/error.xml
index 872ff70d..6f646aa2 100644
--- a/entries/error.xml
+++ b/entries/error.xml
@@ -1,5 +1,5 @@
 
-
+
   .error()
   Bind an event handler to the "error" JavaScript event.
   
@@ -60,4 +60,5 @@ $( "img" )
   
   
   
+  
 
diff --git a/entries/load-event.xml b/entries/load-event.xml
index d95f81bc..e3739cb7 100644
--- a/entries/load-event.xml
+++ b/entries/load-event.xml
@@ -1,5 +1,5 @@
 
-
+
   .load()
   Bind an event handler to the "load" JavaScript event.
   
@@ -76,4 +76,5 @@ $( "img.userIcon" ).load(function() {
   
   
   
+  
 
diff --git a/entries/size.xml b/entries/size.xml
index 2d092a37..e7dd1223 100644
--- a/entries/size.xml
+++ b/entries/size.xml
@@ -1,5 +1,5 @@
 
-
+
   .size()
   
     1.0
@@ -66,4 +66,5 @@ $( document.body )
   
   
   
+  
 
diff --git a/entries/unload.xml b/entries/unload.xml
index 173d560e..1306ddd6 100644
--- a/entries/unload.xml
+++ b/entries/unload.xml
@@ -1,5 +1,5 @@
 
-
+
   .unload()
   
     1.0
@@ -46,4 +46,5 @@ $( window ).unload(function() {
   
   
   
+  
 

From 1b230db9c25a2fe55801454bf83487ca903bca97 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Tue, 19 Apr 2016 02:12:21 +0100
Subject: [PATCH 444/699] jQuery.uniqueSort: Fixed category name

Fixes gh-908
Closes gh-913
---
 categories.xml                | 8 ++++++++
 entries/jQuery.uniqueSort.xml | 3 ++-
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/categories.xml b/categories.xml
index 55038248..d4d31106 100644
--- a/categories.xml
+++ b/categories.xml
@@ -414,6 +414,14 @@ var files = event.originalEvent.dataTransfer.files;
         
              
       ]]>
     
+    
+      Aspects of the API that were changed in the corresponding versions of jQuery. Changes in jQuery 1.12 and 2.2 includes performance improvements of the selector engine, manipulation of class names for SVG elements, support for the Symbol type and iterators added in ES2015, and a new hook has been added for filtering HTML. A jQuery Migrate Plugin was offered to help developers with a transitional upgrade path.
+        
              
+        
              For more information, see the Release Notes/Changelog
              
+        
              
+      ]]>              
+                  
     
       Aspects of the API that were changed in the corresponding version of jQuery. Changes in jQuery 3.0 dealt primarily with deferreds, data, show/hide and removal of some deprecated APIs. A jQuery Migrate Plugin was offered to help developers with a transitional upgrade path.
diff --git a/entries/jQuery.uniqueSort.xml b/entries/jQuery.uniqueSort.xml
index a1927bda..88735af9 100644
--- a/entries/jQuery.uniqueSort.xml
+++ b/entries/jQuery.uniqueSort.xml
@@ -2,7 +2,7 @@
 
   jQuery.uniqueSort()
   
-    1.12/2.2
+    1.12-2.2
     
       The Array of DOM elements.
     
@@ -42,4 +42,5 @@ $( "div:eq(2)" ).text( "Post-unique there are " + divs.length + " elements." )
 ]]>
   
   
+  
 

From 5689f1ade9bcbdb9bb9507f44ccf60dba167c2b8 Mon Sep 17 00:00:00 2001
From: Anton Rieder 
Date: Sun, 17 Jul 2016 13:25:40 -0400
Subject: [PATCH 445/699] Fix documentation for .val()

---
 entries/val.xml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/entries/val.xml b/entries/val.xml
index 1ba0c365..2aaeeb8e 100644
--- a/entries/val.xml
+++ b/entries/val.xml
@@ -13,6 +13,7 @@
     
       
              The .val() method is primarily used to get the values of form elements such as input, select and textarea. When the first element in the collection is a select-multiple (i.e., a select element with the multiple attribute set), it returns an array containing the value of each selected option, or null if no options are selected. When called on an empty collection, it returns undefined.
              
       
              For selects and checkboxes, you can also use the :selected and :checked selectors to get at values, for example:
              
+      
              jQuery 3 changes the behavior of this method to return an empty array if a collection is a select-multiple and no options are selected.
              
       
              
 // Get the value from a dropdown select
 $( "select.foo option:selected").val();
@@ -43,6 +44,8 @@ $.valHooks.textarea = {
 function displayVals() {
   var singleValues = $( "#single" ).val();
   var multipleValues = $( "#multiple" ).val() || [];
+  // When using jQuery 3:
+  // var multipleValues = $( "#multiple" ).val()
   $( "p" ).html( "Single: " + singleValues +
     " Multiple: " + multipleValues.join( ", " ) );
 }

From 56358d08841fc49d842012d82051e9a085471d1e Mon Sep 17 00:00:00 2001
From: Anton Rieder 
Date: Sun, 17 Jul 2016 13:25:40 -0400
Subject: [PATCH 446/699] Fix documentation for .val()

---
 entries/val.xml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/entries/val.xml b/entries/val.xml
index d2e9dbfd..73d9d521 100644
--- a/entries/val.xml
+++ b/entries/val.xml
@@ -14,6 +14,7 @@
       
              The .val() method is primarily used to get the values of form elements such as input, select and textarea. When called on an empty collection, it returns undefined.
              
       
              When the first element in the collection is a select-multiple (i.e., a select element with the multiple attribute set), .val() returns an array containing the value of each selected option. As of jQuery 3.0, if no options are selected, it returns an empty array; prior to jQuery 3.0, it returns null.
              
       
              For selects and checkboxes, you can also use the :selected and :checked selectors to get at values, for example:
              
+      
              jQuery 3 changes the behavior of this method to return an empty array if a collection is a select-multiple and no options are selected.
              
       
              
 // Get the value from a dropdown select
 $( "select.foo option:selected").val();
@@ -44,6 +45,8 @@ $.valHooks.textarea = {
 function displayVals() {
   var singleValues = $( "#single" ).val();
   var multipleValues = $( "#multiple" ).val() || [];
+  // When using jQuery 3:
+  // var multipleValues = $( "#multiple" ).val()
   $( "p" ).html( "Single: " + singleValues +
     " Multiple: " + multipleValues.join( ", " ) );
 }

From ef2a80ec079a49bfebe402814d91c827949ba6a6 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Sun, 17 Jul 2016 13:35:40 -0400
Subject: [PATCH 447/699] val(): Update select multiple no selected statement
 for 3.0. Fixes gh-828. Closes gh-955

---
 entries/val.xml | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/entries/val.xml b/entries/val.xml
index 2aaeeb8e..73d9d521 100644
--- a/entries/val.xml
+++ b/entries/val.xml
@@ -11,7 +11,8 @@
     
     Get the current value of the first element in the set of matched elements.
     
-      
              The .val() method is primarily used to get the values of form elements such as input, select and textarea. When the first element in the collection is a select-multiple (i.e., a select element with the multiple attribute set), it returns an array containing the value of each selected option, or null if no options are selected. When called on an empty collection, it returns undefined.
              
+      
              The .val() method is primarily used to get the values of form elements such as input, select and textarea. When called on an empty collection, it returns undefined.
              
+      
              When the first element in the collection is a select-multiple (i.e., a select element with the multiple attribute set), .val() returns an array containing the value of each selected option. As of jQuery 3.0, if no options are selected, it returns an empty array; prior to jQuery 3.0, it returns null.
              
       
              For selects and checkboxes, you can also use the :selected and :checked selectors to get at values, for example:
              
       
              jQuery 3 changes the behavior of this method to return an empty array if a collection is a select-multiple and no options are selected.
              
       
              
@@ -28,7 +29,7 @@ $( "input:checkbox:checked" ).val();
 $( "input:radio[name=bar]:checked" ).val();
       
              
       
              
-        
              Note:  At present, using .val() on textarea elements strips carriage return characters from the browser-reported value. When this value is sent to the server via XHR however, carriage returns are preserved (or added by browsers which do not include them in the raw value). A workaround for this issue can be achieved using a valHook as follows:
              
+        
              Note:  At present, using .val() on textarea elements strips carriage return characters from the browser-reported value. When this value is sent to the server via XHR, however, carriage returns are preserved (or added by browsers which do not include them in the raw value). A workaround for this issue can be achieved using a valHook as follows:
              
       
              
       
              
 $.valHooks.textarea = {
@@ -118,17 +119,17 @@ $( "input" )
       1.4
       
         
-             
-                 
+        
+        
         A function returning the value to set. this is the current element. Receives the index position of the element in the set and the old value as arguments.
       
     
     Set the value of each element in the set of matched elements.
     
       
              This method is typically used to set the values of form fields. 
              
-      
              val() allows you to pass an array of element values. This is useful when working on a jQuery object containing elements like <input type="checkbox">, <input type="radio">, and <option>s inside of a <select>. In this case, the inputs and the options having a value that matches one of the elements of the array will be checked or selected while those having a value that don't match one of the elements of the array will be unchecked or unselected, depending on the type. In case of <input type="radio">s that are part of a radio group and <select>s, any previously selected element will be deselected.
              
+      
              val() allows you to pass an array of element values. This is useful when working on a jQuery object containing elements like <input type="checkbox">, <input type="radio">, and <option>s inside of a <select>. In this case, the inputs and the options having a value that matches one of the elements of the array will be checked or selected while those having a value that doesn't match one of the elements of the array will be unchecked or unselected, depending on the type. In the case of <input type="radio">s that are part of a radio group and <select>s, any previously selected element will be deselected.
              
       
              Setting values using this method (or using the native value property) does not cause the dispatch of the change event. For this reason, the relevant event handlers will not be executed. If you want to execute them, you should call .trigger( "change" ) after setting the value.
              
-      
              The .val() method allows us to set the value by passing in a function. As of jQuery 1.4, the function is passed two arguments, the current element's index and its current value: 
              
+      
              The .val() method allows setting the value by passing in a function. As of jQuery 1.4, the function is passed two arguments, the current element's index and its current value: 
              
       
              
 $( "input:text.items" ).val(function( index, value ) {
   return value + " " + this.className;

From 470df7b2e68743ed0e6f15addc649a28a4129b3b Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Sun, 17 Jul 2016 13:54:34 -0400
Subject: [PATCH 448/699] Fix duplicate info due to my bad merge

---
 entries/val.xml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/entries/val.xml b/entries/val.xml
index 73d9d521..b2aa7613 100644
--- a/entries/val.xml
+++ b/entries/val.xml
@@ -13,9 +13,9 @@
     
       
              The .val() method is primarily used to get the values of form elements such as input, select and textarea. When called on an empty collection, it returns undefined.
              
       
              When the first element in the collection is a select-multiple (i.e., a select element with the multiple attribute set), .val() returns an array containing the value of each selected option. As of jQuery 3.0, if no options are selected, it returns an empty array; prior to jQuery 3.0, it returns null.
              
-      
              For selects and checkboxes, you can also use the :selected and :checked selectors to get at values, for example:
              
-      
              jQuery 3 changes the behavior of this method to return an empty array if a collection is a select-multiple and no options are selected.
              
+      
              For selects and checkboxes, you can also use the :selected and :checked selectors to get at values. For example:
              
       
              
+
 // Get the value from a dropdown select
 $( "select.foo option:selected").val();
 
@@ -29,7 +29,7 @@ $( "input:checkbox:checked" ).val();
 $( "input:radio[name=bar]:checked" ).val();
       
              
       
              
-        
              Note:  At present, using .val() on textarea elements strips carriage return characters from the browser-reported value. When this value is sent to the server via XHR, however, carriage returns are preserved (or added by browsers which do not include them in the raw value). A workaround for this issue can be achieved using a valHook as follows:
              
+        
              Note:  At present, using .val() on <textarea> elements strips carriage return characters from the browser-reported value. When this value is sent to the server via XHR, however, carriage returns are preserved (or added by browsers which do not include them in the raw value). A workaround for this issue can be achieved using a valHook as follows:
              
       
              
       
              
 $.valHooks.textarea = {
@@ -46,7 +46,7 @@ function displayVals() {
   var singleValues = $( "#single" ).val();
   var multipleValues = $( "#multiple" ).val() || [];
   // When using jQuery 3:
-  // var multipleValues = $( "#multiple" ).val()
+  // var multipleValues = $( "#multiple" ).val();
   $( "p" ).html( "Single: " + singleValues +
     " Multiple: " + multipleValues.join( ", " ) );
 }

From 574cd0ab5c264101f1f339442be5aa2dbd858937 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Sun, 17 Jul 2016 14:07:34 -0400
Subject: [PATCH 449/699] .val(): Ugh. Remove another merge snafu.

---
 entries/val.xml | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/entries/val.xml b/entries/val.xml
index 0283b1bc..b2aa7613 100644
--- a/entries/val.xml
+++ b/entries/val.xml
@@ -46,11 +46,7 @@ function displayVals() {
   var singleValues = $( "#single" ).val();
   var multipleValues = $( "#multiple" ).val() || [];
   // When using jQuery 3:
-<<<<<<< HEAD
-  // var multipleValues = $( "#multiple" ).val()
-=======
   // var multipleValues = $( "#multiple" ).val();
->>>>>>> multi-select-val
   $( "p" ).html( "Single: " + singleValues +
     " Multiple: " + multipleValues.join( ", " ) );
 }

From c15623ef1cac00bec4fb6fc369376d1612d3c9e5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Mon, 25 Jul 2016 13:43:48 +0200
Subject: [PATCH 450/699] 1.12.8

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 266fe856..77495144 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.7",
+  "version": "1.12.8",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From d2d750a6fe8f0a66cacd295fc0123b4a4fdf42d3 Mon Sep 17 00:00:00 2001
From: Gaurang Patel 
Date: Tue, 2 Aug 2016 18:22:17 -0700
Subject: [PATCH 451/699] clone: Fixed a minor typo

Closes gh-963
---
 entries/clone.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/clone.xml b/entries/clone.xml
index 91d7bc29..764b6668 100644
--- a/entries/clone.xml
+++ b/entries/clone.xml
@@ -63,7 +63,7 @@ $( ".hello" ).clone().appendTo( ".goodbye" );
     
              However, objects and arrays within element data are not copied and will continue to be shared between the cloned element and the original element. To deep copy all data, copy each one manually:
              
     
              
 // Original element with attached data
-var $elem = $( "#elem" ).data( "arr": [ 1 ] ),
+var $elem = $( "#elem" ).data( "arr", [ 1 ] ),
     $clone = $elem.clone( true )
       // Deep copy to prevent data sharing
       .data( "arr", $.extend( [], $elem.data( "arr" ) ) );

From 925c41e5a4aa0b8cd0b1f31ceb3e98470f9f35cd Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Fri, 5 Aug 2016 14:39:25 +0100
Subject: [PATCH 452/699] 1.12.9

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 77495144..961b2340 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.8",
+  "version": "1.12.9",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From ba2abaa99d0236e8360efe9e76e778984c91b715 Mon Sep 17 00:00:00 2001
From: Dave Methvin 
Date: Sat, 6 Aug 2016 17:50:33 -0400
Subject: [PATCH 453/699] Ready: Rewrite to clarify and add jQuery 3.0 notes.

Fixes gh-964
Closes gh-967
---
 entries/ready.xml | 50 +++++++++++++++++++++++++----------------------
 1 file changed, 27 insertions(+), 23 deletions(-)

diff --git a/entries/ready.xml b/entries/ready.xml
index 09e1993f..9f14ae52 100644
--- a/entries/ready.xml
+++ b/entries/ready.xml
@@ -9,49 +9,53 @@
     
   
   
-    
              While JavaScript provides the load event for executing code when a page is rendered, this event does not get triggered until all assets such as images have been completely received. In most cases, the script can be run as soon as the DOM hierarchy has been fully constructed. The handler passed to .ready() is guaranteed to be executed after the DOM is ready, so this is usually the best place to attach all other event handlers and run other jQuery code.  When using scripts that rely on the value of CSS style properties, it's important to reference external stylesheets or embed style elements before referencing the scripts.
              
-    
              In cases where code relies on loaded assets (for example, if the dimensions of an image are required), the code should be placed in a handler for the load event instead.
              
-    
              
-      
              The .ready() method is generally incompatible with the <body onload=""> attribute. If load must be used, either do not use .ready() or use jQuery's .load() method to attach load event handlers to the window or to more specific items, like images.
-      
              
-    
              
-    
              All three of the following syntaxes are equivalent:
              
+    
              The .ready() method offers a way to run JavaScript code as soon as the page's Document Object Model (DOM) becomes safe to manipulate. This will often be a good time to perform tasks that are needed before the user views or interacts with the page, for example to add event handlers and initialize plugins. When multiple functions are added via successive calls to this method, they run when the DOM is ready in the order in which they are added. As of jQuery 3.0, jQuery ensures that an exception occuring in one handler does not prevent subsequently added handlers from executing.
              
+
+    
              Most browsers provide similar functionality in the form of a DOMContentLoaded event. However, jQuery's .ready() method differs in an important and useful way: If the DOM becomes ready and the browser fires DOMContentLoaded before the code calls .ready( handler ), the function handler will still be executed. In contrast, a DOMContentLoaded event listener added after the event fires is never executed.
              
+
+    
              Browsers also provide the load event on the window object. When this event fires it indicates that all assets on the page have loaded, including images. This event can be watched in jQuery using $( window ).on( "load", handler ). In cases where code relies on loaded assets (for example, if the dimensions of an image are required), the code should be placed in a handler for the load event instead.
              
+    
+    
              Note that although the DOM always becomes ready before the page is fully loaded, it is usually not safe to attach a load event listener in code executed during a .ready() handler. For example, scripts can be loaded dynamically long after the page has loaded using methods such as $.getScript(). Although handlers added by .ready() will always be executed in a dynamically loaded script, the window's load event has already occurred and those listeners will never run.
              
+
+    
              jQuery offers several ways to attach a function that will run when the DOM is ready. All of the following syntaxes are equivalent:
              
+
     
                
-      
              • 
-        $( document ).ready( handler )
-      
                • 
-      
              • $().ready( handler ) (this is not recommended)
                • 
-      
              • 
-        $( handler )
-      
                • 
+      
              • $( handler )
                • 
+      
              • $( document ).ready( handler )
                • 
+      
              • $( "document" ).ready( handler )
                • 
+      
              • $( "img" ).ready( handler )
                • 
+      
              • $().ready( handler )
                • 
     
              
-    
              There is also $(document).on( "ready", handler ), deprecated as of jQuery 1.8. This behaves similarly to the ready method but if the ready event has already fired and you try to .on( "ready" ) the bound handler will not be executed. Ready handlers bound this way are executed after any bound by the other three methods above.
              
-    
              The .ready() method can only be called on a jQuery object matching the current document, so the selector can be omitted.
              
+
+    
              As of jQuery 3.0, only the first syntax is recommended; the other syntaxes still work but are deprecated. This is because the selection has no bearing on the behavior of the .ready() method, which is inefficient and can lead to incorrect assumptions about the method's behavior. For example, the third syntax works with "document" which selects nothing. The fourth syntax waits for the document to be ready but implies (incorrectly) that it waits for images to become ready. 
              
+
+    
              There is also $(document).on( "ready", handler ), deprecated as of jQuery 1.8 and removed in jQuery 3.0. Note that if the DOM becomes ready before this event is attached, the handler will not be executed.
              
+
     
              The .ready() method is typically used with an anonymous function:
              
     
              
 $( document ).ready(function() {
   // Handler for .ready() called.
 });
     
              
-    
              Which is equivalent to calling:
              
+    
              Which is equivalent to the recommended way of calling:
              
     
              
 $(function() {
   // Handler for .ready() called.
 });
     
              
-    
              If .ready() is called after the DOM has been initialized, the new handler passed in will be executed immediately.
              
-    
              Aliasing the jQuery Namespace
              
-    
              When using another JavaScript library, we may wish to call $.noConflict() to avoid namespace difficulties. When this function is called, the $ shortcut is no longer available, forcing us to write jQuery each time we would normally write $. However, the handler passed to the .ready() method can take an argument, which is passed the global jQuery object. This means we can rename the object within the context of our .ready() handler without affecting other code:
              
+    
              Aliasing the jQuery Object
              
+    
              When $.noConflict() is used to avoid namespace conflicts, the $ shortcut is no longer available. However, the .ready() handler is passed a reference to the jQuery object that called the method. This allows the handler to use a jQuery object, for example as $, without knowing its aliased name:
              
     
              
-jQuery( document ).ready(function( $ ) {
-  // Code using $ as usual goes here.
+jq2 = jQuery.noConflict();
+jq2(function( $ ) {
+  // Code using $ as usual goes here; the actual jQuery object is jq2
 });
     
              
                 
   
     Display a message when the DOM is loaded.
     

From fd4e6355c2839b024a98ff4e5650f8c5463406de Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Sat, 6 Aug 2016 17:53:26 -0400
Subject: [PATCH 454/699] 1.12.10

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 961b2340..e5db9eed 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.9",
+  "version": "1.12.10",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From e55cf6302af7ee9fe849d062998ebda0510ad43f Mon Sep 17 00:00:00 2001
From: Dave Methvin 
Date: Mon, 8 Aug 2016 18:14:20 -0400
Subject: [PATCH 455/699] 1.12.11

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index e5db9eed..3a62a3fe 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.10",
+  "version": "1.12.11",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 9fef869ecd132c6f8bcfb92bf60a50251289f962 Mon Sep 17 00:00:00 2001
From: Dave Methvin 
Date: Wed, 10 Aug 2016 17:18:45 -0400
Subject: [PATCH 456/699] Deprecate jQuery.fx.interval as of 3.0

Closes #969
---
 entries/jQuery.fx.interval.xml | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/entries/jQuery.fx.interval.xml b/entries/jQuery.fx.interval.xml
index cf67f484..5516d75c 100644
--- a/entries/jQuery.fx.interval.xml
+++ b/entries/jQuery.fx.interval.xml
@@ -1,12 +1,13 @@
 
-
+
   jQuery.fx.interval
   The rate (in milliseconds) at which animations fire.
   
     1.4.3
   
   
-    
              This property can be manipulated to adjust the number of frames per second at which animations will run. The default is 13 milliseconds. Making this a lower number could make the animations run smoother in faster browsers (such as Chrome) but there may be performance and CPU implications of doing so.
              
+    
              This property is deprecated as of version 3.0, and has no effect in browsers that support the requestAnimationFrame method.
              
+    
              On browsers that do not support requestAnimationFrame, this property can be changed to adjust the interval at which animations will run. The default is 13 milliseconds.
              
     
              Since jQuery uses one global interval, no animation should be running or all animations should stop for the change of this property to take effect.
              
                 
   
@@ -34,4 +35,5 @@ $( "input" ).click(function() {
   
   
   
+  
               

From 69cc61fa64fd1468264cda3c3393c3e20247a74b Mon Sep 17 00:00:00 2001
From: Dave Methvin 
Date: Mon, 8 Aug 2016 16:52:21 -0400
Subject: [PATCH 457/699] Filter: Explain behavior on text and comment nodes

Closes #968
---
 entries/filter.xml | 1 +
 entries/not.xml    | 1 +
 2 files changed, 2 insertions(+)

diff --git a/entries/filter.xml b/entries/filter.xml
index 831672aa..01489193 100644
--- a/entries/filter.xml
+++ b/entries/filter.xml
@@ -76,6 +76,7 @@ $( "li" )
     .css( "background-color", "red" );
     
              
     
              This alteration to the code will cause the third and sixth list items to be highlighted, as it uses the modulus operator (%) to select every item with an index value that, when divided by 3, has a remainder of 2.
              
+    
              Note: When a CSS selector string is passed to .filter(), text and comment nodes will always be removed from the resulting jQuery object during the filtering process. When a specific node or array of nodes are provided, a text or comment node will be included in the resulting jQuery object only if it matches one of the nodes in the filtering array.
              
     
   
   
diff --git a/entries/not.xml b/entries/not.xml
index 059e5e29..a9a0880d 100644
--- a/entries/not.xml
+++ b/entries/not.xml
@@ -61,6 +61,7 @@ $( "li" ).not( document.getElementById( "notli" ) )
     
              
     
              This statement changes the color of items 1, 2, 4, and 5. We could have accomplished the same thing with a simpler jQuery expression, but this technique can be useful when, for example, other libraries provide references to plain DOM nodes.
              
     
              As of jQuery 1.4, the .not() method can take a function as its argument in the same way that .filter() does. Elements for which the function returns true are excluded from the filtered set; all other elements are included.
              
+    
              Note: When a CSS selector string is passed to .not(), text and comment nodes will always be removed from the resulting jQuery object during the filtering process. When a specific node or array of nodes are provided, text or comment nodes will only be removed from the jQuery object if they match one of the nodes in the filtering array.
              
                 
   
     Adds a border to divs that are not green or blue.

From 878331190459558435bb9a969c0eeb3e5f986bab Mon Sep 17 00:00:00 2001
From: Dave Methvin 
Date: Tue, 23 Aug 2016 17:30:15 -0400
Subject: [PATCH 458/699] 1.12.12

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 3a62a3fe..d306d940 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.11",
+  "version": "1.12.12",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From ae219e2795668f2bc5df5486b5102bbad11b1e6f Mon Sep 17 00:00:00 2001
From: Dave Methvin 
Date: Tue, 23 Aug 2016 17:49:51 -0400
Subject: [PATCH 459/699] 1.12.13

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index d306d940..2fb714fc 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.12",
+  "version": "1.12.13",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 9fa469e1804241d753fe3bd7d72a640960448130 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 10 Jul 2016 12:26:58 +0100
Subject: [PATCH 460/699] bind, unbind, delegate, undelegate: Document the
 methods were deprecated in jQuery 3

Also, add the missing deprecated-3.0 category

Fixes gh-945
---
 categories.xml         | 5 +++++
 entries/bind.xml       | 5 +++--
 entries/delegate.xml   | 5 +++--
 entries/unbind.xml     | 6 ++++--
 entries/undelegate.xml | 6 ++++--
 5 files changed, 19 insertions(+), 8 deletions(-)

diff --git a/categories.xml b/categories.xml
index d4d31106..58563915 100644
--- a/categories.xml
+++ b/categories.xml
@@ -66,6 +66,11 @@
         
              For more information, see the Release Notes/Changelog at https://blog.jquery.com/2013/05/24/jquery-1-10-0-and-2-0-1-released/
              
       ]]>
     
+    
+      For more information, see the Release Notes/Changelog at http://blog.jquery.com/2016/06/09/jquery-3-0-final-released/
              
+      ]]>              
+                  
   
   
 	  
diff --git a/entries/bind.xml b/entries/bind.xml
index a81e46a8..05856faa 100644
--- a/entries/bind.xml
+++ b/entries/bind.xml
@@ -1,5 +1,5 @@
 
-
+
   .bind()
   
     1.0
@@ -34,7 +34,7 @@
   
   Attach a handler to an event for the elements.
   
-    
              As of jQuery 1.7, the .on() method is the preferred method for attaching event handlers to a document. For earlier versions, the .bind() method is used for attaching an event handler directly to elements. Handlers are attached to the currently selected elements in the jQuery object, so those elements must exist at the point the call to .bind() occurs. For more flexible event binding, see the discussion of event delegation in .on() or .delegate().
              
+    
              As of jQuery 3.0, .bind() has been deprecated. It was superseded by the .on() method for attaching event handlers to a document since jQuery 1.7, so its use was already discouraged. For earlier versions, the .bind() method is used for attaching an event handler directly to elements. Handlers are attached to the currently selected elements in the jQuery object, so those elements must exist at the point the call to .bind() occurs. For more flexible event binding, see the discussion of event delegation in .on() or .delegate().
              
     
              Any string is legal for eventType; if the string is not the name of a native DOM event, then the handler is bound to a custom event. These events are never called by the browser, but may be triggered manually from other JavaScript code using .trigger() or .triggerHandler().
              
     
              If the eventType string contains a period (.) character, then the event is namespaced. The period character separates the event from its namespace. For example, in the call .bind( "click.name", handler ), the string click is the event type, and the string name is the namespace. Namespacing allows us to unbind or trigger some events of a type without affecting others. See the discussion of .unbind() for more information.
              
     
              There are shorthand methods for some standard browser events such as .click() that can be used to attach or trigger event handlers. For a complete list of shorthand methods, see the events category.
              
@@ -259,4 +259,5 @@ $( "div.test" ).bind({
   
   
   
+  
               
diff --git a/entries/delegate.xml b/entries/delegate.xml
index e1670e84..10641ae6 100644
--- a/entries/delegate.xml
+++ b/entries/delegate.xml
@@ -1,5 +1,5 @@
 
-
+
   .delegate()
   Attach a handler to one or more events for all elements that match the selector, now or in the future, based on a specific set of root elements.
   
@@ -41,7 +41,7 @@
     
   
   
-    
              As of jQuery 1.7, .delegate() has been superseded by the .on() method. For earlier versions, however, it remains the most effective means to use event delegation. More information on event binding and delegation is in the .on() method. In general, these are the equivalent templates for the two methods:
              
+    
              As of jQuery 3.0, .delegate() has been deprecated. It was superseded by the .on() method since jQuery 1.7, so its use was already discouraged. For earlier versions, however, it remains the most effective means to use event delegation. More information on event binding and delegation is in the .on() method. In general, these are the equivalent templates for the two methods:
              
     
              
 // jQuery 1.4.3+
 $( elements ).delegate( selector, events, data, handler );
@@ -148,4 +148,5 @@ $( "button" ).click(function() {
   
   
   
+  
 
diff --git a/entries/unbind.xml b/entries/unbind.xml
index e6be9a13..c53dd6af 100644
--- a/entries/unbind.xml
+++ b/entries/unbind.xml
@@ -1,5 +1,5 @@
 
-
+
   .unbind()
   Remove a previously-attached event handler from the elements.
   
@@ -31,7 +31,8 @@
     1.0
   
   
-    
              Event handlers attached with .bind() can be removed with .unbind(). (As of jQuery 1.7, the .on() and .off() methods are preferred to attach and remove event handlers on elements.) In the simplest case, with no arguments, .unbind() removes all handlers attached to the elements:
              
+    
              As of jQuery 3.0, .unbind() has been deprecated. It was superseded by the .off() method since jQuery 1.7, so its use was already discouraged.
              
+    
              Event handlers attached with .bind() can be removed with .unbind(). In the simplest case, with no arguments, .unbind() removes all handlers attached to the elements:
              
     
              
 $( "#foo" ).unbind();
     
              
@@ -155,4 +156,5 @@ $( "p" ).unbind( "click", foo ); // ... foo will no longer be called.
   
   
   
+  
               
diff --git a/entries/undelegate.xml b/entries/undelegate.xml
index 842a504a..f97e6b01 100644
--- a/entries/undelegate.xml
+++ b/entries/undelegate.xml
@@ -1,5 +1,5 @@
 
-
+
   .undelegate()
   Remove a handler from the event for all elements which match the current selector, based upon a specific set of root elements.
   
@@ -43,7 +43,8 @@
     
   
   
-    
              The .undelegate() method is a way of removing event handlers that have been bound using .delegate(). As of jQuery 1.7, the .on() and .off() methods are preferred for attaching and removing event handlers.
              
+    
              As of jQuery 3.0, .undelegate() has been deprecated. It was superseded by the .off() method since jQuery 1.7, so its use was already discouraged.
              
+    
              The .undelegate() method is a way of removing event handlers that have been bound using .delegate().
              
                 
   
     Can bind and unbind events to the colored button.
@@ -124,4 +125,5 @@ $( "form" ).undelegate( ".whatever" );
   
   
   
+  
               

From e1c7aaf16aa2931543137da729c2bcc3704ab70d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Wed, 24 Aug 2016 13:50:49 +0200
Subject: [PATCH 461/699] bind: remove the link to .delegate() as it's
 deprecated as well

Closes #948
---
 entries/bind.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/bind.xml b/entries/bind.xml
index 05856faa..150c645b 100644
--- a/entries/bind.xml
+++ b/entries/bind.xml
@@ -34,7 +34,7 @@
   
   Attach a handler to an event for the elements.
   
-    
              As of jQuery 3.0, .bind() has been deprecated. It was superseded by the .on() method for attaching event handlers to a document since jQuery 1.7, so its use was already discouraged. For earlier versions, the .bind() method is used for attaching an event handler directly to elements. Handlers are attached to the currently selected elements in the jQuery object, so those elements must exist at the point the call to .bind() occurs. For more flexible event binding, see the discussion of event delegation in .on() or .delegate().
              
+    
              As of jQuery 3.0, .bind() has been deprecated. It was superseded by the .on() method for attaching event handlers to a document since jQuery 1.7, so its use was already discouraged. For earlier versions, the .bind() method is used for attaching an event handler directly to elements. Handlers are attached to the currently selected elements in the jQuery object, so those elements must exist at the point the call to .bind() occurs. For more flexible event binding, see the discussion of event delegation in .on().
              
     
              Any string is legal for eventType; if the string is not the name of a native DOM event, then the handler is bound to a custom event. These events are never called by the browser, but may be triggered manually from other JavaScript code using .trigger() or .triggerHandler().
              
     
              If the eventType string contains a period (.) character, then the event is namespaced. The period character separates the event from its namespace. For example, in the call .bind( "click.name", handler ), the string click is the event type, and the string name is the namespace. Namespacing allows us to unbind or trigger some events of a type without affecting others. See the discussion of .unbind() for more information.
              
     
              There are shorthand methods for some standard browser events such as .click() that can be used to attach or trigger event handlers. For a complete list of shorthand methods, see the events category.
              

From 43e0f008f963359acf72c24bea4d8d48dd3b610b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Wed, 24 Aug 2016 13:53:15 +0200
Subject: [PATCH 462/699] 1.12.14

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 2fb714fc..1abbf65c 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.13",
+  "version": "1.12.14",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 1c249b2cf2325376d64b75afa0365c37b68894d1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=84=9A=E4=BA=BA=E7=A0=81=E5=A4=B4?= 
Date: Wed, 7 Sep 2016 11:38:54 +0800
Subject: [PATCH 463/699] toggleClass: Fixed a typo

Closes gh-977
---
 entries/toggleClass.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/toggleClass.xml b/entries/toggleClass.xml
index 5a18aa05..dfe45f2d 100644
--- a/entries/toggleClass.xml
+++ b/entries/toggleClass.xml
@@ -137,7 +137,7 @@ $( "p" ).each(function() {
     float: left;
     width: 100px;
     margin: 1em 1em 0 0;
-    padding=left: 3px;
+    padding-left: 3px;
     border: 1px solid #abc;
   }
   div.a {

From 36e13162cd54fe620ca9d92ba13dcc6c3de94af3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Wed, 19 Oct 2016 14:32:30 +0200
Subject: [PATCH 464/699] deferred.catch: create the page

Fixes #951
Closes #992
---
 entries/deferred.catch.xml | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 entries/deferred.catch.xml

diff --git a/entries/deferred.catch.xml b/entries/deferred.catch.xml
new file mode 100644
index 00000000..17df8dda
--- /dev/null
+++ b/entries/deferred.catch.xml
@@ -0,0 +1,31 @@
+
+
+    deferred.catch()
+    
+        3.0
+        
+            
+                A function that is called when the Deferred is rejected.
+            
+        
+    
+    Add handlers to be called when the Deferred object is rejected. 
+
+    
+        
              deferred.catch( fn ) is an alias to deferred.then( null, fn ). Read its page for more information.
              
+                  
+    
+        Since the jQuery.get method returns a jqXHR object, which is derived from a Deferred object, we can rejection handlers using the .catch method.
+        
+    
+    
+    
+              

From d16d569c48236676782d22d474838fca6bb3ad06 Mon Sep 17 00:00:00 2001
From: Chealer 
Date: Sat, 1 Oct 2016 11:35:22 -0400
Subject: [PATCH 465/699] val: Mention radio buttons in addition to selects and
 checkboxes

Fixes #981
Closes #987
---
 entries/val.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/val.xml b/entries/val.xml
index b2aa7613..e7a82550 100644
--- a/entries/val.xml
+++ b/entries/val.xml
@@ -13,7 +13,7 @@
     
       
              The .val() method is primarily used to get the values of form elements such as input, select and textarea. When called on an empty collection, it returns undefined.
              
       
              When the first element in the collection is a select-multiple (i.e., a select element with the multiple attribute set), .val() returns an array containing the value of each selected option. As of jQuery 3.0, if no options are selected, it returns an empty array; prior to jQuery 3.0, it returns null.
              
-      
              For selects and checkboxes, you can also use the :selected and :checked selectors to get at values. For example:
              
+      
              For selects, checkboxes and radio buttons, you can also use the :selected and :checked selectors to get at values. For example:
              
       
              
 
 // Get the value from a dropdown select

From 8235e7b9ba4281f1562ba35eb2e1a92f15da97fe Mon Sep 17 00:00:00 2001
From: Richard Gibson 
Date: Sun, 25 Sep 2016 23:04:15 -0400
Subject: [PATCH 466/699] Types: Document lack of support for wrapped
 primitives

Fixes #985
Closes #986
---
 pages/Types.html | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/pages/Types.html b/pages/Types.html
index 2deff771..c56d995a 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -9,7 +9,7 @@
 ol ul li { font-size: 1em !important; }
 ol ul { margin-left: 1.5em !important; }
 
-
              JavaScript provides several built-in datatypes. In addition to those, this page documents virtual types like Selectors, enhanced pseudo-types like Events and some concepts you need to know about Functions. If you want to study these concepts in depth, take a look at MDN.
+
              This page documents data types appearing in jQuery function signatures, whether defined by JavaScript itself or further restricted by jQuery. Unless explicitly stated otherwise, jQuery functions require primitive values where applicable, and do not accept their Object-wrapped forms. If you want to study these concepts in depth, take a look at MDN.
 
              
 
              You should be able to try out most of the examples below by just copying them to your browser's JavaScript Console (Chrome, Safari with Develop menu activated, IE 8+) or Firebug console (Firefox).
 
              
@@ -104,7 +104,7 @@ 
               Anything 
              
 
              
 
 
               String 
              
-
              A string in JavaScript is an immutable object that contains none, one or many characters.
+
              A string in JavaScript is an immutable primitive value that contains none, one or many characters.
 
              
 
              "I'm a String in JavaScript!"
 'So am I!'
@@ -165,7 +165,7 @@ 
               htmlString 
              
 $( "hellowaitbye" ).appendTo( "body" );
 
              
 
               Number 
              
-
              Numbers in JavaScript are double-precision 64-bit format IEEE 754 values. They are immutable, just as strings. All operators common in c-based languages are available to work with numbers (+, -, *, /, %, =, +=, -=, *=, /=, ++, --).
+
              Numbers in JavaScript are double-precision 64-bit format IEEE 754 values. They are immutable primitive values, just like strings. All operators common in c-based languages are available to work with numbers (+, -, *, /, %, =, +=, -=, *=, /=, ++, --).
 
              
 
              12
 3.543

From e40db5e2e3596e523265b75b97aaa0ca9fdcbb38 Mon Sep 17 00:00:00 2001
From: Han Seoul-Oh 
Date: Thu, 23 Jun 2016 16:14:12 -0700
Subject: [PATCH 467/699] jQuery.post: Mark jqXHR.always() as added in 1.6

While I'm there, fix missing ``
---
 entries/jQuery.post.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/jQuery.post.xml b/entries/jQuery.post.xml
index 91382759..6152350a 100644
--- a/entries/jQuery.post.xml
+++ b/entries/jQuery.post.xml
@@ -50,7 +50,7 @@ $.post( "ajax/test.html", function( data ) {
     
              This example fetches the requested HTML snippet and inserts it on the page.
              
     
              Pages fetched with POST are never cached, so the cache and ifModified options in jQuery.ajaxSetup() have no effect on these requests.
              
     
              The jqXHR Object
              
-    
              As of jQuery 1.5, all of jQuery's Ajax methods return  a superset of the XMLHTTPRequest object. This jQuery XHR object, or "jqXHR," returned by $.get() implements the Promise interface, giving it all the properties, methods, and behavior of a Promise (see Deferred object for more information). The jqXHR.done() (for success), jqXHR.fail() (for error), and jqXHR.always() (for completion, whether success or error) methods take a function argument that is called when the request terminates. For information about the arguments this function receives, see the jqXHR Object section of the $.ajax() documentation.
              
+    
              As of jQuery 1.5, all of jQuery's Ajax methods return  a superset of the XMLHTTPRequest object. This jQuery XHR object, or "jqXHR," returned by $.get() implements the Promise interface, giving it all the properties, methods, and behavior of a Promise (see Deferred object for more information). The jqXHR.done() (for success), jqXHR.fail() (for error), and jqXHR.always() (for completion, whether success or error; added in jQuery 1.6) methods take a function argument that is called when the request terminates. For information about the arguments this function receives, see the jqXHR Object section of the $.ajax() documentation.
              
         
              The Promise interface also allows jQuery's Ajax methods, including $.get(), to chain multiple .done(), .fail(), and .always() callbacks on a single request, and even to assign these callbacks after the request may have completed. If the request is already complete, the callback is fired immediately.
              
     
              
 // Assign handlers immediately after making the request,
@@ -66,7 +66,7 @@ var jqxhr = $.post( "example.php", function() {
   })
   .always(function() {
     alert( "finished" );
-});
+  });
 
 // Perform other work here ...
 

From 8b39fe73c6b915e09493117ea0a3975938d3d0f3 Mon Sep 17 00:00:00 2001
From: Han Seoul-Oh 
Date: Thu, 23 Jun 2016 16:18:01 -0700
Subject: [PATCH 468/699] jQuery.get: Mark jqXHR.always() as added in 1.6

---
 entries/jQuery.get.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.get.xml b/entries/jQuery.get.xml
index 87707e51..be1e25a2 100644
--- a/entries/jQuery.get.xml
+++ b/entries/jQuery.get.xml
@@ -49,7 +49,7 @@ $.get( "ajax/test.html", function( data ) {
     
              
     
              This example fetches the requested HTML snippet and inserts it on the page.
              
     
              The jqXHR Object
              
-    
              As of jQuery 1.5, all of jQuery's Ajax methods return  a superset of the XMLHTTPRequest object. This jQuery XHR object, or "jqXHR," returned by $.get() implements the Promise interface, giving it all the properties, methods, and behavior of a Promise (see Deferred object for more information). The jqXHR.done() (for success), jqXHR.fail() (for error), and jqXHR.always() (for completion, whether success or error) methods take a function argument that is called when the request terminates. For information about the arguments this function receives, see the jqXHR Object section of the $.ajax() documentation.
              
+    
              As of jQuery 1.5, all of jQuery's Ajax methods return  a superset of the XMLHTTPRequest object. This jQuery XHR object, or "jqXHR," returned by $.get() implements the Promise interface, giving it all the properties, methods, and behavior of a Promise (see Deferred object for more information). The jqXHR.done() (for success), jqXHR.fail() (for error), and jqXHR.always() (for completion, whether success or error; added in jQuery 1.6) methods take a function argument that is called when the request terminates. For information about the arguments this function receives, see the jqXHR Object section of the $.ajax() documentation.
              
     
              The Promise interface also allows jQuery's Ajax methods, including $.get(), to chain multiple .done(), .fail(), and .always() callbacks on a single request, and even to assign these callbacks after the request may have completed. If the request is already complete, the callback is fired immediately.
              
     
              
 // Assign handlers immediately after making the request,

From dfbbb79cfec2a7fb880989434ba4fe050b3d3ef8 Mon Sep 17 00:00:00 2001
From: Han Seoul-Oh 
Date: Thu, 23 Jun 2016 16:20:34 -0700
Subject: [PATCH 469/699] jQuery.ajax: Mark jqXHR.always() as added in 1.6

---
 entries/jQuery.ajax.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index d5e6a33c..c35582bc 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -240,7 +240,7 @@ $.ajax({
         
              
       
       
            • 
-        jqXHR.always(function( data|jqXHR, textStatus, jqXHR|errorThrown ) { });
+        jqXHR.always(function( data|jqXHR, textStatus, jqXHR|errorThrown ) { }); (added in jQuery 1.6)
         
              An alternative construct to the complete callback option, the .always() method replaces the deprecated .complete() method.
              
         
              In response to a successful request, the function's arguments are the same as those of .done(): data, textStatus, and the jqXHR object. For failed requests the arguments are the same as those of .fail(): the jqXHR object, textStatus, and errorThrown. Refer to deferred.always() for implementation details.
              
       
              • 

From 606a30eb27af95957a8f74e65e422b15c1ffa879 Mon Sep 17 00:00:00 2001
From: Han Seoul-Oh 
Date: Thu, 23 Jun 2016 16:24:12 -0700
Subject: [PATCH 470/699] jQuery.getJSON: Mark jqXHR.always() as added in 1.6

Closes #941
---
 entries/jQuery.getJSON.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.getJSON.xml b/entries/jQuery.getJSON.xml
index 7d5e08b6..c3b1e1e2 100644
--- a/entries/jQuery.getJSON.xml
+++ b/entries/jQuery.getJSON.xml
@@ -61,7 +61,7 @@ $.getJSON( "ajax/test.json", function( data ) {
     
              JSONP
              
     
              If the URL includes the string "callback=?" (or similar, as defined by the server-side API), the request is treated as JSONP instead. See the discussion of the jsonp data type in $.ajax() for more details.
              
     
              The jqXHR Object
              
-    
              As of jQuery 1.5, all of jQuery's Ajax methods return  a superset of the XMLHTTPRequest object. This jQuery XHR object, or "jqXHR," returned by $.getJSON() implements the Promise interface, giving it all the properties, methods, and behavior of a Promise (see Deferred object for more information). The jqXHR.done() (for success), jqXHR.fail() (for error), and jqXHR.always() (for completion, whether success or error) methods take a function argument that is called when the request terminates. For information about the arguments this function receives, see the jqXHR Object section of the $.ajax() documentation.
              
+    
              As of jQuery 1.5, all of jQuery's Ajax methods return  a superset of the XMLHTTPRequest object. This jQuery XHR object, or "jqXHR," returned by $.getJSON() implements the Promise interface, giving it all the properties, methods, and behavior of a Promise (see Deferred object for more information). The jqXHR.done() (for success), jqXHR.fail() (for error), and jqXHR.always() (for completion, whether success or error; added in jQuery 1.6) methods take a function argument that is called when the request terminates. For information about the arguments this function receives, see the jqXHR Object section of the $.ajax() documentation.
              
     
              The Promise interface in jQuery 1.5 also allows jQuery's Ajax methods, including $.getJSON(), to chain multiple .done(), .always(), and .fail() callbacks on a single request, and even to assign these callbacks after the request may have completed. If the request is already complete, the callback is fired immediately.
              
     
              
 // Assign handlers immediately after making the request,

From 9257b8006027b1550b206d1932caa64516cef11e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Wed, 26 Oct 2016 13:57:37 +0200
Subject: [PATCH 471/699] 1.12.15

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 1abbf65c..025e962d 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.14",
+  "version": "1.12.15",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 9c1e80975ed30122feb6977470845c8042519d96 Mon Sep 17 00:00:00 2001
From: Richard Gibson 
Date: Sun, 13 Nov 2016 17:08:16 -0500
Subject: [PATCH 472/699] Dimensions: normalize outerWidth and outerHeight

---
 entries/outerHeight.xml | 10 +++++-----
 entries/outerWidth.xml  |  8 ++++----
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/entries/outerHeight.xml b/entries/outerHeight.xml
index ab497404..9f3a8fe5 100644
--- a/entries/outerHeight.xml
+++ b/entries/outerHeight.xml
@@ -1,6 +1,6 @@
 
 
-  Get the current computed height for the first element in the set of matched elements, including padding, border, and optionally margin. Returns a number (without "px") representation of the value or null if called on an empty set of elements.
+  Get the current computed outer height (including padding, border, and optionally margin) for the first element in the set of matched elements or set the outer height of every matched element.
 
   .outerHeight()
   
@@ -9,10 +9,10 @@
       A Boolean indicating whether to include the element's margin in the calculation.
     
   
-  Get the current computed height for the first element in the set of matched elements, including padding, border, and optionally margin. Returns a number (without "px") representation of the value or null if called on an empty set of elements.
+  Get the current computed outer height (including padding, border, and optionally margin) for the first element in the set of matched elements.
   
-    
              The top and bottom padding and border are always included in the .outerHeight() calculation; if the includeMargin argument is set to true, the margin (top and bottom) is also included.
              
-    
              This method is not applicable to window and document objects; for these, use .height() instead.
              
+    
              Returns the height of the element, including top and bottom padding, border, and optionally margin, in pixels.
              
+    
              This method is not applicable to window and document objects; for these, use .height() instead. Although .outerHeight() can be used on table elements, it may give unexpected results on tables using the border-collapse: collapse CSS property.
              
     
              
       
       
              Figure 1 - Illustration of the measured height
              
@@ -60,7 +60,7 @@ $( "p:last" ).text(
       A function returning the outer height to set. Receives the index position of the element in the set and the old outer height as arguments. Within the function, this refers to the current element in the set.
     
   
-  Set the CSS outer Height of each element in the set of matched elements.
+  Set the CSS outer height of each element in the set of matched elements.
   
     
              When calling .outerHeight(value), the value can be either a string (number and unit) or a number. If only a number is provided for the value, jQuery assumes a pixel unit. If a string is provided, however, any valid CSS measurement may be used (such as 100px, 50%, or auto).
              
                 
diff --git a/entries/outerWidth.xml b/entries/outerWidth.xml
index 64687fb9..dcf7d23c 100644
--- a/entries/outerWidth.xml
+++ b/entries/outerWidth.xml
@@ -1,6 +1,6 @@
 
 
-  Get the current computed width for the first element in the set of matched elements, including padding and border.
+  Get the current computed outer width (including padding, border, and optionally margin) for the first element in the set of matched elements or set the outer width of every matched element.
 
   .outerWidth()
   
@@ -9,10 +9,9 @@
       A Boolean indicating whether to include the element's margin in the calculation.
     
   
-  Get the current computed width for the first element in the set of matched elements, including padding and border.
+  Get the current computed outer width (including padding, border, and optionally margin) for the first element in the set of matched elements.
   
-    
              Returns the width of the element, along with left and right padding, border, and optionally margin, in pixels.
              
-    
              If includeMargin is omitted or false, the padding and border are included in the calculation; if true, the margin is also included.
              
+    
              Returns the width of the element, including left and right padding, border, and optionally margin, in pixels.
              
     
              This method is not applicable to window and document objects; for these, use .width() instead. Although .outerWidth() can be used on table elements, it may give unexpected results on tables using the border-collapse: collapse CSS property.
              
     
              
       
@@ -45,6 +44,7 @@ $( "p:last" ).text(
   
   
 
+
 
   
     1.8.0

From 3aa71f277abc08eef73391d447b5dc1ae5354b7a Mon Sep 17 00:00:00 2001
From: Richard Gibson 
Date: Sun, 13 Nov 2016 17:21:31 -0500
Subject: [PATCH 473/699] Dimensions: Document empty-context getters

Fixes gh-997
Closes gh-998
---
 entries/innerHeight.xml | 2 +-
 entries/innerWidth.xml  | 2 +-
 entries/outerHeight.xml | 2 +-
 entries/outerWidth.xml  | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/entries/innerHeight.xml b/entries/innerHeight.xml
index b8c5654e..bdc22f23 100644
--- a/entries/innerHeight.xml
+++ b/entries/innerHeight.xml
@@ -9,7 +9,7 @@
   
   Get the current computed height for the first element in the set of matched elements, including padding but not border.
   
-    
              This method returns the height of the element, including top and bottom padding, in pixels.
              
+    
              This method returns the height of the element, including top and bottom padding, in pixels. If called on an empty set of elements, returns undefined (null before jQuery 3.0).
              
     
              This method is not applicable to window and document objects; for these, use .height() instead.
              
     
              
       
diff --git a/entries/innerWidth.xml b/entries/innerWidth.xml
index 6e9fd0d3..d3641b00 100644
--- a/entries/innerWidth.xml
+++ b/entries/innerWidth.xml
@@ -8,7 +8,7 @@
   
   Get the current computed inner width for the first element in the set of matched elements, including padding but not border.
   
-    
              This method returns the width of the element, including left and right padding, in pixels.
              
+    
              This method returns the width of the element, including left and right padding, in pixels. If called on an empty set of elements, returns undefined (null before jQuery 3.0).
              
     
              This method is not applicable to window and document objects; for these, use .width() instead.
              
     
              
       
diff --git a/entries/outerHeight.xml b/entries/outerHeight.xml
index 9f3a8fe5..c50dd23d 100644
--- a/entries/outerHeight.xml
+++ b/entries/outerHeight.xml
@@ -11,7 +11,7 @@
   
   Get the current computed outer height (including padding, border, and optionally margin) for the first element in the set of matched elements.
   
-    
              Returns the height of the element, including top and bottom padding, border, and optionally margin, in pixels.
              
+    
              Returns the height of the element, including top and bottom padding, border, and optionally margin, in pixels. If called on an empty set of elements, returns undefined (null before jQuery 3.0).
              
     
              This method is not applicable to window and document objects; for these, use .height() instead. Although .outerHeight() can be used on table elements, it may give unexpected results on tables using the border-collapse: collapse CSS property.
              
     
              
       
diff --git a/entries/outerWidth.xml b/entries/outerWidth.xml
index dcf7d23c..bb37d571 100644
--- a/entries/outerWidth.xml
+++ b/entries/outerWidth.xml
@@ -11,7 +11,7 @@
   
   Get the current computed outer width (including padding, border, and optionally margin) for the first element in the set of matched elements.
   
-    
              Returns the width of the element, including left and right padding, border, and optionally margin, in pixels.
              
+    
              Returns the width of the element, including left and right padding, border, and optionally margin, in pixels. If called on an empty set of elements, returns undefined (null before jQuery 3.0).
              
     
              This method is not applicable to window and document objects; for these, use .width() instead. Although .outerWidth() can be used on table elements, it may give unexpected results on tables using the border-collapse: collapse CSS property.
              
     
              
       

From c2f3d41ce8168d2e8bd75c63a71ab39f80a6b170 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Wed, 16 Nov 2016 11:53:05 +0100
Subject: [PATCH 474/699] Categories: Use jquery14.com via Web Archive

The domain currently contains a scam site; web archive has the original version.
---
 categories.xml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/categories.xml b/categories.xml
index 58563915..2ccd959e 100644
--- a/categories.xml
+++ b/categories.xml
@@ -43,7 +43,7 @@
     
     
       For more information, see the jQuery 1.4 Release Notes
              
+        
              For more information, see the jQuery 1.4 Release Notes
              
       ]]>              
                   
     
@@ -357,12 +357,12 @@ var files = event.originalEvent.dataTransfer.files;
     
     
       jQuery 1.4 Release Notes.
+				jQuery 1.4 Release Notes.
 			]]>
     
     
       jQuery 1.4.1 Release Notes.
+				jQuery 1.4.1 Release Notes.
 			]]>
     
     

From 244b0b07fcb16f9eb935e9edb287fedc2cbf8874 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Wed, 16 Nov 2016 11:53:57 +0100
Subject: [PATCH 475/699] 1.12.16

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 025e962d..d140d3da 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.15",
+  "version": "1.12.16",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 44cc16c57e76a03696c8fa171000b33ddf07da55 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Wed, 23 Nov 2016 12:46:26 +0100
Subject: [PATCH 476/699] jQuery.parseJSON: Move the deprecation note to the
 top, rephrase it

The deprecation note has been moved to the top of the description as it's the
most important information about the API. This is also how other pages for
deprecated APIs are documented.

Also, the message has been rephrased a little as JSON is a string, not an
object.

Ref #899
Closes #1000
---
 entries/jQuery.parseJSON.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.parseJSON.xml b/entries/jQuery.parseJSON.xml
index d0965e41..054663df 100644
--- a/entries/jQuery.parseJSON.xml
+++ b/entries/jQuery.parseJSON.xml
@@ -14,6 +14,7 @@
   
   Takes a well-formed JSON string and returns the resulting JavaScript value.
   
+    
              As of jQuery 3.0, $.parseJSON is deprecated. To parse JSON strings use the native JSON.parse method instead.
              
     
              Passing in a malformed JSON string results in a JavaScript exception being thrown. For example, the following are all invalid JSON strings:
              
     
                
       
              • "{test: 1}" (test does not have double quotes around it).
                • 
@@ -26,7 +27,6 @@
     
                The JSON standard does not permit "control characters" such as a tab or newline. An example like $.parseJSON( '{ "testing":"1\t2\n3" }' ) will throw an error in most implementations because the JavaScript parser converts the string's tab and newline escapes into literal tab and newline; doubling the backslashes like "1\\t2\\n3" yields expected results. This problem is often seen when injecting JSON into a JavaScript file from a server-side language such as PHP.
                
     
                Where the browser provides a native implementation of JSON.parse, jQuery uses it to parse the string. For details on the JSON format, see http://json.org/.
                
     
                Prior to jQuery 1.9, $.parseJSON returned null instead of throwing an error if it was passed an empty string, null, or undefined, even though those are not valid JSON.
                
-    
                As of jQuery 3.0, $.parseJSON is deprecated. To parse JSON objects, use the native JSON.parse method instead.
                
   
   
     Parse a JSON string.

From 30fe58a4eaee6fccee91e16c4b54774ad7adeaa2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Wed, 30 Nov 2016 12:45:38 +0100
Subject: [PATCH 477/699] 1.12.17

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index d140d3da..d5921cb5 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.16",
+  "version": "1.12.17",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From f52d5e8d13b7b317ecf972a6562d6e443a42c569 Mon Sep 17 00:00:00 2001
From: ash 
Date: Mon, 5 Dec 2016 13:55:36 +0530
Subject: [PATCH 478/699] ajaxComplete(): Fixed a typo

Closes gh-1002
---
 entries/ajaxComplete.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/ajaxComplete.xml b/entries/ajaxComplete.xml
index 33705e53..f96dc4cf 100644
--- a/entries/ajaxComplete.xml
+++ b/entries/ajaxComplete.xml
@@ -48,7 +48,7 @@ $( document ).ajaxComplete(function( event, xhr, settings ) {
   
     Show a message when an Ajax request completes.
     Request Complete." );
 });
 ]]>

From 5d37c0aaa5a7aa942572a25e7e700525578d823c Mon Sep 17 00:00:00 2001
From: Richard Gibson 
Date: Wed, 26 Oct 2016 14:40:38 -0400
Subject: [PATCH 479/699] val: Remove use of nonstandard selectors

Fixes gh-993
Closes gh-994
---
 entries/val.xml | 21 ++++++++++-----------
 1 file changed, 10 insertions(+), 11 deletions(-)

diff --git a/entries/val.xml b/entries/val.xml
index e7a82550..56ef9e34 100644
--- a/entries/val.xml
+++ b/entries/val.xml
@@ -13,20 +13,19 @@
     
       
                The .val() method is primarily used to get the values of form elements such as input, select and textarea. When called on an empty collection, it returns undefined.
                
       
                When the first element in the collection is a select-multiple (i.e., a select element with the multiple attribute set), .val() returns an array containing the value of each selected option. As of jQuery 3.0, if no options are selected, it returns an empty array; prior to jQuery 3.0, it returns null.
                
-      
                For selects, checkboxes and radio buttons, you can also use the :selected and :checked selectors to get at values. For example:
                
+      
                For selects, checkboxes and radio buttons, you can use :checked to select the right elements. For example:
                
       
                
+// Get the value from the selected option in a dropdown
+$( "select#foo option:checked" ).val();
 
-// Get the value from a dropdown select
-$( "select.foo option:selected").val();
-
-// Get the value from a dropdown select even easier
-$( "select.foo" ).val();
+// Get the value from a dropdown select directly
+$( "select#foo" ).val();
 
 // Get the value from a checked checkbox
-$( "input:checkbox:checked" ).val();
+$( "input[type=checkbox][name=bar]:checked" ).val();
 
 // Get the value from a set of radio buttons
-$( "input:radio[name=bar]:checked" ).val();
+$( "input[type=radio][name=baz]:checked" ).val();
       
                
       
                
         
                Note:  At present, using .val() on <textarea> elements strips carriage return characters from the browser-reported value. When this value is sent to the server via XHR, however, carriage returns are preserved (or added by browsers which do not include them in the raw value). A workaround for this issue can be achieved using a valHook as follows:
                
@@ -131,11 +130,11 @@ $( "input" )
       
                Setting values using this method (or using the native value property) does not cause the dispatch of the change event. For this reason, the relevant event handlers will not be executed. If you want to execute them, you should call .trigger( "change" ) after setting the value.
                
       
                The .val() method allows setting the value by passing in a function. As of jQuery 1.4, the function is passed two arguments, the current element's index and its current value: 
                
       
                
-$( "input:text.items" ).val(function( index, value ) {
-  return value + " " + this.className;
+$( "input[type=text].tags" ).val(function( index, value ) {
+  return value.trim();
 });
       
                
-      
                This example appends the string " items" to the text inputs' values.
                
+      
                This example removes leading and trailing whitespace from the values of text inputs with a "tags" class.
                
     
     
       Set the value of an input box.

From 6b54ab52f52ee586cbc97b695211322d1c670551 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 19 Dec 2016 15:49:59 +0000
Subject: [PATCH 480/699] prop(): Fixed incorrect position of parenthesis

Fixes gh-1003
Closes gh-1004
---
 entries/prop.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/prop.xml b/entries/prop.xml
index adccbc85..419c3cc2 100644
--- a/entries/prop.xml
+++ b/entries/prop.xml
@@ -86,7 +86,7 @@ $( "input" ).change(function() {
   $( "p" ).html(
     ".attr( \"checked\" ): " + $input.attr( "checked" ) + "
                " +
     ".prop( \"checked\" ): " + $input.prop( "checked" ) + "
                " +
-    ".is( \":checked\" ): " + $input.is( ":checked" ) ) + "";
+    ".is( \":checked\" ): " + $input.is( ":checked" ) + "" );
 }).change();
 ]]>
       
Date: Mon, 19 Dec 2016 17:12:59 +0000
Subject: [PATCH 481/699] unbind(): Specified that it accepts multiple events
 at once

Fixes gh-975
Closes gh-1007
---
 entries/unbind.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/unbind.xml b/entries/unbind.xml
index c53dd6af..8b91e66a 100644
--- a/entries/unbind.xml
+++ b/entries/unbind.xml
@@ -5,7 +5,7 @@
   
     1.0
     
-      A string containing a JavaScript event type, such as click or submit.
+      A string containing one or more DOM event types, such as "click" or "submit," or custom event names.
     
     
       The function that is to be no longer executed.
@@ -15,7 +15,7 @@
   
     1.4.3
     
-      A string containing a JavaScript event type, such as click or submit.
+      A string containing one or more DOM event types, such as "click" or "submit," or custom event names.
     
     
       Unbinds the corresponding 'return false' function that was bound using .bind( eventType, false ).

From 9729a4b3212f48df715069cfe453aec5e352a55e Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Tue, 20 Dec 2016 16:35:29 +0000
Subject: [PATCH 482/699] Types: Added Error

Fixes gh-958
Closes gh-1012
---
 pages/Types.html | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/pages/Types.html b/pages/Types.html
index c56d995a..47f5ea74 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -85,6 +85,7 @@
       
              • Proxy Pattern
                • 
     
              
   
+  
            • Error
              • 
   
            • Selector
              • 
   
            • Event
              • 
   
            • Element
              • 
@@ -566,8 +567,16 @@ 
               Callback 
              
 
              
 
              Instead of always returning false, the callback could check fields of the form for validity, and return false only when the form is invalid.
 
              
-

              
+
               Error 
              
+
              An instance of an Error object is thrown as an exception when a runtime error occurs. Error can also be used as base to define user custom exception classes. In JavaScript an error can be thrown as shown below:
+
              
+
              throw new Error( "The argument provided is incorrect" );
+
              
+
              An error can also be thrown by the engine under some circumstances. For example, when trying to access a property of null:
 
              
+
              var obj = null;
+console.log( obj.foo() );
+
              
 
               Selector 
              
 
              A selector is used in jQuery to select DOM elements from a DOM document. That document is, in most cases, the DOM document present in all browsers, but can also be an XML document received via Ajax.
 
              

From 431ccdb463d647a502d91f002838af8fd6b807e2 Mon Sep 17 00:00:00 2001
From: Kris Borchers 
Date: Tue, 20 Dec 2016 22:18:40 -0600
Subject: [PATCH 483/699] 1.12.18

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index d5921cb5..4ba9e9b4 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.17",
+  "version": "1.12.18",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 13c6d7a41ee6d0378cd1e501d619f9e95a7128ba Mon Sep 17 00:00:00 2001
From: Kris Borchers 
Date: Tue, 20 Dec 2016 22:59:45 -0600
Subject: [PATCH 484/699] 1.12.19

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 4ba9e9b4..3fb09190 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.18",
+  "version": "1.12.19",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 9af27d66abf585dd6802ba12f9ddba1038b1227d Mon Sep 17 00:00:00 2001
From: Tom 
Date: Tue, 27 Dec 2016 20:59:27 -0600
Subject: [PATCH 485/699] one(): Add named parameter to example

Fixes #1008
Closes #1016
---
 entries/one.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/one.xml b/entries/one.xml
index 588f1d55..8d37f3f8 100644
--- a/entries/one.xml
+++ b/entries/one.xml
@@ -60,7 +60,7 @@ $( "#foo" ).on( "click", function( event ) {
     
              In other words, explicitly calling .off() from within a regularly-bound handler has exactly the same effect.
              
     
              If the first argument contains more than one space-separated event types, the event handler is called once for each event type.
              
     
              
-$( "#foo" ).one( "click mouseover", function() {
+$( "#foo" ).one( "click mouseover", function( event ) {
   alert( "The " + event.type + " event happened!" );
 });
     
              

From 53ffa06085f4cd8c729e6fdb494bf6579e332ace Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Tue, 20 Dec 2016 15:45:23 +0000
Subject: [PATCH 486/699] find(): Mention support for selectors starting with >

Fixes gh-973
Closes gh-1011
---
 entries/find.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/find.xml b/entries/find.xml
index 0a080a05..c6a32e84 100644
--- a/entries/find.xml
+++ b/entries/find.xml
@@ -18,7 +18,7 @@
   Get the descendants of each element in the current set of matched elements, filtered by a selector, jQuery object, or element.
   
     
              Given a jQuery object that represents a set of DOM elements, the .find() method allows us to search through the descendants of these elements in the DOM tree and construct a new jQuery object from the matching elements. The .find() and .children() methods are similar, except that the latter only travels a single level down the DOM tree.
              
-    
              The first signature for the .find()method accepts a selector expression of the same type that we can pass to the $() function. The elements will be filtered by testing whether they match this selector.
              
+    
              The first signature for the .find()method accepts a selector expression of the same type that we can pass to the $() function. The elements will be filtered by testing whether they match this selector. The expressions allowed include selectors like > p which will find all the paragraphs that are children of the elements in the jQuery object.
              
     
              Consider a page with a basic nested list on it:
              
     
              
 <ul class="level-1">

From 6a2c8cd629feb3ba82a9ace9b2ef72de0455e818 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 16 Jan 2017 22:04:29 +0000
Subject: [PATCH 487/699] 1.12.20

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 3fb09190..ccd3be22 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.19",
+  "version": "1.12.20",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From ab9fcb05f3981bbc11b15beb5912e2289a94319f Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 19 Dec 2016 16:57:19 +0000
Subject: [PATCH 488/699] ajax: Specified behavior for a timeout of 0

Fixes gh-979
Closes gh-1006
---
 entries/jQuery.ajax.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index c35582bc..93fd2759 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -170,7 +170,7 @@ $.ajax({
         A function to be called if the request succeeds. The function gets passed three arguments: The data returned from the server, formatted according to the dataType parameter or the dataFilter callback function, if specified; a string describing the status; and the jqXHR (in jQuery 1.4.x, XMLHttpRequest) object. As of jQuery 1.5, the success setting can accept an array of functions. Each function will be called in turn. This is an Ajax Event.
       
       
-        Set a timeout (in milliseconds) for the request. This will override any global timeout set with $.ajaxSetup(). The timeout period starts at the point the $.ajax call is made; if several other requests are in progress and the browser has no connections available, it is possible for a request to time out before it can be sent. In jQuery 1.4.x and below, the XMLHttpRequest object will be in an invalid state if the request times out; accessing any object members may throw an exception. In Firefox 3.0+ only, script and JSONP requests cannot be cancelled by a timeout; the script will run even if it arrives after the timeout period.
+        Set a timeout (in milliseconds) for the request. A value of 0 means there will be no timeout. This will override any global timeout set with $.ajaxSetup(). The timeout period starts at the point the $.ajax call is made; if several other requests are in progress and the browser has no connections available, it is possible for a request to time out before it can be sent. In jQuery 1.4.x and below, the XMLHttpRequest object will be in an invalid state if the request times out; accessing any object members may throw an exception. In Firefox 3.0+ only, script and JSONP requests cannot be cancelled by a timeout; the script will run even if it arrives after the timeout period.
       
       
         Set this to true if you wish to use the traditional style of param serialization.

From 79a5c0c9f8e2ed423a7bf9af7486dd47749b6a34 Mon Sep 17 00:00:00 2001
From: Mike Pennisi 
Date: Sat, 21 Jan 2017 23:19:37 -0500
Subject: [PATCH 489/699] serializeArray: Document Behavior for Value-less
 Input Elements

Close gh-1018
---
 entries/serializeArray.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/serializeArray.xml b/entries/serializeArray.xml
index bc46e920..4a836265 100644
--- a/entries/serializeArray.xml
+++ b/entries/serializeArray.xml
@@ -28,7 +28,7 @@
   </div>
 </form>
     
              
-    
              The .serializeArray() method uses the standard W3C rules for successful controls to determine which elements it should include; in particular the element cannot be disabled and must contain a name attribute. No submit button value is serialized since the form was not submitted using a button. Data from file select elements is not serialized.
              
+    
              The .serializeArray() method uses the standard W3C rules for successful controls to determine which elements it should include; in particular the element cannot be disabled and must contain a name attribute. No submit button value is serialized since the form was not submitted using a button. Data from file select elements is not serialized. Elements that do not contain a value attribute are represented with the empty string value.
              
     
              This method can act on a jQuery object that has selected individual form controls, such as <input>, <textarea>, and <select>. However, it is typically easier to select the <form> element itself for serialization:
              
     
              
 $( "form" ).submit(function( event ) {

From 874113df6ef381f34b0d3e27ddfd87f2b1955e1e Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Sat, 21 Jan 2017 23:20:25 -0500
Subject: [PATCH 490/699] 1.12.21

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index ccd3be22..368efd68 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.20",
+  "version": "1.12.21",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From af3f23e7360ea8260bea002b70340dae107f1791 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Tue, 20 Dec 2016 15:24:23 +0000
Subject: [PATCH 491/699] load(): Specified that load event alias is removed

Fixes #976
Closes #1010
---
 entries/load.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/load.xml b/entries/load.xml
index 951c43f6..3444cb90 100644
--- a/entries/load.xml
+++ b/entries/load.xml
@@ -21,7 +21,7 @@
   Load data from the server and place the returned HTML into the matched element.
   
     
              
-      
              Note: The event handling suite also has a method named .load(). jQuery determines which method to fire based on the set of arguments passed to it.
              
+      
              Note: Prior to jQuery 3.0, the event handling suite also had a method named .load(). Older versions of jQuery determined which method to fire based on the set of arguments passed to it.
              
     
              
     
              This method is the simplest way to fetch data from the server. It is roughly equivalent to $.get(url, data, success) except that it is a method rather than global function and it has an implicit callback function.  When a successful response is detected (i.e. when textStatus is "success" or "notmodified"), .load() sets the HTML contents of the matched element to the returned data. This means that most uses of the method can be quite simple:
              
     
              

From eceefcf142534cb51ae443157a4752c9357f3ebd Mon Sep 17 00:00:00 2001
From: denis 
Date: Mon, 20 Feb 2017 17:54:40 +0100
Subject: [PATCH 492/699] jQuery.type: Add results for symbols (bare & boxed)

Closes #1025
---
 entries/jQuery.type.xml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/entries/jQuery.type.xml b/entries/jQuery.type.xml
index f77b3139..26dbe913 100644
--- a/entries/jQuery.type.xml
+++ b/entries/jQuery.type.xml
@@ -32,6 +32,8 @@
           
            • jQuery.type( new Array() ) === "array"
              • 
           
            • jQuery.type( new Date() ) === "date"
              • 
           
            • jQuery.type( new Error() ) === "error" // as of jQuery 1.9
              • 
+          
            • jQuery.type( Symbol() ) === "symbol" // as of jQuery 1.9
              • 
+          
            • jQuery.type( Object(Symbol()) ) === "symbol" // as of jQuery 1.12
              • 
           
            • jQuery.type( /test/ ) === "regexp"
              • 
         
       

From de9998303049b92d5e2f7cba88009cb55709e4fe Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Wed, 1 Mar 2017 10:49:55 +0100
Subject: [PATCH 493/699] 1.12.22

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 368efd68..574ad9d9 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.21",
+  "version": "1.12.22",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From b7ec850f7c515318d24f268ff080d71ccdf7d33f Mon Sep 17 00:00:00 2001
From: Richard Gibson 
Date: Sat, 21 Jan 2017 23:42:41 -0500
Subject: [PATCH 494/699] jQuery.ajax: Improve the jqXHR properties/methods
 documentation

* Alphabetize properties and methods
* Add missing methods and parameters
* Clarify getAllResponseHeaders
* Standardize formatting
* Document getResponseHeader argument

Fixes gh-1019
Closes gh-1020
---
 entries/jQuery.ajax.xml | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index 93fd2759..393bc83c 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -280,25 +280,32 @@ jqxhr.always(function() {
       
            • 
         readyState
       
              • 
+      
            • 
+        responseXML and/or responseText when the underlying request responded with xml and/or text, respectively
+      
              • 
       
            • 
         status
       
              • 
       
            • 
         statusText
       
              • 
-      
            • responseXML and/or responseText when the underlying request responded with xml and/or text, respectively
              • 
-      
            • setRequestHeader(name, value) which departs from the standard by replacing the old value with the new one rather than concatenating the new value to the old one
              • 
       
            • 
-        getAllResponseHeaders()
+        abort( [ statusText ] )
+      
              • 
+      
            • 
+        getAllResponseHeaders() as a string
+      
              • 
+      
            • 
+        getResponseHeader( name )
       
              • 
       
            • 
-        getResponseHeader()
+        overrideMimeType( mimeType )
       
              • 
       
            • 
-        statusCode()
+        setRequestHeader( name, value ) which departs from the standard by replacing the old value with the new one rather than concatenating the new value to the old one
       
              • 
       
            • 
-        abort()
+        statusCode( callbacksByStatusCode )
       
              • 
     
     
              No onreadystatechange mechanism is provided, however, since done, fail, always, and statusCode cover all conceivable requirements.
              

From b2b9d8acd523fa2da2147be1a18204217c17b361 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Wed, 8 Mar 2017 10:41:29 +0100
Subject: [PATCH 495/699] 1.12.23

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 574ad9d9..64b6253c 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.22",
+  "version": "1.12.23",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 3ab6720bdbeefa64d34bdb7d79bc03468788f49f Mon Sep 17 00:00:00 2001
From: Timo Tijhof 
Date: Mon, 20 Mar 2017 15:34:07 -0700
Subject: [PATCH 496/699] jQuery.when: Add Thenable and Promise as acceptable
 types

Technically replacing Deferred with Thenable would work, but
mentioning Deferred and Promise directly should make this
easier to understand for new and existing users.

Fixes #906
Closes #1026
---
 entries/jQuery.when.xml | 9 ++++++---
 pages/Types.html        | 3 +++
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/entries/jQuery.when.xml b/entries/jQuery.when.xml
index 09c8393e..a27f2adc 100644
--- a/entries/jQuery.when.xml
+++ b/entries/jQuery.when.xml
@@ -3,11 +3,14 @@
   jQuery.when()
   
     1.5
-    
-      Zero or more Deferred objects, or plain JavaScript objects.
+    
+      Zero or more Thenable objects.
+      
+      
+      
     
   
-  Provides a way to execute callback functions based on zero or more objects, usually Deferred objects that represent asynchronous events.
+  Provides a way to execute callback functions based on zero or more Thenable objects, usually Deferred objects that represent asynchronous events.
   
     
              If no arguments are passed to jQuery.when(), it will return a resolved Promise.
              
     
              If a single Deferred is passed to jQuery.when(), its Promise object (a subset of the Deferred methods) is returned by the method. Additional methods of the Promise object can be called to attach callbacks, such as deferred.then. When the Deferred is resolved or rejected, usually by the code that created the Deferred originally, the appropriate callbacks will be called. For example, the jqXHR object returned by jQuery.ajax() is a Promise-compatible object and can be used this way:
              
diff --git a/pages/Types.html b/pages/Types.html
index 47f5ea74..5eb5eceb 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -93,6 +93,7 @@
   
            • jQuery
              • 
   
            • XMLHttpRequest
              • 
   
            • jqXHR
              • 
+  
            • Thenable
              • 
   
            • Deferred Object
              • 
   
            • Promise Object
              • 
   
            • Callbacks Object
              • 
@@ -657,6 +658,8 @@ 
               XMLHttpRequest 
              
 
               jqXHR 
              
 
              As of jQuery 1.5, the $.ajax() method returns the jqXHR object, which is a superset of the XMLHTTPRequest object. For more information, see the jqXHR section of the $.ajax entry
 
              
+
              Thenable
              
+
              Any object that has a then method.
              
 
               Deferred Object
              
 
              As of jQuery 1.5, the Deferred object provides a way to register multiple callbacks into self-managed callback queues, invoke callback queues as appropriate, and relay the success or failure state of any synchronous or asynchronous function.
 
              

From 21c1fb1615c1de368ebf87dd418fa89395faf0c4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Mon, 20 Mar 2017 23:34:41 +0100
Subject: [PATCH 497/699] 1.12.24

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 64b6253c..a43380ff 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.23",
+  "version": "1.12.24",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 65f99f984f2ab60b2ccd64f4024a6c641fc9a8c4 Mon Sep 17 00:00:00 2001
From: Timo Tijhof 
Date: Wed, 22 Mar 2017 01:59:24 -0700
Subject: [PATCH 498/699] Selector: Move from global to instance property
 category

Follows-up e3c9d15239, which added it to the wrong category.

Closes #1030
---
 entries/selector.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/selector.xml b/entries/selector.xml
index e9e61c1e..d64fc0aa 100644
--- a/entries/selector.xml
+++ b/entries/selector.xml
@@ -9,7 +9,7 @@
     
              The .selector property was deprecated in jQuery 1.7 and is only maintained to the extent needed for supporting .live() in the jQuery Migrate plugin. It may be removed without notice in a future version. The property was never a reliable indicator of the selector that could be used to obtain the set of elements currently contained in the jQuery set where it was a property, since subsequent traversal methods may have changed the set. Plugins that need to use a selector string within their plugin can require it as a parameter of the method. For example, a "foo" plugin could be written as $.fn.foo = function( selector, options ) { /* plugin code goes here */ };, and the person using the plugin would write $( "div.bar" ).foo( "div.bar", {dog: "bark"} ); with the "div.bar" selector repeated as the first argument of .foo().
              
                 
   
-  
+  
   
   
   

From 7f1299441cfe8afb1b829795abf7d16ecc0ae334 Mon Sep 17 00:00:00 2001
From: Timo Tijhof 
Date: Wed, 22 Mar 2017 02:02:01 -0700
Subject: [PATCH 499/699] jQuery.ready: create page

Also categorise jQuery.holdReady in events/document-loading and
properties/global-jquery-object-properties, to match jQuery.ready.

Fixes #205
Closes #983
---
 entries/jQuery.holdReady.xml |  2 ++
 entries/jQuery.ready.xml     | 36 ++++++++++++++++++++++++++++++++++++
 2 files changed, 38 insertions(+)
 create mode 100644 entries/jQuery.ready.xml

diff --git a/entries/jQuery.holdReady.xml b/entries/jQuery.holdReady.xml
index cb795f2f..016e951a 100644
--- a/entries/jQuery.holdReady.xml
+++ b/entries/jQuery.holdReady.xml
@@ -22,5 +22,7 @@ $.getScript( "myplugin.js", function() {
 ]]>              
   
   
+  
+  
   
 
diff --git a/entries/jQuery.ready.xml b/entries/jQuery.ready.xml
new file mode 100644
index 00000000..cc1a98f1
--- /dev/null
+++ b/entries/jQuery.ready.xml
@@ -0,0 +1,36 @@
+
+
+  jQuery.ready
+  A Promise-like object (or "thenable") that resolves when the document is ready.
+  
+    1.8
+  
+  
+    
              As of jQuery 3.0, use of this object is supported via jQuery.when or the native Promise.resolve(). Code should not make assumptions about whether this object is a jQuery.Deferred, native Promise, or some other type of promise object.
              
+    
              See also ready(), which makes use of this.
              
+                
+  
+    Listen for document ready using jQuery.when.
+    
+  
+  
+    Typical usage involving another promise, using jQuery.when.
+    
+  
+  
+  
+  
+  
+              

From ca8f0526486bdfb9f746ce305563ded2a424465f Mon Sep 17 00:00:00 2001
From: Matt Flaschen 
Date: Wed, 22 Mar 2017 05:02:52 -0400
Subject: [PATCH 500/699] Add the warning about deep=false to the short
 description as well

Closes #1031
---
 entries/jQuery.extend.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.extend.xml b/entries/jQuery.extend.xml
index ee6fb4a7..42edb4ae 100644
--- a/entries/jQuery.extend.xml
+++ b/entries/jQuery.extend.xml
@@ -16,7 +16,7 @@
   
     1.1.4
     
-      If true, the merge becomes recursive (aka. deep copy).
+      If true, the merge becomes recursive (aka. deep copy).  Passing false for this argument is not supported.
     
     
       The object to extend. It will receive the new properties.

From 95dcca44d9e466b006d9884eb77f2881fc064954 Mon Sep 17 00:00:00 2001
From: eironman 
Date: Wed, 21 Dec 2016 16:50:00 +0100
Subject: [PATCH 501/699] show: fix incorrect information related to !important

There was a contradiction between show() and css() documentation about
!important behaviour.

Closes #1015
---
 entries/show.xml | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/entries/show.xml b/entries/show.xml
index fb150631..535b9c5d 100644
--- a/entries/show.xml
+++ b/entries/show.xml
@@ -32,10 +32,9 @@
     
              
 $( ".target" ).show();
     
              
-    
              The matched elements will be revealed immediately, with no animation. This is roughly equivalent to calling .css( "display", "block"), except that the display property is restored to whatever it was initially. If an element has a display value of inline, then is hidden and shown, it will once again be displayed inline.
              
-    
              Note:  If using !important in your styles, such as
-    display: none !important,
-    it is necessary to override the style using .css( "display", "block !important") should you wish for .show() to function correctly.
              
+    
              The matched elements will be revealed immediately, with no animation. This is roughly equivalent to calling .css( "display", "block" ), except that the display property is restored to whatever it was initially. If an element has a display value of inline, then is hidden and shown, it will once again be displayed inline.
              
+    
              Note:  If using !important in your styles, such as display: none !important, .show() will not override !important.
+    It is recommended to use different classes with .addClass(), .removeClass() or .toggleClass(). Another approach is using .attr( "style", "display: block !important;" ); be careful, though, as it overwrites the style attribute of the element.
              
     
              When a duration, a plain object, or a "complete" function is provided, .show() becomes an animation method. The .show() method animates the width, height, and opacity of the matched elements simultaneously.
              
     
              Durations are given in milliseconds; higher values indicate slower animations, not faster ones. The strings 'fast' and 'slow' can be supplied to indicate durations of 200 and 600 milliseconds, respectively.
              
     
              As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
              

From 90321abaeb410b79dd734b0cc7fe1c927d4e8204 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Wed, 22 Mar 2017 14:45:55 +0000
Subject: [PATCH 502/699] outerHeight: Specified type of passed arguments to
 callback

Fixes gh-989
Closes gh-1009
---
 entries/outerHeight.xml | 8 +++++++-
 entries/outerWidth.xml  | 8 +++++++-
 2 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/entries/outerHeight.xml b/entries/outerHeight.xml
index c50dd23d..e1caaf55 100644
--- a/entries/outerHeight.xml
+++ b/entries/outerHeight.xml
@@ -56,7 +56,13 @@ $( "p:last" ).text(
                 
   
     1.8.0
-    
+    
+      
+      
+      
+        
+        
+      
       A function returning the outer height to set. Receives the index position of the element in the set and the old outer height as arguments. Within the function, this refers to the current element in the set.
     
   
diff --git a/entries/outerWidth.xml b/entries/outerWidth.xml
index bb37d571..4e613cc1 100644
--- a/entries/outerWidth.xml
+++ b/entries/outerWidth.xml
@@ -56,7 +56,13 @@ $( "p:last" ).text(
   
   
     1.8.0
-    
+    
+      
+      
+      
+        
+        
+      
       A function returning the outer width to set. Receives the index position of the element in the set and the old outer width as arguments. Within the function, this refers to the current element in the set.
     
   

From 622c78ea4286bf8979f7fbded7a4c98ffa23c612 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Wed, 22 Mar 2017 15:47:59 +0100
Subject: [PATCH 503/699] 1.12.25

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index a43380ff..82f32942 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.24",
+  "version": "1.12.25",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 06e4ce4d933c3456040669912e4b4164026a825c Mon Sep 17 00:00:00 2001
From: Jade Misenas 
Date: Wed, 22 Mar 2017 17:41:35 -0400
Subject: [PATCH 504/699] one: indicate where passed data will be available

Closes #855
---
 entries/one.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/one.xml b/entries/one.xml
index 8d37f3f8..4b98e5f9 100644
--- a/entries/one.xml
+++ b/entries/one.xml
@@ -8,7 +8,7 @@
       A string containing one or more JavaScript event types, such as "click" or "submit," or custom event names.
     
     
-      An object containing data that will be passed to the event handler.
+      Data to be passed to the handler in event.data when an event is triggered.
     
     
       A function to execute at the time the event is triggered.

From 28884e399182f81ab3894b81eb0d95e15acfd0c1 Mon Sep 17 00:00:00 2001
From: Richard Gibson 
Date: Tue, 25 Apr 2017 15:43:57 -0400
Subject: [PATCH 505/699] Offset: Be more precise about the origins for
 .offset() and .position()

Ref https://github.com/jquery/jquery/pull/3487
Closes gh-1027
---
 entries/offset.xml   | 6 +++---
 entries/position.xml | 4 ++--
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/entries/offset.xml b/entries/offset.xml
index e626ac5a..9a588ca2 100644
--- a/entries/offset.xml
+++ b/entries/offset.xml
@@ -8,10 +8,10 @@
     
     Get the current coordinates of the first element in the set of matched elements, relative to the document.
     
-      
              The .offset() method allows us to retrieve the current position of an element relative to the document. Contrast this with .position(), which retrieves the current position relative to the offset parent. When positioning a new element on top of an existing one for global manipulation (in particular, for implementing drag-and-drop), .offset() is more useful.
              
+      
              The .offset() method allows us to retrieve the current position of an element (specifically its border box, which excludes margins) relative to the document. Contrast this with .position(), which retrieves the current position relative to the offset parent. When positioning a new element on top of an existing one for global manipulation (in particular, for implementing drag-and-drop), .offset() is more useful.
              
       
              .offset() returns an object containing the properties top and left.
              
       
              
-        
              Note: jQuery does not support getting the offset coordinates of hidden elements or accounting for borders, margins, or padding set on the body element.
              
+	  
              Note: jQuery does not support getting the offset coordinates of hidden elements or accounting for margins set on the <html> document element.
              
         
              While it is possible to get the coordinates of elements with visibility:hidden set, display:none is excluded from the rendering tree and thus has a position that is undefined.
              
       
              
                   
@@ -96,7 +96,7 @@ $( "*", document.body ).click(function( event ) {
     
     Set the current coordinates of every element in the set of matched elements, relative to the document.
     
-      
              The .offset() setter method allows us to reposition an element. The element's position is specified relative to the document. If the element's position style property is currently static, it will be set to relative to allow for this repositioning.
              
+      
              The .offset() setter method allows us to reposition an element. The element's border-box position is specified relative to the document. If the element's position style property is currently static, it will be set to relative to allow for this repositioning.
              
                   
     
       Set the offset of the second paragraph:
diff --git a/entries/position.xml b/entries/position.xml
index 41bd0fb7..3eed46b4 100644
--- a/entries/position.xml
+++ b/entries/position.xml
@@ -6,10 +6,10 @@
   
   Get the current coordinates of the first element in the set of matched elements, relative to the offset parent.
   
-    
              The .position() method allows us to retrieve the current position of an element relative to the offset parent. Contrast this with .offset(), which retrieves the current position relative to the document. When positioning a new element near another one and within the same containing DOM element, .position() is the more useful.
              
+    
              The .position() method allows us to retrieve the current position of an element (specifically its margin box) relative to the offset parent (specifically its padding box, which excludes margins and borders). Contrast this with .offset(), which retrieves the current position relative to the document. When positioning a new element near another one and within the same containing DOM element, .position() is the more useful.
              
     
              Returns an object containing the properties top and left.
              
     
              
-      
              Note: jQuery does not support getting the position coordinates of hidden elements or accounting for borders, margins, or padding set on the body element.
              
+      
              Note: jQuery does not support getting the position coordinates of hidden elements or accounting for margins set on the <html> document element.
              
     
              
                 
 	

From c905b5169f4f9b2ade1172edb418a6c7ca738e00 Mon Sep 17 00:00:00 2001
From: Richard Gibson 
Date: Tue, 25 Apr 2017 15:44:41 -0400
Subject: [PATCH 506/699] 1.12.26

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 82f32942..ab9ac01c 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.25",
+  "version": "1.12.26",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From c021b3efd9b8332aca6eaa8a65119dccd77e78eb Mon Sep 17 00:00:00 2001
From: Jack Alma 
Date: Wed, 26 Jul 2017 02:58:05 -0600
Subject: [PATCH 507/699] mousedown: Fix a misplaced space

Closes #1051
---
 entries/mousedown.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/mousedown.xml b/entries/mousedown.xml
index dc1626fd..ea8d9a0e 100644
--- a/entries/mousedown.xml
+++ b/entries/mousedown.xml
@@ -54,7 +54,7 @@ $( "#other" ).click(function() {
 });
     
              
     
              After this code executes, clicks on Trigger the handler will also alert the message.
              
-    
              The mousedown event is sent when any mouse button is clicked. To act only on specific buttons, we can use the event object's which property. Not all browsers support this property (Internet Explorer uses button instead), but jQuery normalizes the property so that it is safe to use in any browser. The value of which will be 1 for the left button, 2 for the middle button, or 3 for the right button.
              
+    
              The mousedown event is sent when any mouse button is clicked. To act only on specific buttons, we can use the event object's which property. Not all browsers support this property (Internet Explorer uses button instead), but jQuery normalizes the property so that it is safe to use in any browser. The value of which will be 1 for the left button, 2 for the middle button, or 3 for the right button.
              
     
              This event is primarily useful for ensuring that the primary button was used to begin a drag operation; if ignored, strange results can occur when the user attempts to use a context menu. While the middle and right buttons can be detected with these properties, this is not reliable. In Opera and Safari, for example, right mouse button clicks are not detectable by default.
              
     
              If the user clicks on an element, drags away from it, and releases the button, this is still counted as a mousedown event. This sequence of actions is treated as a "canceling" of the button press in most user interfaces, so it is usually better to use the click event unless we know that the mousedown event is preferable for a particular situation.
              
   

From 8dabbaf7d382718827b10eedb61a7345d02a020c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Wed, 26 Jul 2017 11:18:51 +0200
Subject: [PATCH 508/699] Build: Add a package-lock.json

---
 package-lock.json | 666 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 666 insertions(+)
 create mode 100644 package-lock.json

diff --git a/package-lock.json b/package-lock.json
new file mode 100644
index 00000000..2eaf2817
--- /dev/null
+++ b/package-lock.json
@@ -0,0 +1,666 @@
+{
+  "name": "api.jquery.com",
+  "version": "1.12.26",
+  "lockfileVersion": 1,
+  "requires": true,
+  "dependencies": {
+    "abbrev": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/abbrev/-/abbrev-1.1.0.tgz",
+      "integrity": "sha1-0FVMIlZjbi9W58LlrRg/hZQo2B8="
+    },
+    "argparse": {
+      "version": "0.1.16",
+      "resolved": "https://registry.npmjs.org/argparse/-/argparse-0.1.16.tgz",
+      "integrity": "sha1-z9AeD7uj1srtBJ+9dY1A9lGW9Xw=",
+      "requires": {
+        "underscore": "1.7.0",
+        "underscore.string": "2.4.0"
+      },
+      "dependencies": {
+        "underscore.string": {
+          "version": "2.4.0",
+          "resolved": "https://registry.npmjs.org/underscore.string/-/underscore.string-2.4.0.tgz",
+          "integrity": "sha1-jN2PusTi0uoefi6Al8QvRCKA+Fs="
+        }
+      }
+    },
+    "async": {
+      "version": "0.1.22",
+      "resolved": "https://registry.npmjs.org/async/-/async-0.1.22.tgz",
+      "integrity": "sha1-D8GqoIig4+8Ovi2IMbqw3PiEUGE="
+    },
+    "balanced-match": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.0.tgz",
+      "integrity": "sha1-ibTRmasr7kneFk6gK4nORi1xt2c="
+    },
+    "brace-expansion": {
+      "version": "1.1.8",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.8.tgz",
+      "integrity": "sha1-wHshHHyVLsH479Uad+8NHTmQopI=",
+      "requires": {
+        "balanced-match": "1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "cheerio": {
+      "version": "0.17.0",
+      "resolved": "https://registry.npmjs.org/cheerio/-/cheerio-0.17.0.tgz",
+      "integrity": "sha1-+lrkLMYBIRM9KW0LRtmDIV9yaOo=",
+      "requires": {
+        "CSSselect": "0.4.1",
+        "dom-serializer": "0.0.1",
+        "entities": "1.1.1",
+        "htmlparser2": "3.7.3",
+        "lodash": "2.4.2"
+      },
+      "dependencies": {
+        "lodash": {
+          "version": "2.4.2",
+          "resolved": "https://registry.npmjs.org/lodash/-/lodash-2.4.2.tgz",
+          "integrity": "sha1-+t2DS5aDBz2hebPq5tnA0VBT9z4="
+        }
+      }
+    },
+    "coffee-script": {
+      "version": "1.3.3",
+      "resolved": "https://registry.npmjs.org/coffee-script/-/coffee-script-1.3.3.tgz",
+      "integrity": "sha1-FQ1rTLUiiUNp7+1qIQHCC8f0pPQ="
+    },
+    "colors": {
+      "version": "0.6.2",
+      "resolved": "https://registry.npmjs.org/colors/-/colors-0.6.2.tgz",
+      "integrity": "sha1-JCP+ZnisDF2uiFLl0OW+CMmXq8w="
+    },
+    "concat-map": {
+      "version": "0.0.1",
+      "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
+      "integrity": "sha1-2Klr13/Wjfd5OnMDajug1UBdR3s="
+    },
+    "core-util-is": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.2.tgz",
+      "integrity": "sha1-tf1UIgqivFq1eqtxQMlAdUUDwac="
+    },
+    "CSSselect": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/CSSselect/-/CSSselect-0.4.1.tgz",
+      "integrity": "sha1-+Kt+H4QYzmPNput713ioXX7EkrI=",
+      "requires": {
+        "CSSwhat": "0.4.7",
+        "domutils": "1.4.3"
+      }
+    },
+    "CSSwhat": {
+      "version": "0.4.7",
+      "resolved": "https://registry.npmjs.org/CSSwhat/-/CSSwhat-0.4.7.tgz",
+      "integrity": "sha1-hn2g/zn3eGEyQsRM/qg/CqTr35s="
+    },
+    "dateformat": {
+      "version": "1.0.2-1.2.3",
+      "resolved": "https://registry.npmjs.org/dateformat/-/dateformat-1.0.2-1.2.3.tgz",
+      "integrity": "sha1-sCIMAt6YYXQztyhRz0fePfLNvuk="
+    },
+    "dom-serializer": {
+      "version": "0.0.1",
+      "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-0.0.1.tgz",
+      "integrity": "sha1-lYmCfx4y0iw3yCmtq9WbMkevjq8=",
+      "requires": {
+        "domelementtype": "1.1.3",
+        "entities": "1.1.1"
+      },
+      "dependencies": {
+        "domelementtype": {
+          "version": "1.1.3",
+          "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-1.1.3.tgz",
+          "integrity": "sha1-vSh3PiZCiBrsUVRJJCmcXNgiGFs="
+        }
+      }
+    },
+    "domelementtype": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-1.3.0.tgz",
+      "integrity": "sha1-sXrtguirWeUt2cGbF1bg/BhyBMI="
+    },
+    "domhandler": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-2.2.1.tgz",
+      "integrity": "sha1-Wd+dzSJ+gIs2Wuc+H2aErD2Ub8I=",
+      "requires": {
+        "domelementtype": "1.3.0"
+      }
+    },
+    "domutils": {
+      "version": "1.4.3",
+      "resolved": "https://registry.npmjs.org/domutils/-/domutils-1.4.3.tgz",
+      "integrity": "sha1-CGVRN5bGswYDGFDhdVFrr4C3Km8=",
+      "requires": {
+        "domelementtype": "1.3.0"
+      }
+    },
+    "entities": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/entities/-/entities-1.1.1.tgz",
+      "integrity": "sha1-blwtClYhtdra7O+AuQ7ftc13cvA="
+    },
+    "esprima": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/esprima/-/esprima-1.0.4.tgz",
+      "integrity": "sha1-n1V+CPw7TSbs6d00+Pv0drYlha0="
+    },
+    "eventemitter2": {
+      "version": "0.4.14",
+      "resolved": "https://registry.npmjs.org/eventemitter2/-/eventemitter2-0.4.14.tgz",
+      "integrity": "sha1-j2G3XN4BKy6esoTUVFWDtWQ7Yas="
+    },
+    "exit": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/exit/-/exit-0.1.2.tgz",
+      "integrity": "sha1-BjJjj42HfMghB9MKD/8aF8uhzQw="
+    },
+    "findup-sync": {
+      "version": "0.1.3",
+      "resolved": "https://registry.npmjs.org/findup-sync/-/findup-sync-0.1.3.tgz",
+      "integrity": "sha1-fz56l7gjksZTvwZYm9hRkOk8NoM=",
+      "requires": {
+        "glob": "3.2.11",
+        "lodash": "2.4.2"
+      },
+      "dependencies": {
+        "glob": {
+          "version": "3.2.11",
+          "resolved": "https://registry.npmjs.org/glob/-/glob-3.2.11.tgz",
+          "integrity": "sha1-Spc/Y1uRkPcV0QmH1cAP0oFevj0=",
+          "requires": {
+            "inherits": "2.0.3",
+            "minimatch": "0.3.0"
+          }
+        },
+        "lodash": {
+          "version": "2.4.2",
+          "resolved": "https://registry.npmjs.org/lodash/-/lodash-2.4.2.tgz",
+          "integrity": "sha1-+t2DS5aDBz2hebPq5tnA0VBT9z4="
+        },
+        "minimatch": {
+          "version": "0.3.0",
+          "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-0.3.0.tgz",
+          "integrity": "sha1-J12O2qxPG7MyZHIInnlJyDlGmd0=",
+          "requires": {
+            "lru-cache": "2.7.3",
+            "sigmund": "1.0.1"
+          }
+        }
+      }
+    },
+    "getobject": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/getobject/-/getobject-0.1.0.tgz",
+      "integrity": "sha1-BHpEl4n6Fg0Bj1SG7ZEyC27HiFw="
+    },
+    "gilded-wordpress": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/gilded-wordpress/-/gilded-wordpress-1.0.3.tgz",
+      "integrity": "sha1-kh/iJ93yWyxAgp5QUjsOMXRDsz4=",
+      "requires": {
+        "async": "0.9.2",
+        "glob": "4.0.6",
+        "wordpress": "1.1.2"
+      },
+      "dependencies": {
+        "async": {
+          "version": "0.9.2",
+          "resolved": "https://registry.npmjs.org/async/-/async-0.9.2.tgz",
+          "integrity": "sha1-rqdNXmHB+JlhO/ZL2mbUx48v0X0="
+        },
+        "glob": {
+          "version": "4.0.6",
+          "resolved": "https://registry.npmjs.org/glob/-/glob-4.0.6.tgz",
+          "integrity": "sha1-aVxQvdTi+1xdNwsJHziNNwfikac=",
+          "requires": {
+            "graceful-fs": "3.0.11",
+            "inherits": "2.0.3",
+            "minimatch": "1.0.0",
+            "once": "1.4.0"
+          }
+        },
+        "graceful-fs": {
+          "version": "3.0.11",
+          "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-3.0.11.tgz",
+          "integrity": "sha1-dhPHeKGv6mLyXGMKCG1/Osu92Bg=",
+          "requires": {
+            "natives": "1.1.0"
+          }
+        },
+        "minimatch": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-1.0.0.tgz",
+          "integrity": "sha1-4N0hILSeG3JM6NcUxSCCKpQ4V20=",
+          "requires": {
+            "lru-cache": "2.7.3",
+            "sigmund": "1.0.1"
+          }
+        }
+      }
+    },
+    "glob": {
+      "version": "3.1.21",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-3.1.21.tgz",
+      "integrity": "sha1-0p4KBV3qUTj00H7UDomC6DwgZs0=",
+      "requires": {
+        "graceful-fs": "1.2.3",
+        "inherits": "1.0.2",
+        "minimatch": "0.2.14"
+      },
+      "dependencies": {
+        "inherits": {
+          "version": "1.0.2",
+          "resolved": "https://registry.npmjs.org/inherits/-/inherits-1.0.2.tgz",
+          "integrity": "sha1-ykMJ2t7mtUzAuNJH6NfHoJdb3Js="
+        }
+      }
+    },
+    "graceful-fs": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-1.2.3.tgz",
+      "integrity": "sha1-FaSAaldUfLLS2/J/QuiajDRRs2Q="
+    },
+    "grunt": {
+      "version": "0.4.5",
+      "resolved": "https://registry.npmjs.org/grunt/-/grunt-0.4.5.tgz",
+      "integrity": "sha1-VpN81RlDJK3/bSB2MYMqnWuk5/A=",
+      "requires": {
+        "async": "0.1.22",
+        "coffee-script": "1.3.3",
+        "colors": "0.6.2",
+        "dateformat": "1.0.2-1.2.3",
+        "eventemitter2": "0.4.14",
+        "exit": "0.1.2",
+        "findup-sync": "0.1.3",
+        "getobject": "0.1.0",
+        "glob": "3.1.21",
+        "grunt-legacy-log": "0.1.3",
+        "grunt-legacy-util": "0.2.0",
+        "hooker": "0.2.3",
+        "iconv-lite": "0.2.11",
+        "js-yaml": "2.0.5",
+        "lodash": "0.9.2",
+        "minimatch": "0.2.14",
+        "nopt": "1.0.10",
+        "rimraf": "2.2.8",
+        "underscore.string": "2.2.1",
+        "which": "1.0.9"
+      }
+    },
+    "grunt-check-modules": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/grunt-check-modules/-/grunt-check-modules-1.0.0.tgz",
+      "integrity": "sha1-Y/9erkYTF5tKifaozTcfekAfd4I="
+    },
+    "grunt-cli": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/grunt-cli/-/grunt-cli-1.1.0.tgz",
+      "integrity": "sha1-r9eWmTTd8zYg6ER+3B+pTlHlWjQ=",
+      "requires": {
+        "findup-sync": "0.3.0",
+        "nopt": "3.0.6",
+        "resolve": "1.1.7"
+      },
+      "dependencies": {
+        "findup-sync": {
+          "version": "0.3.0",
+          "resolved": "https://registry.npmjs.org/findup-sync/-/findup-sync-0.3.0.tgz",
+          "integrity": "sha1-N5MKpdgWt3fANEXhlmzGeQpMCxY=",
+          "requires": {
+            "glob": "5.0.15"
+          }
+        },
+        "glob": {
+          "version": "5.0.15",
+          "resolved": "https://registry.npmjs.org/glob/-/glob-5.0.15.tgz",
+          "integrity": "sha1-G8k2ueAvSmA/zCIuz3Yz0wuLk7E=",
+          "requires": {
+            "inflight": "1.0.6",
+            "inherits": "2.0.3",
+            "minimatch": "3.0.4",
+            "once": "1.4.0",
+            "path-is-absolute": "1.0.1"
+          }
+        },
+        "minimatch": {
+          "version": "3.0.4",
+          "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.0.4.tgz",
+          "integrity": "sha512-yJHVQEhyqPLUTgt9B83PXu6W3rx4MvvHvSUvToogpwoGDOUQ+yDrR0HRot+yOCdCO7u4hX3pWft6kWBBcqh0UA==",
+          "requires": {
+            "brace-expansion": "1.1.8"
+          }
+        },
+        "nopt": {
+          "version": "3.0.6",
+          "resolved": "https://registry.npmjs.org/nopt/-/nopt-3.0.6.tgz",
+          "integrity": "sha1-xkZdvwirzU2zWTF/eaxopkayj/k=",
+          "requires": {
+            "abbrev": "1.1.0"
+          }
+        }
+      }
+    },
+    "grunt-jquery-content": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/grunt-jquery-content/-/grunt-jquery-content-3.0.1.tgz",
+      "integrity": "sha1-aHdrx0G1SVEdaPBouVCsizd+g90=",
+      "requires": {
+        "async": "0.9.0",
+        "cheerio": "0.17.0",
+        "grunt-check-modules": "1.0.0",
+        "grunt-wordpress": "2.1.2",
+        "he": "0.5.0",
+        "highlight.js": "7.3.0",
+        "marked": "0.3.2",
+        "rimraf": "2.2.8",
+        "spawnback": "1.0.0",
+        "which": "1.0.5",
+        "wordpress": "1.1.2"
+      },
+      "dependencies": {
+        "async": {
+          "version": "0.9.0",
+          "resolved": "https://registry.npmjs.org/async/-/async-0.9.0.tgz",
+          "integrity": "sha1-rDYTsdqb7RtHUQu0ZRuJMeRxRsc="
+        },
+        "which": {
+          "version": "1.0.5",
+          "resolved": "https://registry.npmjs.org/which/-/which-1.0.5.tgz",
+          "integrity": "sha1-VjDWgZ3aaS8UZEYueVbLQsCEJzk="
+        }
+      }
+    },
+    "grunt-legacy-log": {
+      "version": "0.1.3",
+      "resolved": "https://registry.npmjs.org/grunt-legacy-log/-/grunt-legacy-log-0.1.3.tgz",
+      "integrity": "sha1-7ClCboAwIa9ZAp+H0vnNczWgVTE=",
+      "requires": {
+        "colors": "0.6.2",
+        "grunt-legacy-log-utils": "0.1.1",
+        "hooker": "0.2.3",
+        "lodash": "2.4.2",
+        "underscore.string": "2.3.3"
+      },
+      "dependencies": {
+        "lodash": {
+          "version": "2.4.2",
+          "resolved": "https://registry.npmjs.org/lodash/-/lodash-2.4.2.tgz",
+          "integrity": "sha1-+t2DS5aDBz2hebPq5tnA0VBT9z4="
+        },
+        "underscore.string": {
+          "version": "2.3.3",
+          "resolved": "https://registry.npmjs.org/underscore.string/-/underscore.string-2.3.3.tgz",
+          "integrity": "sha1-ccCL9rQosRM/N+ePo6Icgvcymw0="
+        }
+      }
+    },
+    "grunt-legacy-log-utils": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/grunt-legacy-log-utils/-/grunt-legacy-log-utils-0.1.1.tgz",
+      "integrity": "sha1-wHBrndkGThFvNvI/5OawSGcsD34=",
+      "requires": {
+        "colors": "0.6.2",
+        "lodash": "2.4.2",
+        "underscore.string": "2.3.3"
+      },
+      "dependencies": {
+        "lodash": {
+          "version": "2.4.2",
+          "resolved": "https://registry.npmjs.org/lodash/-/lodash-2.4.2.tgz",
+          "integrity": "sha1-+t2DS5aDBz2hebPq5tnA0VBT9z4="
+        },
+        "underscore.string": {
+          "version": "2.3.3",
+          "resolved": "https://registry.npmjs.org/underscore.string/-/underscore.string-2.3.3.tgz",
+          "integrity": "sha1-ccCL9rQosRM/N+ePo6Icgvcymw0="
+        }
+      }
+    },
+    "grunt-legacy-util": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/grunt-legacy-util/-/grunt-legacy-util-0.2.0.tgz",
+      "integrity": "sha1-kzJIhNv343qf98Am3/RR2UqeVUs=",
+      "requires": {
+        "async": "0.1.22",
+        "exit": "0.1.2",
+        "getobject": "0.1.0",
+        "hooker": "0.2.3",
+        "lodash": "0.9.2",
+        "underscore.string": "2.2.1",
+        "which": "1.0.9"
+      }
+    },
+    "grunt-wordpress": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/grunt-wordpress/-/grunt-wordpress-2.1.2.tgz",
+      "integrity": "sha1-ue3Lv5jp6HM9F6gsMmWf2zbO2LE=",
+      "requires": {
+        "gilded-wordpress": "1.0.3"
+      }
+    },
+    "he": {
+      "version": "0.5.0",
+      "resolved": "https://registry.npmjs.org/he/-/he-0.5.0.tgz",
+      "integrity": "sha1-LAX/rvkLaOhg8/0rVO9YCYknfuI="
+    },
+    "highlight.js": {
+      "version": "7.3.0",
+      "resolved": "https://registry.npmjs.org/highlight.js/-/highlight.js-7.3.0.tgz",
+      "integrity": "sha1-bF8PZOcHj2ZAK82/yJEQw/0bqZ8="
+    },
+    "hooker": {
+      "version": "0.2.3",
+      "resolved": "https://registry.npmjs.org/hooker/-/hooker-0.2.3.tgz",
+      "integrity": "sha1-uDT3I8xKJCqmWWNFnfbZhMXT2Vk="
+    },
+    "htmlparser2": {
+      "version": "3.7.3",
+      "resolved": "https://registry.npmjs.org/htmlparser2/-/htmlparser2-3.7.3.tgz",
+      "integrity": "sha1-amTHdjfAjG8w7CqBV6UzM758sF4=",
+      "requires": {
+        "domelementtype": "1.3.0",
+        "domhandler": "2.2.1",
+        "domutils": "1.5.1",
+        "entities": "1.0.0",
+        "readable-stream": "1.1.14"
+      },
+      "dependencies": {
+        "domutils": {
+          "version": "1.5.1",
+          "resolved": "https://registry.npmjs.org/domutils/-/domutils-1.5.1.tgz",
+          "integrity": "sha1-3NhIiib1Y9YQeeSMn3t+Mjc2gs8=",
+          "requires": {
+            "dom-serializer": "0.0.1",
+            "domelementtype": "1.3.0"
+          }
+        },
+        "entities": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/entities/-/entities-1.0.0.tgz",
+          "integrity": "sha1-sph6o4ITR/zeZCsk/fyeT7cSvyY="
+        }
+      }
+    },
+    "iconv-lite": {
+      "version": "0.2.11",
+      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.2.11.tgz",
+      "integrity": "sha1-HOYKOleGSiktEyH/RgnKS7llrcg="
+    },
+    "inflight": {
+      "version": "1.0.6",
+      "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz",
+      "integrity": "sha1-Sb1jMdfQLQwJvJEKEHW6gWW1bfk=",
+      "requires": {
+        "once": "1.4.0",
+        "wrappy": "1.0.2"
+      }
+    },
+    "inherits": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.3.tgz",
+      "integrity": "sha1-Yzwsg+PaQqUC9SRmAiSA9CCCYd4="
+    },
+    "isarray": {
+      "version": "0.0.1",
+      "resolved": "https://registry.npmjs.org/isarray/-/isarray-0.0.1.tgz",
+      "integrity": "sha1-ihis/Kmo9Bd+Cav8YDiTmwXR7t8="
+    },
+    "js-yaml": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-2.0.5.tgz",
+      "integrity": "sha1-olrmUJmZ6X3yeMZxnaEb0Gh3Q6g=",
+      "requires": {
+        "argparse": "0.1.16",
+        "esprima": "1.0.4"
+      }
+    },
+    "lodash": {
+      "version": "0.9.2",
+      "resolved": "https://registry.npmjs.org/lodash/-/lodash-0.9.2.tgz",
+      "integrity": "sha1-jzSZxSRdNG1oLlsNO0B2fgnxqSw="
+    },
+    "lru-cache": {
+      "version": "2.7.3",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-2.7.3.tgz",
+      "integrity": "sha1-bUUk6LlV+V1PW1iFHOId1y+06VI="
+    },
+    "marked": {
+      "version": "0.3.2",
+      "resolved": "https://registry.npmjs.org/marked/-/marked-0.3.2.tgz",
+      "integrity": "sha1-AV2xWIZEOPJKZL3WGgQotBhwbQk="
+    },
+    "minimatch": {
+      "version": "0.2.14",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-0.2.14.tgz",
+      "integrity": "sha1-x054BXT2PG+aCQ6Q775u9TpqdWo=",
+      "requires": {
+        "lru-cache": "2.7.3",
+        "sigmund": "1.0.1"
+      }
+    },
+    "natives": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/natives/-/natives-1.1.0.tgz",
+      "integrity": "sha1-6f+EFBimsux6SV6TmYT3jxY+bjE="
+    },
+    "nopt": {
+      "version": "1.0.10",
+      "resolved": "https://registry.npmjs.org/nopt/-/nopt-1.0.10.tgz",
+      "integrity": "sha1-bd0hvSoxQXuScn3Vhfim83YI6+4=",
+      "requires": {
+        "abbrev": "1.1.0"
+      }
+    },
+    "once": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
+      "integrity": "sha1-WDsap3WWHUsROsF9nFC6753Xa9E=",
+      "requires": {
+        "wrappy": "1.0.2"
+      }
+    },
+    "path-is-absolute": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz",
+      "integrity": "sha1-F0uSaHNVNP+8es5r9TpanhtcX18="
+    },
+    "readable-stream": {
+      "version": "1.1.14",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-1.1.14.tgz",
+      "integrity": "sha1-fPTFTvZI44EwhMY23SB54WbAgdk=",
+      "requires": {
+        "core-util-is": "1.0.2",
+        "inherits": "2.0.3",
+        "isarray": "0.0.1",
+        "string_decoder": "0.10.31"
+      }
+    },
+    "resolve": {
+      "version": "1.1.7",
+      "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.1.7.tgz",
+      "integrity": "sha1-IDEU2CrSxe2ejgQRs5ModeiJ6Xs="
+    },
+    "rimraf": {
+      "version": "2.2.8",
+      "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-2.2.8.tgz",
+      "integrity": "sha1-5Dm+Kq7jJzIZUnMPmaiSnk/FBYI="
+    },
+    "sax": {
+      "version": "0.6.1",
+      "resolved": "https://registry.npmjs.org/sax/-/sax-0.6.1.tgz",
+      "integrity": "sha1-VjsZx8HeiS4Jv8Ty/DDjwn8JUrk="
+    },
+    "sigmund": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/sigmund/-/sigmund-1.0.1.tgz",
+      "integrity": "sha1-P/IfGYytIXX587eBhT/ZTQ0ZtZA="
+    },
+    "spawnback": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/spawnback/-/spawnback-1.0.0.tgz",
+      "integrity": "sha1-9zZi9+VNlTZ+ynTWQmxnfdfqaG8="
+    },
+    "string_decoder": {
+      "version": "0.10.31",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz",
+      "integrity": "sha1-YuIDvEF2bGwoyfyEMB2rHFMQ+pQ="
+    },
+    "underscore": {
+      "version": "1.7.0",
+      "resolved": "https://registry.npmjs.org/underscore/-/underscore-1.7.0.tgz",
+      "integrity": "sha1-a7rwh3UA02vjTsqlhODbn+8DUgk="
+    },
+    "underscore.string": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/underscore.string/-/underscore.string-2.2.1.tgz",
+      "integrity": "sha1-18D6KvXVoaZ/QlPa7pgTLnM/Dxk="
+    },
+    "which": {
+      "version": "1.0.9",
+      "resolved": "https://registry.npmjs.org/which/-/which-1.0.9.tgz",
+      "integrity": "sha1-RgwdoPgQED0DIam2M6+eV15kSG8="
+    },
+    "wordpress": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/wordpress/-/wordpress-1.1.2.tgz",
+      "integrity": "sha1-uDZhhSBVSXESG8VsQ7A5yzgg94M=",
+      "requires": {
+        "xmlrpc": "1.3.1"
+      }
+    },
+    "wrappy": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
+      "integrity": "sha1-tSQ9jz7BqjXxNkYFvA0QNuMKtp8="
+    },
+    "xmlbuilder": {
+      "version": "2.6.5",
+      "resolved": "https://registry.npmjs.org/xmlbuilder/-/xmlbuilder-2.6.5.tgz",
+      "integrity": "sha1-b/etYPty0idk8AehZLd/K/FABSY=",
+      "requires": {
+        "lodash": "3.10.1"
+      },
+      "dependencies": {
+        "lodash": {
+          "version": "3.10.1",
+          "resolved": "https://registry.npmjs.org/lodash/-/lodash-3.10.1.tgz",
+          "integrity": "sha1-W/Rejkm6QYnhfUgnid/RW9FAt7Y="
+        }
+      }
+    },
+    "xmlrpc": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/xmlrpc/-/xmlrpc-1.3.1.tgz",
+      "integrity": "sha1-OqWCCG/vUwz+Hc2qDEyd3F0ORFE=",
+      "requires": {
+        "sax": "0.6.1",
+        "xmlbuilder": "2.6.5"
+      }
+    }
+  }
+}

From e0a236becabfd660f656ef74d0abb16a38efe8cc Mon Sep 17 00:00:00 2001
From: Levi Robertson 
Date: Wed, 26 Jul 2017 02:31:09 -0700
Subject: [PATCH 509/699] closest: Correct spelling of "highlight"

Closes #1045
---
 entries/closest.xml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/entries/closest.xml b/entries/closest.xml
index 14c10a80..903ba1a7 100644
--- a/entries/closest.xml
+++ b/entries/closest.xml
@@ -109,7 +109,7 @@ $( "li.item-a" )
       Show how event delegation can be done with closest. The closest list element toggles a yellow background when it or its descendent is clicked.
       
       
@@ -134,7 +134,7 @@ $( document ).on( "click", function( event ) {
       
       

From 39e4bf4dcf4060eec4e4a12739d50713c6c7b16a Mon Sep 17 00:00:00 2001
From: Dasheng Jonathan Zhang 
Date: Wed, 26 Jul 2017 05:32:58 -0400
Subject: [PATCH 510/699] stop: fix misplaced default value

Closes #1037
---
 entries/stop.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/stop.xml b/entries/stop.xml
index b66c0bcc..c0f17348 100644
--- a/entries/stop.xml
+++ b/entries/stop.xml
@@ -13,10 +13,10 @@
   
   
     1.7
-    
+    
       The name of the queue in which to stop animations.
     
-    
+    
       A Boolean indicating whether to remove queued animation as well. Defaults to false.
     
     

From 5b7121ab1a7d2a1805e702eca20da180e336528c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski?= 
Date: Wed, 26 Jul 2017 11:54:49 +0200
Subject: [PATCH 511/699] 1.12.27

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 2eaf2817..d3c03011 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "1.12.26",
+  "version": "1.12.27",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index ab9ac01c..6a5ba757 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.26",
+  "version": "1.12.27",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 9b33cd476b8c94378a672cac9e4efde7c16d1eca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Wed, 11 Oct 2017 10:59:26 +0200
Subject: [PATCH 512/699] Add my new name to .mailmap

---
 .mailmap | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.mailmap b/.mailmap
index 175ab74f..7f902dbd 100644
--- a/.mailmap
+++ b/.mailmap
@@ -1 +1,2 @@
 Matic Potočnik  
+Michał Gołębiowski-Owczarek 

From 0c56670f38fd4e28f1f217e7fbe7de92849e0df9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?B=C3=A1lint=20Kov=C3=A1cs?= 
Date: Wed, 22 Nov 2017 04:00:12 +0000
Subject: [PATCH 513/699] callbacks.fireWith: Update text and add value type
 information

Fixes gh-1066
Closes gh-1067
---
 entries/callbacks.fireWith.xml             | 6 +++---
 entries/event.stopImmediatePropagation.xml | 2 +-
 entries/event.stopPropagation.xml          | 2 +-
 entries/jQuery.ajaxSetup.xml               | 2 +-
 entries/jQuery.globalEval.xml              | 2 +-
 5 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/entries/callbacks.fireWith.xml b/entries/callbacks.fireWith.xml
index dfb2adb3..7527e182 100644
--- a/entries/callbacks.fireWith.xml
+++ b/entries/callbacks.fireWith.xml
@@ -3,11 +3,11 @@
   callbacks.fireWith()
   
     1.7
-    
+    
       A reference to the context in which the callbacks in the list should be fired.
     
-    
-      An argument, or array of arguments, to pass to the callbacks in the list.
+    
+      An array or array-like object of arguments to pass to the callbacks in the list. If omitted or undefined, no arguments will be passed.
     
   
   Call all callbacks in a list with the given context and arguments.
diff --git a/entries/event.stopImmediatePropagation.xml b/entries/event.stopImmediatePropagation.xml
index b067e43a..e5b53eba 100644
--- a/entries/event.stopImmediatePropagation.xml
+++ b/entries/event.stopImmediatePropagation.xml
@@ -1,5 +1,5 @@
 
-
+
   event.stopImmediatePropagation()
   
     1.3
diff --git a/entries/event.stopPropagation.xml b/entries/event.stopPropagation.xml
index adf4ea10..8d34bd4d 100644
--- a/entries/event.stopPropagation.xml
+++ b/entries/event.stopPropagation.xml
@@ -1,5 +1,5 @@
 
-
+
   event.stopPropagation()
   
     1.0
diff --git a/entries/jQuery.ajaxSetup.xml b/entries/jQuery.ajaxSetup.xml
index d9589e3a..d175c54a 100644
--- a/entries/jQuery.ajaxSetup.xml
+++ b/entries/jQuery.ajaxSetup.xml
@@ -1,5 +1,5 @@
 
-
+
   jQuery.ajaxSetup()
   
     1.1
diff --git a/entries/jQuery.globalEval.xml b/entries/jQuery.globalEval.xml
index ce510fe3..ad6b7d1e 100644
--- a/entries/jQuery.globalEval.xml
+++ b/entries/jQuery.globalEval.xml
@@ -1,5 +1,5 @@
 
-
+
   jQuery.globalEval()
   
     1.0.4

From b82f48de332840e347d723d269f2943d4ccebda0 Mon Sep 17 00:00:00 2001
From: Richard Gibson 
Date: Tue, 21 Nov 2017 23:01:41 -0500
Subject: [PATCH 514/699] 1.12.28

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 6a5ba757..d388b15a 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.27",
+  "version": "1.12.28",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 576a64b8f5986bb6a447e6f98764a80a152e06fb Mon Sep 17 00:00:00 2001
From: Michael Welling 
Date: Mon, 11 Dec 2017 14:58:38 -0500
Subject: [PATCH 515/699] unwrap: Update description to include return value
 information

The `.unwrap()` method returns whatever content was unwrapped. Adding this to the description so that the behavior is documented.

Closes gh-1071
---
 entries/unwrap.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/unwrap.xml b/entries/unwrap.xml
index d3a7b405..ff6d6100 100644
--- a/entries/unwrap.xml
+++ b/entries/unwrap.xml
@@ -12,7 +12,7 @@
   
   Remove the parents of the set of matched elements from the DOM, leaving the matched elements in their place.
   
-    
              The .unwrap() method removes the element's parent. This is effectively the inverse of the .wrap() method. The matched elements (and their siblings, if any) replace their parents within the DOM structure.
              
+    
              The .unwrap() method removes the element's parent and returns the unwrapped content. This is effectively the inverse of the .wrap() method. The matched elements (and their siblings, if any) replace their parents within the DOM structure.
              
                 
   
     Wrap/unwrap a div around each of the paragraphs.

From e50c07016b42a76103927c2d5f8dba84c553861d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Wed, 6 Dec 2017 19:40:51 +0100
Subject: [PATCH 516/699] jQuery.cssHooks: remove the "O" Opera prefix

jQuery 3.0+ doesn't support Opera Presto (versions <=12.x) so including its
prefix in the docs doesn't make much sense.

Closes gh-1069
---
 entries/jQuery.cssHooks.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/jQuery.cssHooks.xml b/entries/jQuery.cssHooks.xml
index f7ecb170..19bb9054 100644
--- a/entries/jQuery.cssHooks.xml
+++ b/entries/jQuery.cssHooks.xml
@@ -45,7 +45,7 @@ function styleSupport( prop ) {
 
     // Capitalize first character of the prop to test vendor prefix
     capProp = prop.charAt( 0 ).toUpperCase() + prop.slice( 1 ),
-    prefixes = [ "Moz", "Webkit", "O", "ms" ],
+    prefixes = [ "Moz", "Webkit", "ms" ],
     div = document.createElement( "div" );
 
   if ( prop in div.style ) {
@@ -89,7 +89,7 @@ if ( !$.cssHooks ) {
 function styleSupport( prop ) {
   var vendorProp, supportedProp,
     capProp = prop.charAt( 0 ).toUpperCase() + prop.slice( 1 ),
-    prefixes = [ "Moz", "Webkit", "O", "ms" ],
+    prefixes = [ "Moz", "Webkit", "ms" ],
     div = document.createElement( "div" );
 
   if ( prop in div.style ) {

From 7a6ba164ee16317b375d2bfb59b025b13cf273a1 Mon Sep 17 00:00:00 2001
From: Wolfgang Hochleitner 
Date: Tue, 13 Jun 2017 11:38:15 +0200
Subject: [PATCH 517/699] Types: Updated XMLHttpRequest standard link

W3C's XMLHttpRequest standardization process has been discontinued.
Documentation now refers to the WHATWG living standard.

Closes gh-1046
Fixes gh-1043
---
 pages/Types.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pages/Types.html b/pages/Types.html
index 5eb5eceb..b31c47ee 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -645,9 +645,9 @@ 
               jQuery 
              
 
               XMLHttpRequest 
              
 
              Some of jQuery's Ajax functions return the native XMLHttpRequest (XHR) object, or pass it as an argument to success/error/complete handlers, so that you can do additional processing or monitoring on the request. Note that Ajax functions only return or pass an XHR object when an XHR object is actually used in the request. For example, JSONP requests and cross-domain GET requests use a script element rather than an XHR object.
 
              
-
              Although the XHR object is a standard, there are variations in its behavior on different browsers. Refer to the W3C site and browsers' documentation for more information:
+
              Although the XHR object is a standard, there are variations in its behavior on different browsers. Refer to the WHATWG site and browsers' documentation for more information:
 
              
-
              •  W3C standard
+
                •  WHATWG living standard
 
                •  Apple (Safari)
 
                •  Mozilla (Firefox)
 
                •  Microsoft (Internet Explorer)

From db4ca52993c19a3ab5ef7481252db88e2843f750 Mon Sep 17 00:00:00 2001
From: Herst 
Date: Mon, 6 Nov 2017 14:10:42 +0100
Subject: [PATCH 518/699] contextmenu: Menu button trigger not just on root

Closes gh-1065
---
 entries/contextmenu.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/contextmenu.xml b/entries/contextmenu.xml
index 0c846169..a3645ef7 100644
--- a/entries/contextmenu.xml
+++ b/entries/contextmenu.xml
@@ -24,7 +24,7 @@
   
   
     
                  This method is a shortcut for .on( "contextmenu", handler ) in the first two variations, and .trigger( "contextmenu" ) in the third.
-    The contextmenu event is sent to an element when the right button of the mouse is clicked on it, but before the context menu is displayed. In case the context menu key is pressed, the event is triggered on the html element. Any HTML element can receive this event.
+    The contextmenu event is sent to an element when the right button of the mouse is clicked on it, but before the context menu is displayed. In case the context menu key is pressed, the event is triggered on the html element or the currently focused element. Any HTML element can receive this event.
     For example, consider the HTML:
                  
     
                  
 <div id="target">

From 5d32df8c1c8db2bdf023895155f7f9c58966f3ec Mon Sep 17 00:00:00 2001
From: Richard Gibson 
Date: Mon, 29 Jan 2018 22:12:31 -0500
Subject: [PATCH 519/699] jQuery.isFunction: Resolve ambiguity about what is
 being tested

Closes gh-1079
Fixes gh-1034
---
 entries/jQuery.isFunction.xml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/entries/jQuery.isFunction.xml b/entries/jQuery.isFunction.xml
index 689cdbf7..349061ef 100644
--- a/entries/jQuery.isFunction.xml
+++ b/entries/jQuery.isFunction.xml
@@ -3,11 +3,11 @@
   jQuery.isFunction()
   
     1.2
-    
-      Object to test whether or not it is a function.
+    
+      The value to be tested.
     
   
-  Determine if the argument passed is a JavaScript function object. 
+  Determines if its argument is callable as a function.
   
     
                  Note: As of jQuery 1.3, functions provided by the browser like alert() and DOM element methods like getAttribute() are not guaranteed to be detected as functions in browsers such as Internet Explorer.
                  
                     

From 82322be998f07ee7e95f9c691dfa00d0591526bc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Wed, 7 Feb 2018 09:29:17 +0100
Subject: [PATCH 520/699] Build: Update Node from 0.12 to 8

---
 .travis.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index 86929762..3396aa4c 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,5 +1,5 @@
 language: node_js
 node_js:
-  - "0.12"
+  - "8"
 before_script:
   - npm install -g grunt-cli

From c5ad660a194ad5efda8ffb81f0a6e17b23971712 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Wed, 7 Feb 2018 09:38:25 +0100
Subject: [PATCH 521/699] Build: Don't install grunt-cli manually in Travis

It's not needed as npm scripts have node_modules/.bin prepended to PATH.
It's also better to have all versions as locked up as possible to prevent build
instability.
---
 .travis.yml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index 3396aa4c..efb09833 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,5 +1,3 @@
 language: node_js
 node_js:
   - "8"
-before_script:
-  - npm install -g grunt-cli

From 077f1bec6a1a9ff73cd364bdb1f75d5c09650a72 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Wed, 7 Feb 2018 09:40:00 +0100
Subject: [PATCH 522/699] Build: Install the libxml2-utils package on Travis,
 it's needed for xmllint

Closes #1080
---
 .travis.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.travis.yml b/.travis.yml
index efb09833..8b645e42 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,3 +1,7 @@
 language: node_js
 node_js:
   - "8"
+addons:
+  apt:
+    packages:
+    - libxml2-utils

From ba6e6a47dff7a83358d123ef4b57c416dc7f0b44 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Thu, 8 Feb 2018 22:17:55 +0100
Subject: [PATCH 523/699] 1.12.29

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index d3c03011..3fb8caf1 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "1.12.27",
+  "version": "1.12.29",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index d388b15a..fcf103c2 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.28",
+  "version": "1.12.29",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From ca12161164e2c2bc996f405ec80c74360d90b72f Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Tue, 30 Jan 2018 02:22:56 +0000
Subject: [PATCH 524/699] Added note about the deprecation of jQuery.isFunction
 in version 3.3

Closes gh-1077
Fixes gh-1074
---
 categories.xml                | 5 +++++
 entries/jQuery.isFunction.xml | 4 +++-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/categories.xml b/categories.xml
index 2ccd959e..4af831f8 100644
--- a/categories.xml
+++ b/categories.xml
@@ -70,6 +70,11 @@
       For more information, see the Release Notes/Changelog at http://blog.jquery.com/2016/06/09/jquery-3-0-final-released/
                  
       ]]>                  
+    
+	
+      For more information, see the Release Notes/Changelog at 
diff --git a/entries/jQuery.isFunction.xml b/entries/jQuery.isFunction.xml
index 349061ef..7aed5574 100644
--- a/entries/jQuery.isFunction.xml
+++ b/entries/jQuery.isFunction.xml
@@ -1,5 +1,5 @@
 
-
+
   jQuery.isFunction()
   
     1.2
@@ -9,6 +9,7 @@
   
   Determines if its argument is callable as a function.
   
+    
                  As of jQuery 3.3, jQuery.isFunction() has been deprecated. In most cases, its use can be replaced by typeof x === "function".
                  
     
                  Note: As of jQuery 1.3, functions provided by the browser like alert() and DOM element methods like getAttribute() are not guaranteed to be detected as functions in browsers such as Internet Explorer.
                  
                     
   
@@ -57,4 +58,5 @@ true
   
   
   
+  
                   

From 9d03b3717a9e8d4b8a832866f8f8a7049e2f1cbb Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Tue, 30 Jan 2018 02:49:12 +0000
Subject: [PATCH 525/699] Specified that jQuery.each accepts array-like objects

Closes gh-1078
Fixes gh-1032
Ref gh-473
---
 entries/jQuery.each.xml | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/entries/jQuery.each.xml b/entries/jQuery.each.xml
index 67fe70cc..18836015 100644
--- a/entries/jQuery.each.xml
+++ b/entries/jQuery.each.xml
@@ -3,13 +3,13 @@
   jQuery.each()
   
     1.0
-    
-      The array to iterate over.
+    
+      The array or array-like object to iterate over.
     
     
             
             
-      The function that will be executed on every object.
+      The function that will be executed on every value.
     
     
   
@@ -20,13 +20,12 @@
     
       
             
-      The function that will be executed on every object.
+      The function that will be executed on every value.
     
   
   A generic iterator function, which can be used to seamlessly iterate over both objects and arrays. Arrays and array-like objects with a length property (such as a function's arguments object) are iterated by numeric index, from 0 to length-1. Other objects are iterated via their named properties.
   
     
                  The $.each() function is not the same as $(selector).each(), which is used to iterate, exclusively, over a jQuery object. The $.each() function can be used to iterate over any collection, whether it is an object or an array. In the case of an array, the callback is passed an array index and a corresponding array value each time. (The value can also be accessed through the this keyword, but Javascript will always wrap the this value as an Object even if it is a simple string or number value.) The method returns its first argument, the object that was iterated.
                  
-    
                  Note: The $.each() function internally retrieves and uses the length property of the passed collection. So, if the collection has a property called length — e.g. {bar: 'foo', length: 10} — the function might not work as expected.
                  
     
                  
 $.each([ 52, 97 ], function( index, value ) {
   alert( index + ": " + value );

From 530dbceef1e332803a442486b1905915c324c98c Mon Sep 17 00:00:00 2001
From: pinguin999 
Date: Tue, 19 Dec 2017 14:20:03 +0100
Subject: [PATCH 526/699] getJSON: Fix Example by using https

Closes gh-1072

Error was:

Mixed Content: The page at 'https://api.jquery.com/jquery.getjson/' was loaded over HTTPS, but requested an insecure script 'http://api.flickr.com/services/feeds/photos_public.gne?jsoncallback=jQuery110203890736409927371_1513688901634&tags=mount+rainier&tagmode=any&format=json&_=1513688901635'. This request has been blocked; the content must be served over HTTPS.
---
 entries/jQuery.getJSON.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.getJSON.xml b/entries/jQuery.getJSON.xml
index c3b1e1e2..b8a5ee49 100644
--- a/entries/jQuery.getJSON.xml
+++ b/entries/jQuery.getJSON.xml
@@ -95,7 +95,7 @@ jqxhr.complete(function() {
     Loads the four most recent pictures of Mount Rainier from the Flickr JSONP API.
     
Date: Tue, 30 Jan 2018 02:30:57 +0000
Subject: [PATCH 527/699] Added note about the deprecation of jQuery.isWindow
 in version 3.3

Closes gh-1082
Fixes gh-1050
---
 entries/jQuery.isWindow.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/entries/jQuery.isWindow.xml b/entries/jQuery.isWindow.xml
index 15453599..ee8ed3b1 100644
--- a/entries/jQuery.isWindow.xml
+++ b/entries/jQuery.isWindow.xml
@@ -1,5 +1,5 @@
 
-
+
   jQuery.isWindow()
   
     1.4.3
@@ -22,4 +22,5 @@ Is 'window' a window? 
   
   
   
+  
 

From 05caac8968b98aa45d066a382d45d4ce0510bae5 Mon Sep 17 00:00:00 2001
From: Daniil Zhilin 
Date: Mon, 26 Mar 2018 19:43:40 +0300
Subject: [PATCH 528/699] jQuery.ajax: Change DataType to dataType

Closes #1088
---
 entries/jQuery.ajax.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index 393bc83c..fa77edcd 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -15,7 +15,7 @@
     1.0
     
       A set of key/value pairs that configure the Ajax request. All settings are optional. A default can be set for any option with $.ajaxSetup().
-      
+      
         A set of key/value pairs that map a given dataType to its MIME type, which gets sent in the Accept request header. This header tells the server what kind of response it will accept in return. For example, the following defines a custom type mycustomtype to be sent with the request:
           
                  
 $.ajax({

From 82380a70f10728b4274afe387b742b24f97a9dfa Mon Sep 17 00:00:00 2001
From: Brahim Arkni 
Date: Mon, 26 Mar 2018 17:44:56 +0100
Subject: [PATCH 529/699] data: Replace URL markdown syntax with HTML

Ref #943
Closes #1087
---
 entries/data.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/data.xml b/entries/data.xml
index 3606395d..66ed7253 100644
--- a/entries/data.xml
+++ b/entries/data.xml
@@ -89,7 +89,7 @@ alert( $( "body" ).data( "foo" ) ); // undefined
 $( "body" ).data( "bar", "foobar" );
 alert( $( "body" ).data( "bar" ) ); // foobar
       
                  
-      
                  jQuery 3 changes the behavior of this method to align it to the Dataset API specifications. Specifically, jQuery 3 transforms every two-character sequence of "-" (U+002D) followed by a lowercase ASCII letter by the uppercase version of the letter as per definition of [the algorithm of the Dataset API](http://www.w3.org/TR/html5/dom.html#dom-dataset). Writing a statement like $( "body" ).data( { "my-name": "aValue" } ).data(); will return { myName: "aValue" }.
                  
+      
                  jQuery 3 changes the behavior of this method to align it to the Dataset API specifications. Specifically, jQuery 3 transforms every two-character sequence of "-" (U+002D) followed by a lowercase ASCII letter by the uppercase version of the letter as per definition of the algorithm of the Dataset API. Writing a statement like $( "body" ).data( { "my-name": "aValue" } ).data(); will return { myName: "aValue" }.
                  
       
                  
         HTML5 data-* Attributes
       
                  

From 0998d12d4e12ec6b89028aeb89661187421384a4 Mon Sep 17 00:00:00 2001
From: Ethan Smith 
Date: Mon, 26 Mar 2018 12:48:56 -0400
Subject: [PATCH 530/699] jQuery.ajax: Adjust note about cross-domain ajax
 request with 'JSON' datatype

Fixes #959
Closes #1021
---
 entries/jQuery.ajax.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index fa77edcd..8d92e0f8 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -98,7 +98,7 @@ $.ajax({
             
                • "xml": Returns a XML document that can be processed via jQuery.
                  • 
             
                • "html": Returns HTML as plain text; included script tags are evaluated when inserted in the DOM.
                  • 
             
                • "script": Evaluates the response as JavaScript and returns it as plain text. Disables caching by appending a query string parameter, _=[TIMESTAMP], to the URL unless the cache option is set to true. Note: This will turn POSTs into GETs for remote-domain requests.
                  • 
-            
                • "json": Evaluates the response as JSON and returns a JavaScript object. Cross-domain "json" requests are converted to "jsonp" unless the request includes jsonp: false in its request options. The JSON data is parsed in a strict manner; any malformed JSON is rejected and a parse error is thrown. As of jQuery 1.9, an empty response is also rejected; the server should return a response of null or {} instead. (See json.org for more information on proper JSON formatting.)
                  • 
+            
                • "json": Evaluates the response as JSON and returns a JavaScript object. Cross-domain "json" requests that have a callback placeholder, e.g. ?callback=?, are performed using JSONP unless the request includes jsonp: false in its request options. The JSON data is parsed in a strict manner; any malformed JSON is rejected and a parse error is thrown. As of jQuery 1.9, an empty response is also rejected; the server should return a response of null or {} instead. (See json.org for more information on proper JSON formatting.)
                  • 
             
                • "jsonp": Loads in a JSON block using JSONP. Adds an extra "?callback=?" to the end of your URL to specify the callback. Disables caching by appending a query string parameter, "_=[TIMESTAMP]", to the URL unless the cache option is set to true.
                  • 
             
                • "text": A plain text string.
                  • 
             
                • multiple, space-separated values: As of jQuery 1.5, jQuery can convert a dataType from what it received in the Content-Type header to what you require. For example, if you want a text response to be treated as XML, use "text xml" for the dataType. You can also make a JSONP request, have it received as text, and interpreted by jQuery as XML: "jsonp text xml". Similarly, a shorthand string such as "jsonp xml" will first attempt to convert from jsonp to xml, and, failing that, convert from jsonp to text, and then from text to xml.
                  • 

From 8e67f74e434adf26ab72903caae040fd85baf749 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Mon, 26 Mar 2018 19:10:30 +0200
Subject: [PATCH 531/699] Misc: Change HTTP links to HTTPS where possible

Closes #1089
---
 CONTRIBUTING.md                                 |  6 +++---
 LICENSE.txt                                     |  4 ++--
 README.md                                       |  6 +++---
 categories.xml                                  |  6 +++---
 entries/animate.xml                             |  6 +++---
 entries/attr.xml                                |  2 +-
 entries/contents.xml                            |  2 +-
 entries/data.xml                                |  8 ++++----
 entries/empty-selector.xml                      |  2 +-
 entries/event.isImmediatePropagationStopped.xml |  2 +-
 entries/event.isPropagationStopped.xml          |  2 +-
 entries/event.metaKey.xml                       |  4 ++--
 entries/event.preventDefault.xml                |  2 +-
 entries/fadeIn.xml                              |  2 +-
 entries/fadeOut.xml                             |  2 +-
 entries/fadeToggle.xml                          |  2 +-
 entries/hidden-selector.xml                     |  2 +-
 entries/hide.xml                                |  2 +-
 entries/html.xml                                |  2 +-
 entries/id-selector.xml                         |  2 +-
 entries/jQuery.ajax.xml                         | 10 +++++-----
 entries/jQuery.ajaxPrefilter.xml                |  4 ++--
 entries/jQuery.boxModel.xml                     |  2 +-
 entries/jQuery.browser.xml                      |  2 +-
 entries/jQuery.extend.xml                       |  2 +-
 entries/jQuery.fx.interval.xml                  |  2 +-
 entries/jQuery.getJSON.xml                      |  2 +-
 entries/jQuery.parseJSON.xml                    |  2 +-
 entries/jQuery.support.xml                      |  2 +-
 entries/jQuery.xml                              |  4 ++--
 entries/keypress.xml                            |  2 +-
 entries/lang-selector.xml                       |  2 +-
 entries/map.xml                                 |  2 +-
 entries/nth-child-selector.xml                  |  2 +-
 entries/nth-last-child-selector.xml             |  2 +-
 entries/nth-last-of-type-selector.xml           |  2 +-
 entries/nth-of-type-selector.xml                |  2 +-
 entries/on.xml                                  |  4 ++--
 entries/parent-selector.xml                     |  2 +-
 entries/prop.xml                                |  2 +-
 entries/ready.xml                               |  2 +-
 entries/serialize.xml                           |  2 +-
 entries/serializeArray.xml                      |  2 +-
 entries/show.xml                                |  2 +-
 entries/slideDown.xml                           |  2 +-
 entries/slideToggle.xml                         |  2 +-
 entries/slideUp.xml                             |  2 +-
 entries/target-selector.xml                     |  4 ++--
 entries/toggle.xml                              |  2 +-
 entries/visible-selector.xml                    |  2 +-
 notes.xsl                                       |  4 ++--
 pages/Types.html                                | 11 +++--------
 52 files changed, 76 insertions(+), 81 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index ba9f6b8f..9a004cd3 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,5 +1,5 @@
-Welcome! Thanks for your interest in contributing to api.jquery.com. You're **almost** in the right place. More information on how to contribute to this and all other jQuery Foundation projects is over at [contribute.jquery.org](http://contribute.jquery.org). You'll definitely want to take a look at the articles on contributing [documentation](http://contribute.jquery.org/documentation).
+Welcome! Thanks for your interest in contributing to api.jquery.com. You're **almost** in the right place. More information on how to contribute to this and all other jQuery Foundation projects is over at [contribute.jquery.org](https://contribute.jquery.org). You'll definitely want to take a look at the articles on contributing [documentation](https://contribute.jquery.org/documentation).
 
-You may also want to take a look at our [commit & pull request guide](http://contribute.jquery.org/commits-and-pull-requests/) and [style guides](http://contribute.jquery.org/style-guide/) for instructions on how to maintain your fork and submit your code. Before we can merge any pull request, we'll also need you to sign our [contributor license agreement](http://contribute.jquery.org/cla).
+You may also want to take a look at our [commit & pull request guide](https://contribute.jquery.org/commits-and-pull-requests/) and [style guides](https://contribute.jquery.org/style-guide/) for instructions on how to maintain your fork and submit your code. Before we can merge any pull request, we'll also need you to sign our [contributor license agreement](https://contribute.jquery.org/cla).
 
-You can find us on [IRC](http://irc.jquery.org), specifically in #jquery-dev and #jquery-content should you have any questions. If you've never contributed to open source before, we've put together [a short guide with tips, tricks, and ideas on getting started](http://contribute.jquery.org/open-source/).
+You can find us on [IRC](https://irc.jquery.org), specifically in #jquery-dev and #jquery-content should you have any questions. If you've never contributed to open source before, we've put together [a short guide with tips, tricks, and ideas on getting started](https://contribute.jquery.org/open-source/).
diff --git a/LICENSE.txt b/LICENSE.txt
index 19a9bad2..203b68a7 100644
--- a/LICENSE.txt
+++ b/LICENSE.txt
@@ -1,4 +1,4 @@
-Copyright Packt Publishing (http://packtpub.com/),
+Copyright Packt Publishing (https://www.packtpub.com/),
 jQuery Foundation (https://jquery.org/), and other contributors.
 
 This software consists of voluntary contributions made by many
@@ -35,7 +35,7 @@ Copyright and related rights for sample code are waived via CC0. Sample
 code is defined as all source code displayed within the prose of the
 documentation and all examples and demos.
 
-CC0: http://creativecommons.org/publicdomain/zero/1.0/
+CC0: https://creativecommons.org/publicdomain/zero/1.0/
 
 ====
 
diff --git a/README.md b/README.md
index 805e0442..1141cd22 100644
--- a/README.md
+++ b/README.md
@@ -2,14 +2,14 @@
 
 ## Building and Deploying
 
-To build and deploy your changes for previewing in a [`jquery-wp-content`](https://github.com/jquery/jquery-wp-content) instance, follow the [workflow instructions](http://contribute.jquery.org/web-sites/#workflow) from our documentation on [contributing to jQuery Foundation web sites](http://contribute.jquery.org/web-sites/).
+To build and deploy your changes for previewing in a [`jquery-wp-content`](https://github.com/jquery/jquery-wp-content) instance, follow the [workflow instructions](https://contribute.jquery.org/web-sites/#workflow) from our documentation on [contributing to jQuery Foundation web sites](http://contribute.jquery.org/web-sites/).
 
 ### Requirements
 
 * [libxml2](http://xmlsoft.org/)
 * [libxslt](http://xmlsoft.org/libxslt/)
 
-The `xmllint` and `xsltproc` utilities need to be in your path. If you are on Windows, you can get libxml2 and libxslt from zlatkovic.com.
+The `xmllint` and `xsltproc` utilities need to be in your path. If you are on Windows, you can get libxml2 and libxslt from zlatkovic.com.
 
 **Note**: If you're using Windows and you receive the error "Error" when executing the task `build-xml-entries:all`, try to add the DLL `libwinpthread-1.dll` in the root of the project.
 
@@ -49,7 +49,7 @@ The `xmllint` and `xsltproc` utilities need to be in your path. If you are on Wi
 
 ### Code Style
 
-Code in the API documentation should follow the [jQuery Core Style Guide](http://contribute.jquery.org/style-guide/) with the following addition:
+Code in the API documentation should follow the [jQuery Core Style Guide](https://contribute.jquery.org/style-guide/) with the following addition:
 
 * **Document ready syntax**: Use `$( document ).ready(function() {` instead of `$(function() {` as it's harder for new users to distinguish the difference between the latter and an IIFE.
 
diff --git a/categories.xml b/categories.xml
index 4af831f8..b08956d9 100644
--- a/categories.xml
+++ b/categories.xml
@@ -68,12 +68,12 @@
     
     
       For more information, see the Release Notes/Changelog at http://blog.jquery.com/2016/06/09/jquery-3-0-final-released/
                  
+        
                  For more information, see the Release Notes/Changelog at http://blog.jquery.com/2016/06/09/jquery-3-0-final-released/
                  
       ]]>                  
                       
 	
       For more information, see the Release Notes/Changelog at 
                  
       ]]>                  
                       
   
@@ -428,7 +428,7 @@ var files = event.originalEvent.dataTransfer.files;
       Aspects of the API that were changed in the corresponding versions of jQuery. Changes in jQuery 1.12 and 2.2 includes performance improvements of the selector engine, manipulation of class names for SVG elements, support for the Symbol type and iterators added in ES2015, and a new hook has been added for filtering HTML. A jQuery Migrate Plugin was offered to help developers with a transitional upgrade path.
         
                  
-        
                  For more information, see the Release Notes/Changelog
                  
+        
                  For more information, see the Release Notes/Changelog
                  
         
                  
       ]]>                  
     
diff --git a/entries/animate.xml b/entries/animate.xml
index 5db2dcf6..97cac616 100644
--- a/entries/animate.xml
+++ b/entries/animate.xml
@@ -72,10 +72,10 @@ $( "#clickme" ).click(function() {
     
                  The opacity of the image is already at its target value, so this property is not animated by the second click. Since the target value for left is a relative value, the image moves even farther to the right during this second animation.
                  
     
                  Directional properties (top, right, bottom, left) have no discernible effect on elements if their  position style property is static, which it is by default.
                  
     
                  
-      
                  Note: The jQuery UI project extends the .animate() method by allowing some non-numeric styles such as colors to be animated. The project also includes mechanisms for specifying animations through CSS classes rather than individual attributes.
                  
+      
                  Note: The jQuery UI project extends the .animate() method by allowing some non-numeric styles such as colors to be animated. The project also includes mechanisms for specifying animations through CSS classes rather than individual attributes.
                  
     
                  
     
                  
-      
                  Note: if attempting to animate an element with a height or width of 0px, where contents of the element are visible due to overflow, jQuery may clip this overflow during animation. By fixing the dimensions of the original element being hidden however, it is possible to ensure that the animation runs smoothly. A clearfix can be used to automatically fix the dimensions of your main element without the need to set this manually.
                  
+      
                  Note: if attempting to animate an element with a height or width of 0px, where contents of the element are visible due to overflow, jQuery may clip this overflow during animation. By fixing the dimensions of the original element being hidden however, it is possible to ensure that the animation runs smoothly. A clearfix can be used to automatically fix the dimensions of your main element without the need to set this manually.
                  
     
                  
     
                  Step Function
                  
     
                  The second version of .animate() provides a step option — a callback function that is fired at each step of the animation. This function is useful for enabling custom animation types or altering the animation as it is occurring. It accepts two arguments (now and fx), and this is set to the DOM element being animated.
                  
@@ -96,7 +96,7 @@ $( "li" ).animate({
 });
     
                  
     
                  Easing
                  
-    
                  The remaining parameter of .animate() is a string naming an easing function to use. An easing function specifies the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
                  
+    
                  The remaining parameter of .animate() is a string naming an easing function to use. An easing function specifies the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
                  
     
                  Per-property Easing
                  
     
                  As of jQuery version 1.4, you can set per-property easing functions within a single .animate() call. In the first version of .animate(), each property can take an array as its value: The first member of the array is the CSS property and the second member is an easing function.  If a per-property easing function is not defined for a particular property, it uses the value of the .animate() method's optional easing argument. If the easing argument is not defined, the default swing function is used.
                  
     
                  For example, to simultaneously animate the width and height with the swing easing function and the opacity with the linear easing function:
                  
diff --git a/entries/attr.xml b/entries/attr.xml
index 2a963254..1628ec72 100644
--- a/entries/attr.xml
+++ b/entries/attr.xml
@@ -69,7 +69,7 @@
         
       
              
       
              
-      
              According to the W3C forms specification, the checked attribute is a boolean attribute, which means the corresponding property is true if the attribute is present at all—even if, for example, the attribute has no value or is set to empty string value or even "false". This is true of all boolean attributes.
              
+      
              According to the W3C forms specification, the checked attribute is a boolean attribute, which means the corresponding property is true if the attribute is present at all—even if, for example, the attribute has no value or is set to empty string value or even "false". This is true of all boolean attributes.
              
       
              Nevertheless, the most important concept to remember about the checked attribute is that it does not correspond to the checked property. The attribute actually corresponds to the defaultChecked property and should be used only to set the initial value of the checkbox. The checked attribute value does not change with the state of the checkbox, while the checked property does. Therefore, the cross-browser-compatible way to determine if a checkbox is checked is to use the property:
              
       
                
         
              • 
diff --git a/entries/contents.xml b/entries/contents.xml
index 5bfe9fc6..70188f7b 100644
--- a/entries/contents.xml
+++ b/entries/contents.xml
@@ -46,7 +46,7 @@ $( "p" )
   .wrap( "" );
 ]]>
     Hello John, how are you doing?
                
+
                Hello John, how are you doing?
                
 ]]>
   
   
diff --git a/entries/data.xml b/entries/data.xml
index 66ed7253..71c6c10f 100644
--- a/entries/data.xml
+++ b/entries/data.xml
@@ -31,7 +31,7 @@ $( "body" ).data(); // { foo: 52, bar: { myType: "test", count: 40 }, baz: [ 1,
       
            
       
            In jQuery 1.4.3 setting an element's data object with .data(obj) extends the data previously stored with that element.
            
       
            Prior to jQuery 1.4.3 (starting in jQuery 1.4) the .data() method completely replaced all data, instead of just extending the data object. If you are using third-party plugins it may not be advisable to completely replace the element's data object, since plugins may have also set data.
            
-      
            jQuery 3 changes the behavior of this method to align it to the Dataset API specifications. Specifically, jQuery 3 transforms every two-character sequence of "-" (U+002D) followed by a lowercase ASCII letter by the uppercase version of the letter as per definition of the algorithm of the Dataset API. Writing a statement like $( "body" ).data( { "my-name": "aValue" } ).data(); will return { myName: "aValue" }.
            
+      
            jQuery 3 changes the behavior of this method to align it to the Dataset API specifications. Specifically, jQuery 3 transforms every two-character sequence of "-" (U+002D) followed by a lowercase ASCII letter by the uppercase version of the letter as per definition of the algorithm of the Dataset API. Writing a statement like $( "body" ).data( { "my-name": "aValue" } ).data(); will return { myName: "aValue" }.
            
       
            Due to the way browsers interact with plugins and external code, the .data() method cannot be used on <object> (unless it's a Flash plugin), <applet> or <embed> elements.
            
                 
     
@@ -89,11 +89,11 @@ alert( $( "body" ).data( "foo" ) ); // undefined
 $( "body" ).data( "bar", "foobar" );
 alert( $( "body" ).data( "bar" ) ); // foobar
       
            
-      
            jQuery 3 changes the behavior of this method to align it to the Dataset API specifications. Specifically, jQuery 3 transforms every two-character sequence of "-" (U+002D) followed by a lowercase ASCII letter by the uppercase version of the letter as per definition of the algorithm of the Dataset API. Writing a statement like $( "body" ).data( { "my-name": "aValue" } ).data(); will return { myName: "aValue" }.
            
+      
            jQuery 3 changes the behavior of this method to align it to the Dataset API specifications. Specifically, jQuery 3 transforms every two-character sequence of "-" (U+002D) followed by a lowercase ASCII letter by the uppercase version of the letter as per definition of the algorithm of the Dataset API. Writing a statement like $( "body" ).data( { "my-name": "aValue" } ).data(); will return { myName: "aValue" }.
            
       
            
         HTML5 data-* Attributes
       
            
-      
            As of jQuery 1.4.3 HTML 5 data- attributes will be automatically pulled in to jQuery's data object. The treatment of attributes with embedded dashes was changed in jQuery 1.6 to conform to the W3C HTML5 specification.
            
+      
            As of jQuery 1.4.3 HTML 5 data- attributes will be automatically pulled in to jQuery's data object. The treatment of attributes with embedded dashes was changed in jQuery 1.6 to conform to the W3C HTML5 specification.
            
       
            For example, given the following HTML:
            
       
            <div data-role="page" data-last-value="43" data-hidden="true" data-options='{"name":"John"}'></div>
            
       
            All of the following jQuery code will work.
            
@@ -105,7 +105,7 @@ $( "div" ).data( "options" ).name === "John";
       
            
       
            The second statement of the code above correctly refers to the data-last-value attribute of the element. In case no data is stored with the passed key, jQuery searches among the attributes of the element, converting a camel-cased string into a dashed string and then prepending data- to the result. So, the string lastValue is converted to data-last-value.
            
       
            Every attempt is made to convert the string to a JavaScript value (this includes booleans, numbers, objects, arrays, and null). A value is only converted to a number if doing so doesn't change the value's representation. For example, "1E02" and "100.000" are equivalent as numbers (numeric value 100) but converting them would alter their representation so they are left as strings. The string value "100" is converted to the number 100.
            
-      
            When the data attribute is an object (starts with '{') or array (starts with '[') then jQuery.parseJSON is used to parse the string; it must follow valid JSON syntax including quoted property names. If the value isn't parseable as a JavaScript value, it is left as a string.
            
+      
            When the data attribute is an object (starts with '{') or array (starts with '[') then jQuery.parseJSON is used to parse the string; it must follow valid JSON syntax including quoted property names. If the value isn't parseable as a JavaScript value, it is left as a string.
            
       
            To retrieve the value's attribute as a string without any attempt to convert it, use the attr() method.
            
       
            The data- attributes are pulled in the first time the data property is accessed and then are no longer accessed or mutated (all data values are then stored internally in jQuery).
            
       
            Calling .data() with no parameters retrieves all of the values as a JavaScript object. This object can be safely cached in a variable as long as a new object is not set with .data(obj). Using the object directly to get or set values is faster than making individual calls to .data() to get or set each value:
            
diff --git a/entries/empty-selector.xml b/entries/empty-selector.xml
index 8e06d87c..165e2112 100644
--- a/entries/empty-selector.xml
+++ b/entries/empty-selector.xml
@@ -9,7 +9,7 @@
   
     
            This is the inverse of :parent. 
            
     
            One important thing to note with :empty (and :parent) is that child elements include text nodes.
            
-    
            The W3C recommends that the <p> element have at least one child node, even if that child is merely text (see http://www.w3.org/TR/html401/struct/text.html#edef-P). Some other elements, on the other hand, are empty (i.e. have no children) by definition: <input>, <img>, <br>, and <hr>, for example.
            
+    
            The W3C recommends that the <p> element have at least one child node, even if that child is merely text (see https://www.w3.org/TR/html401/struct/text.html#edef-P). Some other elements, on the other hand, are empty (i.e. have no children) by definition: <input>, <img>, <br>, and <hr>, for example.
            
               
   
     Finds all elements that are empty - they don't have child elements or text.
diff --git a/entries/event.isImmediatePropagationStopped.xml b/entries/event.isImmediatePropagationStopped.xml
index 44235564..4d8f3ad1 100644
--- a/entries/event.isImmediatePropagationStopped.xml
+++ b/entries/event.isImmediatePropagationStopped.xml
@@ -6,7 +6,7 @@
   
     Returns whether event.stopImmediatePropagation() was ever called on this event object. 
   
-    
            This property was introduced in DOM level 3.
            
+    
            This property was introduced in DOM level 3.
            
               
   
     Checks whether event.stopImmediatePropagation() was called.
diff --git a/entries/event.isPropagationStopped.xml b/entries/event.isPropagationStopped.xml
index ff7f7451..26a85b76 100644
--- a/entries/event.isPropagationStopped.xml
+++ b/entries/event.isPropagationStopped.xml
@@ -6,7 +6,7 @@
   
     Returns whether event.stopPropagation() was ever called on this event object. 
   
-    
            This event method is described in the W3C DOM Level 3 specification.
            
+    
            This event method is described in the W3C DOM Level 3 specification.
            
               
   
     Checks whether event.stopPropagation() was called
diff --git a/entries/event.metaKey.xml b/entries/event.metaKey.xml
index b83eeadd..f27b6e46 100644
--- a/entries/event.metaKey.xml
+++ b/entries/event.metaKey.xml
@@ -8,8 +8,8 @@
   
     
            Returns a boolean value (true or false) that indicates whether or not the META key was pressed at the time the event fired.
     This key might map to an alternative key name on some platforms.
            
-    
            On Macintosh keyboards, the META key maps to the Command key (⌘).
            
-    
            On Windows keyboards, the META key maps to the Windows key.
            
+    
            On Macintosh keyboards, the META key maps to the Command key (⌘).
            
+    
            On Windows keyboards, the META key maps to the Windows key.
            
               
   
     Determine whether the META key was pressed when the event fired.
diff --git a/entries/event.preventDefault.xml b/entries/event.preventDefault.xml
index 68f0a43a..ac534fcb 100644
--- a/entries/event.preventDefault.xml
+++ b/entries/event.preventDefault.xml
@@ -19,7 +19,7 @@ $( "a" ).click(function( event ) {
 });
 ]]>
     default click action is prevented
+default click action is prevented
 
            
 ]]>
               
diff --git a/entries/fadeIn.xml b/entries/fadeIn.xml
index f3b2e9e2..0f4b6888 100644
--- a/entries/fadeIn.xml
+++ b/entries/fadeIn.xml
@@ -43,7 +43,7 @@ $( "#clickme" ).click(function() {
       
            Figure 1 - Illustration of the fadeIn() effect
            
     
     
            Easing
            
-    
            As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
            
+    
            As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
            
     
            Callback Function
            
     
            If supplied, the callback is fired once the animation is complete. This can be useful for stringing different animations together in sequence. The callback is not sent any arguments, but this is set to the DOM element being animated. If multiple elements are animated, it is important to note that the callback is executed once per matched element, not once for the animation as a whole. 
            
     
            As of jQuery 1.6, the .promise() method can be used in conjunction with the deferred.done() method to execute a single callback for the animation as a whole when all matching elements have completed their animations ( See the example for .promise() ).  
            
diff --git a/entries/fadeOut.xml b/entries/fadeOut.xml
index 1bdddaf6..186056eb 100644
--- a/entries/fadeOut.xml
+++ b/entries/fadeOut.xml
@@ -47,7 +47,7 @@ $( "#clickme" ).click(function() {
       
            Note: To avoid unnecessary DOM manipulation, .fadeOut() will not hide an element that is already considered hidden. For information on which elements jQuery considers hidden, see  :hidden Selector.
            
     
     
            Easing
            
-    
            As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
            
+    
            As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
            
     
            Callback Function
            
     
            If supplied, the callback is fired once the animation is complete. This can be useful for stringing different animations together in sequence. The callback is not sent any arguments, but this is set to the DOM element being animated. If multiple elements are animated, it is important to note that the callback is executed once per matched element, not once for the animation as a whole.
            
     
            As of jQuery 1.6, the .promise() method can be used in conjunction with the deferred.done() method to execute a single callback for the animation as a whole when all matching elements have completed their animations ( See the example for .promise() ).  
            
diff --git a/entries/fadeToggle.xml b/entries/fadeToggle.xml
index 93bac084..f3906b45 100644
--- a/entries/fadeToggle.xml
+++ b/entries/fadeToggle.xml
@@ -17,7 +17,7 @@
     
            The .fadeToggle() method animates the opacity of the matched elements. When called on a visible element, the element's display style property is set to none once the opacity reaches 0, so the element no longer affects the layout of the page.
            
     
            Durations are given in milliseconds; higher values indicate slower animations, not faster ones. The strings 'fast' and 'slow' can be supplied to indicate durations of 200 and 600 milliseconds, respectively.
            
     
            Easing
            
-    
            The string representing an easing function specifies the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
            
+    
            The string representing an easing function specifies the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
            
     
            Callback Function
            
     
            If supplied, the callback is fired once the animation is complete. This can be useful for stringing different animations together in sequence. The callback is not sent any arguments, but this is set to the DOM element being animated. If multiple elements are animated, it is important to note that the callback is executed once per matched element, not once for the animation as a whole.
            
     
            As of jQuery 1.6, the .promise() method can be used in conjunction with the deferred.done() method to execute a single callback for the animation as a whole when all matching elements have completed their animations ( See the example for .promise() ).  
            
diff --git a/entries/hidden-selector.xml b/entries/hidden-selector.xml
index 47c0bf6c..e44d732b 100644
--- a/entries/hidden-selector.xml
+++ b/entries/hidden-selector.xml
@@ -18,7 +18,7 @@
     
            Elements that are not in a document are not considered to be visible; jQuery does not have a way to know if they will be visible when appended to a document since it depends on the applicable styles.
            
     
            This selector is the opposite of the :visible selector. So, every element selected by :hidden isn't selected by :visible and vice versa.
            
     
            During animations to show an element, the element is considered to be visible at the start of the animation.
            
-    
            How :hidden is determined was changed in jQuery 1.3.2. An element is assumed to be hidden if it or any of its parents consumes no space in the document. CSS visibility isn't taken into account (therefore $( elem ).css( "visibility", "hidden" ).is( ":hidden" ) == false). The release notes outline the changes in more detail.
            
+    
            How :hidden is determined was changed in jQuery 1.3.2. An element is assumed to be hidden if it or any of its parents consumes no space in the document. CSS visibility isn't taken into account (therefore $( elem ).css( "visibility", "hidden" ).is( ":hidden" ) == false). The release notes outline the changes in more detail.
            
     
            jQuery 3 slightly modifies the meaning of :hidden (and therefore of :visible). Starting with this version, elements will be considered :hidden if they don't have any layout boxes. For example, br elements and inline elements with no content will not be selected by the :hidden selector.
            
               
   
diff --git a/entries/hide.xml b/entries/hide.xml
index 3a68ca15..b90aed05 100644
--- a/entries/hide.xml
+++ b/entries/hide.xml
@@ -35,7 +35,7 @@ $( ".target" ).hide();
     
            When a duration, a plain object, or a "complete" function is provided, .hide() becomes an animation method. The .hide() method animates the width, height, and opacity of the matched elements simultaneously. When these properties reach 0, the display style property is set to none to ensure that the element no longer affects the layout of the page.
            
     
            Durations are given in milliseconds; higher values indicate slower animations, not faster ones. The strings 'fast' and 'slow' can be supplied to indicate durations of 200 and 600 milliseconds, respectively.
            
     
            Note that .hide() is fired immediately and will override the animation queue if no duration or a duration of 0 is specified.
            
-    
            As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
            
+    
            As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
            
     
            If supplied, the callback is fired once the animation is complete. This can be useful for stringing different animations together in sequence. The callback is not sent any arguments, but this is set to the DOM element being animated. If multiple elements are animated, it is important to note that the callback is executed once per matched element, not once for the animation as a whole.
            
     
            
       
            Note: This method may cause performance issues, especially when used on many elements. If you're encountering such issues, use performance testing tools to determine whether this method is causing them. Moreover, this method can cause problems with responsive layouts if the display value differs at different viewport sizes.
            
diff --git a/entries/html.xml b/entries/html.xml
index 7a4f2594..b830c566 100644
--- a/entries/html.xml
+++ b/entries/html.xml
@@ -118,7 +118,7 @@ $( "div.demo-container" ).html(function() {
 });

            Given a document with six paragraphs, this example will set the HTML of <div class="demo-container"> to <p>All new content for <em>6 paragraphs!</em></p>.

            -

            This method uses the browser's innerHTML property. Some browsers may not generate a DOM that exactly replicates the HTML source provided. For example, Internet Explorer prior to version 8 will convert all href properties on links to absolute URLs, and Internet Explorer prior to version 9 will not correctly handle HTML5 elements without the addition of a separate compatibility layer.

            +

            This method uses the browser's innerHTML property. Some browsers may not generate a DOM that exactly replicates the HTML source provided. For example, Internet Explorer prior to version 8 will convert all href properties on links to absolute URLs, and Internet Explorer prior to version 9 will not correctly handle HTML5 elements without the addition of a separate compatibility layer.

            To set the content of a <script> element, which does not contain HTML, use the .text() method and not .html().

            Note: In Internet Explorer up to and including version 9, setting the text content of an HTML element may corrupt the text nodes of its children that are being removed from the document as a result of the operation. If you are keeping references to these DOM elements and need them to be unchanged, use .empty().html( string ) instead of .html(string) so that the elements are removed from the document before the new string is assigned to the element.

            diff --git a/entries/id-selector.xml b/entries/id-selector.xml index 20aab992..3cc8b926 100644 --- a/entries/id-selector.xml +++ b/entries/id-selector.xml @@ -13,7 +13,7 @@

            For id selectors, jQuery uses the JavaScript function document.getElementById(), which is extremely efficient. When another selector is attached to the id selector, such as h2#pageTitle, jQuery performs an additional check before identifying the element as a match.

            Calling jQuery() (or $()) with an id selector as its argument will return a jQuery object containing a collection of either zero or one DOM element.

            Each id value must be used only once within a document. If more than one element has been assigned the same ID, queries that use that ID will only select the first matched element in the DOM. This behavior should not be relied on, however; a document with more than one element using the same ID is invalid.

            -

            If the id contains characters like periods or colons you have to escape those characters with backslashes.

            +

            If the id contains characters like periods or colons you have to escape those characters with backslashes.

            Select the element with the id "myDiv" and give it a red border. diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml index 8d92e0f8..80157d28 100644 --- a/entries/jQuery.ajax.xml +++ b/entries/jQuery.ajax.xml @@ -98,8 +98,8 @@ $.ajax({
          • "xml": Returns a XML document that can be processed via jQuery.
          • "html": Returns HTML as plain text; included script tags are evaluated when inserted in the DOM.
          • "script": Evaluates the response as JavaScript and returns it as plain text. Disables caching by appending a query string parameter, _=[TIMESTAMP], to the URL unless the cache option is set to true. Note: This will turn POSTs into GETs for remote-domain requests.
            • -
          • "json": Evaluates the response as JSON and returns a JavaScript object. Cross-domain "json" requests that have a callback placeholder, e.g. ?callback=?, are performed using JSONP unless the request includes jsonp: false in its request options. The JSON data is parsed in a strict manner; any malformed JSON is rejected and a parse error is thrown. As of jQuery 1.9, an empty response is also rejected; the server should return a response of null or {} instead. (See json.org for more information on proper JSON formatting.)
            • -
          • "jsonp": Loads in a JSON block using JSONP. Adds an extra "?callback=?" to the end of your URL to specify the callback. Disables caching by appending a query string parameter, "_=[TIMESTAMP]", to the URL unless the cache option is set to true.
            • +
          • "json": Evaluates the response as JSON and returns a JavaScript object. Cross-domain "json" requests that have a callback placeholder, e.g. ?callback=?, are performed using JSONP unless the request includes jsonp: false in its request options. The JSON data is parsed in a strict manner; any malformed JSON is rejected and a parse error is thrown. As of jQuery 1.9, an empty response is also rejected; the server should return a response of null or {} instead. (See json.org for more information on proper JSON formatting.)
            • +
          • "jsonp": Loads in a JSON block using JSONP. Adds an extra "?callback=?" to the end of your URL to specify the callback. Disables caching by appending a query string parameter, "_=[TIMESTAMP]", to the URL unless the cache option is set to true.
          • "text": A plain text string.
          • multiple, space-separated values: As of jQuery 1.5, jQuery can convert a dataType from what it received in the Content-Type header to what you require. For example, if you want a text response to be treated as XML, use "text xml" for the dataType. You can also make a JSONP request, have it received as text, and interpreted by jQuery as XML: "jsonp text xml". Similarly, a shorthand string such as "jsonp xml" will first attempt to convert from jsonp to xml, and, failing that, convert from jsonp to text, and then from text to xml.
            • @@ -217,7 +217,7 @@ $.ajax();

            As of jQuery 1.5.1, the jqXHR object also contains the overrideMimeType() method (it was available in jQuery 1.4.x, as well, but was temporarily removed in jQuery 1.5). The .overrideMimeType() method may be used in the beforeSend() callback function, for example, to modify the response content-type header:

            
 $.ajax({
-  url: "http://fiddle.jshell.net/favicon.png",
+  url: "https://fiddle.jshell.net/favicon.png",
   beforeSend: function( xhr ) {
     xhr.overrideMimeType( "text/plain; charset=x-user-defined" );
   }
@@ -326,11 +326,11 @@ jqxhr.always(function() {
     
            Different types of response to $.ajax() call are subjected to different kinds of pre-processing before being passed to the success handler. The type of pre-processing depends by default upon the Content-Type of the response, but can be set explicitly using the dataType option. If the dataType option is provided, the Content-Type header of the response will be disregarded.
            
     
            The available data types are text, html, xml, json, jsonp, and script.
            
     
            If text or html is specified, no pre-processing occurs. The data is simply passed on to the success handler, and made available through the responseText property of the jqXHR object.
            
-    
            If xml is specified, the response is parsed using jQuery.parseXML before being passed, as an XMLDocument, to the success handler. The XML document is made available through the responseXML property of the jqXHR object.
            
+    
            If xml is specified, the response is parsed using jQuery.parseXML before being passed, as an XMLDocument, to the success handler. The XML document is made available through the responseXML property of the jqXHR object.
            
     
            If json is specified, the response is parsed using jQuery.parseJSON before being passed, as an object, to the success handler. The parsed JSON object is made available through the responseJSON property of the jqXHR object.
            
     
            If script is specified, $.ajax() will execute the JavaScript that is received from the server before passing it on to the success handler as a string.
            
     
            If jsonp is specified, $.ajax() will automatically append a query string parameter of (by default) callback=? to the URL. The jsonp and jsonpCallback properties of the settings passed to $.ajax() can be used to specify, respectively, the name of the query string parameter and the name of the JSONP callback function. The server should return valid JavaScript that passes the JSON response into the callback function. $.ajax() will execute the returned JavaScript, calling the JSONP callback function, before passing the JSON object contained in the response to the $.ajax() success handler.
            
-    
            For more information on JSONP, see the original post detailing its use.
            
+    
            For more information on JSONP, see the original post detailing its use.
            
     
            Sending Data to the Server
            
     
            By default, Ajax requests are sent using the GET HTTP method. If the POST method is required, the method can be specified by setting a value for the type option. This option affects how the contents of the data option are sent to the server. POST data will always be transmitted to the server using UTF-8 charset, per the W3C XMLHTTPRequest standard.
            
     
            The data option can contain either a query string of the form key1=value1&key2=value2, or an object of the form {key1: 'value1', key2: 'value2'}. If the latter form is used, the data is converted into a query string using jQuery.param() before it is sent. This processing can be circumvented by setting processData to false.  The processing might be undesirable if you wish to send an XML object to the server; in this case, change the contentType option from application/x-www-form-urlencoded to a more appropriate MIME type.
            
diff --git a/entries/jQuery.ajaxPrefilter.xml b/entries/jQuery.ajaxPrefilter.xml
index f82d8d02..708ca829 100644
--- a/entries/jQuery.ajaxPrefilter.xml
+++ b/entries/jQuery.ajaxPrefilter.xml
@@ -40,11 +40,11 @@ $.ajaxPrefilter(function( options, originalOptions, jqXHR ) {
   }
 });
            -

            Prefilters can also be used to modify existing options. For example, the following proxies cross-domain requests through http://mydomain.net/proxy/:

            +

            Prefilters can also be used to modify existing options. For example, the following proxies cross-domain requests through https://mydomain.net/proxy/:

            
 $.ajaxPrefilter(function( options ) {
   if ( options.crossDomain ) {
-    options.url = "http://mydomain.net/proxy/" + encodeURIComponent( options.url );
+    options.url = "https://mydomain.net/proxy/" + encodeURIComponent( options.url );
     options.crossDomain = false;
   }
 });
diff --git a/entries/jQuery.boxModel.xml b/entries/jQuery.boxModel.xml
index f260538a..ac464850 100644
--- a/entries/jQuery.boxModel.xml
+++ b/entries/jQuery.boxModel.xml
@@ -4,7 +4,7 @@
   
     1.0
   
-  States if the current page, in the user's browser, is being rendered using the W3C CSS Box Model. This property was removed in jQuery 1.8. Please try to use feature detection instead.
+  States if the current page, in the user's browser, is being rendered using the W3C CSS Box Model. This property was removed in jQuery 1.8. Please try to use feature detection instead.
   
   
   
diff --git a/entries/jQuery.browser.xml b/entries/jQuery.browser.xml
index e7c690ac..667ed5f1 100644
--- a/entries/jQuery.browser.xml
+++ b/entries/jQuery.browser.xml
@@ -18,7 +18,7 @@
       
       
            This property is available immediately. It is therefore safe to use it to determine whether or not to call $(document).ready().
     The $.browser property is deprecated in jQuery 1.3, and its functionality may be moved to a team-supported plugin in a future release of jQuery.
            
-      
            Because $.browser uses navigator.userAgent to determine the platform, it is vulnerable to spoofing by the user or misrepresentation by the browser itself. It is always best to avoid browser-specific code entirely where possible. Instead of relying on $.browser it's better to use libraries like Modernizr.
            
+      
            Because $.browser uses navigator.userAgent to determine the platform, it is vulnerable to spoofing by the user or misrepresentation by the browser itself. It is always best to avoid browser-specific code entirely where possible. Instead of relying on $.browser it's better to use libraries like Modernizr.
            
                 
     
       Show the browser info.
diff --git a/entries/jQuery.extend.xml b/entries/jQuery.extend.xml
index 42edb4ae..b28ec2e0 100644
--- a/entries/jQuery.extend.xml
+++ b/entries/jQuery.extend.xml
@@ -38,7 +38,7 @@
     
            Warning: Passing false for the first argument is not supported.
            
     
            Undefined properties are not copied. However, properties inherited from the object's prototype will be copied over. Properties that are an object constructed via new MyCustomObject(args), or built-in JavaScript types such as Date or RegExp, are not re-constructed and will appear as plain Objects in the resulting object or array.
            
     
            On a deep extend, Object and Array are extended, but object wrappers on primitive types such as String, Boolean, and Number are not. Deep-extending a cyclical data structure will result in an error.
            
-    
            For needs that fall outside of this behavior, write a custom extend method instead, or use a library like lodash. 
            
+    
            For needs that fall outside of this behavior, write a custom extend method instead, or use a library like lodash. 
            
   
   
     Merge two objects, modifying the first.
diff --git a/entries/jQuery.fx.interval.xml b/entries/jQuery.fx.interval.xml
index 5516d75c..2dfd1719 100644
--- a/entries/jQuery.fx.interval.xml
+++ b/entries/jQuery.fx.interval.xml
@@ -6,7 +6,7 @@
     1.4.3
   
   
-    
            This property is deprecated as of version 3.0, and has no effect in browsers that support the requestAnimationFrame method.
            
+    
            This property is deprecated as of version 3.0, and has no effect in browsers that support the requestAnimationFrame method.
            
     
            On browsers that do not support requestAnimationFrame, this property can be changed to adjust the interval at which animations will run. The default is 13 milliseconds.
            
     
            Since jQuery uses one global interval, no animation should be running or all animations should stop for the change of this property to take effect.
            
               
diff --git a/entries/jQuery.getJSON.xml b/entries/jQuery.getJSON.xml
index b8a5ee49..11a26341 100644
--- a/entries/jQuery.getJSON.xml
+++ b/entries/jQuery.getJSON.xml
@@ -56,7 +56,7 @@ $.getJSON( "ajax/test.json", function( data ) {
     
            The success callback is passed the returned data, which is typically a JavaScript object or array as defined by the JSON structure and parsed using the $.parseJSON() method. It is also passed the text status of the response.
            
     
            As of jQuery 1.5, the success callback function receives a "jqXHR" object (in jQuery 1.4, it received the XMLHttpRequest object). However, since JSONP and cross-domain GET requests do not use XHR, in those cases the jqXHR and textStatus parameters passed to the success callback are undefined.
            
     
            
-      
            Important: As of jQuery 1.4, if the JSON file contains a syntax error, the request will usually fail silently. Avoid frequent hand-editing of JSON data for this reason. JSON is a data-interchange format with syntax rules that are stricter than those of JavaScript's object literal notation. For example, all strings represented in JSON, whether they are properties or values, must be enclosed in double-quotes. For details on the JSON format, see http://json.org/.
            
+      
            Important: As of jQuery 1.4, if the JSON file contains a syntax error, the request will usually fail silently. Avoid frequent hand-editing of JSON data for this reason. JSON is a data-interchange format with syntax rules that are stricter than those of JavaScript's object literal notation. For example, all strings represented in JSON, whether they are properties or values, must be enclosed in double-quotes. For details on the JSON format, see http://json.org/.
            
     
            
     
            JSONP
            
     
            If the URL includes the string "callback=?" (or similar, as defined by the server-side API), the request is treated as JSONP instead. See the discussion of the jsonp data type in $.ajax() for more details.
            
diff --git a/entries/jQuery.parseJSON.xml b/entries/jQuery.parseJSON.xml
index 054663df..d47eab4b 100644
--- a/entries/jQuery.parseJSON.xml
+++ b/entries/jQuery.parseJSON.xml
@@ -25,7 +25,7 @@
       
          • "NaN" (NaN cannot be represented in a JSON string; direct representation of Infinity is also not permitted).
            • 
     
     
            The JSON standard does not permit "control characters" such as a tab or newline. An example like $.parseJSON( '{ "testing":"1\t2\n3" }' ) will throw an error in most implementations because the JavaScript parser converts the string's tab and newline escapes into literal tab and newline; doubling the backslashes like "1\\t2\\n3" yields expected results. This problem is often seen when injecting JSON into a JavaScript file from a server-side language such as PHP.
            
-    
            Where the browser provides a native implementation of JSON.parse, jQuery uses it to parse the string. For details on the JSON format, see http://json.org/.
            
+    
            Where the browser provides a native implementation of JSON.parse, jQuery uses it to parse the string. For details on the JSON format, see http://json.org/.
            
     
            Prior to jQuery 1.9, $.parseJSON returned null instead of throwing an error if it was passed an empty string, null, or undefined, even though those are not valid JSON.
            
   
   
diff --git a/entries/jQuery.support.xml b/entries/jQuery.support.xml
index c44b2b42..636ec72e 100644
--- a/entries/jQuery.support.xml
+++ b/entries/jQuery.support.xml
@@ -4,7 +4,7 @@
   
     1.3
   
-  A collection of properties that represent the presence of different browser features or bugs. Intended for jQuery's internal use; specific properties may be removed when they are no longer needed internally to improve page startup performance. For your own project's feature-detection needs, we strongly recommend the use of an external library such as Modernizr instead of dependency on properties in jQuery.support.
+  A collection of properties that represent the presence of different browser features or bugs. Intended for jQuery's internal use; specific properties may be removed when they are no longer needed internally to improve page startup performance. For your own project's feature-detection needs, we strongly recommend the use of an external library such as Modernizr instead of dependency on properties in jQuery.support.
   
   
   
diff --git a/entries/jQuery.xml b/entries/jQuery.xml
index 80e5bf19..a0ff76d1 100644
--- a/entries/jQuery.xml
+++ b/entries/jQuery.xml
@@ -177,9 +177,9 @@ $( myForm.elements ).hide();
       
            By default, elements are created with an .ownerDocument matching the document into which the jQuery library was loaded. Elements being injected into a different document should be created using that document, e.g., $("<p>hello iframe</p>", $("#myiframe").prop("contentWindow").document).
            
       
            If the HTML is more complex than a single tag without attributes, as it is in the above example, the actual creation of the elements is handled by the browser's .innerHTML mechanism. In most cases, jQuery creates a new <div> element and sets the innerHTML property of the element to the HTML snippet that was passed in. When the parameter has a single tag (with optional closing tag or quick-closing) — $( "<img />" ) or $( "<img>" ), $( "<a></a>" ) or $( "<a>" ) — jQuery creates the element using the native JavaScript .createElement() function.
            
       
            When passing in complex HTML, some browsers may not generate a DOM that exactly replicates the HTML source provided. As mentioned, jQuery uses the browser's .innerHTML property to parse the passed HTML and insert it into the current document. During this process, some browsers filter out certain elements such as <html>, <title>, or <head> elements. As a result, the elements inserted may not be representative of the original string passed.
            
-      
            Filtering isn't, however, limited to these tags. For example, Internet Explorer prior to version 8 will also convert all href properties on links to absolute URLs, and Internet Explorer prior to version 9 will not correctly handle HTML5 elements without the addition of a separate compatibility layer.
            
+      
            Filtering isn't, however, limited to these tags. For example, Internet Explorer prior to version 8 will also convert all href properties on links to absolute URLs, and Internet Explorer prior to version 9 will not correctly handle HTML5 elements without the addition of a separate compatibility layer.
            
       
            To ensure cross-platform compatibility, the snippet must be well-formed. Tags that can contain other elements should be paired with a closing tag:
            
-      
            $( "<a href='http://jquery.com'></a>" );
            
+      
            $( "<a href='https://jquery.com'></a>" );
            
       
            Tags that cannot contain elements may be quick-closed or not:
            
       
            
 $( "<img>" );
diff --git a/entries/keypress.xml b/entries/keypress.xml
index 96b6b6c6..0fd28cf3 100644
--- a/entries/keypress.xml
+++ b/entries/keypress.xml
@@ -61,7 +61,7 @@ $( "#other" ).click(function() {
   
   
   
-    Show the event object when a key is pressed in the input. Note: This demo relies on a simple $.print() plugin (http://api.jquery.com/resources/events.js) for the event object's output.
+    Show the event object when a key is pressed in the input. Note: This demo relies on a simple $.print() plugin (https://api.jquery.com/resources/events.js) for the event object's output.
     
     
            The :lang() selector matches elements that have a language value equal to the supplied language code or that start with the supplied language code immediately followed by "-". For example, the selector $("div:lang(en)")will match <div lang="en"> and <div lang="en-us"> (and any of their descendant <div>s), but not <div lang="fr">
            
     
            For HTML elements, the language value is determined by the lang attribute and possibly information from  meta elements or HTTP headers.
            
-    
            Further discussion of this usage can be found in the W3C CSS specification.
            
+    
            Further discussion of this usage can be found in the W3C CSS specification.
            
   
   
     Color div elements according to their language.
diff --git a/entries/map.xml b/entries/map.xml
index 55a87d83..c151e831 100644
--- a/entries/map.xml
+++ b/entries/map.xml
@@ -69,7 +69,7 @@ $( "p" )
 
            
   
   
-  
+  
 
            
 ]]>
               
diff --git a/entries/nth-child-selector.xml b/entries/nth-child-selector.xml
index 40d46787..68da261d 100644
--- a/entries/nth-child-selector.xml
+++ b/entries/nth-child-selector.xml
@@ -12,7 +12,7 @@
   
     
            Because jQuery's implementation of :nth- selectors is strictly derived from the CSS specification, the value of n is "1-indexed", meaning that the counting starts at 1. For other selector expressions such as :eq() or :even jQuery follows JavaScript's "0-indexed" counting. Given a single <ul> containing two <li>s, $( "li:nth-child(1)" ) selects the first <li> while  $( "li:eq(1)" ) selects the second.
            
     
            The :nth-child(n) pseudo-class is easily confused with :eq(n), even though the two can result in dramatically different matched elements. With :nth-child(n), all children are counted, regardless of what they are, and the specified element is selected only if it matches the selector attached to the pseudo-class. With :eq(n) only the selector attached to the pseudo-class is counted, not limited to children of any other element, and the (n+1)th one (n is 0-based) is selected.
            
-    
            Further discussion of this unusual usage can be found in the W3C CSS specification.
            
+    
            Further discussion of this unusual usage can be found in the W3C CSS specification.
            
               
   
     Find the second li in each matched ul and note it.
diff --git a/entries/nth-last-child-selector.xml b/entries/nth-last-child-selector.xml
index ce21de1f..9d63636a 100644
--- a/entries/nth-last-child-selector.xml
+++ b/entries/nth-last-child-selector.xml
@@ -11,7 +11,7 @@
   Selects all elements that are the nth-child of their parent, counting from the last element to the first.
   
     
            Because jQuery's implementation of :nth- selectors is strictly derived from the CSS specification, the value of n is "1-indexed", meaning that the counting starts at 1. For other selector expressions such as :eq() or :even jQuery follows JavaScript's "0-indexed" counting. Given a single <ul> containing three <li>s, $( "li:nth-last-child(1)" ) selects the third, last, <li>.
            
-    
            Further discussion of this usage can be found in the W3C CSS specification.
            
+    
            Further discussion of this usage can be found in the W3C CSS specification.
            
               
   
     Find the second to last li in each matched ul and note it.
diff --git a/entries/nth-last-of-type-selector.xml b/entries/nth-last-of-type-selector.xml
index eb96db43..602d430a 100644
--- a/entries/nth-last-of-type-selector.xml
+++ b/entries/nth-last-of-type-selector.xml
@@ -11,7 +11,7 @@
   Selects all the elements that are the nth-child of their parent in relation to siblings with the same element name, counting from the last element to the first.
   
     
            Because jQuery's implementation of :nth- selectors is strictly derived from the CSS specification, the value of n is "1-indexed", meaning that the counting starts at 1. For other selector expressions such as :eq() or :even jQuery follows JavaScript's "0-indexed" counting. Given a single <ul> containing three <li>s, $('li:nth-last-of-type(1)') selects the third, last, <li>.
            
-    
            Further discussion of this usage can be found in the W3C CSS specification.
            
+    
            Further discussion of this usage can be found in the W3C CSS specification.
            
               
   
     Find the second to last li in each matched ul and note it.
diff --git a/entries/nth-of-type-selector.xml b/entries/nth-of-type-selector.xml
index 839cb8f0..89e6d452 100644
--- a/entries/nth-of-type-selector.xml
+++ b/entries/nth-of-type-selector.xml
@@ -11,7 +11,7 @@
   Selects all elements that are the nth child of their parent in relation to siblings with the same element name.
   
     
            Because jQuery's implementation of :nth- selectors is strictly derived from the CSS specification, the value of n is "1-indexed", meaning that the counting starts at 1. For other selector expressions such as :eq() or :even jQuery follows JavaScript's "0-indexed" counting. 
            
-    
            Further discussion of this usage can be found in the W3C CSS specification.
            
+    
            Further discussion of this usage can be found in the W3C CSS specification.
            
               
     
       Find each span that is second in relation to its sibling spans.
diff --git a/entries/on.xml b/entries/on.xml
index 18a17cae..622fff6a 100644
--- a/entries/on.xml
+++ b/entries/on.xml
@@ -66,7 +66,7 @@ $( "button" ).on( "click", notify );
     
            
     
            When the browser triggers an event or other JavaScript calls jQuery's .trigger() method, jQuery passes the handler an Event object it can use to analyze and change the status of the event. This object is a normalized subset of data provided by the browser; the browser's unmodified native event object is available in event.originalEvent. For example, event.type contains the event name (e.g., "resize") and event.target indicates the deepest (innermost) element where the event occurred.
            
     
            By default, most events bubble up from the original event target to the document element. At each element along the way, jQuery calls any matching event handlers that have been attached. A handler can prevent the event from bubbling further up the document tree (and thus prevent handlers on those elements from running) by calling event.stopPropagation(). Any other handlers attached on the current element will run however. To prevent that, call event.stopImmediatePropagation(). (Event handlers bound to an element are called in the same order that they were bound.)
            
-    
            Similarly, a handler can call event.preventDefault() to cancel any default action that the browser may have for this event; for example, the default action on a click event is to follow the link. Not all browser events have default actions, and not all default actions can be canceled. See the W3C Events Specification for details.
            
+    
            Similarly, a handler can call event.preventDefault() to cancel any default action that the browser may have for this event; for example, the default action on a click event is to follow the link. Not all browser events have default actions, and not all default actions can be canceled. See the W3C Events Specification for details.
            
     
            Returning false from an event handler will automatically call event.stopPropagation() and event.preventDefault(). A false value can also be passed for the handler as a shorthand for function(){ return false; }. So, $( "a.disabled" ).on( "click", false ); attaches an event handler to all links with class "disabled" that prevents them from being followed when they are clicked and also stops the event from bubbling. 
            
     
            When jQuery calls a handler, the this keyword is a reference to the element where the event is being delivered; for directly bound events this is the element where the event was attached and for delegated events this is an element matching selector. (Note that this may not be equal to event.target if the event has bubbled from a descendant element.) To create a jQuery object from the element so that it can be used with jQuery methods, use $( this ).
            
     
            Passing data to the handler
            
@@ -96,7 +96,7 @@ $( "button" ).on( "click", {
     
            The focus and blur events are specified by the W3C to not bubble, but jQuery defines cross-browser focusin and focusout events that do bubble. When focus and blur are used to attach delegated event handlers, jQuery maps the names and delivers them as focusin and focusout respectively. For consistency and clarity, use the bubbling event type names.
            
     
            In all browsers, the load, scroll, and error events (e.g., on an <img> element) do not bubble. In Internet Explorer 8 and lower, the paste and reset events do not bubble. Such events are not supported for use with delegation, but they can be used when the event handler is directly attached to the element generating the event.
            
     
            The error event on the window object uses nonstandard arguments and return value conventions, so it is not supported by jQuery. Instead, assign a handler function directly to the window.onerror property.
            
-    
            The handler list for an element is set when the event is first delivered. Adding or removing event handlers on the current element won't take effect until the next time the event is handled. To prevent any further event handlers from executing on an element within an event handler, call event.stopImmediatePropagation(). This behavior goes against the W3C events specification. To better understand this case, consider the following code:
            
+    
            The handler list for an element is set when the event is first delivered. Adding or removing event handlers on the current element won't take effect until the next time the event is handled. To prevent any further event handlers from executing on an element within an event handler, call event.stopImmediatePropagation(). This behavior goes against the W3C events specification. To better understand this case, consider the following code:
            
     
            var $test = $( "#test" );
 
 function handler1() {
diff --git a/entries/parent-selector.xml b/entries/parent-selector.xml
index 424cd36e..72832a23 100644
--- a/entries/parent-selector.xml
+++ b/entries/parent-selector.xml
@@ -9,7 +9,7 @@
   
     
            This is the inverse of :empty. 
            
     
            One important thing to note regarding the use of :parent (and :empty) is that child nodes include text nodes.
            
-    
            The W3C recommends that the <p> element have at least one child node, even if that child is merely text (see http://www.w3.org/TR/html401/struct/text.html#edef-P). Some other elements, on the other hand, are empty (i.e. have no children) by definition: <input>, <img>, <br>, and <hr>, for example.
            
+    
            The W3C recommends that the <p> element have at least one child node, even if that child is merely text (see http://www.w3.org/TR/html401/struct/text.html#edef-P). Some other elements, on the other hand, are empty (i.e. have no children) by definition: <input>, <img>, <br>, and <hr>, for example.
            
     
            To obtain the parents or ancestors of an existing jQuery set, see the .parent() and .parents() methods.
            
               
   
diff --git a/entries/prop.xml b/entries/prop.xml
index 419c3cc2..49ccceda 100644
--- a/entries/prop.xml
+++ b/entries/prop.xml
@@ -62,7 +62,7 @@
         
       
       
            
-      
            According to the W3C forms specification, the checked attribute is a boolean attribute, which means the corresponding property is true if the attribute is present at all—even if, for example, the attribute has no value or is set to empty string value or even "false". This is true of all boolean attributes.
            
+      
            According to the W3C forms specification, the checked attribute is a boolean attribute, which means the corresponding property is true if the attribute is present at all—even if, for example, the attribute has no value or is set to empty string value or even "false". This is true of all boolean attributes.
            
       
            Nevertheless, the most important concept to remember about the checked attribute is that it does not correspond to the checked property. The attribute actually corresponds to the defaultChecked property and should be used only to set the initial value of the checkbox. The checked attribute value does not change with the state of the checkbox, while the checked property does. Therefore, the cross-browser-compatible way to determine if a checkbox is checked is to use the property:
            
       
              
         
            • 
diff --git a/entries/ready.xml b/entries/ready.xml
index 9f14ae52..20cdafa6 100644
--- a/entries/ready.xml
+++ b/entries/ready.xml
@@ -11,7 +11,7 @@
   
     
              The .ready() method offers a way to run JavaScript code as soon as the page's Document Object Model (DOM) becomes safe to manipulate. This will often be a good time to perform tasks that are needed before the user views or interacts with the page, for example to add event handlers and initialize plugins. When multiple functions are added via successive calls to this method, they run when the DOM is ready in the order in which they are added. As of jQuery 3.0, jQuery ensures that an exception occuring in one handler does not prevent subsequently added handlers from executing.
              
 
-    
              Most browsers provide similar functionality in the form of a DOMContentLoaded event. However, jQuery's .ready() method differs in an important and useful way: If the DOM becomes ready and the browser fires DOMContentLoaded before the code calls .ready( handler ), the function handler will still be executed. In contrast, a DOMContentLoaded event listener added after the event fires is never executed.
              
+    
              Most browsers provide similar functionality in the form of a DOMContentLoaded event. However, jQuery's .ready() method differs in an important and useful way: If the DOM becomes ready and the browser fires DOMContentLoaded before the code calls .ready( handler ), the function handler will still be executed. In contrast, a DOMContentLoaded event listener added after the event fires is never executed.
              
 
     
              Browsers also provide the load event on the window object. When this event fires it indicates that all assets on the page have loaded, including images. This event can be watched in jQuery using $( window ).on( "load", handler ). In cases where code relies on loaded assets (for example, if the dimensions of an image are required), the code should be placed in a handler for the load event instead.
              
     
diff --git a/entries/serialize.xml b/entries/serialize.xml
index c5c99ccb..55dd099f 100644
--- a/entries/serialize.xml
+++ b/entries/serialize.xml
@@ -15,7 +15,7 @@ $( "form" ).on( "submit", function( event ) {
 });
     
            
     
            In this case, jQuery serializes the successful controls within the form. Only form elements are examined for inputs they contain, in all other cases the input elements to be serialized should be part of the set passed to the .serialize() method. Selecting both the form and its children in a set will cause duplicates in the serialized string.
            
-    
            Note: Only "successful controls" are serialized to the string. No submit button value is serialized since the form was not submitted using a button. For a form element's value to be included in the serialized string, the element must have a name attribute. Values from checkboxes and radio buttons (inputs of type "radio" or "checkbox") are included only if they are checked. Data from file select elements is not serialized.
            
+    
            Note: Only "successful controls" are serialized to the string. No submit button value is serialized since the form was not submitted using a button. For a form element's value to be included in the serialized string, the element must have a name attribute. Values from checkboxes and radio buttons (inputs of type "radio" or "checkbox") are included only if they are checked. Data from file select elements is not serialized.
            
   
   
     Serialize a form to a query string that could be sent to a server in an Ajax request.
diff --git a/entries/serializeArray.xml b/entries/serializeArray.xml
index 4a836265..b2df233e 100644
--- a/entries/serializeArray.xml
+++ b/entries/serializeArray.xml
@@ -28,7 +28,7 @@
   </div>
 </form>
            -

            The .serializeArray() method uses the standard W3C rules for successful controls to determine which elements it should include; in particular the element cannot be disabled and must contain a name attribute. No submit button value is serialized since the form was not submitted using a button. Data from file select elements is not serialized. Elements that do not contain a value attribute are represented with the empty string value.

            +

            The .serializeArray() method uses the standard W3C rules for successful controls to determine which elements it should include; in particular the element cannot be disabled and must contain a name attribute. No submit button value is serialized since the form was not submitted using a button. Data from file select elements is not serialized. Elements that do not contain a value attribute are represented with the empty string value.

            This method can act on a jQuery object that has selected individual form controls, such as <input>, <textarea>, and <select>. However, it is typically easier to select the <form> element itself for serialization:

            
 $( "form" ).submit(function( event ) {
diff --git a/entries/show.xml b/entries/show.xml
index 535b9c5d..c47faccc 100644
--- a/entries/show.xml
+++ b/entries/show.xml
@@ -37,7 +37,7 @@ $( ".target" ).show();
     It is recommended to use different classes with .addClass(), .removeClass() or .toggleClass(). Another approach is using .attr( "style", "display: block !important;" ); be careful, though, as it overwrites the style attribute of the element.
            
     
            When a duration, a plain object, or a "complete" function is provided, .show() becomes an animation method. The .show() method animates the width, height, and opacity of the matched elements simultaneously.
            
     
            Durations are given in milliseconds; higher values indicate slower animations, not faster ones. The strings 'fast' and 'slow' can be supplied to indicate durations of 200 and 600 milliseconds, respectively.
            
-    
            As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
            
+    
            As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
            
     
            If supplied, the callback is fired once the animation is complete. This can be useful for stringing different animations together in sequence. The callback is not sent any arguments, but this is set to the DOM element being animated. If multiple elements are animated, it is important to note that the callback is executed once per matched element, not once for the animation as a whole.
            
     
            
       
            Note: This method may cause performance issues, especially when used on many elements. If you're encountering such issues, use performance testing tools to determine whether this method is causing them. Moreover, this method can cause problems with responsive layouts if the display value differs at different viewport sizes.
            
diff --git a/entries/slideDown.xml b/entries/slideDown.xml
index 7ca77825..d4f27544 100644
--- a/entries/slideDown.xml
+++ b/entries/slideDown.xml
@@ -44,7 +44,7 @@ $( "#clickme" ).click(function() {
       
            Figure 1 - Illustration of the slideDown() effect
            
     
     
            Easing
            
-    
            As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
            
+    
            As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
            
     
            Callback Function
            
     
            If supplied, the callback is fired once the animation is complete. This can be useful for stringing different animations together in sequence. The callback is not sent any arguments, but this is set to the DOM element being animated. If multiple elements are animated, it is important to note that the callback is executed once per matched element, not once for the animation as a whole.
            
     
            As of jQuery 1.6, the .promise() method can be used in conjunction with the deferred.done() method to execute a single callback for the animation as a whole when all matching elements have completed their animations ( See the example for .promise() ).  
            
diff --git a/entries/slideToggle.xml b/entries/slideToggle.xml
index 12b97ad1..ecf801a6 100644
--- a/entries/slideToggle.xml
+++ b/entries/slideToggle.xml
@@ -53,7 +53,7 @@ $( "#clickme" ).click(function() {
       
            Figure 2 - Illustration of the slideToggle() effect when showing the image
            
     
     
            Easing
            
-    
            As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
            
+    
            As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
            
     
            Callback Function
            
     
            If supplied, the callback is fired once the animation is complete. This can be useful for stringing different animations together in sequence. The callback is not sent any arguments, but this is set to the DOM element being animated. If multiple elements are animated, it is important to note that the callback is executed once per matched element, not once for the animation as a whole.
            
     
            As of jQuery 1.6, the .promise() method can be used in conjunction with the deferred.done() method to execute a single callback for the animation as a whole when all matching elements have completed their animations ( See the example for .promise() ).  
            
diff --git a/entries/slideUp.xml b/entries/slideUp.xml
index 8db63468..648665c9 100644
--- a/entries/slideUp.xml
+++ b/entries/slideUp.xml
@@ -44,7 +44,7 @@ $( "#clickme" ).click(function() {
       
            Figure 1 - Illustration of the slideUp() effect
            
     
     
            Easing
            
-    
            As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
            
+    
            As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
            
     
            Callback Function
            
     
            If supplied, the callback is fired once the animation is complete. This can be useful for stringing different animations together in sequence. The callback is not sent any arguments, but this is set to the DOM element being animated. If multiple elements are animated, it is important to note that the callback is executed once per matched element, not once for the animation as a whole.
            
     
            As of jQuery 1.6, the .promise() method can be used in conjunction with the deferred.done() method to execute a single callback for the animation as a whole when all matching elements have completed their animations ( See the example for .promise() ).  
            
diff --git a/entries/target-selector.xml b/entries/target-selector.xml
index 5d60f3da..b010a5ce 100644
--- a/entries/target-selector.xml
+++ b/entries/target-selector.xml
@@ -7,8 +7,8 @@
   
   Selects the target element indicated by the fragment identifier of the document's URI.
   
-    
            If the document's URI contains a fragment identifier, or hash, then the :target selector will match the element with an ID that matches the identifier. For example, given a document with a URI of http://example.com/#foo, $( "p:target" ) will select the <p id="foo"> element.
            
-    
            Further discussion of this usage can be found in the W3C CSS specification.
            
+    
            If the document's URI contains a fragment identifier, or hash, then the :target selector will match the element with an ID that matches the identifier. For example, given a document with a URI of https://example.com/#foo, $( "p:target" ) will select the <p id="foo"> element.
            
+    
            Further discussion of this usage can be found in the W3C CSS specification.
            
               
   
   
diff --git a/entries/toggle.xml b/entries/toggle.xml
index 6c290220..deb0224d 100644
--- a/entries/toggle.xml
+++ b/entries/toggle.xml
@@ -40,7 +40,7 @@ $( ".target" ).toggle();
     
            The matched elements will be revealed or hidden immediately, with no animation, by changing the CSS display property. If the element is initially displayed, it will be hidden; if hidden, it will be shown. The display property is saved and restored as needed. If an element has a display value of inline, then is hidden and shown, it will once again be displayed inline.
            
     
            When a duration, a plain object, or a single "complete" function is provided, .toggle() becomes an animation method. The .toggle() method animates the width, height, and opacity of the matched elements simultaneously. When these properties reach 0 after a hiding animation, the display style property is set to none to ensure that the element no longer affects the layout of the page.
            
     
            Durations are given in milliseconds; higher values indicate slower animations, not faster ones. The strings 'fast' and 'slow' can be supplied to indicate durations of 200 and 600 milliseconds, respectively.
            
-    
            As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
            
+    
            As of jQuery 1.4.3, an optional string naming an easing function may be used. Easing functions specify the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.
            
     
            If supplied, the callback is fired once the animation is complete. This can be useful for stringing different animations together in sequence. The callback is not sent any arguments, but this is set to the DOM element being animated. If multiple elements are animated, it is important to note that the callback is executed once per matched element, not once for the animation as a whole.
            
     
            We can animate any element, such as a simple image:
            
     
            
diff --git a/entries/visible-selector.xml b/entries/visible-selector.xml
index 6b159740..45c5b973 100644
--- a/entries/visible-selector.xml
+++ b/entries/visible-selector.xml
@@ -13,7 +13,7 @@
     
            This selector is the opposite of the :hidden selector. So, every element selected by :visible isn't selected by :hidden and vice versa.
            
     
            All option elements are considered hidden, regardless of their selected state.
            
     
            During animations that hide an element, the element is considered visible until the end of the animation. During animations to show an element, the element is considered visible at the start at the animation.
            
-    
            How :visible is calculated was changed in jQuery 1.3.2. The release notes outline the changes in more detail.
            
+    
            How :visible is calculated was changed in jQuery 1.3.2. The release notes outline the changes in more detail.
            
     
            jQuery 3 slightly modifies the meaning of :visible (and therefore of :hidden). Starting with this version, elements will be considered :visible if they have any layout boxes, including those of zero width and/or height. For example, br elements and inline elements with no content will be selected by the :visible selector.
            
   
   
diff --git a/notes.xsl b/notes.xsl
index 50f94fc0..cfaf9bfb 100644
--- a/notes.xsl
+++ b/notes.xsl
@@ -17,7 +17,7 @@
 			Selected elements are in the order of their appearance in the document.
 		
 		
-			Forms and their child elements should not use input names or ids that conflict with properties of a form, such as submit, length, or method. Name conflicts can cause confusing failures. For a complete list of rules and to check your markup for these problems, see DOMLint.
+			Forms and their child elements should not use input names or ids that conflict with properties of a form, such as submit, length, or method. Name conflicts can cause confusing failures. For a complete list of rules and to check your markup for these problems, see DOMLint.
 		
 		
 			The value reported by  is not guaranteed to be accurate when the element or its parent is hidden. To get an accurate value, ensure the element is visible before using . jQuery will attempt to temporarily show and then re-hide an element in order to measure its dimensions, but this is unreliable and (even when accurate) can significantly impact page performance. This show-and-rehide measurement feature may be removed in a future version of jQuery.
@@ -44,7 +44,7 @@
 			The  method removes all data and event handlers associated with the removed nodes.
 		
 		
-			Due to browser security restrictions, most "Ajax" requests are subject to the same origin policy; the request can not successfully retrieve data from a different domain, subdomain, port, or protocol.
+			Due to browser security restrictions, most "Ajax" requests are subject to the same origin policy; the request can not successfully retrieve data from a different domain, subdomain, port, or protocol.
 		
 		
 			Script and JSONP requests are not subject to the same origin policy restrictions.
diff --git a/pages/Types.html b/pages/Types.html
index b31c47ee..612caa10 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -11,7 +11,7 @@
 
 
            This page documents data types appearing in jQuery function signatures, whether defined by JavaScript itself or further restricted by jQuery. Unless explicitly stated otherwise, jQuery functions require primitive values where applicable, and do not accept their Object-wrapped forms. If you want to study these concepts in depth, take a look at MDN.
 
            
-
            You should be able to try out most of the examples below by just copying them to your browser's JavaScript Console (Chrome, Safari with Develop menu activated, IE 8+) or Firebug console (Firefox).
+
            You should be able to try out most of the examples below by just copying them to your browser's JavaScript Console.
 
            
 
            Whenever an example mentions that a type defaults to a boolean value, the result is good to know when using that type in a boolean context:
 
            
@@ -645,16 +645,11 @@ 
             jQuery 
            
 
             XMLHttpRequest 
            
 
            Some of jQuery's Ajax functions return the native XMLHttpRequest (XHR) object, or pass it as an argument to success/error/complete handlers, so that you can do additional processing or monitoring on the request. Note that Ajax functions only return or pass an XHR object when an XHR object is actually used in the request. For example, JSONP requests and cross-domain GET requests use a script element rather than an XHR object.
 
            
-
            Although the XHR object is a standard, there are variations in its behavior on different browsers. Refer to the WHATWG site and browsers' documentation for more information:
+
            Although the XHR object is a standard, there are variations in its behavior on different browsers. Refer to the WHATWG site and Mozilla Developer Network for more information:
 
            
 
-
            Google does not appear to have an official page for their XHR documentation for Chrome. As of version 5, Chrome does not support the use of the file protocol for XHR requests.
-
            
 
             jqXHR 
            
 
            As of jQuery 1.5, the $.ajax() method returns the jqXHR object, which is a superset of the XMLHTTPRequest object. For more information, see the jqXHR section of the $.ajax entry
 
            

From fb25247da95dc147faa36800143e0d8cd2092dfb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Fri, 30 Mar 2018 16:42:11 +0200
Subject: [PATCH 532/699] 1.12.30

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 3fb8caf1..c473dadc 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "1.12.29",
+  "version": "1.12.30",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index fcf103c2..cf6a5be8 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.29",
+  "version": "1.12.30",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From d2d71d72d85ac117d5f0927204290bbdca9f321d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Fri, 30 Mar 2018 16:47:37 +0200
Subject: [PATCH 533/699] Misc: Convert a few remaining HTTP links to HTTPS

---
 entries/attr.xml | 2 +-
 entries/data.xml | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/entries/attr.xml b/entries/attr.xml
index 1628ec72..2dc8a25e 100644
--- a/entries/attr.xml
+++ b/entries/attr.xml
@@ -69,7 +69,7 @@
         
       
       
            
-      
            According to the W3C forms specification, the checked attribute is a boolean attribute, which means the corresponding property is true if the attribute is present at all—even if, for example, the attribute has no value or is set to empty string value or even "false". This is true of all boolean attributes.
            
+      
            According to the W3C forms specification, the checked attribute is a boolean attribute, which means the corresponding property is true if the attribute is present at all—even if, for example, the attribute has no value or is set to empty string value or even "false". This is true of all boolean attributes.
            
       
            Nevertheless, the most important concept to remember about the checked attribute is that it does not correspond to the checked property. The attribute actually corresponds to the defaultChecked property and should be used only to set the initial value of the checkbox. The checked attribute value does not change with the state of the checkbox, while the checked property does. Therefore, the cross-browser-compatible way to determine if a checkbox is checked is to use the property:
            
       
              
         
            • 
diff --git a/entries/data.xml b/entries/data.xml
index 71c6c10f..a8ff396c 100644
--- a/entries/data.xml
+++ b/entries/data.xml
@@ -31,7 +31,7 @@ $( "body" ).data(); // { foo: 52, bar: { myType: "test", count: 40 }, baz: [ 1,
       
            
       
            In jQuery 1.4.3 setting an element's data object with .data(obj) extends the data previously stored with that element.
            
       
            Prior to jQuery 1.4.3 (starting in jQuery 1.4) the .data() method completely replaced all data, instead of just extending the data object. If you are using third-party plugins it may not be advisable to completely replace the element's data object, since plugins may have also set data.
            
-      
            jQuery 3 changes the behavior of this method to align it to the Dataset API specifications. Specifically, jQuery 3 transforms every two-character sequence of "-" (U+002D) followed by a lowercase ASCII letter by the uppercase version of the letter as per definition of the algorithm of the Dataset API. Writing a statement like $( "body" ).data( { "my-name": "aValue" } ).data(); will return { myName: "aValue" }.
            
+      
            jQuery 3 changes the behavior of this method to align it to the Dataset API specifications. Specifically, jQuery 3 transforms every two-character sequence of "-" (U+002D) followed by a lowercase ASCII letter by the uppercase version of the letter as per definition of the algorithm of the Dataset API. Writing a statement like $( "body" ).data( { "my-name": "aValue" } ).data(); will return { myName: "aValue" }.
            
       
            Due to the way browsers interact with plugins and external code, the .data() method cannot be used on <object> (unless it's a Flash plugin), <applet> or <embed> elements.
            
     
     
@@ -89,11 +89,11 @@ alert( $( "body" ).data( "foo" ) ); // undefined
 $( "body" ).data( "bar", "foobar" );
 alert( $( "body" ).data( "bar" ) ); // foobar
            -

            jQuery 3 changes the behavior of this method to align it to the Dataset API specifications. Specifically, jQuery 3 transforms every two-character sequence of "-" (U+002D) followed by a lowercase ASCII letter by the uppercase version of the letter as per definition of the algorithm of the Dataset API. Writing a statement like $( "body" ).data( { "my-name": "aValue" } ).data(); will return { myName: "aValue" }.

            +

            jQuery 3 changes the behavior of this method to align it to the Dataset API specifications. Specifically, jQuery 3 transforms every two-character sequence of "-" (U+002D) followed by a lowercase ASCII letter by the uppercase version of the letter as per definition of the algorithm of the Dataset API. Writing a statement like $( "body" ).data( { "my-name": "aValue" } ).data(); will return { myName: "aValue" }.

            HTML5 data-* Attributes

            -

            As of jQuery 1.4.3 HTML 5 data- attributes will be automatically pulled in to jQuery's data object. The treatment of attributes with embedded dashes was changed in jQuery 1.6 to conform to the W3C HTML5 specification.

            +

            As of jQuery 1.4.3 HTML 5 data- attributes will be automatically pulled in to jQuery's data object. The treatment of attributes with embedded dashes was changed in jQuery 1.6 to conform to the W3C HTML5 specification.

            For example, given the following HTML:

            <div data-role="page" data-last-value="43" data-hidden="true" data-options='{"name":"John"}'></div>

            All of the following jQuery code will work.

            From 385c4db76d613a6409c7e0aa69a65c821d0c2ca3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?= Date: Fri, 30 Mar 2018 16:55:44 +0200 Subject: [PATCH 534/699] 1.12.31 --- package-lock.json | 2 +- package.json | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/package-lock.json b/package-lock.json index c473dadc..fb070fc4 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,6 +1,6 @@ { "name": "api.jquery.com", - "version": "1.12.30", + "version": "1.12.31", "lockfileVersion": 1, "requires": true, "dependencies": { diff --git a/package.json b/package.json index cf6a5be8..4bfeeb70 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "api.jquery.com", "title": "jQuery API Docs", "description": "API reference documentation for the jQuery JavaScript Library.", - "version": "1.12.30", + "version": "1.12.31", "homepage": "https://github.com/jquery/api.jquery.com", "author": { "name": "jQuery Foundation and other contributors" From bcdb151494299fa840db8b7bb7721985684c26e3 Mon Sep 17 00:00:00 2001 From: Dave Methvin Date: Tue, 24 Apr 2018 05:03:23 -0400 Subject: [PATCH 535/699] Event: Clarify valid chars for events and namespaces Fixes #1086 Fixes #1085 Closes #1093 --- entries/on.xml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/entries/on.xml b/entries/on.xml index 622fff6a..735f82b4 100644 --- a/entries/on.xml +++ b/entries/on.xml @@ -35,14 +35,14 @@

            The .on() method attaches event handlers to the currently selected set of elements in the jQuery object. As of jQuery 1.7, the .on() method provides all functionality required for attaching event handlers. For help in converting from older jQuery event methods, see .bind(), .delegate(), and .live(). To remove events bound with .on(), see .off(). To attach an event that runs only once and then removes itself, see .one()

            Event names and namespaces

            Any event names can be used for the events argument. jQuery will pass through the browser's standard JavaScript event types, calling the handler function when the browser generates events due to user actions such as click. In addition, the .trigger() method can trigger both standard browser event names and custom event names to call attached handlers. Event names should only contain alphanumerics, underscore, and colon characters.

            -

            An event name can be qualified by event namespaces that simplify removing or triggering the event. For example, "click.myPlugin.simple" defines both the myPlugin and simple namespaces for this particular click event. A click event handler attached via that string could be removed with .off("click.myPlugin") or .off("click.simple") without disturbing other click handlers attached to the elements. Namespaces are similar to CSS classes in that they are not hierarchical; only one name needs to match. Namespaces beginning with an underscore are reserved for jQuery's use.

            +

            An event name can be qualified by event namespaces that simplify removing or triggering the event. For example, "click.myPlugin.simple" defines both the myPlugin and simple namespaces for this particular click event. A click event handler attached via that string could be removed with .off("click.myPlugin") or .off("click.simple") without disturbing other click handlers attached to the elements. Namespaces are similar to CSS classes in that they are not hierarchical; only one name needs to match. Namespaces should contain upper/lowercase letters and digits only.

            In the second form of .on(), the events argument is a plain object. The keys are strings in the same form as the events argument with space-separated event type names and optional namespaces. The value for each key is a function (or false value) that is used as the handler instead of the final argument to the method. In other respects, the two forms are identical in their behavior as described below.

            -

            Direct and delegated events

            +

            Direct and delegated event handlers

            The majority of browser events bubble, or propagate, from the deepest, innermost element (the event target) in the document where they occur all the way up to the body and the document element. In Internet Explorer 8 and lower, a few events such as change and submit do not natively bubble but jQuery patches these to bubble and create consistent cross-browser behavior.

            If selector is omitted or is null, the event handler is referred to as direct or directly-bound. The handler is called every time an event occurs on the selected elements, whether it occurs directly on the element or bubbles from a descendant (inner) element.

            When a selector is provided, the event handler is referred to as delegated. The handler is not called when the event occurs directly on the bound element, but only for descendants (inner elements) that match the selector. jQuery bubbles the event from the event target up to the element where the handler is attached (i.e., innermost to outermost element) and runs the handler for any elements along that path matching the selector.

            Event handlers are bound only to the currently selected elements; they must exist at the time your code makes the call to .on(). To ensure the elements are present and can be selected, place scripts after the elements in the HTML markup or perform event binding inside a document ready handler. Alternatively, use delegated events to attach event handlers.

            -

            Delegated events have the advantage that they can process events from descendant elements that are added to the document at a later time. By picking an element that is guaranteed to be present at the time the delegated event handler is attached, you can use delegated events to avoid the need to frequently attach and remove event handlers. This element could be the container element of a view in a Model-View-Controller design, for example, or document if the event handler wants to monitor all bubbling events in the document. The document element is available in the head of the document before loading any other HTML, so it is safe to attach events there without waiting for the document to be ready.

            +

            Delegated event handlers have the advantage that they can process events from descendant elements that are added to the document at a later time. By picking an element that is guaranteed to be present at the time the delegated event handler is attached, you can use delegated events to avoid the need to frequently attach and remove event handlers. This element could be the container element of a view in a Model-View-Controller design, for example, or document if the event handler wants to monitor all bubbling events in the document. The document element is available in the head of the document before loading any other HTML, so it is safe to attach events there without waiting for the document to be ready.

            In addition to their ability to handle events on descendant elements not yet created, another advantage of delegated events is their potential for much lower overhead when many elements must be monitored. On a data table with 1,000 rows in its tbody, this example attaches a handler to 1,000 elements:

            
 $( "#dataTable tbody tr" ).on( "click", function() {
@@ -55,7 +55,7 @@ $( "#dataTable tbody" ).on( "click", "tr", function() {
   console.log( $( this ).text() );
 });
            -

            Note: Delegated events do not work for SVG.

            +

            Note: Delegated event handlers do not work for SVG.

            The event handler and its environment

            The handler argument is a function (or the value false, see below), and is required unless you pass an object for the events argument. You can provide an anonymous handler function at the point of the .on() call, as the examples have done above, or declare a named function and pass its name:

            

From 07fab9b17cb8727bee1d60e5d2b122ee75f3a538 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Wed, 13 Jun 2018 14:29:59 +0200
Subject: [PATCH 536/699] Misc: Convert a few more remaining links to HTTPS

---
 README.md                    | 2 +-
 categories.xml               | 2 +-
 entries/contents.xml         | 2 +-
 entries/jQuery.getJSON.xml   | 2 +-
 entries/jQuery.parseJSON.xml | 2 +-
 entries/parent-selector.xml  | 2 +-
 pages/Types.html             | 2 +-
 7 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 1141cd22..f7920803 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 
 ## Building and Deploying
 
-To build and deploy your changes for previewing in a [`jquery-wp-content`](https://github.com/jquery/jquery-wp-content) instance, follow the [workflow instructions](https://contribute.jquery.org/web-sites/#workflow) from our documentation on [contributing to jQuery Foundation web sites](http://contribute.jquery.org/web-sites/).
+To build and deploy your changes for previewing in a [`jquery-wp-content`](https://github.com/jquery/jquery-wp-content) instance, follow the [workflow instructions](https://contribute.jquery.org/web-sites/#workflow) from our documentation on [contributing to jQuery Foundation web sites](https://contribute.jquery.org/web-sites/).
 
 ### Requirements
 
diff --git a/categories.xml b/categories.xml
index b08956d9..d247f835 100644
--- a/categories.xml
+++ b/categories.xml
@@ -68,7 +68,7 @@
     
     
       For more information, see the Release Notes/Changelog at http://blog.jquery.com/2016/06/09/jquery-3-0-final-released/
            
+        
            For more information, see the Release Notes/Changelog at https://blog.jquery.com/2016/06/09/jquery-3-0-final-released/
            
       ]]>            
                 
 	
diff --git a/entries/contents.xml b/entries/contents.xml
index 70188f7b..f4118e0c 100644
--- a/entries/contents.xml
+++ b/entries/contents.xml
@@ -55,7 +55,7 @@ $( "p" )
 $( "#frameDemo" ).contents().find( "a" ).css( "background-color", "#BADA55" );
 ]]>            
     
+
 ]]>
   
   
diff --git a/entries/jQuery.getJSON.xml b/entries/jQuery.getJSON.xml
index 11a26341..07a926cc 100644
--- a/entries/jQuery.getJSON.xml
+++ b/entries/jQuery.getJSON.xml
@@ -56,7 +56,7 @@ $.getJSON( "ajax/test.json", function( data ) {
     
            The success callback is passed the returned data, which is typically a JavaScript object or array as defined by the JSON structure and parsed using the $.parseJSON() method. It is also passed the text status of the response.
            
     
            As of jQuery 1.5, the success callback function receives a "jqXHR" object (in jQuery 1.4, it received the XMLHttpRequest object). However, since JSONP and cross-domain GET requests do not use XHR, in those cases the jqXHR and textStatus parameters passed to the success callback are undefined.
            
     
            
-      
            Important: As of jQuery 1.4, if the JSON file contains a syntax error, the request will usually fail silently. Avoid frequent hand-editing of JSON data for this reason. JSON is a data-interchange format with syntax rules that are stricter than those of JavaScript's object literal notation. For example, all strings represented in JSON, whether they are properties or values, must be enclosed in double-quotes. For details on the JSON format, see http://json.org/.
            
+      
            Important: As of jQuery 1.4, if the JSON file contains a syntax error, the request will usually fail silently. Avoid frequent hand-editing of JSON data for this reason. JSON is a data-interchange format with syntax rules that are stricter than those of JavaScript's object literal notation. For example, all strings represented in JSON, whether they are properties or values, must be enclosed in double-quotes. For details on the JSON format, see https://json.org/.
            
     
            
     
            JSONP
            
     
            If the URL includes the string "callback=?" (or similar, as defined by the server-side API), the request is treated as JSONP instead. See the discussion of the jsonp data type in $.ajax() for more details.
            
diff --git a/entries/jQuery.parseJSON.xml b/entries/jQuery.parseJSON.xml
index d47eab4b..16e1f6dd 100644
--- a/entries/jQuery.parseJSON.xml
+++ b/entries/jQuery.parseJSON.xml
@@ -25,7 +25,7 @@
       
          • "NaN" (NaN cannot be represented in a JSON string; direct representation of Infinity is also not permitted).
            • 
     
     
            The JSON standard does not permit "control characters" such as a tab or newline. An example like $.parseJSON( '{ "testing":"1\t2\n3" }' ) will throw an error in most implementations because the JavaScript parser converts the string's tab and newline escapes into literal tab and newline; doubling the backslashes like "1\\t2\\n3" yields expected results. This problem is often seen when injecting JSON into a JavaScript file from a server-side language such as PHP.
            
-    
            Where the browser provides a native implementation of JSON.parse, jQuery uses it to parse the string. For details on the JSON format, see http://json.org/.
            
+    
            Where the browser provides a native implementation of JSON.parse, jQuery uses it to parse the string. For details on the JSON format, see https://json.org/.
            
     
            Prior to jQuery 1.9, $.parseJSON returned null instead of throwing an error if it was passed an empty string, null, or undefined, even though those are not valid JSON.
            
   
   
diff --git a/entries/parent-selector.xml b/entries/parent-selector.xml
index 72832a23..bd3fd743 100644
--- a/entries/parent-selector.xml
+++ b/entries/parent-selector.xml
@@ -9,7 +9,7 @@
   
     
            This is the inverse of :empty. 
            
     
            One important thing to note regarding the use of :parent (and :empty) is that child nodes include text nodes.
            
-    
            The W3C recommends that the <p> element have at least one child node, even if that child is merely text (see http://www.w3.org/TR/html401/struct/text.html#edef-P). Some other elements, on the other hand, are empty (i.e. have no children) by definition: <input>, <img>, <br>, and <hr>, for example.
            
+    
            The W3C recommends that the <p> element have at least one child node, even if that child is merely text (see https://www.w3.org/TR/html401/struct/text.html#edef-P). Some other elements, on the other hand, are empty (i.e. have no children) by definition: <input>, <img>, <br>, and <hr>, for example.
            
     
            To obtain the parents or ancestors of an existing jQuery set, see the .parent() and .parents() methods.
            
               
   
diff --git a/pages/Types.html b/pages/Types.html
index 612caa10..de56ce02 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -666,4 +666,4 @@ 
            Callbacks Object
            
 
            XML Document
            
 
            A document object created by the browser's XML DOM parser, usually from a string representing XML. XML documents have different semantics than HTML documents, but most of the traversing and manipulation methods provided by jQuery will work with them.
            
 
            Assert
            
-
            A reference to or instance of the object holding all of QUnit's assertions. See the API documentation for QUnit.assert for details.
            
+
            A reference to or instance of the object holding all of QUnit's assertions. See the API documentation for QUnit.assert for details.
            

From 6cbafd74922ba8de0f88bf1fc5f8198902e26bd9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Wed, 13 Jun 2018 14:30:07 +0200
Subject: [PATCH 537/699] 1.12.32

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index fb070fc4..3704bcb7 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "1.12.31",
+  "version": "1.12.32",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 4bfeeb70..3de1003d 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.31",
+  "version": "1.12.32",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 613f22cd40f8b2a9af772b0ac8c0072cd545ed43 Mon Sep 17 00:00:00 2001
From: Andy Li 
Date: Mon, 23 Jul 2018 16:11:01 +0800
Subject: [PATCH 538/699] Categories: Fix a syntax error in a link to the
 blogpost

Closes #1100
---
 categories.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/categories.xml b/categories.xml
index d247f835..c02b93b3 100644
--- a/categories.xml
+++ b/categories.xml
@@ -73,7 +73,7 @@
                 
 	
       For more information, see the Release Notes/Changelog at https://blog.jquery.com/2018/01/19/jquery-3-3-0-a-fragrant-bouquet-of-deprecations-and-is-that-a-new-feature/
            
       ]]>            
                 
   

From 53308ef90ca423e35b101aea27055a48c1c67b54 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Mon, 23 Jul 2018 10:12:50 +0200
Subject: [PATCH 539/699] 1.12.33

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 3704bcb7..5e1b2f79 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "1.12.32",
+  "version": "1.12.33",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 3de1003d..509a4a72 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.32",
+  "version": "1.12.33",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 3a94c501985adee0c01af01df4bc79968d82bb7d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Mon, 23 Jul 2018 19:09:21 +0200
Subject: [PATCH 540/699] 1.12.34

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 5e1b2f79..95efd8ae 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "1.12.33",
+  "version": "1.12.34",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 509a4a72..9584d1eb 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.33",
+  "version": "1.12.34",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 8407a384caf4895692bb3786cdaf0c6ec8b2ba68 Mon Sep 17 00:00:00 2001
From: Sakthipriyan Vairamani 
Date: Wed, 26 Sep 2018 02:03:05 +0530
Subject: [PATCH 541/699] deferred.catch: Add a missing word

Closes gh-1106
---
 entries/deferred.catch.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/deferred.catch.xml b/entries/deferred.catch.xml
index 17df8dda..e6e3d95a 100644
--- a/entries/deferred.catch.xml
+++ b/entries/deferred.catch.xml
@@ -15,7 +15,7 @@
         
            deferred.catch( fn ) is an alias to deferred.then( null, fn ). Read its page for more information.
            
     
     
-        Since the jQuery.get method returns a jqXHR object, which is derived from a Deferred object, we can rejection handlers using the .catch method.
+        Since the jQuery.get method returns a jqXHR object, which is derived from a Deferred object, we can add rejection handlers using the .catch method.
         
Date: Tue, 13 Nov 2018 17:50:14 +0100
Subject: [PATCH 542/699] Misc: Add missing entries to the deprecated-3.0
 category

Fixes #1116
Closes #1117
---
 entries/jQuery.parseJSON.xml | 1 +
 entries/jQuery.unique.xml    | 1 +
 entries/toggleClass.xml      | 1 +
 3 files changed, 3 insertions(+)

diff --git a/entries/jQuery.parseJSON.xml b/entries/jQuery.parseJSON.xml
index 16e1f6dd..c09f3c40 100644
--- a/entries/jQuery.parseJSON.xml
+++ b/entries/jQuery.parseJSON.xml
@@ -37,4 +37,5 @@ alert( obj.name === "John" );
   
   
   
+  
 
diff --git a/entries/jQuery.unique.xml b/entries/jQuery.unique.xml
index b31ce023..56a8ced5 100644
--- a/entries/jQuery.unique.xml
+++ b/entries/jQuery.unique.xml
@@ -43,4 +43,5 @@ $( "div:eq(2)" ).text( "Post-unique there are " + divs.length + " elements." )
   
   
   
+  
 
diff --git a/entries/toggleClass.xml b/entries/toggleClass.xml
index dfe45f2d..51bdf746 100644
--- a/entries/toggleClass.xml
+++ b/entries/toggleClass.xml
@@ -208,5 +208,6 @@ $( "a" ).on( "click", function( event ) {
     
       
            This signature (only!) is deprecated as of jQuery 3.0.
            
                 
+    
   
 
\ No newline at end of file

From ed497086495d7cb6f7379b42c8cc2fb77bc6812b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Tue, 13 Nov 2018 17:52:48 +0100
Subject: [PATCH 543/699] 1.12.35

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 95efd8ae..a3cc492e 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "1.12.34",
+  "version": "1.12.35",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 9584d1eb..f06fac96 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.34",
+  "version": "1.12.35",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 3d88fc63dc82f5d4ddf390076f537dcadbe4cf64 Mon Sep 17 00:00:00 2001
From: Richard Gibson 
Date: Wed, 21 Nov 2018 10:51:43 -0500
Subject: [PATCH 544/699] data: Explicitly disavow writing data-* attributes
 (#1112)

Also includes general cleanup.

Fixes gh-1023
Closes gh-1112
---
 entries/data.xml | 54 ++++++++++++++++++++----------------------------
 1 file changed, 22 insertions(+), 32 deletions(-)

diff --git a/entries/data.xml b/entries/data.xml
index a8ff396c..7e742da1 100644
--- a/entries/data.xml
+++ b/entries/data.xml
@@ -24,14 +24,14 @@
       
            We can set several distinct values for a single element and retrieve them later:
            
       
            
 $( "body" ).data( "foo", 52 );
-$( "body" ).data( "bar", { myType: "test", count: 40 } );
+$( "body" ).data( "bar", { isManual: true } );
 $( "body" ).data( { baz: [ 1, 2, 3 ] } );
 $( "body" ).data( "foo" ); // 52
-$( "body" ).data(); // { foo: 52, bar: { myType: "test", count: 40 }, baz: [ 1, 2, 3 ] }
+$( "body" ).data(); // { foo: 52, bar: { isManual: true }, baz: [ 1, 2, 3 ] }
       
            
-      
            In jQuery 1.4.3 setting an element's data object with .data(obj) extends the data previously stored with that element.
            
-      
            Prior to jQuery 1.4.3 (starting in jQuery 1.4) the .data() method completely replaced all data, instead of just extending the data object. If you are using third-party plugins it may not be advisable to completely replace the element's data object, since plugins may have also set data.
            
-      
            jQuery 3 changes the behavior of this method to align it to the Dataset API specifications. Specifically, jQuery 3 transforms every two-character sequence of "-" (U+002D) followed by a lowercase ASCII letter by the uppercase version of the letter as per definition of the algorithm of the Dataset API. Writing a statement like $( "body" ).data( { "my-name": "aValue" } ).data(); will return { myName: "aValue" }.
            
+      
            Using the data() method to update data does not affect attributes in the DOM. To set a data-* attribute value, use attr.
            
+      
            Prior to jQuery 1.4.3, .data( obj ) completely replaced all data. Since jQuery 1.4.3, data is instead extended by shallow merge.
            
+      
            Since jQuery 3, every two-character sequence of "-" (U+002D) followed by a lowercase ASCII letter in a key is replaced by the uppercase version of the letter, in alignment with the HTML dataset API. A statement like $( "body" ).data( { "my-name": "aValue" } ).data(); will return { myName: "aValue" }.
            
       
            Due to the way browsers interact with plugins and external code, the .data() method cannot be used on <object> (unless it's a Flash plugin), <applet> or <embed> elements.
            
     
     
@@ -76,46 +76,36 @@ $( "span:last" ).text( $( "div" ).data( "test" ).last );
     
       1.4
     
-    Return the value at the named data store for the first element in the jQuery collection, as set by data(name, value) or by an HTML5 data-* attribute.
+    Return arbitrary data associated with the first element in the jQuery collection, as set by data() or by an HTML5 data-* attribute.
     
-      
            The .data() method allows us to attach data of any type to DOM elements in a way that is safe from circular references and therefore from memory leaks. We can retrieve several distinct values for a single element one at a time, or as a set:
            
+      
            The .data() method allows us to read data previously associated with DOM elements. We can retrieve several distinct values for a single element one at a time, or as a set:
            
       
            
-alert( $( "body" ).data( "foo" ) );
-alert( $( "body" ).data() );
-      
            
-      
            The above lines alert the data values that were set on the body element. If no data at all was set on that element, undefined is returned.
            
-      
            
-alert( $( "body" ).data( "foo" ) ); // undefined
-$( "body" ).data( "bar", "foobar" );
-alert( $( "body" ).data( "bar" ) ); // foobar
+var elem = document.createElement( "span" );
+$( elem ).data( "foo" ); // undefined
+$( elem ).data(); // {}
+
+$( elem ).data( "foo", 42 );
+$( elem ).data( "foo" ); // 42
+$( elem ).data(); // { foo: 42 }
       
            
-      
            jQuery 3 changes the behavior of this method to align it to the Dataset API specifications. Specifically, jQuery 3 transforms every two-character sequence of "-" (U+002D) followed by a lowercase ASCII letter by the uppercase version of the letter as per definition of the algorithm of the Dataset API. Writing a statement like $( "body" ).data( { "my-name": "aValue" } ).data(); will return { myName: "aValue" }.
            
+      
            Calling .data() with no parameters returns a JavaScript object containing each stored value as a property. The object can be used directly to get data values (but note that property names originally containing dashes will have been modified as described below).
            
+      
            Since jQuery 3, every two-character sequence of "-" (U+002D) followed by a lowercase ASCII letter in a key is replaced by the uppercase version of the letter, in alignment with the HTML dataset API. A statement like $( "body" ).data( { "my-name": "aValue" } ).data(); will return { myName: "aValue" }.
            
       
            
-        HTML5 data-* Attributes
+        HTML5 data-* Attributes
       
            
-      
            As of jQuery 1.4.3 HTML 5 data- attributes will be automatically pulled in to jQuery's data object. The treatment of attributes with embedded dashes was changed in jQuery 1.6 to conform to the W3C HTML5 specification.
            
+      
            Since jQuery 1.4.3, data-* attributes are used to initialize jQuery data. An element's data-* attributes are retrieved the first time the data() method is invoked upon it, and then are no longer accessed or mutated (all values are stored internally by jQuery).
            
+      
            Every attempt is made to convert the attribute's string value to a JavaScript value (this includes booleans, numbers, objects, arrays, and null). A string is only converted to a number if doing so doesn't change its representation (for example, the string "100" is converted to the number 100, but "1E02" and "100.000" are left as strings because their numeric value of 100 serializes to "100"). When a string starts with '{' or '[', then jQuery.parseJSON is used to parse it; it must follow valid JSON syntax including quoted property names. A string not parseable as a JavaScript value is not converted.
            
+      
            To retrieve a data-* attribute value as an unconverted string, use the attr() method.
            
+      
            Since jQuery 1.6, dashes in data-* attribute names have been processed in alignment with the HTML dataset API.
            
       
            For example, given the following HTML:
            
       
            <div data-role="page" data-last-value="43" data-hidden="true" data-options='{"name":"John"}'></div>
            
-      
            All of the following jQuery code will work.
            
+      
            The following comparisons are all true:
            
       
            
 $( "div" ).data( "role" ) === "page";
 $( "div" ).data( "lastValue" ) === 43;
 $( "div" ).data( "hidden" ) === true;
 $( "div" ).data( "options" ).name === "John";
       
            
-      
            The second statement of the code above correctly refers to the data-last-value attribute of the element. In case no data is stored with the passed key, jQuery searches among the attributes of the element, converting a camel-cased string into a dashed string and then prepending data- to the result. So, the string lastValue is converted to data-last-value.
            
-      
            Every attempt is made to convert the string to a JavaScript value (this includes booleans, numbers, objects, arrays, and null). A value is only converted to a number if doing so doesn't change the value's representation. For example, "1E02" and "100.000" are equivalent as numbers (numeric value 100) but converting them would alter their representation so they are left as strings. The string value "100" is converted to the number 100.
            
-      
            When the data attribute is an object (starts with '{') or array (starts with '[') then jQuery.parseJSON is used to parse the string; it must follow valid JSON syntax including quoted property names. If the value isn't parseable as a JavaScript value, it is left as a string.
            
-      
            To retrieve the value's attribute as a string without any attempt to convert it, use the attr() method.
            
-      
            The data- attributes are pulled in the first time the data property is accessed and then are no longer accessed or mutated (all data values are then stored internally in jQuery).
            
-      
            Calling .data() with no parameters retrieves all of the values as a JavaScript object. This object can be safely cached in a variable as long as a new object is not set with .data(obj). Using the object directly to get or set values is faster than making individual calls to .data() to get or set each value:
            
-      
            
-var mydata = $( "#mydiv" ).data();
-if ( mydata.count < 9 ) {
-  mydata.count = 43;
-  mydata.status = "embiggened";
-}
-    
            
                 
     
     

From fb2edb2c941ef7a44cac66a0e4be45e630ae48d3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Wed, 21 Nov 2018 16:52:32 +0100
Subject: [PATCH 545/699] 1.12.36

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index a3cc492e..e3059772 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "1.12.35",
+  "version": "1.12.36",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index f06fac96..34ef2b83 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.35",
+  "version": "1.12.36",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 812e1326b3323bbf6c32ac284e3e50be17b3cff4 Mon Sep 17 00:00:00 2001
From: Matt Doyle 
Date: Wed, 28 Nov 2018 08:19:06 +1100
Subject: [PATCH 546/699] width: Add quotes around .css() width argument
 (#1118)

Fixes gh-1102
Closes gh-1118
---
 entries/width.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/width.xml b/entries/width.xml
index f073145a..c197119c 100644
--- a/entries/width.xml
+++ b/entries/width.xml
@@ -8,7 +8,7 @@
     
     Get the current computed width for the first element in the set of matched elements.
     
-      
            The difference between .css(width) and .width() is that the latter returns a unit-less pixel value (for example, 400) while the former returns a value with units intact (for example, 400px). The .width() method is recommended when an element's width needs to be used in a mathematical calculation.
            
+      
            The difference between .css( "width" ) and .width() is that the latter returns a unit-less pixel value (for example, 400) while the former returns a value with units intact (for example, 400px). The .width() method is recommended when an element's width needs to be used in a mathematical calculation.
            
       
            
         
         
            Figure 1 - Illustration of the measured width
            

From e56c5736cc65dd9ee7d6b08584afaf7387e1fe9c Mon Sep 17 00:00:00 2001
From: Philippe Cloutier 
Date: Sun, 10 Feb 2019 18:06:13 -0500
Subject: [PATCH 547/699] load: Fix singular references to matched elements

Fixes #1125
Closes #1126
---
 entries/load.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/load.xml b/entries/load.xml
index 3444cb90..c0f6a46f 100644
--- a/entries/load.xml
+++ b/entries/load.xml
@@ -18,12 +18,12 @@
       A callback function that is executed when the request completes.
     
   
-  Load data from the server and place the returned HTML into the matched element.
+  Load data from the server and place the returned HTML into the matched elements.
   
     
            
       
            Note: Prior to jQuery 3.0, the event handling suite also had a method named .load(). Older versions of jQuery determined which method to fire based on the set of arguments passed to it.
            
     
            
-    
            This method is the simplest way to fetch data from the server. It is roughly equivalent to $.get(url, data, success) except that it is a method rather than global function and it has an implicit callback function.  When a successful response is detected (i.e. when textStatus is "success" or "notmodified"), .load() sets the HTML contents of the matched element to the returned data. This means that most uses of the method can be quite simple:
            
+    
            This method is the simplest way to fetch data from the server. It is roughly equivalent to $.get(url, data, success) except that it is a method rather than global function and it has an implicit callback function.  When a successful response is detected (i.e. when textStatus is "success" or "notmodified"), .load() sets the HTML contents of the matched elements to the returned data. This means that most uses of the method can be quite simple:
            
     
            
 $( "#result" ).load( "ajax/test.html" );
     
            

From 4b6b1e9f08412e892cfb6a76db36898114f1a04a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Mon, 8 Apr 2019 11:06:08 +0200
Subject: [PATCH 548/699] 1.12.37

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index e3059772..a70406ed 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "1.12.36",
+  "version": "1.12.37",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 34ef2b83..11fc459d 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.36",
+  "version": "1.12.37",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 51f3979e25b4dc0c13d38e588fef602d8d288415 Mon Sep 17 00:00:00 2001
From: Dave Methvin 
Date: Mon, 15 Apr 2019 11:20:39 -0400
Subject: [PATCH 549/699] Ajax: Add scriptAttrs

Fixes #1091
Closes #1092

Can be landed once https://github.com/jquery/jquery/issues/3028 is closed and we know a specific version for the feature. I've assume 3.4.0 here.
---
 entries/jQuery.ajax.xml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index 80157d28..f75de949 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -145,8 +145,11 @@ $.ajax({
       
         By default, data passed in to the data option as an object (technically, anything other than a string) will be processed and transformed into a query string, fitting to the default content-type "application/x-www-form-urlencoded". If you want to send a DOMDocument, or other non-processed data, set this option to false.
       
+      
+        Defines an object with additional attributes to be used in a "script" or "jsonp" request. The key represents the name of the attribute and the value is the attribute's value. If this object is provided it will force the use of a script-tag transport. For example, this can be used to set nonce, integrity, or crossorigin attributes to satisfy Content Security Policy requirements.
+      
       
-        Only applies when the "script" transport is used (e.g., cross-domain requests with "jsonp" or "script" dataType and "GET" type). Sets the charset attribute on the script tag used in the request. Used when the character set on the local page is not the same as the one on the remote script.
+        Only applies when the "script" transport is used. Sets the charset attribute on the script tag used in the request. Used when the character set on the local page is not the same as the one on the remote script. Alternatively, the charset attribute can be specified in scriptAttrs instead, which will also ensure the use of the "script" transport.
       
       
         

From 05e21403b1a807adb0e3bae152cee68773996100 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Mon, 29 Apr 2019 18:49:13 +0200
Subject: [PATCH 550/699] jQuery.globalEval: Document the nonce option

Fixes #1123
Closes #1131
---
 entries/jQuery.globalEval.xml | 25 ++++++++++++++++++++++++-
 1 file changed, 24 insertions(+), 1 deletion(-)

diff --git a/entries/jQuery.globalEval.xml b/entries/jQuery.globalEval.xml
index ad6b7d1e..1900cd78 100644
--- a/entries/jQuery.globalEval.xml
+++ b/entries/jQuery.globalEval.xml
@@ -7,6 +7,17 @@
       The JavaScript code to execute.
     
   
+  
+    3.4.0
+    
+      The JavaScript code to execute.
+    
+    
+      
+        The nonce attribute passed to the executed script.
+      
+    
+  
   Execute some JavaScript code globally.
   
     
            This method behaves differently from using a normal JavaScript eval() in that it's executed within the global context (which is important for loading external scripts dynamically).
            
@@ -15,7 +26,19 @@
     Execute a script in the global context.
     
+  
+  
+    Execute a script with a nonce value on a site with Content Security Policy enabled.
+    
Date: Mon, 29 Apr 2019 18:50:43 +0200
Subject: [PATCH 551/699] 1.12.38

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index a70406ed..3efd0132 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "1.12.37",
+  "version": "1.12.38",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 11fc459d..8dbb378c 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.37",
+  "version": "1.12.38",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From fcefc0f80da4badaddbc3001980f4daed6f780ec Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 5 May 2019 20:58:19 +0100
Subject: [PATCH 552/699] Replaced "delegated events" with "delegated event
 handlers"

Closes gh-1132
Fixes gh-1103
---
 entries/on.xml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/entries/on.xml b/entries/on.xml
index 735f82b4..568f3be6 100644
--- a/entries/on.xml
+++ b/entries/on.xml
@@ -41,9 +41,9 @@
     
            The majority of browser events bubble, or propagate, from the deepest, innermost element (the event target) in the document where they occur all the way up to the body and the document element. In Internet Explorer 8 and lower, a few events such as change and submit do not natively bubble but jQuery patches these to bubble and create consistent cross-browser behavior.
            
     
            If selector is omitted or is null, the event handler is referred to as direct or directly-bound. The handler is called every time an event occurs on the selected elements, whether it occurs directly on the element or bubbles from a descendant (inner) element.
            
     
            When a selector is provided, the event handler is referred to as delegated. The handler is not called when the event occurs directly on the bound element, but only for descendants (inner elements) that match the selector. jQuery bubbles the event from the event target up to the element where the handler is attached (i.e., innermost to outermost element) and runs the handler for any elements along that path matching the selector.
            
-    
            Event handlers are bound only to the currently selected elements; they must exist at the time your code makes the call to .on(). To ensure the elements are present and can be selected, place scripts after the elements in the HTML markup or perform event binding inside a document ready handler. Alternatively, use delegated events to attach event handlers.
            
-    
            Delegated event handlers have the advantage that they can process events from descendant elements that are added to the document at a later time. By picking an element that is guaranteed to be present at the time the delegated event handler is attached, you can use delegated events to avoid the need to frequently attach and remove event handlers. This element could be the container element of a view in a Model-View-Controller design, for example, or document if the event handler wants to monitor all bubbling events in the document. The document element is available in the head of the document before loading any other HTML, so it is safe to attach events there without waiting for the document to be ready.
            
-    
            In addition to their ability to handle events on descendant elements not yet created, another advantage of delegated events is their potential for much lower overhead when many elements must be monitored. On a data table with 1,000 rows in its tbody, this example attaches a handler to 1,000 elements:
            
+    
            Event handlers are bound only to the currently selected elements; they must exist at the time your code makes the call to .on(). To ensure the elements are present and can be selected, place scripts after the elements in the HTML markup or perform event binding inside a document ready handler. Alternatively, use delegated event handlers to attach event handlers.
            
+    
            Delegated event handlers have the advantage that they can process events from descendant elements that are added to the document at a later time. By picking an element that is guaranteed to be present at the time the delegated event handler is attached, you can use delegated event handlers to avoid the need to frequently attach and remove event handlers. This element could be the container element of a view in a Model-View-Controller design, for example, or document if the event handler wants to monitor all bubbling events in the document. The document element is available in the head of the document before loading any other HTML, so it is safe to attach events there without waiting for the document to be ready.
            
+    
            In addition to their ability to handle events on descendant elements not yet created, another advantage of delegated event handlers is their potential for much lower overhead when many elements must be monitored. On a data table with 1,000 rows in its tbody, this example attaches a handler to 1,000 elements:
            
     
            
 $( "#dataTable tbody tr" ).on( "click", function() {
   console.log( $( this ).text() );

From 25b47f5b54cf574e53f793eb0035dbf6107a3797 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Mon, 6 May 2019 15:13:04 +0100
Subject: [PATCH 553/699] Document optional includeMargin argument

Closes gh-1133
Fixes gh-1107
---
 entries/outerHeight.xml | 3 +++
 entries/outerWidth.xml  | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/entries/outerHeight.xml b/entries/outerHeight.xml
index e1caaf55..09aa255e 100644
--- a/entries/outerHeight.xml
+++ b/entries/outerHeight.xml
@@ -53,6 +53,9 @@ $( "p:last" ).text(
       
       A number representing the number of pixels, or a number along with an optional unit of measure appended (as a string).
     
+    
+      A Boolean indicating whether to new value should account for the element's margin.
+    
   
   
     1.8.0
diff --git a/entries/outerWidth.xml b/entries/outerWidth.xml
index 4e613cc1..cfb07bc8 100644
--- a/entries/outerWidth.xml
+++ b/entries/outerWidth.xml
@@ -53,6 +53,9 @@ $( "p:last" ).text(
       
       A number representing the number of pixels, or a number along with an optional unit of measure appended (as a string).
     
+    
+      A Boolean indicating whether to new value should account for the element's margin.
+    
   
   
     1.8.0

From 7cd5ae8e5756bdacaeda503abe8ebc3ed4e3be4d Mon Sep 17 00:00:00 2001
From: biziclop <904630+biziclop@users.noreply.github.com>
Date: Thu, 6 Jun 2019 23:18:32 +0200
Subject: [PATCH 554/699] "Returning an Empty Set" clarifications (#1137)

Fixes #1136
---
 entries/jQuery.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.xml b/entries/jQuery.xml
index a0ff76d1..b31102b5 100644
--- a/entries/jQuery.xml
+++ b/entries/jQuery.xml
@@ -77,7 +77,7 @@ $.post( "url.xml", function( data ) {
       
            When a jQuery object is passed to the $() function, a clone of the object is created. This new jQuery object references the same DOM elements as the initial one.
            
 
       
            Returning an Empty Set
            
-      
            As of jQuery 1.4, calling the jQuery() method with no arguments returns an empty jQuery set (with a .length property of 0). In previous versions of jQuery, this would return a set containing the document node.
            
+      
            Calling the jQuery() method with no arguments returns an empty jQuery set (with a .length property of 0). Similarly, if an argument of null, undefined, an empty array ([]), or an empty string ("") is passed, the set contains no elements.
            
       
            Working With Plain Objects
            
       
            At present, the only operations supported on plain JavaScript objects wrapped in jQuery are: .data(),.prop(),.on(), .off(), .trigger() and .triggerHandler(). The use of .data() (or any method requiring .data()) on a plain object will result in a new property on the object called jQuery{randomNumber} (eg. jQuery123456789).
            
       
            

From 49e1e7c6b9bfe8650cd4d12b51d6e5b53e168cf0 Mon Sep 17 00:00:00 2001
From: ryenus 
Date: Thu, 18 Jul 2019 06:21:17 +0800
Subject: [PATCH 555/699] Types: Fix a typo: "{a,i}s passed as"

Closes gh-1139
---
 pages/Types.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pages/Types.html b/pages/Types.html
index de56ce02..fd4df2ca 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -149,7 +149,7 @@ 
             Boolean Default 
            
 
 
             htmlString 
            
 
            A string is designated htmlString in jQuery documentation when it is used to represent one or more DOM elements, typically to be created and inserted in the document. When passed as an argument of the jQuery() function, the string is identified as HTML if it starts with <tag ... >) and is parsed as such until the final > character. Prior to jQuery 1.9, a string was considered to be HTML if it contained <tag ... > anywhere within the string.
            
-
            When a string as passed as an argument to a manipulation method such as .append(), it is always considered to be HTML since jQuery's other common interpretation of a string (CSS selectors) does not apply in those contexts.
            
+
            When a string is passed as an argument to a manipulation method such as .append(), it is always considered to be HTML since jQuery's other common interpretation of a string (CSS selectors) does not apply in those contexts.
            
 
            For explicit parsing of a string to HTML, the $.parseHTML() method is available as of jQuery 1.8.
            
 
            // Appends hello:
 $( "hello" ).appendTo( "body" );

From 0fca273075cd8fbcebc7b3b10199881700d69123 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Thu, 18 Jul 2019 00:21:57 +0200
Subject: [PATCH 556/699] 1.12.39

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 3efd0132..d2b7ebfd 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "1.12.38",
+  "version": "1.12.39",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 8dbb378c..355f6217 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.38",
+  "version": "1.12.39",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From d3b821b1a5ed1516153076c2dc3eb40182c4c362 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Fri, 30 Aug 2019 00:18:09 +0200
Subject: [PATCH 557/699] Build: Make the build compatible with Node.js 12

---
 .nvmrc            |    1 +
 package-lock.json | 2360 +++++++++++++++++++++++++++++++++++++--------
 package.json      |    6 +-
 3 files changed, 1955 insertions(+), 412 deletions(-)
 create mode 100644 .nvmrc

diff --git a/.nvmrc b/.nvmrc
new file mode 100644
index 00000000..f599e28b
--- /dev/null
+++ b/.nvmrc
@@ -0,0 +1 @@
+10
diff --git a/package-lock.json b/package-lock.json
index d2b7ebfd..c0781a3e 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -4,56 +4,239 @@
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
+    "CSSselect": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/CSSselect/-/CSSselect-0.4.1.tgz",
+      "integrity": "sha1-+Kt+H4QYzmPNput713ioXX7EkrI=",
+      "requires": {
+        "CSSwhat": "0.4",
+        "domutils": "1.4"
+      }
+    },
+    "CSSwhat": {
+      "version": "0.4.7",
+      "resolved": "https://registry.npmjs.org/CSSwhat/-/CSSwhat-0.4.7.tgz",
+      "integrity": "sha1-hn2g/zn3eGEyQsRM/qg/CqTr35s="
+    },
     "abbrev": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/abbrev/-/abbrev-1.1.0.tgz",
-      "integrity": "sha1-0FVMIlZjbi9W58LlrRg/hZQo2B8="
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/abbrev/-/abbrev-1.1.1.tgz",
+      "integrity": "sha512-nne9/IiQ/hzIhY6pdDnbBtz7DjPTKrY00P/zvPSm5pOFkl6xuGrGnXn/VtTNNfNtAfZ9/1RtehkszU9qcTii0Q=="
+    },
+    "ansi-styles": {
+      "version": "3.2.1",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
+      "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
+      "requires": {
+        "color-convert": "^1.9.0"
+      }
     },
     "argparse": {
-      "version": "0.1.16",
-      "resolved": "https://registry.npmjs.org/argparse/-/argparse-0.1.16.tgz",
-      "integrity": "sha1-z9AeD7uj1srtBJ+9dY1A9lGW9Xw=",
+      "version": "1.0.10",
+      "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz",
+      "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==",
       "requires": {
-        "underscore": "1.7.0",
-        "underscore.string": "2.4.0"
+        "sprintf-js": "~1.0.2"
       },
       "dependencies": {
-        "underscore.string": {
-          "version": "2.4.0",
-          "resolved": "https://registry.npmjs.org/underscore.string/-/underscore.string-2.4.0.tgz",
-          "integrity": "sha1-jN2PusTi0uoefi6Al8QvRCKA+Fs="
+        "sprintf-js": {
+          "version": "1.0.3",
+          "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz",
+          "integrity": "sha1-BOaSb2YolTVPPdAVIDYzuFcpfiw="
         }
       }
     },
+    "arr-diff": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/arr-diff/-/arr-diff-4.0.0.tgz",
+      "integrity": "sha1-1kYQdP6/7HHn4VI1dhoyml3HxSA="
+    },
+    "arr-flatten": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/arr-flatten/-/arr-flatten-1.1.0.tgz",
+      "integrity": "sha512-L3hKV5R/p5o81R7O02IGnwpDmkp6E982XhtbuwSe3O4qOtMMMtodicASA1Cny2U+aCXcNpml+m4dPsvsJ3jatg=="
+    },
+    "arr-union": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/arr-union/-/arr-union-3.1.0.tgz",
+      "integrity": "sha1-45sJrqne+Gao8gbiiK9jkZuuOcQ="
+    },
+    "array-each": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/array-each/-/array-each-1.0.1.tgz",
+      "integrity": "sha1-p5SvDAWrF1KEbudTofIRoFugxE8="
+    },
+    "array-find-index": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/array-find-index/-/array-find-index-1.0.2.tgz",
+      "integrity": "sha1-3wEKoSh+Fku9pvlyOwqWoexBh6E="
+    },
+    "array-slice": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/array-slice/-/array-slice-1.1.0.tgz",
+      "integrity": "sha512-B1qMD3RBP7O8o0H2KbrXDyB0IccejMF15+87Lvlor12ONPRHP6gTjXMNkt/d3ZuOGbAe66hFmaCfECI24Ufp6w=="
+    },
+    "array-unique": {
+      "version": "0.3.2",
+      "resolved": "https://registry.npmjs.org/array-unique/-/array-unique-0.3.2.tgz",
+      "integrity": "sha1-qJS3XUvE9s1nnvMkSp/Y9Gri1Cg="
+    },
+    "assign-symbols": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/assign-symbols/-/assign-symbols-1.0.0.tgz",
+      "integrity": "sha1-WWZ/QfrdTyDMvCu5a41Pf3jsA2c="
+    },
     "async": {
-      "version": "0.1.22",
-      "resolved": "https://registry.npmjs.org/async/-/async-0.1.22.tgz",
-      "integrity": "sha1-D8GqoIig4+8Ovi2IMbqw3PiEUGE="
+      "version": "1.5.2",
+      "resolved": "https://registry.npmjs.org/async/-/async-1.5.2.tgz",
+      "integrity": "sha1-7GphrlZIDAw8skHJVhjiCJL5Zyo="
+    },
+    "atob": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/atob/-/atob-2.1.2.tgz",
+      "integrity": "sha512-Wm6ukoaOGJi/73p/cl2GvLjTI5JM1k/O14isD73YML8StrH/7/lRFgmg8nICZgD3bZZvjwCGxtMOD3wWNAu8cg=="
     },
     "balanced-match": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.0.tgz",
       "integrity": "sha1-ibTRmasr7kneFk6gK4nORi1xt2c="
     },
+    "base": {
+      "version": "0.11.2",
+      "resolved": "https://registry.npmjs.org/base/-/base-0.11.2.tgz",
+      "integrity": "sha512-5T6P4xPgpp0YDFvSWwEZ4NoE3aM4QBQXDzmVbraCkFj8zHM+mba8SyqB5DbZWyR7mYHo6Y7BdQo3MoA4m0TeQg==",
+      "requires": {
+        "cache-base": "^1.0.1",
+        "class-utils": "^0.3.5",
+        "component-emitter": "^1.2.1",
+        "define-property": "^1.0.0",
+        "isobject": "^3.0.1",
+        "mixin-deep": "^1.2.0",
+        "pascalcase": "^0.1.1"
+      },
+      "dependencies": {
+        "define-property": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/define-property/-/define-property-1.0.0.tgz",
+          "integrity": "sha1-dp66rz9KY6rTr56NMEybvnm/sOY=",
+          "requires": {
+            "is-descriptor": "^1.0.0"
+          }
+        },
+        "is-accessor-descriptor": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-1.0.0.tgz",
+          "integrity": "sha512-m5hnHTkcVsPfqx3AKlyttIPb7J+XykHvJP2B9bZDjlhLIoEq4XoK64Vg7boZlVWYK6LUY94dYPEE7Lh0ZkZKcQ==",
+          "requires": {
+            "kind-of": "^6.0.0"
+          }
+        },
+        "is-data-descriptor": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-1.0.0.tgz",
+          "integrity": "sha512-jbRXy1FmtAoCjQkVmIVYwuuqDFUbaOeDjmed1tOGPrsMhtJA4rD9tkgA0F1qJ3gRFRXcHYVkdeaP50Q5rE/jLQ==",
+          "requires": {
+            "kind-of": "^6.0.0"
+          }
+        },
+        "is-descriptor": {
+          "version": "1.0.2",
+          "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-1.0.2.tgz",
+          "integrity": "sha512-2eis5WqQGV7peooDyLmNEPUrps9+SXX5c9pL3xEB+4e9HnGuDa7mB7kHxHw4CbqS9k1T2hOH3miL8n8WtiYVtg==",
+          "requires": {
+            "is-accessor-descriptor": "^1.0.0",
+            "is-data-descriptor": "^1.0.0",
+            "kind-of": "^6.0.2"
+          }
+        }
+      }
+    },
     "brace-expansion": {
-      "version": "1.1.8",
-      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.8.tgz",
-      "integrity": "sha1-wHshHHyVLsH479Uad+8NHTmQopI=",
+      "version": "1.1.11",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz",
+      "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==",
       "requires": {
-        "balanced-match": "1.0.0",
+        "balanced-match": "^1.0.0",
         "concat-map": "0.0.1"
       }
     },
+    "braces": {
+      "version": "2.3.2",
+      "resolved": "https://registry.npmjs.org/braces/-/braces-2.3.2.tgz",
+      "integrity": "sha512-aNdbnj9P8PjdXU4ybaWLK2IF3jc/EoDYbC7AazW6to3TRsfXxscC9UXOB5iDiEQrkyIbWp2SLQda4+QAa7nc3w==",
+      "requires": {
+        "arr-flatten": "^1.1.0",
+        "array-unique": "^0.3.2",
+        "extend-shallow": "^2.0.1",
+        "fill-range": "^4.0.0",
+        "isobject": "^3.0.1",
+        "repeat-element": "^1.1.2",
+        "snapdragon": "^0.8.1",
+        "snapdragon-node": "^2.0.1",
+        "split-string": "^3.0.2",
+        "to-regex": "^3.0.1"
+      },
+      "dependencies": {
+        "extend-shallow": {
+          "version": "2.0.1",
+          "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
+          "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=",
+          "requires": {
+            "is-extendable": "^0.1.0"
+          }
+        }
+      }
+    },
+    "cache-base": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/cache-base/-/cache-base-1.0.1.tgz",
+      "integrity": "sha512-AKcdTnFSWATd5/GCPRxr2ChwIJ85CeyrEyjRHlKxQ56d4XJMGym0uAiKn0xbLOGOl3+yRpOTi484dVCEc5AUzQ==",
+      "requires": {
+        "collection-visit": "^1.0.0",
+        "component-emitter": "^1.2.1",
+        "get-value": "^2.0.6",
+        "has-value": "^1.0.0",
+        "isobject": "^3.0.1",
+        "set-value": "^2.0.0",
+        "to-object-path": "^0.3.0",
+        "union-value": "^1.0.0",
+        "unset-value": "^1.0.0"
+      }
+    },
+    "camelcase": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-2.1.1.tgz",
+      "integrity": "sha1-fB0W1nmhu+WcoCys7PsBHiAfWh8="
+    },
+    "camelcase-keys": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/camelcase-keys/-/camelcase-keys-2.1.0.tgz",
+      "integrity": "sha1-MIvur/3ygRkFHvodkyITyRuPkuc=",
+      "requires": {
+        "camelcase": "^2.0.0",
+        "map-obj": "^1.0.0"
+      }
+    },
+    "chalk": {
+      "version": "2.4.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.2.tgz",
+      "integrity": "sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==",
+      "requires": {
+        "ansi-styles": "^3.2.1",
+        "escape-string-regexp": "^1.0.5",
+        "supports-color": "^5.3.0"
+      }
+    },
     "cheerio": {
       "version": "0.17.0",
       "resolved": "https://registry.npmjs.org/cheerio/-/cheerio-0.17.0.tgz",
       "integrity": "sha1-+lrkLMYBIRM9KW0LRtmDIV9yaOo=",
       "requires": {
-        "CSSselect": "0.4.1",
-        "dom-serializer": "0.0.1",
-        "entities": "1.1.1",
-        "htmlparser2": "3.7.3",
-        "lodash": "2.4.2"
+        "CSSselect": "~0.4.0",
+        "dom-serializer": "~0.0.0",
+        "entities": "~1.1.1",
+        "htmlparser2": "~3.7.2",
+        "lodash": "~2.4.1"
       },
       "dependencies": {
         "lodash": {
@@ -63,52 +246,163 @@
         }
       }
     },
-    "coffee-script": {
-      "version": "1.3.3",
-      "resolved": "https://registry.npmjs.org/coffee-script/-/coffee-script-1.3.3.tgz",
-      "integrity": "sha1-FQ1rTLUiiUNp7+1qIQHCC8f0pPQ="
+    "class-utils": {
+      "version": "0.3.6",
+      "resolved": "https://registry.npmjs.org/class-utils/-/class-utils-0.3.6.tgz",
+      "integrity": "sha512-qOhPa/Fj7s6TY8H8esGu5QNpMMQxz79h+urzrNYN6mn+9BnxlDGf5QZ+XeCDsxSjPqsSR56XOZOJmpeurnLMeg==",
+      "requires": {
+        "arr-union": "^3.1.0",
+        "define-property": "^0.2.5",
+        "isobject": "^3.0.0",
+        "static-extend": "^0.1.1"
+      },
+      "dependencies": {
+        "define-property": {
+          "version": "0.2.5",
+          "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz",
+          "integrity": "sha1-w1se+RjsPJkPmlvFe+BKrOxcgRY=",
+          "requires": {
+            "is-descriptor": "^0.1.0"
+          }
+        }
+      }
+    },
+    "coffeescript": {
+      "version": "1.10.0",
+      "resolved": "https://registry.npmjs.org/coffeescript/-/coffeescript-1.10.0.tgz",
+      "integrity": "sha1-56qDAZF+9iGzXYo580jc3R234z4="
+    },
+    "collection-visit": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/collection-visit/-/collection-visit-1.0.0.tgz",
+      "integrity": "sha1-S8A3PBZLwykbTTaMgpzxqApZ3KA=",
+      "requires": {
+        "map-visit": "^1.0.0",
+        "object-visit": "^1.0.0"
+      }
+    },
+    "color-convert": {
+      "version": "1.9.3",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.3.tgz",
+      "integrity": "sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==",
+      "requires": {
+        "color-name": "1.1.3"
+      }
+    },
+    "color-name": {
+      "version": "1.1.3",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz",
+      "integrity": "sha1-p9BVi9icQveV3UIyj3QIMcpTvCU="
     },
     "colors": {
-      "version": "0.6.2",
-      "resolved": "https://registry.npmjs.org/colors/-/colors-0.6.2.tgz",
-      "integrity": "sha1-JCP+ZnisDF2uiFLl0OW+CMmXq8w="
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/colors/-/colors-1.1.2.tgz",
+      "integrity": "sha1-FopHAXVran9RoSzgyXv6KMCE7WM="
+    },
+    "component-emitter": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/component-emitter/-/component-emitter-1.3.0.tgz",
+      "integrity": "sha512-Rd3se6QB+sO1TwqZjscQrurpEPIfO0/yYnSin6Q/rD3mOutHvUrCAhJub3r90uNb+SESBuE0QYoB90YdfatsRg=="
     },
     "concat-map": {
       "version": "0.0.1",
       "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
       "integrity": "sha1-2Klr13/Wjfd5OnMDajug1UBdR3s="
     },
+    "copy-descriptor": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/copy-descriptor/-/copy-descriptor-0.1.1.tgz",
+      "integrity": "sha1-Z29us8OZl8LuGsOpJP1hJHSPV40="
+    },
     "core-util-is": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.2.tgz",
       "integrity": "sha1-tf1UIgqivFq1eqtxQMlAdUUDwac="
     },
-    "CSSselect": {
+    "currently-unhandled": {
       "version": "0.4.1",
-      "resolved": "https://registry.npmjs.org/CSSselect/-/CSSselect-0.4.1.tgz",
-      "integrity": "sha1-+Kt+H4QYzmPNput713ioXX7EkrI=",
+      "resolved": "https://registry.npmjs.org/currently-unhandled/-/currently-unhandled-0.4.1.tgz",
+      "integrity": "sha1-mI3zP+qxke95mmE2nddsF635V+o=",
       "requires": {
-        "CSSwhat": "0.4.7",
-        "domutils": "1.4.3"
+        "array-find-index": "^1.0.1"
       }
     },
-    "CSSwhat": {
-      "version": "0.4.7",
-      "resolved": "https://registry.npmjs.org/CSSwhat/-/CSSwhat-0.4.7.tgz",
-      "integrity": "sha1-hn2g/zn3eGEyQsRM/qg/CqTr35s="
-    },
     "dateformat": {
-      "version": "1.0.2-1.2.3",
-      "resolved": "https://registry.npmjs.org/dateformat/-/dateformat-1.0.2-1.2.3.tgz",
-      "integrity": "sha1-sCIMAt6YYXQztyhRz0fePfLNvuk="
+      "version": "1.0.12",
+      "resolved": "https://registry.npmjs.org/dateformat/-/dateformat-1.0.12.tgz",
+      "integrity": "sha1-nxJLZ1lMk3/3BpMuSmQsyo27/uk=",
+      "requires": {
+        "get-stdin": "^4.0.1",
+        "meow": "^3.3.0"
+      }
+    },
+    "debug": {
+      "version": "2.6.9",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
+      "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
+      "requires": {
+        "ms": "2.0.0"
+      }
+    },
+    "decamelize": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/decamelize/-/decamelize-1.2.0.tgz",
+      "integrity": "sha1-9lNNFRSCabIDUue+4m9QH5oZEpA="
+    },
+    "decode-uri-component": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/decode-uri-component/-/decode-uri-component-0.2.0.tgz",
+      "integrity": "sha1-6zkTMzRYd1y4TNGh+uBiEGu4dUU="
+    },
+    "define-property": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/define-property/-/define-property-2.0.2.tgz",
+      "integrity": "sha512-jwK2UV4cnPpbcG7+VRARKTZPUWowwXA8bzH5NP6ud0oeAxyYPuGZUAC7hMugpCdz4BeSZl2Dl9k66CHJ/46ZYQ==",
+      "requires": {
+        "is-descriptor": "^1.0.2",
+        "isobject": "^3.0.1"
+      },
+      "dependencies": {
+        "is-accessor-descriptor": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-1.0.0.tgz",
+          "integrity": "sha512-m5hnHTkcVsPfqx3AKlyttIPb7J+XykHvJP2B9bZDjlhLIoEq4XoK64Vg7boZlVWYK6LUY94dYPEE7Lh0ZkZKcQ==",
+          "requires": {
+            "kind-of": "^6.0.0"
+          }
+        },
+        "is-data-descriptor": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-1.0.0.tgz",
+          "integrity": "sha512-jbRXy1FmtAoCjQkVmIVYwuuqDFUbaOeDjmed1tOGPrsMhtJA4rD9tkgA0F1qJ3gRFRXcHYVkdeaP50Q5rE/jLQ==",
+          "requires": {
+            "kind-of": "^6.0.0"
+          }
+        },
+        "is-descriptor": {
+          "version": "1.0.2",
+          "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-1.0.2.tgz",
+          "integrity": "sha512-2eis5WqQGV7peooDyLmNEPUrps9+SXX5c9pL3xEB+4e9HnGuDa7mB7kHxHw4CbqS9k1T2hOH3miL8n8WtiYVtg==",
+          "requires": {
+            "is-accessor-descriptor": "^1.0.0",
+            "is-data-descriptor": "^1.0.0",
+            "kind-of": "^6.0.2"
+          }
+        }
+      }
+    },
+    "detect-file": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/detect-file/-/detect-file-1.0.0.tgz",
+      "integrity": "sha1-8NZtA2cqglyxtzvbP+YjEMjlUrc="
     },
     "dom-serializer": {
       "version": "0.0.1",
       "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-0.0.1.tgz",
       "integrity": "sha1-lYmCfx4y0iw3yCmtq9WbMkevjq8=",
       "requires": {
-        "domelementtype": "1.1.3",
-        "entities": "1.1.1"
+        "domelementtype": "~1.1.1",
+        "entities": "~1.1.1"
       },
       "dependencies": {
         "domelementtype": {
@@ -119,16 +413,16 @@
       }
     },
     "domelementtype": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-1.3.0.tgz",
-      "integrity": "sha1-sXrtguirWeUt2cGbF1bg/BhyBMI="
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-1.3.1.tgz",
+      "integrity": "sha512-BSKB+TSpMpFI/HOxCNr1O8aMOTZ8hT3pM3GQ0w/mWRmkhEDSFJkkyzz4XQsBV44BChwGkrDfMyjVD0eA2aFV3w=="
     },
     "domhandler": {
       "version": "2.2.1",
       "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-2.2.1.tgz",
       "integrity": "sha1-Wd+dzSJ+gIs2Wuc+H2aErD2Ub8I=",
       "requires": {
-        "domelementtype": "1.3.0"
+        "domelementtype": "1"
       }
     },
     "domutils": {
@@ -136,18 +430,31 @@
       "resolved": "https://registry.npmjs.org/domutils/-/domutils-1.4.3.tgz",
       "integrity": "sha1-CGVRN5bGswYDGFDhdVFrr4C3Km8=",
       "requires": {
-        "domelementtype": "1.3.0"
+        "domelementtype": "1"
       }
     },
     "entities": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/entities/-/entities-1.1.1.tgz",
-      "integrity": "sha1-blwtClYhtdra7O+AuQ7ftc13cvA="
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/entities/-/entities-1.1.2.tgz",
+      "integrity": "sha512-f2LZMYl1Fzu7YSBKg+RoROelpOaNrcGmE9AZubeDfrCEia483oW4MI4VyFd5VNHIgQ/7qm1I0wUHK1eJnn2y2w=="
+    },
+    "error-ex": {
+      "version": "1.3.2",
+      "resolved": "https://registry.npmjs.org/error-ex/-/error-ex-1.3.2.tgz",
+      "integrity": "sha512-7dFHNmqeFSEt2ZBsCriorKnn3Z2pj+fd9kmI6QoWw4//DL+icEBfc0U7qJCisqrTsKTjw4fNFy2pW9OqStD84g==",
+      "requires": {
+        "is-arrayish": "^0.2.1"
+      }
+    },
+    "escape-string-regexp": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz",
+      "integrity": "sha1-G2HAViGQqN/2rjuyzwIAyhMLhtQ="
     },
     "esprima": {
-      "version": "1.0.4",
-      "resolved": "https://registry.npmjs.org/esprima/-/esprima-1.0.4.tgz",
-      "integrity": "sha1-n1V+CPw7TSbs6d00+Pv0drYlha0="
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz",
+      "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A=="
     },
     "eventemitter2": {
       "version": "0.4.14",
@@ -159,288 +466,499 @@
       "resolved": "https://registry.npmjs.org/exit/-/exit-0.1.2.tgz",
       "integrity": "sha1-BjJjj42HfMghB9MKD/8aF8uhzQw="
     },
-    "findup-sync": {
-      "version": "0.1.3",
-      "resolved": "https://registry.npmjs.org/findup-sync/-/findup-sync-0.1.3.tgz",
-      "integrity": "sha1-fz56l7gjksZTvwZYm9hRkOk8NoM=",
+    "expand-brackets": {
+      "version": "2.1.4",
+      "resolved": "https://registry.npmjs.org/expand-brackets/-/expand-brackets-2.1.4.tgz",
+      "integrity": "sha1-t3c14xXOMPa27/D4OwQVGiJEliI=",
       "requires": {
-        "glob": "3.2.11",
-        "lodash": "2.4.2"
+        "debug": "^2.3.3",
+        "define-property": "^0.2.5",
+        "extend-shallow": "^2.0.1",
+        "posix-character-classes": "^0.1.0",
+        "regex-not": "^1.0.0",
+        "snapdragon": "^0.8.1",
+        "to-regex": "^3.0.1"
       },
       "dependencies": {
-        "glob": {
-          "version": "3.2.11",
-          "resolved": "https://registry.npmjs.org/glob/-/glob-3.2.11.tgz",
-          "integrity": "sha1-Spc/Y1uRkPcV0QmH1cAP0oFevj0=",
+        "define-property": {
+          "version": "0.2.5",
+          "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz",
+          "integrity": "sha1-w1se+RjsPJkPmlvFe+BKrOxcgRY=",
           "requires": {
-            "inherits": "2.0.3",
-            "minimatch": "0.3.0"
+            "is-descriptor": "^0.1.0"
           }
         },
-        "lodash": {
-          "version": "2.4.2",
-          "resolved": "https://registry.npmjs.org/lodash/-/lodash-2.4.2.tgz",
-          "integrity": "sha1-+t2DS5aDBz2hebPq5tnA0VBT9z4="
-        },
-        "minimatch": {
-          "version": "0.3.0",
-          "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-0.3.0.tgz",
-          "integrity": "sha1-J12O2qxPG7MyZHIInnlJyDlGmd0=",
+        "extend-shallow": {
+          "version": "2.0.1",
+          "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
+          "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=",
           "requires": {
-            "lru-cache": "2.7.3",
-            "sigmund": "1.0.1"
+            "is-extendable": "^0.1.0"
           }
         }
       }
     },
-    "getobject": {
-      "version": "0.1.0",
-      "resolved": "https://registry.npmjs.org/getobject/-/getobject-0.1.0.tgz",
-      "integrity": "sha1-BHpEl4n6Fg0Bj1SG7ZEyC27HiFw="
+    "expand-tilde": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/expand-tilde/-/expand-tilde-2.0.2.tgz",
+      "integrity": "sha1-l+gBqgUt8CRU3kawK/YhZCzchQI=",
+      "requires": {
+        "homedir-polyfill": "^1.0.1"
+      }
     },
-    "gilded-wordpress": {
-      "version": "1.0.3",
-      "resolved": "https://registry.npmjs.org/gilded-wordpress/-/gilded-wordpress-1.0.3.tgz",
-      "integrity": "sha1-kh/iJ93yWyxAgp5QUjsOMXRDsz4=",
+    "extend": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/extend/-/extend-3.0.2.tgz",
+      "integrity": "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g=="
+    },
+    "extend-shallow": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-3.0.2.tgz",
+      "integrity": "sha1-Jqcarwc7OfshJxcnRhMcJwQCjbg=",
       "requires": {
-        "async": "0.9.2",
-        "glob": "4.0.6",
-        "wordpress": "1.1.2"
+        "assign-symbols": "^1.0.0",
+        "is-extendable": "^1.0.1"
       },
       "dependencies": {
-        "async": {
-          "version": "0.9.2",
-          "resolved": "https://registry.npmjs.org/async/-/async-0.9.2.tgz",
-          "integrity": "sha1-rqdNXmHB+JlhO/ZL2mbUx48v0X0="
+        "is-extendable": {
+          "version": "1.0.1",
+          "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-1.0.1.tgz",
+          "integrity": "sha512-arnXMxT1hhoKo9k1LZdmlNyJdDDfy2v0fXjFlmok4+i8ul/6WlbVge9bhM74OpNPQPMGUToDtz+KXa1PneJxOA==",
+          "requires": {
+            "is-plain-object": "^2.0.4"
+          }
+        }
+      }
+    },
+    "extglob": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/extglob/-/extglob-2.0.4.tgz",
+      "integrity": "sha512-Nmb6QXkELsuBr24CJSkilo6UHHgbekK5UiZgfE6UHD3Eb27YC6oD+bhcT+tJ6cl8dmsgdQxnWlcry8ksBIBLpw==",
+      "requires": {
+        "array-unique": "^0.3.2",
+        "define-property": "^1.0.0",
+        "expand-brackets": "^2.1.4",
+        "extend-shallow": "^2.0.1",
+        "fragment-cache": "^0.2.1",
+        "regex-not": "^1.0.0",
+        "snapdragon": "^0.8.1",
+        "to-regex": "^3.0.1"
+      },
+      "dependencies": {
+        "define-property": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/define-property/-/define-property-1.0.0.tgz",
+          "integrity": "sha1-dp66rz9KY6rTr56NMEybvnm/sOY=",
+          "requires": {
+            "is-descriptor": "^1.0.0"
+          }
         },
-        "glob": {
-          "version": "4.0.6",
-          "resolved": "https://registry.npmjs.org/glob/-/glob-4.0.6.tgz",
-          "integrity": "sha1-aVxQvdTi+1xdNwsJHziNNwfikac=",
+        "extend-shallow": {
+          "version": "2.0.1",
+          "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
+          "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=",
           "requires": {
-            "graceful-fs": "3.0.11",
-            "inherits": "2.0.3",
-            "minimatch": "1.0.0",
-            "once": "1.4.0"
+            "is-extendable": "^0.1.0"
           }
         },
-        "graceful-fs": {
-          "version": "3.0.11",
-          "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-3.0.11.tgz",
-          "integrity": "sha1-dhPHeKGv6mLyXGMKCG1/Osu92Bg=",
+        "is-accessor-descriptor": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-1.0.0.tgz",
+          "integrity": "sha512-m5hnHTkcVsPfqx3AKlyttIPb7J+XykHvJP2B9bZDjlhLIoEq4XoK64Vg7boZlVWYK6LUY94dYPEE7Lh0ZkZKcQ==",
           "requires": {
-            "natives": "1.1.0"
+            "kind-of": "^6.0.0"
           }
         },
-        "minimatch": {
+        "is-data-descriptor": {
           "version": "1.0.0",
-          "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-1.0.0.tgz",
-          "integrity": "sha1-4N0hILSeG3JM6NcUxSCCKpQ4V20=",
+          "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-1.0.0.tgz",
+          "integrity": "sha512-jbRXy1FmtAoCjQkVmIVYwuuqDFUbaOeDjmed1tOGPrsMhtJA4rD9tkgA0F1qJ3gRFRXcHYVkdeaP50Q5rE/jLQ==",
+          "requires": {
+            "kind-of": "^6.0.0"
+          }
+        },
+        "is-descriptor": {
+          "version": "1.0.2",
+          "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-1.0.2.tgz",
+          "integrity": "sha512-2eis5WqQGV7peooDyLmNEPUrps9+SXX5c9pL3xEB+4e9HnGuDa7mB7kHxHw4CbqS9k1T2hOH3miL8n8WtiYVtg==",
           "requires": {
-            "lru-cache": "2.7.3",
-            "sigmund": "1.0.1"
+            "is-accessor-descriptor": "^1.0.0",
+            "is-data-descriptor": "^1.0.0",
+            "kind-of": "^6.0.2"
           }
         }
       }
     },
-    "glob": {
-      "version": "3.1.21",
-      "resolved": "https://registry.npmjs.org/glob/-/glob-3.1.21.tgz",
-      "integrity": "sha1-0p4KBV3qUTj00H7UDomC6DwgZs0=",
+    "fill-range": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-4.0.0.tgz",
+      "integrity": "sha1-1USBHUKPmOsGpj3EAtJAPDKMOPc=",
       "requires": {
-        "graceful-fs": "1.2.3",
-        "inherits": "1.0.2",
-        "minimatch": "0.2.14"
+        "extend-shallow": "^2.0.1",
+        "is-number": "^3.0.0",
+        "repeat-string": "^1.6.1",
+        "to-regex-range": "^2.1.0"
       },
       "dependencies": {
-        "inherits": {
-          "version": "1.0.2",
-          "resolved": "https://registry.npmjs.org/inherits/-/inherits-1.0.2.tgz",
-          "integrity": "sha1-ykMJ2t7mtUzAuNJH6NfHoJdb3Js="
+        "extend-shallow": {
+          "version": "2.0.1",
+          "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
+          "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=",
+          "requires": {
+            "is-extendable": "^0.1.0"
+          }
         }
       }
     },
-    "graceful-fs": {
-      "version": "1.2.3",
-      "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-1.2.3.tgz",
-      "integrity": "sha1-FaSAaldUfLLS2/J/QuiajDRRs2Q="
-    },
-    "grunt": {
-      "version": "0.4.5",
-      "resolved": "https://registry.npmjs.org/grunt/-/grunt-0.4.5.tgz",
-      "integrity": "sha1-VpN81RlDJK3/bSB2MYMqnWuk5/A=",
-      "requires": {
-        "async": "0.1.22",
-        "coffee-script": "1.3.3",
-        "colors": "0.6.2",
-        "dateformat": "1.0.2-1.2.3",
-        "eventemitter2": "0.4.14",
-        "exit": "0.1.2",
-        "findup-sync": "0.1.3",
-        "getobject": "0.1.0",
-        "glob": "3.1.21",
-        "grunt-legacy-log": "0.1.3",
-        "grunt-legacy-util": "0.2.0",
-        "hooker": "0.2.3",
-        "iconv-lite": "0.2.11",
-        "js-yaml": "2.0.5",
-        "lodash": "0.9.2",
-        "minimatch": "0.2.14",
-        "nopt": "1.0.10",
-        "rimraf": "2.2.8",
-        "underscore.string": "2.2.1",
-        "which": "1.0.9"
+    "find-up": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/find-up/-/find-up-1.1.2.tgz",
+      "integrity": "sha1-ay6YIrGizgpgq2TWEOzK1TyyTQ8=",
+      "requires": {
+        "path-exists": "^2.0.0",
+        "pinkie-promise": "^2.0.0"
       }
     },
-    "grunt-check-modules": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/grunt-check-modules/-/grunt-check-modules-1.0.0.tgz",
-      "integrity": "sha1-Y/9erkYTF5tKifaozTcfekAfd4I="
-    },
-    "grunt-cli": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/grunt-cli/-/grunt-cli-1.1.0.tgz",
-      "integrity": "sha1-r9eWmTTd8zYg6ER+3B+pTlHlWjQ=",
+    "findup-sync": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/findup-sync/-/findup-sync-0.3.0.tgz",
+      "integrity": "sha1-N5MKpdgWt3fANEXhlmzGeQpMCxY=",
       "requires": {
-        "findup-sync": "0.3.0",
-        "nopt": "3.0.6",
-        "resolve": "1.1.7"
+        "glob": "~5.0.0"
       },
       "dependencies": {
-        "findup-sync": {
-          "version": "0.3.0",
-          "resolved": "https://registry.npmjs.org/findup-sync/-/findup-sync-0.3.0.tgz",
-          "integrity": "sha1-N5MKpdgWt3fANEXhlmzGeQpMCxY=",
-          "requires": {
-            "glob": "5.0.15"
-          }
-        },
         "glob": {
           "version": "5.0.15",
           "resolved": "https://registry.npmjs.org/glob/-/glob-5.0.15.tgz",
           "integrity": "sha1-G8k2ueAvSmA/zCIuz3Yz0wuLk7E=",
           "requires": {
-            "inflight": "1.0.6",
-            "inherits": "2.0.3",
-            "minimatch": "3.0.4",
-            "once": "1.4.0",
-            "path-is-absolute": "1.0.1"
-          }
-        },
-        "minimatch": {
-          "version": "3.0.4",
-          "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.0.4.tgz",
-          "integrity": "sha512-yJHVQEhyqPLUTgt9B83PXu6W3rx4MvvHvSUvToogpwoGDOUQ+yDrR0HRot+yOCdCO7u4hX3pWft6kWBBcqh0UA==",
-          "requires": {
-            "brace-expansion": "1.1.8"
-          }
-        },
-        "nopt": {
-          "version": "3.0.6",
-          "resolved": "https://registry.npmjs.org/nopt/-/nopt-3.0.6.tgz",
-          "integrity": "sha1-xkZdvwirzU2zWTF/eaxopkayj/k=",
-          "requires": {
-            "abbrev": "1.1.0"
+            "inflight": "^1.0.4",
+            "inherits": "2",
+            "minimatch": "2 || 3",
+            "once": "^1.3.0",
+            "path-is-absolute": "^1.0.0"
           }
         }
       }
     },
-    "grunt-jquery-content": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/grunt-jquery-content/-/grunt-jquery-content-3.0.1.tgz",
-      "integrity": "sha1-aHdrx0G1SVEdaPBouVCsizd+g90=",
+    "fined": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/fined/-/fined-1.2.0.tgz",
+      "integrity": "sha512-ZYDqPLGxDkDhDZBjZBb+oD1+j0rA4E0pXY50eplAAOPg2N/gUBSSk5IM1/QhPfyVo19lJ+CvXpqfvk+b2p/8Ng==",
       "requires": {
-        "async": "0.9.0",
-        "cheerio": "0.17.0",
-        "grunt-check-modules": "1.0.0",
-        "grunt-wordpress": "2.1.2",
-        "he": "0.5.0",
-        "highlight.js": "7.3.0",
-        "marked": "0.3.2",
-        "rimraf": "2.2.8",
-        "spawnback": "1.0.0",
-        "which": "1.0.5",
-        "wordpress": "1.1.2"
-      },
-      "dependencies": {
-        "async": {
-          "version": "0.9.0",
-          "resolved": "https://registry.npmjs.org/async/-/async-0.9.0.tgz",
-          "integrity": "sha1-rDYTsdqb7RtHUQu0ZRuJMeRxRsc="
-        },
-        "which": {
-          "version": "1.0.5",
-          "resolved": "https://registry.npmjs.org/which/-/which-1.0.5.tgz",
-          "integrity": "sha1-VjDWgZ3aaS8UZEYueVbLQsCEJzk="
-        }
+        "expand-tilde": "^2.0.2",
+        "is-plain-object": "^2.0.3",
+        "object.defaults": "^1.1.0",
+        "object.pick": "^1.2.0",
+        "parse-filepath": "^1.0.1"
       }
     },
-    "grunt-legacy-log": {
-      "version": "0.1.3",
-      "resolved": "https://registry.npmjs.org/grunt-legacy-log/-/grunt-legacy-log-0.1.3.tgz",
-      "integrity": "sha1-7ClCboAwIa9ZAp+H0vnNczWgVTE=",
-      "requires": {
-        "colors": "0.6.2",
-        "grunt-legacy-log-utils": "0.1.1",
-        "hooker": "0.2.3",
-        "lodash": "2.4.2",
-        "underscore.string": "2.3.3"
-      },
-      "dependencies": {
-        "lodash": {
-          "version": "2.4.2",
-          "resolved": "https://registry.npmjs.org/lodash/-/lodash-2.4.2.tgz",
-          "integrity": "sha1-+t2DS5aDBz2hebPq5tnA0VBT9z4="
-        },
-        "underscore.string": {
-          "version": "2.3.3",
-          "resolved": "https://registry.npmjs.org/underscore.string/-/underscore.string-2.3.3.tgz",
-          "integrity": "sha1-ccCL9rQosRM/N+ePo6Icgvcymw0="
-        }
-      }
+    "flagged-respawn": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/flagged-respawn/-/flagged-respawn-1.0.1.tgz",
+      "integrity": "sha512-lNaHNVymajmk0OJMBn8fVUAU1BtDeKIqKoVhk4xAALB57aALg6b4W0MfJ/cUE0g9YBXy5XhSlPIpYIJ7HaY/3Q=="
     },
-    "grunt-legacy-log-utils": {
-      "version": "0.1.1",
-      "resolved": "https://registry.npmjs.org/grunt-legacy-log-utils/-/grunt-legacy-log-utils-0.1.1.tgz",
-      "integrity": "sha1-wHBrndkGThFvNvI/5OawSGcsD34=",
+    "for-in": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/for-in/-/for-in-1.0.2.tgz",
+      "integrity": "sha1-gQaNKVqBQuwKxybG4iAMMPttXoA="
+    },
+    "for-own": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/for-own/-/for-own-1.0.0.tgz",
+      "integrity": "sha1-xjMy9BXO3EsE2/5wz4NklMU8tEs=",
       "requires": {
-        "colors": "0.6.2",
-        "lodash": "2.4.2",
-        "underscore.string": "2.3.3"
-      },
-      "dependencies": {
-        "lodash": {
-          "version": "2.4.2",
-          "resolved": "https://registry.npmjs.org/lodash/-/lodash-2.4.2.tgz",
-          "integrity": "sha1-+t2DS5aDBz2hebPq5tnA0VBT9z4="
-        },
-        "underscore.string": {
-          "version": "2.3.3",
-          "resolved": "https://registry.npmjs.org/underscore.string/-/underscore.string-2.3.3.tgz",
-          "integrity": "sha1-ccCL9rQosRM/N+ePo6Icgvcymw0="
-        }
+        "for-in": "^1.0.1"
       }
     },
-    "grunt-legacy-util": {
-      "version": "0.2.0",
-      "resolved": "https://registry.npmjs.org/grunt-legacy-util/-/grunt-legacy-util-0.2.0.tgz",
-      "integrity": "sha1-kzJIhNv343qf98Am3/RR2UqeVUs=",
+    "fragment-cache": {
+      "version": "0.2.1",
+      "resolved": "https://registry.npmjs.org/fragment-cache/-/fragment-cache-0.2.1.tgz",
+      "integrity": "sha1-QpD60n8T6Jvn8zeZxrxaCr//DRk=",
       "requires": {
-        "async": "0.1.22",
-        "exit": "0.1.2",
-        "getobject": "0.1.0",
-        "hooker": "0.2.3",
-        "lodash": "0.9.2",
-        "underscore.string": "2.2.1",
-        "which": "1.0.9"
+        "map-cache": "^0.2.2"
+      }
+    },
+    "fs.realpath": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz",
+      "integrity": "sha1-FQStJSMVjKpA20onh8sBQRmU6k8="
+    },
+    "get-stdin": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/get-stdin/-/get-stdin-4.0.1.tgz",
+      "integrity": "sha1-uWjGsKBDhDJJAui/Gl3zJXmkUP4="
+    },
+    "get-value": {
+      "version": "2.0.6",
+      "resolved": "https://registry.npmjs.org/get-value/-/get-value-2.0.6.tgz",
+      "integrity": "sha1-3BXKHGcjh8p2vTesCjlbogQqLCg="
+    },
+    "getobject": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/getobject/-/getobject-0.1.0.tgz",
+      "integrity": "sha1-BHpEl4n6Fg0Bj1SG7ZEyC27HiFw="
+    },
+    "gilded-wordpress": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/gilded-wordpress/-/gilded-wordpress-1.0.5.tgz",
+      "integrity": "sha1-EnBg4iv/x6uo+++Xq/Pr+7fsScE=",
+      "requires": {
+        "async": "^0.9.0",
+        "glob": "^4.0.6",
+        "wordpress": "^1.1.2"
+      },
+      "dependencies": {
+        "async": {
+          "version": "0.9.2",
+          "resolved": "https://registry.npmjs.org/async/-/async-0.9.2.tgz",
+          "integrity": "sha1-rqdNXmHB+JlhO/ZL2mbUx48v0X0="
+        },
+        "glob": {
+          "version": "4.5.3",
+          "resolved": "https://registry.npmjs.org/glob/-/glob-4.5.3.tgz",
+          "integrity": "sha1-xstz0yJsHv7wTePFbQEvAzd+4V8=",
+          "requires": {
+            "inflight": "^1.0.4",
+            "inherits": "2",
+            "minimatch": "^2.0.1",
+            "once": "^1.3.0"
+          }
+        },
+        "minimatch": {
+          "version": "2.0.10",
+          "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-2.0.10.tgz",
+          "integrity": "sha1-jQh8OcazjAAbl/ynzm0OHoCvusc=",
+          "requires": {
+            "brace-expansion": "^1.0.0"
+          }
+        }
+      }
+    },
+    "glob": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-7.0.6.tgz",
+      "integrity": "sha1-IRuvr0nlJbjNkyYNFKsTYVKz9Xo=",
+      "requires": {
+        "fs.realpath": "^1.0.0",
+        "inflight": "^1.0.4",
+        "inherits": "2",
+        "minimatch": "^3.0.2",
+        "once": "^1.3.0",
+        "path-is-absolute": "^1.0.0"
+      }
+    },
+    "global-modules": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/global-modules/-/global-modules-1.0.0.tgz",
+      "integrity": "sha512-sKzpEkf11GpOFuw0Zzjzmt4B4UZwjOcG757PPvrfhxcLFbq0wpsgpOqxpxtxFiCG4DtG93M6XRVbF2oGdev7bg==",
+      "requires": {
+        "global-prefix": "^1.0.1",
+        "is-windows": "^1.0.1",
+        "resolve-dir": "^1.0.0"
+      }
+    },
+    "global-prefix": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/global-prefix/-/global-prefix-1.0.2.tgz",
+      "integrity": "sha1-2/dDxsFJklk8ZVVoy2btMsASLr4=",
+      "requires": {
+        "expand-tilde": "^2.0.2",
+        "homedir-polyfill": "^1.0.1",
+        "ini": "^1.3.4",
+        "is-windows": "^1.0.1",
+        "which": "^1.2.14"
+      }
+    },
+    "graceful-fs": {
+      "version": "4.2.2",
+      "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.2.tgz",
+      "integrity": "sha512-IItsdsea19BoLC7ELy13q1iJFNmd7ofZH5+X/pJr90/nRoPEX0DJo1dHDbgtYWOhJhcCgMDTOw84RZ72q6lB+Q=="
+    },
+    "grunt": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/grunt/-/grunt-1.0.4.tgz",
+      "integrity": "sha512-PYsMOrOC+MsdGEkFVwMaMyc6Ob7pKmq+deg1Sjr+vvMWp35sztfwKE7qoN51V+UEtHsyNuMcGdgMLFkBHvMxHQ==",
+      "requires": {
+        "coffeescript": "~1.10.0",
+        "dateformat": "~1.0.12",
+        "eventemitter2": "~0.4.13",
+        "exit": "~0.1.1",
+        "findup-sync": "~0.3.0",
+        "glob": "~7.0.0",
+        "grunt-cli": "~1.2.0",
+        "grunt-known-options": "~1.1.0",
+        "grunt-legacy-log": "~2.0.0",
+        "grunt-legacy-util": "~1.1.1",
+        "iconv-lite": "~0.4.13",
+        "js-yaml": "~3.13.0",
+        "minimatch": "~3.0.2",
+        "mkdirp": "~0.5.1",
+        "nopt": "~3.0.6",
+        "path-is-absolute": "~1.0.0",
+        "rimraf": "~2.6.2"
+      },
+      "dependencies": {
+        "grunt-cli": {
+          "version": "1.2.0",
+          "resolved": "https://registry.npmjs.org/grunt-cli/-/grunt-cli-1.2.0.tgz",
+          "integrity": "sha1-VisRnrsGndtGSs4oRVAb6Xs1tqg=",
+          "requires": {
+            "findup-sync": "~0.3.0",
+            "grunt-known-options": "~1.1.0",
+            "nopt": "~3.0.6",
+            "resolve": "~1.1.0"
+          }
+        },
+        "resolve": {
+          "version": "1.1.7",
+          "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.1.7.tgz",
+          "integrity": "sha1-IDEU2CrSxe2ejgQRs5ModeiJ6Xs="
+        }
+      }
+    },
+    "grunt-check-modules": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/grunt-check-modules/-/grunt-check-modules-1.1.0.tgz",
+      "integrity": "sha1-fBZB28ZlSGdqbVl5Ga35C3s11kQ="
+    },
+    "grunt-cli": {
+      "version": "1.3.2",
+      "resolved": "https://registry.npmjs.org/grunt-cli/-/grunt-cli-1.3.2.tgz",
+      "integrity": "sha512-8OHDiZZkcptxVXtMfDxJvmN7MVJNE8L/yIcPb4HB7TlyFD1kDvjHrb62uhySsU14wJx9ORMnTuhRMQ40lH/orQ==",
+      "requires": {
+        "grunt-known-options": "~1.1.0",
+        "interpret": "~1.1.0",
+        "liftoff": "~2.5.0",
+        "nopt": "~4.0.1",
+        "v8flags": "~3.1.1"
+      },
+      "dependencies": {
+        "nopt": {
+          "version": "4.0.1",
+          "resolved": "https://registry.npmjs.org/nopt/-/nopt-4.0.1.tgz",
+          "integrity": "sha1-0NRoWv1UFRk8jHUFYC0NF81kR00=",
+          "requires": {
+            "abbrev": "1",
+            "osenv": "^0.1.4"
+          }
+        }
+      }
+    },
+    "grunt-jquery-content": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/grunt-jquery-content/-/grunt-jquery-content-3.0.3.tgz",
+      "integrity": "sha1-sqFpjFTz6QZyO3cPuuRJ/ZIRXqM=",
+      "requires": {
+        "async": "0.9.0",
+        "cheerio": "0.17.0",
+        "grunt-check-modules": "1.1.0",
+        "grunt-wordpress": "2.1.3",
+        "he": "0.5.0",
+        "highlight.js": "7.3.0",
+        "marked": "0.3.2",
+        "rimraf": "2.2.8",
+        "spawnback": "1.0.0",
+        "which": "1.0.5",
+        "wordpress": "1.3.0"
+      },
+      "dependencies": {
+        "async": {
+          "version": "0.9.0",
+          "resolved": "https://registry.npmjs.org/async/-/async-0.9.0.tgz",
+          "integrity": "sha1-rDYTsdqb7RtHUQu0ZRuJMeRxRsc="
+        },
+        "rimraf": {
+          "version": "2.2.8",
+          "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-2.2.8.tgz",
+          "integrity": "sha1-5Dm+Kq7jJzIZUnMPmaiSnk/FBYI="
+        },
+        "which": {
+          "version": "1.0.5",
+          "resolved": "https://registry.npmjs.org/which/-/which-1.0.5.tgz",
+          "integrity": "sha1-VjDWgZ3aaS8UZEYueVbLQsCEJzk="
+        }
+      }
+    },
+    "grunt-known-options": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/grunt-known-options/-/grunt-known-options-1.1.1.tgz",
+      "integrity": "sha512-cHwsLqoighpu7TuYj5RonnEuxGVFnztcUqTqp5rXFGYL4OuPFofwC4Ycg7n9fYwvK6F5WbYgeVOwph9Crs2fsQ=="
+    },
+    "grunt-legacy-log": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/grunt-legacy-log/-/grunt-legacy-log-2.0.0.tgz",
+      "integrity": "sha512-1m3+5QvDYfR1ltr8hjiaiNjddxGdQWcH0rw1iKKiQnF0+xtgTazirSTGu68RchPyh1OBng1bBUjLmX8q9NpoCw==",
+      "requires": {
+        "colors": "~1.1.2",
+        "grunt-legacy-log-utils": "~2.0.0",
+        "hooker": "~0.2.3",
+        "lodash": "~4.17.5"
+      }
+    },
+    "grunt-legacy-log-utils": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/grunt-legacy-log-utils/-/grunt-legacy-log-utils-2.0.1.tgz",
+      "integrity": "sha512-o7uHyO/J+i2tXG8r2bZNlVk20vlIFJ9IEYyHMCQGfWYru8Jv3wTqKZzvV30YW9rWEjq0eP3cflQ1qWojIe9VFA==",
+      "requires": {
+        "chalk": "~2.4.1",
+        "lodash": "~4.17.10"
+      }
+    },
+    "grunt-legacy-util": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/grunt-legacy-util/-/grunt-legacy-util-1.1.1.tgz",
+      "integrity": "sha512-9zyA29w/fBe6BIfjGENndwoe1Uy31BIXxTH3s8mga0Z5Bz2Sp4UCjkeyv2tI449ymkx3x26B+46FV4fXEddl5A==",
+      "requires": {
+        "async": "~1.5.2",
+        "exit": "~0.1.1",
+        "getobject": "~0.1.0",
+        "hooker": "~0.2.3",
+        "lodash": "~4.17.10",
+        "underscore.string": "~3.3.4",
+        "which": "~1.3.0"
       }
     },
     "grunt-wordpress": {
-      "version": "2.1.2",
-      "resolved": "https://registry.npmjs.org/grunt-wordpress/-/grunt-wordpress-2.1.2.tgz",
-      "integrity": "sha1-ue3Lv5jp6HM9F6gsMmWf2zbO2LE=",
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/grunt-wordpress/-/grunt-wordpress-2.1.3.tgz",
+      "integrity": "sha1-fNI9lBN9DDe+PybfZ4Y2FPUABXA=",
+      "requires": {
+        "gilded-wordpress": "1.0.5"
+      }
+    },
+    "has-flag": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
+      "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0="
+    },
+    "has-value": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/has-value/-/has-value-1.0.0.tgz",
+      "integrity": "sha1-GLKB2lhbHFxR3vJMkw7SmgvmsXc=",
       "requires": {
-        "gilded-wordpress": "1.0.3"
+        "get-value": "^2.0.6",
+        "has-values": "^1.0.0",
+        "isobject": "^3.0.0"
+      }
+    },
+    "has-values": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/has-values/-/has-values-1.0.0.tgz",
+      "integrity": "sha1-lbC2P+whRmGab+V/51Yo1aOe/k8=",
+      "requires": {
+        "is-number": "^3.0.0",
+        "kind-of": "^4.0.0"
+      },
+      "dependencies": {
+        "kind-of": {
+          "version": "4.0.0",
+          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-4.0.0.tgz",
+          "integrity": "sha1-IIE989cSkosgc3hpGkUGb65y3Vc=",
+          "requires": {
+            "is-buffer": "^1.1.5"
+          }
+        }
       }
     },
     "he": {
@@ -453,21 +971,34 @@
       "resolved": "https://registry.npmjs.org/highlight.js/-/highlight.js-7.3.0.tgz",
       "integrity": "sha1-bF8PZOcHj2ZAK82/yJEQw/0bqZ8="
     },
+    "homedir-polyfill": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/homedir-polyfill/-/homedir-polyfill-1.0.3.tgz",
+      "integrity": "sha512-eSmmWE5bZTK2Nou4g0AI3zZ9rswp7GRKoKXS1BLUkvPviOqs4YTN1djQIqrXy9k5gEtdLPy86JjRwsNM9tnDcA==",
+      "requires": {
+        "parse-passwd": "^1.0.0"
+      }
+    },
     "hooker": {
       "version": "0.2.3",
       "resolved": "https://registry.npmjs.org/hooker/-/hooker-0.2.3.tgz",
       "integrity": "sha1-uDT3I8xKJCqmWWNFnfbZhMXT2Vk="
     },
+    "hosted-git-info": {
+      "version": "2.8.4",
+      "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-2.8.4.tgz",
+      "integrity": "sha512-pzXIvANXEFrc5oFFXRMkbLPQ2rXRoDERwDLyrcUxGhaZhgP54BBSl9Oheh7Vv0T090cszWBxPjkQQ5Sq1PbBRQ=="
+    },
     "htmlparser2": {
       "version": "3.7.3",
       "resolved": "https://registry.npmjs.org/htmlparser2/-/htmlparser2-3.7.3.tgz",
       "integrity": "sha1-amTHdjfAjG8w7CqBV6UzM758sF4=",
       "requires": {
-        "domelementtype": "1.3.0",
-        "domhandler": "2.2.1",
-        "domutils": "1.5.1",
-        "entities": "1.0.0",
-        "readable-stream": "1.1.14"
+        "domelementtype": "1",
+        "domhandler": "2.2",
+        "domutils": "1.5",
+        "entities": "1.0",
+        "readable-stream": "1.1"
       },
       "dependencies": {
         "domutils": {
@@ -475,8 +1006,8 @@
           "resolved": "https://registry.npmjs.org/domutils/-/domutils-1.5.1.tgz",
           "integrity": "sha1-3NhIiib1Y9YQeeSMn3t+Mjc2gs8=",
           "requires": {
-            "dom-serializer": "0.0.1",
-            "domelementtype": "1.3.0"
+            "dom-serializer": "0",
+            "domelementtype": "1"
           }
         },
         "entities": {
@@ -487,179 +1018,1190 @@
       }
     },
     "iconv-lite": {
-      "version": "0.2.11",
-      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.2.11.tgz",
-      "integrity": "sha1-HOYKOleGSiktEyH/RgnKS7llrcg="
+      "version": "0.4.24",
+      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz",
+      "integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==",
+      "requires": {
+        "safer-buffer": ">= 2.1.2 < 3"
+      }
+    },
+    "indent-string": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/indent-string/-/indent-string-2.1.0.tgz",
+      "integrity": "sha1-ji1INIdCEhtKghi3oTfppSBJ3IA=",
+      "requires": {
+        "repeating": "^2.0.0"
+      }
     },
     "inflight": {
       "version": "1.0.6",
       "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz",
       "integrity": "sha1-Sb1jMdfQLQwJvJEKEHW6gWW1bfk=",
       "requires": {
-        "once": "1.4.0",
-        "wrappy": "1.0.2"
+        "once": "^1.3.0",
+        "wrappy": "1"
       }
     },
     "inherits": {
-      "version": "2.0.3",
-      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.3.tgz",
-      "integrity": "sha1-Yzwsg+PaQqUC9SRmAiSA9CCCYd4="
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="
     },
-    "isarray": {
-      "version": "0.0.1",
-      "resolved": "https://registry.npmjs.org/isarray/-/isarray-0.0.1.tgz",
-      "integrity": "sha1-ihis/Kmo9Bd+Cav8YDiTmwXR7t8="
+    "ini": {
+      "version": "1.3.5",
+      "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.5.tgz",
+      "integrity": "sha512-RZY5huIKCMRWDUqZlEi72f/lmXKMvuszcMBduliQ3nnWbx9X/ZBQO7DijMEYS9EhHBb2qacRUMtC7svLwe0lcw=="
     },
-    "js-yaml": {
-      "version": "2.0.5",
-      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-2.0.5.tgz",
-      "integrity": "sha1-olrmUJmZ6X3yeMZxnaEb0Gh3Q6g=",
+    "interpret": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/interpret/-/interpret-1.1.0.tgz",
+      "integrity": "sha1-ftGxQQxqDg94z5XTuEQMY/eLhhQ="
+    },
+    "is-absolute": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/is-absolute/-/is-absolute-1.0.0.tgz",
+      "integrity": "sha512-dOWoqflvcydARa360Gvv18DZ/gRuHKi2NU/wU5X1ZFzdYfH29nkiNZsF3mp4OJ3H4yo9Mx8A/uAGNzpzPN3yBA==",
       "requires": {
-        "argparse": "0.1.16",
-        "esprima": "1.0.4"
+        "is-relative": "^1.0.0",
+        "is-windows": "^1.0.1"
       }
     },
-    "lodash": {
-      "version": "0.9.2",
-      "resolved": "https://registry.npmjs.org/lodash/-/lodash-0.9.2.tgz",
-      "integrity": "sha1-jzSZxSRdNG1oLlsNO0B2fgnxqSw="
+    "is-accessor-descriptor": {
+      "version": "0.1.6",
+      "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-0.1.6.tgz",
+      "integrity": "sha1-qeEss66Nh2cn7u84Q/igiXtcmNY=",
+      "requires": {
+        "kind-of": "^3.0.2"
+      },
+      "dependencies": {
+        "kind-of": {
+          "version": "3.2.2",
+          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz",
+          "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=",
+          "requires": {
+            "is-buffer": "^1.1.5"
+          }
+        }
+      }
     },
-    "lru-cache": {
-      "version": "2.7.3",
-      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-2.7.3.tgz",
-      "integrity": "sha1-bUUk6LlV+V1PW1iFHOId1y+06VI="
+    "is-arrayish": {
+      "version": "0.2.1",
+      "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.2.1.tgz",
+      "integrity": "sha1-d8mYQFJ6qOyxqLppe4BkWnqSap0="
     },
-    "marked": {
-      "version": "0.3.2",
-      "resolved": "https://registry.npmjs.org/marked/-/marked-0.3.2.tgz",
-      "integrity": "sha1-AV2xWIZEOPJKZL3WGgQotBhwbQk="
+    "is-buffer": {
+      "version": "1.1.6",
+      "resolved": "https://registry.npmjs.org/is-buffer/-/is-buffer-1.1.6.tgz",
+      "integrity": "sha512-NcdALwpXkTm5Zvvbk7owOUSvVvBKDgKP5/ewfXEznmQFfs4ZRmanOeKBTjRVjka3QFoN6XJ+9F3USqfHqTaU5w=="
     },
-    "minimatch": {
-      "version": "0.2.14",
-      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-0.2.14.tgz",
-      "integrity": "sha1-x054BXT2PG+aCQ6Q775u9TpqdWo=",
+    "is-data-descriptor": {
+      "version": "0.1.4",
+      "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-0.1.4.tgz",
+      "integrity": "sha1-C17mSDiOLIYCgueT8YVv7D8wG1Y=",
       "requires": {
-        "lru-cache": "2.7.3",
-        "sigmund": "1.0.1"
+        "kind-of": "^3.0.2"
+      },
+      "dependencies": {
+        "kind-of": {
+          "version": "3.2.2",
+          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz",
+          "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=",
+          "requires": {
+            "is-buffer": "^1.1.5"
+          }
+        }
       }
     },
-    "natives": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/natives/-/natives-1.1.0.tgz",
-      "integrity": "sha1-6f+EFBimsux6SV6TmYT3jxY+bjE="
+    "is-descriptor": {
+      "version": "0.1.6",
+      "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-0.1.6.tgz",
+      "integrity": "sha512-avDYr0SB3DwO9zsMov0gKCESFYqCnE4hq/4z3TdUlukEy5t9C0YRq7HLrsN52NAcqXKaepeCD0n+B0arnVG3Hg==",
+      "requires": {
+        "is-accessor-descriptor": "^0.1.6",
+        "is-data-descriptor": "^0.1.4",
+        "kind-of": "^5.0.0"
+      },
+      "dependencies": {
+        "kind-of": {
+          "version": "5.1.0",
+          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-5.1.0.tgz",
+          "integrity": "sha512-NGEErnH6F2vUuXDh+OlbcKW7/wOcfdRHaZ7VWtqCztfHri/++YKmP51OdWeGPuqCOba6kk2OTe5d02VmTB80Pw=="
+        }
+      }
     },
-    "nopt": {
-      "version": "1.0.10",
-      "resolved": "https://registry.npmjs.org/nopt/-/nopt-1.0.10.tgz",
-      "integrity": "sha1-bd0hvSoxQXuScn3Vhfim83YI6+4=",
+    "is-extendable": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-0.1.1.tgz",
+      "integrity": "sha1-YrEQ4omkcUGOPsNqYX1HLjAd/Ik="
+    },
+    "is-extglob": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
+      "integrity": "sha1-qIwCU1eR8C7TfHahueqXc8gz+MI="
+    },
+    "is-finite": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/is-finite/-/is-finite-1.0.2.tgz",
+      "integrity": "sha1-zGZ3aVYCvlUO8R6LSqYwU0K20Ko=",
       "requires": {
-        "abbrev": "1.1.0"
+        "number-is-nan": "^1.0.0"
       }
     },
-    "once": {
-      "version": "1.4.0",
-      "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
-      "integrity": "sha1-WDsap3WWHUsROsF9nFC6753Xa9E=",
+    "is-glob": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-3.1.0.tgz",
+      "integrity": "sha1-e6WuJCF4BKxwcHuWkiVnSGzD6Eo=",
       "requires": {
-        "wrappy": "1.0.2"
+        "is-extglob": "^2.1.0"
       }
     },
-    "path-is-absolute": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz",
-      "integrity": "sha1-F0uSaHNVNP+8es5r9TpanhtcX18="
+    "is-number": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/is-number/-/is-number-3.0.0.tgz",
+      "integrity": "sha1-JP1iAaR4LPUFYcgQJ2r8fRLXEZU=",
+      "requires": {
+        "kind-of": "^3.0.2"
+      },
+      "dependencies": {
+        "kind-of": {
+          "version": "3.2.2",
+          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz",
+          "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=",
+          "requires": {
+            "is-buffer": "^1.1.5"
+          }
+        }
+      }
     },
-    "readable-stream": {
-      "version": "1.1.14",
-      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-1.1.14.tgz",
-      "integrity": "sha1-fPTFTvZI44EwhMY23SB54WbAgdk=",
+    "is-plain-object": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/is-plain-object/-/is-plain-object-2.0.4.tgz",
+      "integrity": "sha512-h5PpgXkWitc38BBMYawTYMWJHFZJVnBquFE57xFpjB8pJFiF6gZ+bU+WyI/yqXiFR5mdLsgYNaPe8uao6Uv9Og==",
       "requires": {
-        "core-util-is": "1.0.2",
-        "inherits": "2.0.3",
-        "isarray": "0.0.1",
-        "string_decoder": "0.10.31"
+        "isobject": "^3.0.1"
       }
     },
-    "resolve": {
-      "version": "1.1.7",
-      "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.1.7.tgz",
-      "integrity": "sha1-IDEU2CrSxe2ejgQRs5ModeiJ6Xs="
+    "is-relative": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/is-relative/-/is-relative-1.0.0.tgz",
+      "integrity": "sha512-Kw/ReK0iqwKeu0MITLFuj0jbPAmEiOsIwyIXvvbfa6QfmN9pkD1M+8pdk7Rl/dTKbH34/XBFMbgD4iMJhLQbGA==",
+      "requires": {
+        "is-unc-path": "^1.0.0"
+      }
     },
-    "rimraf": {
-      "version": "2.2.8",
-      "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-2.2.8.tgz",
-      "integrity": "sha1-5Dm+Kq7jJzIZUnMPmaiSnk/FBYI="
+    "is-unc-path": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/is-unc-path/-/is-unc-path-1.0.0.tgz",
+      "integrity": "sha512-mrGpVd0fs7WWLfVsStvgF6iEJnbjDFZh9/emhRDcGWTduTfNHd9CHeUwH3gYIjdbwo4On6hunkztwOaAw0yllQ==",
+      "requires": {
+        "unc-path-regex": "^0.1.2"
+      }
     },
-    "sax": {
-      "version": "0.6.1",
-      "resolved": "https://registry.npmjs.org/sax/-/sax-0.6.1.tgz",
-      "integrity": "sha1-VjsZx8HeiS4Jv8Ty/DDjwn8JUrk="
+    "is-utf8": {
+      "version": "0.2.1",
+      "resolved": "https://registry.npmjs.org/is-utf8/-/is-utf8-0.2.1.tgz",
+      "integrity": "sha1-Sw2hRCEE0bM2NA6AeX6GXPOffXI="
     },
-    "sigmund": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/sigmund/-/sigmund-1.0.1.tgz",
-      "integrity": "sha1-P/IfGYytIXX587eBhT/ZTQ0ZtZA="
+    "is-windows": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/is-windows/-/is-windows-1.0.2.tgz",
+      "integrity": "sha512-eXK1UInq2bPmjyX6e3VHIzMLobc4J94i4AWn+Hpq3OU5KkrRC96OAcR3PRJ/pGu6m8TRnBHP9dkXQVsT/COVIA=="
     },
-    "spawnback": {
+    "isarray": {
       "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/spawnback/-/spawnback-1.0.0.tgz",
-      "integrity": "sha1-9zZi9+VNlTZ+ynTWQmxnfdfqaG8="
-    },
-    "string_decoder": {
-      "version": "0.10.31",
-      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz",
-      "integrity": "sha1-YuIDvEF2bGwoyfyEMB2rHFMQ+pQ="
-    },
-    "underscore": {
-      "version": "1.7.0",
-      "resolved": "https://registry.npmjs.org/underscore/-/underscore-1.7.0.tgz",
-      "integrity": "sha1-a7rwh3UA02vjTsqlhODbn+8DUgk="
+      "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz",
+      "integrity": "sha1-u5NdSFgsuhaMBoNJV6VKPgcSTxE="
     },
-    "underscore.string": {
-      "version": "2.2.1",
-      "resolved": "https://registry.npmjs.org/underscore.string/-/underscore.string-2.2.1.tgz",
-      "integrity": "sha1-18D6KvXVoaZ/QlPa7pgTLnM/Dxk="
+    "isexe": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
+      "integrity": "sha1-6PvzdNxVb/iUehDcsFctYz8s+hA="
     },
-    "which": {
-      "version": "1.0.9",
-      "resolved": "https://registry.npmjs.org/which/-/which-1.0.9.tgz",
-      "integrity": "sha1-RgwdoPgQED0DIam2M6+eV15kSG8="
+    "isobject": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/isobject/-/isobject-3.0.1.tgz",
+      "integrity": "sha1-TkMekrEalzFjaqH5yNHMvP2reN8="
     },
-    "wordpress": {
-      "version": "1.1.2",
-      "resolved": "https://registry.npmjs.org/wordpress/-/wordpress-1.1.2.tgz",
-      "integrity": "sha1-uDZhhSBVSXESG8VsQ7A5yzgg94M=",
+    "js-yaml": {
+      "version": "3.13.1",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.13.1.tgz",
+      "integrity": "sha512-YfbcO7jXDdyj0DGxYVSlSeQNHbD7XPWvrVWeVUujrQEoZzWJIRrCPoyk6kL6IAjAG2IolMK4T0hNUe0HOUs5Jw==",
       "requires": {
-        "xmlrpc": "1.3.1"
+        "argparse": "^1.0.7",
+        "esprima": "^4.0.0"
       }
     },
-    "wrappy": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
-      "integrity": "sha1-tSQ9jz7BqjXxNkYFvA0QNuMKtp8="
+    "kind-of": {
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.2.tgz",
+      "integrity": "sha512-s5kLOcnH0XqDO+FvuaLX8DDjZ18CGFk7VygH40QoKPUQhW4e2rvM0rwUq0t8IQDOwYSeLK01U90OjzBTme2QqA=="
     },
-    "xmlbuilder": {
-      "version": "2.6.5",
-      "resolved": "https://registry.npmjs.org/xmlbuilder/-/xmlbuilder-2.6.5.tgz",
-      "integrity": "sha1-b/etYPty0idk8AehZLd/K/FABSY=",
+    "liftoff": {
+      "version": "2.5.0",
+      "resolved": "https://registry.npmjs.org/liftoff/-/liftoff-2.5.0.tgz",
+      "integrity": "sha1-IAkpG7Mc6oYbvxCnwVooyvdcMew=",
       "requires": {
-        "lodash": "3.10.1"
+        "extend": "^3.0.0",
+        "findup-sync": "^2.0.0",
+        "fined": "^1.0.1",
+        "flagged-respawn": "^1.0.0",
+        "is-plain-object": "^2.0.4",
+        "object.map": "^1.0.0",
+        "rechoir": "^0.6.2",
+        "resolve": "^1.1.7"
       },
       "dependencies": {
-        "lodash": {
-          "version": "3.10.1",
-          "resolved": "https://registry.npmjs.org/lodash/-/lodash-3.10.1.tgz",
-          "integrity": "sha1-W/Rejkm6QYnhfUgnid/RW9FAt7Y="
+        "findup-sync": {
+          "version": "2.0.0",
+          "resolved": "https://registry.npmjs.org/findup-sync/-/findup-sync-2.0.0.tgz",
+          "integrity": "sha1-kyaxSIwi0aYIhlCoaQGy2akKLLw=",
+          "requires": {
+            "detect-file": "^1.0.0",
+            "is-glob": "^3.1.0",
+            "micromatch": "^3.0.4",
+            "resolve-dir": "^1.0.1"
+          }
         }
       }
     },
-    "xmlrpc": {
-      "version": "1.3.1",
-      "resolved": "https://registry.npmjs.org/xmlrpc/-/xmlrpc-1.3.1.tgz",
-      "integrity": "sha1-OqWCCG/vUwz+Hc2qDEyd3F0ORFE=",
+    "load-json-file": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/load-json-file/-/load-json-file-1.1.0.tgz",
+      "integrity": "sha1-lWkFcI1YtLq0wiYbBPWfMcmTdMA=",
+      "requires": {
+        "graceful-fs": "^4.1.2",
+        "parse-json": "^2.2.0",
+        "pify": "^2.0.0",
+        "pinkie-promise": "^2.0.0",
+        "strip-bom": "^2.0.0"
+      }
+    },
+    "lodash": {
+      "version": "4.17.15",
+      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.15.tgz",
+      "integrity": "sha512-8xOcRHvCjnocdS5cpwXQXVzmmh5e5+saE2QGoeQmbKmRS6J3VQppPOIt0MnmE+4xlZoumy0GPG0D0MVIQbNA1A=="
+    },
+    "loud-rejection": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/loud-rejection/-/loud-rejection-1.6.0.tgz",
+      "integrity": "sha1-W0b4AUft7leIcPCG0Eghz5mOVR8=",
+      "requires": {
+        "currently-unhandled": "^0.4.1",
+        "signal-exit": "^3.0.0"
+      }
+    },
+    "make-iterator": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/make-iterator/-/make-iterator-1.0.1.tgz",
+      "integrity": "sha512-pxiuXh0iVEq7VM7KMIhs5gxsfxCux2URptUQaXo4iZZJxBAzTPOLE2BumO5dbfVYq/hBJFBR/a1mFDmOx5AGmw==",
+      "requires": {
+        "kind-of": "^6.0.2"
+      }
+    },
+    "map-cache": {
+      "version": "0.2.2",
+      "resolved": "https://registry.npmjs.org/map-cache/-/map-cache-0.2.2.tgz",
+      "integrity": "sha1-wyq9C9ZSXZsFFkW7TyasXcmKDb8="
+    },
+    "map-obj": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/map-obj/-/map-obj-1.0.1.tgz",
+      "integrity": "sha1-2TPOuSBdgr3PSIb2dCvcK03qFG0="
+    },
+    "map-visit": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/map-visit/-/map-visit-1.0.0.tgz",
+      "integrity": "sha1-7Nyo8TFE5mDxtb1B8S80edmN+48=",
+      "requires": {
+        "object-visit": "^1.0.0"
+      }
+    },
+    "marked": {
+      "version": "0.3.2",
+      "resolved": "https://registry.npmjs.org/marked/-/marked-0.3.2.tgz",
+      "integrity": "sha1-AV2xWIZEOPJKZL3WGgQotBhwbQk="
+    },
+    "meow": {
+      "version": "3.7.0",
+      "resolved": "https://registry.npmjs.org/meow/-/meow-3.7.0.tgz",
+      "integrity": "sha1-cstmi0JSKCkKu/qFaJJYcwioAfs=",
+      "requires": {
+        "camelcase-keys": "^2.0.0",
+        "decamelize": "^1.1.2",
+        "loud-rejection": "^1.0.0",
+        "map-obj": "^1.0.1",
+        "minimist": "^1.1.3",
+        "normalize-package-data": "^2.3.4",
+        "object-assign": "^4.0.1",
+        "read-pkg-up": "^1.0.1",
+        "redent": "^1.0.0",
+        "trim-newlines": "^1.0.0"
+      }
+    },
+    "micromatch": {
+      "version": "3.1.10",
+      "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-3.1.10.tgz",
+      "integrity": "sha512-MWikgl9n9M3w+bpsY3He8L+w9eF9338xRl8IAO5viDizwSzziFEyUzo2xrrloB64ADbTf8uA8vRqqttDTOmccg==",
+      "requires": {
+        "arr-diff": "^4.0.0",
+        "array-unique": "^0.3.2",
+        "braces": "^2.3.1",
+        "define-property": "^2.0.2",
+        "extend-shallow": "^3.0.2",
+        "extglob": "^2.0.4",
+        "fragment-cache": "^0.2.1",
+        "kind-of": "^6.0.2",
+        "nanomatch": "^1.2.9",
+        "object.pick": "^1.3.0",
+        "regex-not": "^1.0.0",
+        "snapdragon": "^0.8.1",
+        "to-regex": "^3.0.2"
+      }
+    },
+    "minimatch": {
+      "version": "3.0.4",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.0.4.tgz",
+      "integrity": "sha512-yJHVQEhyqPLUTgt9B83PXu6W3rx4MvvHvSUvToogpwoGDOUQ+yDrR0HRot+yOCdCO7u4hX3pWft6kWBBcqh0UA==",
+      "requires": {
+        "brace-expansion": "^1.1.7"
+      }
+    },
+    "minimist": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.0.tgz",
+      "integrity": "sha1-o1AIsg9BOD7sH7kU9M1d95omQoQ="
+    },
+    "mixin-deep": {
+      "version": "1.3.2",
+      "resolved": "https://registry.npmjs.org/mixin-deep/-/mixin-deep-1.3.2.tgz",
+      "integrity": "sha512-WRoDn//mXBiJ1H40rqa3vH0toePwSsGb45iInWlTySa+Uu4k3tYUSxa2v1KqAiLtvlrSzaExqS1gtk96A9zvEA==",
+      "requires": {
+        "for-in": "^1.0.2",
+        "is-extendable": "^1.0.1"
+      },
+      "dependencies": {
+        "is-extendable": {
+          "version": "1.0.1",
+          "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-1.0.1.tgz",
+          "integrity": "sha512-arnXMxT1hhoKo9k1LZdmlNyJdDDfy2v0fXjFlmok4+i8ul/6WlbVge9bhM74OpNPQPMGUToDtz+KXa1PneJxOA==",
+          "requires": {
+            "is-plain-object": "^2.0.4"
+          }
+        }
+      }
+    },
+    "mkdirp": {
+      "version": "0.5.1",
+      "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.1.tgz",
+      "integrity": "sha1-MAV0OOrGz3+MR2fzhkjWaX11yQM=",
+      "requires": {
+        "minimist": "0.0.8"
+      },
+      "dependencies": {
+        "minimist": {
+          "version": "0.0.8",
+          "resolved": "https://registry.npmjs.org/minimist/-/minimist-0.0.8.tgz",
+          "integrity": "sha1-hX/Kv8M5fSYluCKCYuhqp6ARsF0="
+        }
+      }
+    },
+    "ms": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
+      "integrity": "sha1-VgiurfwAvmwpAd9fmGF4jeDVl8g="
+    },
+    "nanomatch": {
+      "version": "1.2.13",
+      "resolved": "https://registry.npmjs.org/nanomatch/-/nanomatch-1.2.13.tgz",
+      "integrity": "sha512-fpoe2T0RbHwBTBUOftAfBPaDEi06ufaUai0mE6Yn1kacc3SnTErfb/h+X94VXzI64rKFHYImXSvdwGGCmwOqCA==",
+      "requires": {
+        "arr-diff": "^4.0.0",
+        "array-unique": "^0.3.2",
+        "define-property": "^2.0.2",
+        "extend-shallow": "^3.0.2",
+        "fragment-cache": "^0.2.1",
+        "is-windows": "^1.0.2",
+        "kind-of": "^6.0.2",
+        "object.pick": "^1.3.0",
+        "regex-not": "^1.0.0",
+        "snapdragon": "^0.8.1",
+        "to-regex": "^3.0.1"
+      }
+    },
+    "nopt": {
+      "version": "3.0.6",
+      "resolved": "https://registry.npmjs.org/nopt/-/nopt-3.0.6.tgz",
+      "integrity": "sha1-xkZdvwirzU2zWTF/eaxopkayj/k=",
+      "requires": {
+        "abbrev": "1"
+      }
+    },
+    "normalize-package-data": {
+      "version": "2.5.0",
+      "resolved": "https://registry.npmjs.org/normalize-package-data/-/normalize-package-data-2.5.0.tgz",
+      "integrity": "sha512-/5CMN3T0R4XTj4DcGaexo+roZSdSFW/0AOOTROrjxzCG1wrWXEsGbRKevjlIL+ZDE4sZlJr5ED4YW0yqmkK+eA==",
+      "requires": {
+        "hosted-git-info": "^2.1.4",
+        "resolve": "^1.10.0",
+        "semver": "2 || 3 || 4 || 5",
+        "validate-npm-package-license": "^3.0.1"
+      }
+    },
+    "number-is-nan": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/number-is-nan/-/number-is-nan-1.0.1.tgz",
+      "integrity": "sha1-CXtgK1NCKlIsGvuHkDGDNpQaAR0="
+    },
+    "object-assign": {
+      "version": "4.1.1",
+      "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz",
+      "integrity": "sha1-IQmtx5ZYh8/AXLvUQsrIv7s2CGM="
+    },
+    "object-copy": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/object-copy/-/object-copy-0.1.0.tgz",
+      "integrity": "sha1-fn2Fi3gb18mRpBupde04EnVOmYw=",
+      "requires": {
+        "copy-descriptor": "^0.1.0",
+        "define-property": "^0.2.5",
+        "kind-of": "^3.0.3"
+      },
+      "dependencies": {
+        "define-property": {
+          "version": "0.2.5",
+          "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz",
+          "integrity": "sha1-w1se+RjsPJkPmlvFe+BKrOxcgRY=",
+          "requires": {
+            "is-descriptor": "^0.1.0"
+          }
+        },
+        "kind-of": {
+          "version": "3.2.2",
+          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz",
+          "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=",
+          "requires": {
+            "is-buffer": "^1.1.5"
+          }
+        }
+      }
+    },
+    "object-visit": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/object-visit/-/object-visit-1.0.1.tgz",
+      "integrity": "sha1-95xEk68MU3e1n+OdOV5BBC3QRbs=",
+      "requires": {
+        "isobject": "^3.0.0"
+      }
+    },
+    "object.defaults": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/object.defaults/-/object.defaults-1.1.0.tgz",
+      "integrity": "sha1-On+GgzS0B96gbaFtiNXNKeQ1/s8=",
+      "requires": {
+        "array-each": "^1.0.1",
+        "array-slice": "^1.0.0",
+        "for-own": "^1.0.0",
+        "isobject": "^3.0.0"
+      }
+    },
+    "object.map": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/object.map/-/object.map-1.0.1.tgz",
+      "integrity": "sha1-z4Plncj8wK1fQlDh94s7gb2AHTc=",
+      "requires": {
+        "for-own": "^1.0.0",
+        "make-iterator": "^1.0.0"
+      }
+    },
+    "object.pick": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/object.pick/-/object.pick-1.3.0.tgz",
+      "integrity": "sha1-h6EKxMFpS9Lhy/U1kaZhQftd10c=",
+      "requires": {
+        "isobject": "^3.0.1"
+      }
+    },
+    "once": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
+      "integrity": "sha1-WDsap3WWHUsROsF9nFC6753Xa9E=",
+      "requires": {
+        "wrappy": "1"
+      }
+    },
+    "os-homedir": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/os-homedir/-/os-homedir-1.0.2.tgz",
+      "integrity": "sha1-/7xJiDNuDoM94MFox+8VISGqf7M="
+    },
+    "os-tmpdir": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/os-tmpdir/-/os-tmpdir-1.0.2.tgz",
+      "integrity": "sha1-u+Z0BseaqFxc/sdm/lc0VV36EnQ="
+    },
+    "osenv": {
+      "version": "0.1.5",
+      "resolved": "https://registry.npmjs.org/osenv/-/osenv-0.1.5.tgz",
+      "integrity": "sha512-0CWcCECdMVc2Rw3U5w9ZjqX6ga6ubk1xDVKxtBQPK7wis/0F2r9T6k4ydGYhecl7YUBxBVxhL5oisPsNxAPe2g==",
+      "requires": {
+        "os-homedir": "^1.0.0",
+        "os-tmpdir": "^1.0.0"
+      }
+    },
+    "parse-filepath": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/parse-filepath/-/parse-filepath-1.0.2.tgz",
+      "integrity": "sha1-pjISf1Oq89FYdvWHLz/6x2PWyJE=",
+      "requires": {
+        "is-absolute": "^1.0.0",
+        "map-cache": "^0.2.0",
+        "path-root": "^0.1.1"
+      }
+    },
+    "parse-json": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-2.2.0.tgz",
+      "integrity": "sha1-9ID0BDTvgHQfhGkJn43qGPVaTck=",
+      "requires": {
+        "error-ex": "^1.2.0"
+      }
+    },
+    "parse-passwd": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/parse-passwd/-/parse-passwd-1.0.0.tgz",
+      "integrity": "sha1-bVuTSkVpk7I9N/QKOC1vFmao5cY="
+    },
+    "pascalcase": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/pascalcase/-/pascalcase-0.1.1.tgz",
+      "integrity": "sha1-s2PlXoAGym/iF4TS2yK9FdeRfxQ="
+    },
+    "path-exists": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-2.1.0.tgz",
+      "integrity": "sha1-D+tsZPD8UY2adU3V77YscCJ2H0s=",
+      "requires": {
+        "pinkie-promise": "^2.0.0"
+      }
+    },
+    "path-is-absolute": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz",
+      "integrity": "sha1-F0uSaHNVNP+8es5r9TpanhtcX18="
+    },
+    "path-parse": {
+      "version": "1.0.6",
+      "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.6.tgz",
+      "integrity": "sha512-GSmOT2EbHrINBf9SR7CDELwlJ8AENk3Qn7OikK4nFYAu3Ote2+JYNVvkpAEQm3/TLNEJFD/xZJjzyxg3KBWOzw=="
+    },
+    "path-root": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/path-root/-/path-root-0.1.1.tgz",
+      "integrity": "sha1-mkpoFMrBwM1zNgqV8yCDyOpHRbc=",
+      "requires": {
+        "path-root-regex": "^0.1.0"
+      }
+    },
+    "path-root-regex": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/path-root-regex/-/path-root-regex-0.1.2.tgz",
+      "integrity": "sha1-v8zcjfWxLcUsi0PsONGNcsBLqW0="
+    },
+    "path-type": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/path-type/-/path-type-1.1.0.tgz",
+      "integrity": "sha1-WcRPfuSR2nBNpBXaWkBwuk+P5EE=",
+      "requires": {
+        "graceful-fs": "^4.1.2",
+        "pify": "^2.0.0",
+        "pinkie-promise": "^2.0.0"
+      }
+    },
+    "pify": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz",
+      "integrity": "sha1-7RQaasBDqEnqWISY59yosVMw6Qw="
+    },
+    "pinkie": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/pinkie/-/pinkie-2.0.4.tgz",
+      "integrity": "sha1-clVrgM+g1IqXToDnckjoDtT3+HA="
+    },
+    "pinkie-promise": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/pinkie-promise/-/pinkie-promise-2.0.1.tgz",
+      "integrity": "sha1-ITXW36ejWMBprJsXh3YogihFD/o=",
+      "requires": {
+        "pinkie": "^2.0.0"
+      }
+    },
+    "posix-character-classes": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/posix-character-classes/-/posix-character-classes-0.1.1.tgz",
+      "integrity": "sha1-AerA/jta9xoqbAL+q7jB/vfgDqs="
+    },
+    "read-pkg": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/read-pkg/-/read-pkg-1.1.0.tgz",
+      "integrity": "sha1-9f+qXs0pyzHAR0vKfXVra7KePyg=",
+      "requires": {
+        "load-json-file": "^1.0.0",
+        "normalize-package-data": "^2.3.2",
+        "path-type": "^1.0.0"
+      }
+    },
+    "read-pkg-up": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/read-pkg-up/-/read-pkg-up-1.0.1.tgz",
+      "integrity": "sha1-nWPBMnbAZZGNV/ACpX9AobZD+wI=",
+      "requires": {
+        "find-up": "^1.0.0",
+        "read-pkg": "^1.0.0"
+      }
+    },
+    "readable-stream": {
+      "version": "1.1.14",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-1.1.14.tgz",
+      "integrity": "sha1-fPTFTvZI44EwhMY23SB54WbAgdk=",
+      "requires": {
+        "core-util-is": "~1.0.0",
+        "inherits": "~2.0.1",
+        "isarray": "0.0.1",
+        "string_decoder": "~0.10.x"
+      },
+      "dependencies": {
+        "isarray": {
+          "version": "0.0.1",
+          "resolved": "https://registry.npmjs.org/isarray/-/isarray-0.0.1.tgz",
+          "integrity": "sha1-ihis/Kmo9Bd+Cav8YDiTmwXR7t8="
+        }
+      }
+    },
+    "rechoir": {
+      "version": "0.6.2",
+      "resolved": "https://registry.npmjs.org/rechoir/-/rechoir-0.6.2.tgz",
+      "integrity": "sha1-hSBLVNuoLVdC4oyWdW70OvUOM4Q=",
+      "requires": {
+        "resolve": "^1.1.6"
+      }
+    },
+    "redent": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/redent/-/redent-1.0.0.tgz",
+      "integrity": "sha1-z5Fqsf1fHxbfsggi3W7H9zDCr94=",
+      "requires": {
+        "indent-string": "^2.1.0",
+        "strip-indent": "^1.0.1"
+      }
+    },
+    "regex-not": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/regex-not/-/regex-not-1.0.2.tgz",
+      "integrity": "sha512-J6SDjUgDxQj5NusnOtdFxDwN/+HWykR8GELwctJ7mdqhcyy1xEc4SRFHUXvxTp661YaVKAjfRLZ9cCqS6tn32A==",
+      "requires": {
+        "extend-shallow": "^3.0.2",
+        "safe-regex": "^1.1.0"
+      }
+    },
+    "repeat-element": {
+      "version": "1.1.3",
+      "resolved": "https://registry.npmjs.org/repeat-element/-/repeat-element-1.1.3.tgz",
+      "integrity": "sha512-ahGq0ZnV5m5XtZLMb+vP76kcAM5nkLqk0lpqAuojSKGgQtn4eRi4ZZGm2olo2zKFH+sMsWaqOCW1dqAnOru72g=="
+    },
+    "repeat-string": {
+      "version": "1.6.1",
+      "resolved": "https://registry.npmjs.org/repeat-string/-/repeat-string-1.6.1.tgz",
+      "integrity": "sha1-jcrkcOHIirwtYA//Sndihtp15jc="
+    },
+    "repeating": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/repeating/-/repeating-2.0.1.tgz",
+      "integrity": "sha1-UhTFOpJtNVJwdSf7q0FdvAjQbdo=",
+      "requires": {
+        "is-finite": "^1.0.0"
+      }
+    },
+    "resolve": {
+      "version": "1.12.0",
+      "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.12.0.tgz",
+      "integrity": "sha512-B/dOmuoAik5bKcD6s6nXDCjzUKnaDvdkRyAk6rsmsKLipWj4797iothd7jmmUhWTfinVMU+wc56rYKsit2Qy4w==",
+      "requires": {
+        "path-parse": "^1.0.6"
+      }
+    },
+    "resolve-dir": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/resolve-dir/-/resolve-dir-1.0.1.tgz",
+      "integrity": "sha1-eaQGRMNivoLybv/nOcm7U4IEb0M=",
+      "requires": {
+        "expand-tilde": "^2.0.0",
+        "global-modules": "^1.0.0"
+      }
+    },
+    "resolve-url": {
+      "version": "0.2.1",
+      "resolved": "https://registry.npmjs.org/resolve-url/-/resolve-url-0.2.1.tgz",
+      "integrity": "sha1-LGN/53yJOv0qZj/iGqkIAGjiBSo="
+    },
+    "ret": {
+      "version": "0.1.15",
+      "resolved": "https://registry.npmjs.org/ret/-/ret-0.1.15.tgz",
+      "integrity": "sha512-TTlYpa+OL+vMMNG24xSlQGEJ3B/RzEfUlLct7b5G/ytav+wPrplCpVMFuwzXbkecJrb6IYo1iFb0S9v37754mg=="
+    },
+    "rimraf": {
+      "version": "2.6.3",
+      "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-2.6.3.tgz",
+      "integrity": "sha512-mwqeW5XsA2qAejG46gYdENaxXjx9onRNCfn7L0duuP4hCuTIi/QO7PDK07KJfp1d+izWPrzEJDcSqBa0OZQriA==",
+      "requires": {
+        "glob": "^7.1.3"
+      },
+      "dependencies": {
+        "glob": {
+          "version": "7.1.4",
+          "resolved": "https://registry.npmjs.org/glob/-/glob-7.1.4.tgz",
+          "integrity": "sha512-hkLPepehmnKk41pUGm3sYxoFs/umurYfYJCerbXEyFIWcAzvpipAgVkBqqT9RBKMGjnq6kMuyYwha6csxbiM1A==",
+          "requires": {
+            "fs.realpath": "^1.0.0",
+            "inflight": "^1.0.4",
+            "inherits": "2",
+            "minimatch": "^3.0.4",
+            "once": "^1.3.0",
+            "path-is-absolute": "^1.0.0"
+          }
+        }
+      }
+    },
+    "safe-regex": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/safe-regex/-/safe-regex-1.1.0.tgz",
+      "integrity": "sha1-QKNmnzsHfR6UPURinhV91IAjvy4=",
+      "requires": {
+        "ret": "~0.1.10"
+      }
+    },
+    "safer-buffer": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
+      "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg=="
+    },
+    "sax": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/sax/-/sax-1.2.4.tgz",
+      "integrity": "sha512-NqVDv9TpANUjFm0N8uM5GxL36UgKi9/atZw+x7YFnQ8ckwFGKrl4xX4yWtrey3UJm5nP1kUbnYgLopqWNSRhWw=="
+    },
+    "semver": {
+      "version": "5.7.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-5.7.1.tgz",
+      "integrity": "sha512-sauaDf/PZdVgrLTNYHRtpXa1iRiKcaebiKQ1BJdpQlWH2lCvexQdX55snPFyK7QzpudqbCI0qXFfOasHdyNDGQ=="
+    },
+    "set-value": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/set-value/-/set-value-2.0.1.tgz",
+      "integrity": "sha512-JxHc1weCN68wRY0fhCoXpyK55m/XPHafOmK4UWD7m2CI14GMcFypt4w/0+NV5f/ZMby2F6S2wwA7fgynh9gWSw==",
+      "requires": {
+        "extend-shallow": "^2.0.1",
+        "is-extendable": "^0.1.1",
+        "is-plain-object": "^2.0.3",
+        "split-string": "^3.0.1"
+      },
+      "dependencies": {
+        "extend-shallow": {
+          "version": "2.0.1",
+          "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
+          "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=",
+          "requires": {
+            "is-extendable": "^0.1.0"
+          }
+        }
+      }
+    },
+    "signal-exit": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.2.tgz",
+      "integrity": "sha1-tf3AjxKH6hF4Yo5BXiUTK3NkbG0="
+    },
+    "snapdragon": {
+      "version": "0.8.2",
+      "resolved": "https://registry.npmjs.org/snapdragon/-/snapdragon-0.8.2.tgz",
+      "integrity": "sha512-FtyOnWN/wCHTVXOMwvSv26d+ko5vWlIDD6zoUJ7LW8vh+ZBC8QdljveRP+crNrtBwioEUWy/4dMtbBjA4ioNlg==",
+      "requires": {
+        "base": "^0.11.1",
+        "debug": "^2.2.0",
+        "define-property": "^0.2.5",
+        "extend-shallow": "^2.0.1",
+        "map-cache": "^0.2.2",
+        "source-map": "^0.5.6",
+        "source-map-resolve": "^0.5.0",
+        "use": "^3.1.0"
+      },
+      "dependencies": {
+        "define-property": {
+          "version": "0.2.5",
+          "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz",
+          "integrity": "sha1-w1se+RjsPJkPmlvFe+BKrOxcgRY=",
+          "requires": {
+            "is-descriptor": "^0.1.0"
+          }
+        },
+        "extend-shallow": {
+          "version": "2.0.1",
+          "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
+          "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=",
+          "requires": {
+            "is-extendable": "^0.1.0"
+          }
+        }
+      }
+    },
+    "snapdragon-node": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/snapdragon-node/-/snapdragon-node-2.1.1.tgz",
+      "integrity": "sha512-O27l4xaMYt/RSQ5TR3vpWCAB5Kb/czIcqUFOM/C4fYcLnbZUc1PkjTAMjof2pBWaSTwOUd6qUHcFGVGj7aIwnw==",
+      "requires": {
+        "define-property": "^1.0.0",
+        "isobject": "^3.0.0",
+        "snapdragon-util": "^3.0.1"
+      },
+      "dependencies": {
+        "define-property": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/define-property/-/define-property-1.0.0.tgz",
+          "integrity": "sha1-dp66rz9KY6rTr56NMEybvnm/sOY=",
+          "requires": {
+            "is-descriptor": "^1.0.0"
+          }
+        },
+        "is-accessor-descriptor": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-1.0.0.tgz",
+          "integrity": "sha512-m5hnHTkcVsPfqx3AKlyttIPb7J+XykHvJP2B9bZDjlhLIoEq4XoK64Vg7boZlVWYK6LUY94dYPEE7Lh0ZkZKcQ==",
+          "requires": {
+            "kind-of": "^6.0.0"
+          }
+        },
+        "is-data-descriptor": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-1.0.0.tgz",
+          "integrity": "sha512-jbRXy1FmtAoCjQkVmIVYwuuqDFUbaOeDjmed1tOGPrsMhtJA4rD9tkgA0F1qJ3gRFRXcHYVkdeaP50Q5rE/jLQ==",
+          "requires": {
+            "kind-of": "^6.0.0"
+          }
+        },
+        "is-descriptor": {
+          "version": "1.0.2",
+          "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-1.0.2.tgz",
+          "integrity": "sha512-2eis5WqQGV7peooDyLmNEPUrps9+SXX5c9pL3xEB+4e9HnGuDa7mB7kHxHw4CbqS9k1T2hOH3miL8n8WtiYVtg==",
+          "requires": {
+            "is-accessor-descriptor": "^1.0.0",
+            "is-data-descriptor": "^1.0.0",
+            "kind-of": "^6.0.2"
+          }
+        }
+      }
+    },
+    "snapdragon-util": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/snapdragon-util/-/snapdragon-util-3.0.1.tgz",
+      "integrity": "sha512-mbKkMdQKsjX4BAL4bRYTj21edOf8cN7XHdYUJEe+Zn99hVEYcMvKPct1IqNe7+AZPirn8BCDOQBHQZknqmKlZQ==",
+      "requires": {
+        "kind-of": "^3.2.0"
+      },
+      "dependencies": {
+        "kind-of": {
+          "version": "3.2.2",
+          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz",
+          "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=",
+          "requires": {
+            "is-buffer": "^1.1.5"
+          }
+        }
+      }
+    },
+    "source-map": {
+      "version": "0.5.7",
+      "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.5.7.tgz",
+      "integrity": "sha1-igOdLRAh0i0eoUyA2OpGi6LvP8w="
+    },
+    "source-map-resolve": {
+      "version": "0.5.2",
+      "resolved": "https://registry.npmjs.org/source-map-resolve/-/source-map-resolve-0.5.2.tgz",
+      "integrity": "sha512-MjqsvNwyz1s0k81Goz/9vRBe9SZdB09Bdw+/zYyO+3CuPk6fouTaxscHkgtE8jKvf01kVfl8riHzERQ/kefaSA==",
+      "requires": {
+        "atob": "^2.1.1",
+        "decode-uri-component": "^0.2.0",
+        "resolve-url": "^0.2.1",
+        "source-map-url": "^0.4.0",
+        "urix": "^0.1.0"
+      }
+    },
+    "source-map-url": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/source-map-url/-/source-map-url-0.4.0.tgz",
+      "integrity": "sha1-PpNdfd1zYxuXZZlW1VEo6HtQhKM="
+    },
+    "spawnback": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/spawnback/-/spawnback-1.0.0.tgz",
+      "integrity": "sha1-9zZi9+VNlTZ+ynTWQmxnfdfqaG8="
+    },
+    "spdx-correct": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/spdx-correct/-/spdx-correct-3.1.0.tgz",
+      "integrity": "sha512-lr2EZCctC2BNR7j7WzJ2FpDznxky1sjfxvvYEyzxNyb6lZXHODmEoJeFu4JupYlkfha1KZpJyoqiJ7pgA1qq8Q==",
+      "requires": {
+        "spdx-expression-parse": "^3.0.0",
+        "spdx-license-ids": "^3.0.0"
+      }
+    },
+    "spdx-exceptions": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/spdx-exceptions/-/spdx-exceptions-2.2.0.tgz",
+      "integrity": "sha512-2XQACfElKi9SlVb1CYadKDXvoajPgBVPn/gOQLrTvHdElaVhr7ZEbqJaRnJLVNeaI4cMEAgVCeBMKF6MWRDCRA=="
+    },
+    "spdx-expression-parse": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/spdx-expression-parse/-/spdx-expression-parse-3.0.0.tgz",
+      "integrity": "sha512-Yg6D3XpRD4kkOmTpdgbUiEJFKghJH03fiC1OPll5h/0sO6neh2jqRDVHOQ4o/LMea0tgCkbMgea5ip/e+MkWyg==",
+      "requires": {
+        "spdx-exceptions": "^2.1.0",
+        "spdx-license-ids": "^3.0.0"
+      }
+    },
+    "spdx-license-ids": {
+      "version": "3.0.5",
+      "resolved": "https://registry.npmjs.org/spdx-license-ids/-/spdx-license-ids-3.0.5.tgz",
+      "integrity": "sha512-J+FWzZoynJEXGphVIS+XEh3kFSjZX/1i9gFBaWQcB+/tmpe2qUsSBABpcxqxnAxFdiUFEgAX1bjYGQvIZmoz9Q=="
+    },
+    "split-string": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/split-string/-/split-string-3.1.0.tgz",
+      "integrity": "sha512-NzNVhJDYpwceVVii8/Hu6DKfD2G+NrQHlS/V/qgv763EYudVwEcMQNxd2lh+0VrUByXN/oJkl5grOhYWvQUYiw==",
+      "requires": {
+        "extend-shallow": "^3.0.0"
+      }
+    },
+    "sprintf-js": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.1.2.tgz",
+      "integrity": "sha512-VE0SOVEHCk7Qc8ulkWw3ntAzXuqf7S2lvwQaDLRnUeIEaKNQJzV6BwmLKhOqT61aGhfUMrXeaBk+oDGCzvhcug=="
+    },
+    "static-extend": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/static-extend/-/static-extend-0.1.2.tgz",
+      "integrity": "sha1-YICcOcv/VTNyJv1eC1IPNB8ftcY=",
+      "requires": {
+        "define-property": "^0.2.5",
+        "object-copy": "^0.1.0"
+      },
+      "dependencies": {
+        "define-property": {
+          "version": "0.2.5",
+          "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz",
+          "integrity": "sha1-w1se+RjsPJkPmlvFe+BKrOxcgRY=",
+          "requires": {
+            "is-descriptor": "^0.1.0"
+          }
+        }
+      }
+    },
+    "string_decoder": {
+      "version": "0.10.31",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz",
+      "integrity": "sha1-YuIDvEF2bGwoyfyEMB2rHFMQ+pQ="
+    },
+    "strip-bom": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-2.0.0.tgz",
+      "integrity": "sha1-YhmoVhZSBJHzV4i9vxRHqZx+aw4=",
+      "requires": {
+        "is-utf8": "^0.2.0"
+      }
+    },
+    "strip-indent": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/strip-indent/-/strip-indent-1.0.1.tgz",
+      "integrity": "sha1-DHlipq3vp7vUrDZkYKY4VSrhoKI=",
+      "requires": {
+        "get-stdin": "^4.0.1"
+      }
+    },
+    "supports-color": {
+      "version": "5.5.0",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz",
+      "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==",
+      "requires": {
+        "has-flag": "^3.0.0"
+      }
+    },
+    "to-object-path": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/to-object-path/-/to-object-path-0.3.0.tgz",
+      "integrity": "sha1-KXWIt7Dn4KwI4E5nL4XB9JmeF68=",
+      "requires": {
+        "kind-of": "^3.0.2"
+      },
+      "dependencies": {
+        "kind-of": {
+          "version": "3.2.2",
+          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz",
+          "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=",
+          "requires": {
+            "is-buffer": "^1.1.5"
+          }
+        }
+      }
+    },
+    "to-regex": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/to-regex/-/to-regex-3.0.2.tgz",
+      "integrity": "sha512-FWtleNAtZ/Ki2qtqej2CXTOayOH9bHDQF+Q48VpWyDXjbYxA4Yz8iDB31zXOBUlOHHKidDbqGVrTUvQMPmBGBw==",
+      "requires": {
+        "define-property": "^2.0.2",
+        "extend-shallow": "^3.0.2",
+        "regex-not": "^1.0.2",
+        "safe-regex": "^1.1.0"
+      }
+    },
+    "to-regex-range": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-2.1.1.tgz",
+      "integrity": "sha1-fIDBe53+vlmeJzZ+DU3VWQFB2zg=",
+      "requires": {
+        "is-number": "^3.0.0",
+        "repeat-string": "^1.6.1"
+      }
+    },
+    "trim-newlines": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/trim-newlines/-/trim-newlines-1.0.0.tgz",
+      "integrity": "sha1-WIeWa7WCpFA6QetST301ARgVphM="
+    },
+    "unc-path-regex": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/unc-path-regex/-/unc-path-regex-0.1.2.tgz",
+      "integrity": "sha1-5z3T17DXxe2G+6xrCufYxqadUPo="
+    },
+    "underscore.string": {
+      "version": "3.3.5",
+      "resolved": "https://registry.npmjs.org/underscore.string/-/underscore.string-3.3.5.tgz",
+      "integrity": "sha512-g+dpmgn+XBneLmXXo+sGlW5xQEt4ErkS3mgeN2GFbremYeMBSJKr9Wf2KJplQVaiPY/f7FN6atosWYNm9ovrYg==",
+      "requires": {
+        "sprintf-js": "^1.0.3",
+        "util-deprecate": "^1.0.2"
+      }
+    },
+    "union-value": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/union-value/-/union-value-1.0.1.tgz",
+      "integrity": "sha512-tJfXmxMeWYnczCVs7XAEvIV7ieppALdyepWMkHkwciRpZraG/xwT+s2JN8+pr1+8jCRf80FFzvr+MpQeeoF4Xg==",
+      "requires": {
+        "arr-union": "^3.1.0",
+        "get-value": "^2.0.6",
+        "is-extendable": "^0.1.1",
+        "set-value": "^2.0.1"
+      }
+    },
+    "unset-value": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/unset-value/-/unset-value-1.0.0.tgz",
+      "integrity": "sha1-g3aHP30jNRef+x5vw6jtDfyKtVk=",
+      "requires": {
+        "has-value": "^0.3.1",
+        "isobject": "^3.0.0"
+      },
+      "dependencies": {
+        "has-value": {
+          "version": "0.3.1",
+          "resolved": "https://registry.npmjs.org/has-value/-/has-value-0.3.1.tgz",
+          "integrity": "sha1-ex9YutpiyoJ+wKIHgCVlSEWZXh8=",
+          "requires": {
+            "get-value": "^2.0.3",
+            "has-values": "^0.1.4",
+            "isobject": "^2.0.0"
+          },
+          "dependencies": {
+            "isobject": {
+              "version": "2.1.0",
+              "resolved": "https://registry.npmjs.org/isobject/-/isobject-2.1.0.tgz",
+              "integrity": "sha1-8GVWEJaj8dou9GJy+BXIQNh+DIk=",
+              "requires": {
+                "isarray": "1.0.0"
+              }
+            }
+          }
+        },
+        "has-values": {
+          "version": "0.1.4",
+          "resolved": "https://registry.npmjs.org/has-values/-/has-values-0.1.4.tgz",
+          "integrity": "sha1-bWHeldkd/Km5oCCJrThL/49it3E="
+        }
+      }
+    },
+    "urix": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/urix/-/urix-0.1.0.tgz",
+      "integrity": "sha1-2pN/emLiH+wf0Y1Js1wpNQZ6bHI="
+    },
+    "use": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/use/-/use-3.1.1.tgz",
+      "integrity": "sha512-cwESVXlO3url9YWlFW/TA9cshCEhtu7IKJ/p5soJ/gGpj7vbvFrAY/eIioQ6Dw23KjZhYgiIo8HOs1nQ2vr/oQ=="
+    },
+    "util-deprecate": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
+      "integrity": "sha1-RQ1Nyfpw3nMnYvvS1KKJgUGaDM8="
+    },
+    "v8flags": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/v8flags/-/v8flags-3.1.3.tgz",
+      "integrity": "sha512-amh9CCg3ZxkzQ48Mhcb8iX7xpAfYJgePHxWMQCBWECpOSqJUXgY26ncA61UTV0BkPqfhcy6mzwCIoP4ygxpW8w==",
+      "requires": {
+        "homedir-polyfill": "^1.0.1"
+      }
+    },
+    "validate-npm-package-license": {
+      "version": "3.0.4",
+      "resolved": "https://registry.npmjs.org/validate-npm-package-license/-/validate-npm-package-license-3.0.4.tgz",
+      "integrity": "sha512-DpKm2Ui/xN7/HQKCtpZxoRWBhZ9Z0kqtygG8XCgNQ8ZlDnxuQmWhj566j8fN4Cu3/JmbhsDo7fcAJq4s9h27Ew==",
+      "requires": {
+        "spdx-correct": "^3.0.0",
+        "spdx-expression-parse": "^3.0.0"
+      }
+    },
+    "which": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/which/-/which-1.3.1.tgz",
+      "integrity": "sha512-HxJdYWq1MTIQbJ3nw0cqssHoTNU267KlrDuGZ1WYlxDStUtKUhOaJmh112/TZmHxxUfuJqPXSOm7tDyas0OSIQ==",
+      "requires": {
+        "isexe": "^2.0.0"
+      }
+    },
+    "wordpress": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/wordpress/-/wordpress-1.3.0.tgz",
+      "integrity": "sha1-0LxIUVOktTh3B+O8yRZqDBPpcS8=",
+      "requires": {
+        "xmlrpc": "1.3.2"
+      }
+    },
+    "wrappy": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
+      "integrity": "sha1-tSQ9jz7BqjXxNkYFvA0QNuMKtp8="
+    },
+    "xmlbuilder": {
+      "version": "8.2.2",
+      "resolved": "https://registry.npmjs.org/xmlbuilder/-/xmlbuilder-8.2.2.tgz",
+      "integrity": "sha1-aSSGc0ELS6QuGmE2VR0pIjNap3M="
+    },
+    "xmlrpc": {
+      "version": "1.3.2",
+      "resolved": "https://registry.npmjs.org/xmlrpc/-/xmlrpc-1.3.2.tgz",
+      "integrity": "sha1-JrLqNHhI0Ciqx+dRS1NRl23j6D0=",
       "requires": {
-        "sax": "0.6.1",
-        "xmlbuilder": "2.6.5"
+        "sax": "1.2.x",
+        "xmlbuilder": "8.2.x"
       }
     }
   }
diff --git a/package.json b/package.json
index 355f6217..e0cf10d1 100644
--- a/package.json
+++ b/package.json
@@ -24,8 +24,8 @@
     "test": "grunt lint"
   },
   "dependencies": {
-    "grunt": "0.4.5",
-    "grunt-cli": "1.1.0",
-    "grunt-jquery-content": "3.0.1"
+    "grunt": "1.0.4",
+    "grunt-cli": "1.3.2",
+    "grunt-jquery-content": "3.0.3"
   }
 }

From 92a40f605de36947b784c05786b59e70eda21ac0 Mon Sep 17 00:00:00 2001
From: Brian Leishman 
Date: Thu, 29 Aug 2019 19:51:44 -0400
Subject: [PATCH 558/699] find: Clarify selectors are scoped to context

Clarify that jQuery uses a different context scoping mechanism than native querySelectorAll.

Closes gh-1135
---
 entries/find.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/find.xml b/entries/find.xml
index c6a32e84..fc10241b 100644
--- a/entries/find.xml
+++ b/entries/find.xml
@@ -18,7 +18,7 @@
   Get the descendants of each element in the current set of matched elements, filtered by a selector, jQuery object, or element.
   
     
            Given a jQuery object that represents a set of DOM elements, the .find() method allows us to search through the descendants of these elements in the DOM tree and construct a new jQuery object from the matching elements. The .find() and .children() methods are similar, except that the latter only travels a single level down the DOM tree.
            
-    
            The first signature for the .find()method accepts a selector expression of the same type that we can pass to the $() function. The elements will be filtered by testing whether they match this selector. The expressions allowed include selectors like > p which will find all the paragraphs that are children of the elements in the jQuery object.
            
+    
            The first signature for the .find()method accepts a selector expression of the same type that we can pass to the $() function. The elements will be filtered by testing whether they match this selector; all parts of the selector must lie inside of an element on which .find() is called. The expressions allowed include selectors like > p which will find all the paragraphs that are children of the elements in the jQuery object.
            
     
            Consider a page with a basic nested list on it:
            
     
            
 <ul class="level-1">

From 9e4b6b8260a0f020a42ec0f16652194e2fb4b927 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Fri, 30 Aug 2019 01:52:40 +0200
Subject: [PATCH 559/699] 1.12.40

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index c0781a3e..7a361581 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "1.12.39",
+  "version": "1.12.40",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index e0cf10d1..f76c24d0 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.39",
+  "version": "1.12.40",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 21e1e632887c9ff57a137957b823b01331d0a8b5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Fri, 30 Aug 2019 12:33:51 +0200
Subject: [PATCH 560/699] 1.12.41

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index f76c24d0..079abd1d 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.40",
+  "version": "1.12.41",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From eb5c9002b60327e0666f103159c120863e2c6665 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Mon, 2 Sep 2019 18:11:57 +0200
Subject: [PATCH 561/699] 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
Closes gh-1145
---
 categories.xml                        |  9 +++++++--
 entries/addClass.xml                  |  2 +-
 entries/animate.xml                   |  4 ++--
 entries/children.xml                  |  4 ++--
 entries/contextmenu.xml               |  2 +-
 entries/data.xml                      |  4 ++--
 entries/dblclick.xml                  |  2 +-
 entries/end.xml                       |  2 +-
 entries/eq-selector.xml               |  4 +++-
 entries/even-selector.xml             |  3 ++-
 entries/fadeIn.xml                    |  2 +-
 entries/fadeTo.xml                    |  6 +++---
 entries/fadeToggle.xml                |  8 ++++----
 entries/first-child-selector.xml      |  2 +-
 entries/first-selector.xml            |  4 +++-
 entries/get.xml                       |  2 +-
 entries/gt-selector.xml               |  4 +++-
 entries/hasClass.xml                  |  4 ++--
 entries/hidden-selector.xml           |  4 ++--
 entries/hover.xml                     |  2 +-
 entries/index.xml                     |  4 ++--
 entries/innerHeight.xml               |  4 ++--
 entries/innerWidth.xml                |  4 ++--
 entries/is.xml                        |  2 --
 entries/jQuery.data.xml               |  4 ++--
 entries/jQuery.removeData.xml         |  8 ++++----
 entries/jQuery.unique.xml             |  4 ++--
 entries/jQuery.uniqueSort.xml         |  4 ++--
 entries/last-child-selector.xml       |  2 +-
 entries/last-selector.xml             |  6 ++++--
 entries/lt-selector.xml               |  4 +++-
 entries/mouseenter.xml                | 12 ++++++------
 entries/mouseleave.xml                | 12 ++++++------
 entries/mousemove.xml                 |  4 ++--
 entries/mouseout.xml                  | 12 ++++++------
 entries/nextAll.xml                   |  2 +-
 entries/nth-child-selector.xml        |  4 ++--
 entries/nth-last-child-selector.xml   |  2 +-
 entries/nth-last-of-type-selector.xml |  2 +-
 entries/nth-of-type-selector.xml      |  2 +-
 entries/odd-selector.xml              |  3 ++-
 entries/offset.xml                    |  4 ++--
 entries/outerHeight.xml               |  4 ++--
 entries/outerWidth.xml                |  4 ++--
 entries/position.xml                  |  4 ++--
 entries/prevAll.xml                   |  2 +-
 entries/removeClass.xml               |  4 ++--
 entries/removeData.xml                |  8 ++++----
 entries/scrollLeft.xml                |  4 ++--
 entries/scrollTop.xml                 |  4 ++--
 entries/slideDown.xml                 |  2 +-
 entries/slideUp.xml                   |  2 +-
 entries/submit.xml                    |  4 ++--
 entries/text.xml                      |  4 ++--
 entries/trigger.xml                   | 14 +++++++-------
 55 files changed, 127 insertions(+), 112 deletions(-)

diff --git a/categories.xml b/categories.xml
index c02b93b3..78f012b1 100644
--- a/categories.xml
+++ b/categories.xml
@@ -71,14 +71,19 @@
         
            For more information, see the Release Notes/Changelog at https://blog.jquery.com/2016/06/09/jquery-3-0-final-released/
            
       ]]>
     
-	
+    
       For more information, see the Release Notes/Changelog at https://blog.jquery.com/2018/01/19/jquery-3-3-0-a-fragrant-bouquet-of-deprecations-and-is-that-a-new-feature/
            
       ]]>            
                 
+    
+      For more information, see the Release Notes/Changelog at https://blog.jquery.com/2019/04/10/jquery-3-4-0-released/
            
+      ]]>            
+                
               
   
-	  
+    
   
   
     
diff --git a/entries/addClass.xml b/entries/addClass.xml
index 5dd99ec5..3b28a708 100644
--- a/entries/addClass.xml
+++ b/entries/addClass.xml
@@ -64,7 +64,7 @@ $( "p" ).last().addClass( "selected" );
   
     Add the classes "selected" and "highlight" to the matched elements.
     
     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. 
     
     Right click to toggle background color.
     Store then retrieve a value from the div element.
       
       
     Double click to toggle background color.
     
-
+
   :eq() Selector
   
     :eq(index)
@@ -17,6 +17,7 @@
   
   Select the element at index n within the matched set.
   
+    
            As of jQuery 3.4, the :eq pseudo-class is deprecated. Remove it from your selectors and filter the results later using .eq().
            
     
            The index-related selectors (:eq(), :lt(), :gt(), :even, :odd) 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 (.myclass) and four elements are returned, these elements are given indices 0 through 3 for the purposes of these selectors.
            
     
            Note that since JavaScript arrays use 0-based indexing, these selectors reflect that fact. This is why $( ".myclass:eq(1)" ) selects the second element in the document with the class myclass, rather than the first. In contrast, :nth-child(n) uses 1-based indexing to conform to the CSS specification.
            
     
            Prior to jQuery 1.8, the :eq(index) selector did not accept a negative value for index (though the .eq(index) method did).
            
@@ -92,4 +93,5 @@ $( "li:eq(-2)" ).addClass( "foo" )
   
   
   
+  
             
diff --git a/entries/even-selector.xml b/entries/even-selector.xml
index f190e066..ba2dc5d5 100644
--- a/entries/even-selector.xml
+++ b/entries/even-selector.xml
@@ -1,5 +1,5 @@
 
-
+
   :even Selector
   :even
   
@@ -33,4 +33,5 @@ $( "tr:even" ).css( "background-color", "#bbf" );
   
   
   
+  
 
diff --git a/entries/fadeIn.xml b/entries/fadeIn.xml
index 0f4b6888..a73fdc06 100644
--- a/entries/fadeIn.xml
+++ b/entries/fadeIn.xml
@@ -53,7 +53,7 @@ $( "#clickme" ).click(function() {
     Animates hidden divs to fade in one by one, completing each animation within 600 milliseconds.
     
     
     Animates first paragraph to fade to an opacity of 0.33 (33%, about one third visible), completing the animation within 600 milliseconds.
     
@@ -128,8 +128,8 @@ var getPos = function( n ) {
 $( "p" ).each(function( n ) {
   var r = Math.floor( Math.random() * 3 );
   var tmp = $( this ).text();
-  $( this ).text( $( "p:eq(" + r + ")" ).text() );
-  $( "p:eq(" + r + ")" ).text( tmp );
+  $( this ).text( $( "p" ).eq( r ).text() );
+  $( "p" ).eq( r ).text( tmp );
   $( this ).css( "left", getPos( n ) );
 });
 $( "div" )
diff --git a/entries/fadeToggle.xml b/entries/fadeToggle.xml
index f3906b45..b4d4fb0b 100644
--- a/entries/fadeToggle.xml
+++ b/entries/fadeToggle.xml
@@ -26,11 +26,11 @@
   
     Fades first paragraph in or out, completing the animation within 600 milliseconds and using a linear easing. Fades last paragraph in or out for 200 milliseconds, inserting a "finished" message upon completion. 
     finished" );
   });
 });
diff --git a/entries/first-child-selector.xml b/entries/first-child-selector.xml
index 4b30b503..d91a50b8 100644
--- a/entries/first-child-selector.xml
+++ b/entries/first-child-selector.xml
@@ -7,7 +7,7 @@
   
   Selects all elements that are the first child of their parent.
   
-    
            While :first matches only a single element, the :first-child selector can match more than one: one for each parent. This is equivalent to :nth-child(1).
            
+    
            While .first() matches only a single element, the :first-child selector can match more than one: one for each parent. This is equivalent to :nth-child(1).
            
               
   
     Finds the first span in each matched div to underline and add a hover state.
diff --git a/entries/first-selector.xml b/entries/first-selector.xml
index 0676d85f..ded45ccb 100644
--- a/entries/first-selector.xml
+++ b/entries/first-selector.xml
@@ -1,5 +1,5 @@
 
-
+
   :first Selector
   :first
   
@@ -7,6 +7,7 @@
   
   Selects the first matched DOM element.
   
+    
            As of jQuery 3.4, the :first pseudo-class is deprecated. Remove it from your selectors and filter the results later using .first().
            
     
            The :first pseudo-class is equivalent to :eq( 0 ). It could also be written as :lt( 1 ). While this matches only a single element, :first-child can match more than one: One for each parent.
            
               
   
@@ -33,4 +34,5 @@ $( "tr:first" ).css( "font-style", "italic" );
   
   
   
+  
             
diff --git a/entries/get.xml b/entries/get.xml
index 64272cf4..006d6de5 100644
--- a/entries/get.xml
+++ b/entries/get.xml
@@ -46,7 +46,7 @@ console.log( $( "li" ).get( -1 ) );
 $( "*", document.body ).click(function( event ) {
   event.stopPropagation();
   var domElement = $( this ).get( 0 );
-  $( "span:first" ).text( "Clicked on - " + domElement.nodeName );
+  $( "span" ).first().text( "Clicked on - " + domElement.nodeName );
 });
 ]]>            
       
-
+
   :gt() Selector
   
     :gt(index)
@@ -17,6 +17,7 @@
   
   Select all elements at an index greater than index within the matched set.
   
+    
            As of jQuery 3.4, the :gt pseudo-class is deprecated. Remove it from your selectors and filter the results later using .slice(). For example, :gt(3) can be replaced with a call to .slice( 4 ) (the provided index needs to be increased by one).
            
     
            
       index-related selectors
     
            
@@ -42,4 +43,5 @@ $( "td:gt(-2)" ).css( "color", "red" );
   
   
   
+  
             
diff --git a/entries/hasClass.xml b/entries/hasClass.xml
index ddf5d893..622570e9 100644
--- a/entries/hasClass.xml
+++ b/entries/hasClass.xml
@@ -30,8 +30,8 @@ $( "#mydiv" ).hasClass( "quux" )
   
     Looks for the paragraph that contains 'selected' as a class.
     
                 
      ***" ) );
   }, function() {
-    $( this ).find( "span:last" ).remove();
+    $( this ).find( "span" ).last().remove();
   }
 );
 
diff --git a/entries/index.xml b/entries/index.xml
index efcde43c..16b3bea9 100644
--- a/entries/index.xml
+++ b/entries/index.xml
@@ -53,7 +53,7 @@ alert( "Index: " + $( "li" ).index( listItem ) );
     
            
     
            Note that if the jQuery collection used as the .index() method's argument contains more than one element, the first element within the matched set of elements will be used.
            
     
            
-var listItems = $( "li:gt(0)" );
+var listItems = $( "li" ).slice( 1 );
 alert( "Index: " + $( "li" ).index( listItems ) );
     
            
     
            We get back the zero-based position of the first list item within the matched set:
            
@@ -133,7 +133,7 @@ $( "div" ).html( "Index: " + $( "li" ).index( listItem ) );
   }
 ]]>            
     
     
     Get the innerHeight of a paragraph.
     
     
     Get the innerWidth of a paragraph.
     
     
            
     
            Now, when the user clicks on the word "list" in the first item or anywhere in the third item, the clicked list item will be given a red background. However, when the user clicks on item 1 in the first item or anywhere in the second item, nothing will occur, because in those cases the target of the event would be <strong> or <span>, respectively.
            
-    
            Prior to jQuery 1.7, in selector strings with positional selectors such as :first, :gt(), or :even, the positional filtering is done against the jQuery object passed to .is(), not against the containing document. So for the HTML shown above, an expression such as $( "li:first" ).is( "li:last" ) returns true, but $( "li:first-child" ).is( "li:last-child" ) returns false. In addition, a bug in Sizzle prevented many positional selectors from working properly. These two factors made positional selectors almost unusable in filters.
            
-    
            Starting with jQuery 1.7, selector strings with positional selectors apply the selector against the document, and then determine whether the first element of the current jQuery set matches any of the resulting elements. So for the HTML shown above, an expression such as $( "li:first" ).is( "li:last" ) returns false. Note that since positional selectors are jQuery additions and not W3C standard, we recommend using the W3C selectors whenever feasible.
            
     
            Using a Function
            
     
            The second form of this method evaluates expressions related to elements based on a function rather than a selector. For each element, if the function returns true, .is() returns true as well. For example, given a somewhat more involved HTML snippet:
            
     
            
diff --git a/entries/jQuery.data.xml b/entries/jQuery.data.xml
index bc1bab43..8e275146 100644
--- a/entries/jQuery.data.xml
+++ b/entries/jQuery.data.xml
@@ -34,8 +34,8 @@ jQuery.data( div, "test", {
   first: 16,
   last: "pizza!"
 });
-$( "span:first" ).text( jQuery.data( div, "test" ).first );
-$( "span:last" ).text( jQuery.data( div, "test" ).last );
+$( "span" ).first().text( jQuery.data( div, "test" ).first );
+$( "span" ).last().text( jQuery.data( div, "test" ).last );
 ]]>
       Set a data store for 2 names then remove one of them.
     
     
     
     
   Selects all elements that are the last child of their parent.
   
-    
            While :last matches only a single element, :last-child can match more than one: one for each parent.
            
+    
            While .last() matches only a single element, :last-child can match more than one: one for each parent.
            
               
   
     Find the last span in each matched div and add some css plus a hover state.
diff --git a/entries/last-selector.xml b/entries/last-selector.xml
index 2cbd886f..42cd8490 100644
--- a/entries/last-selector.xml
+++ b/entries/last-selector.xml
@@ -1,5 +1,5 @@
 
-
+
   :last Selector
   :last
   
@@ -7,13 +7,14 @@
   
   Selects the last matched element.
   
+    
            As of jQuery 3.4, the :last pseudo-class is deprecated. Remove it from your selectors and filter the results later using .last().
            
     
            Note that :last selects a single element by filtering  the current jQuery collection and matching the last element within it.
            
               
   
   
     Finds the last table row.
     
     
@@ -26,4 +27,5 @@ $( "tr:last" ).css({ backgroundColor: "yellow", fontWeight: "bolder" });
   
   
   
+  
             
diff --git a/entries/lt-selector.xml b/entries/lt-selector.xml
index b85b5f77..d8c893ea 100644
--- a/entries/lt-selector.xml
+++ b/entries/lt-selector.xml
@@ -1,5 +1,5 @@
 
-
+
   :lt() Selector
   
     :lt(index)
@@ -17,6 +17,7 @@
   
   Select all elements at an index less than index within the matched set.
   
+    
            As of jQuery 3.4, the :lt pseudo-class is deprecated. Remove it from your selectors and filter the results later using .slice(). For example, :lt(3) can be replaced with a call to .slice( 0, 3 ).
            
     
            
       index-related selectors
     
            
@@ -42,4 +43,5 @@ $( "td:lt(-2)" ).css( "color", "red" );
   
   
   
+  
             
diff --git a/entries/mouseenter.xml b/entries/mouseenter.xml
index f9c39697..08bb0632 100644
--- a/entries/mouseenter.xml
+++ b/entries/mouseenter.xml
@@ -84,21 +84,21 @@ $( "#other" ).click(function() {
 var i = 0;
 $( "div.overout" )
   .mouseover(function() {
-    $( "p:first", this ).text( "mouse over" );
-    $( "p:last", this ).text( ++i );
+    $( "p", this ).first().text( "mouse over" );
+    $( "p", this ).last().text( ++i );
   })
   .mouseout(function() {
-    $( "p:first", this ).text( "mouse out" );
+    $( "p", this ).first().text( "mouse out" );
   });
 
 var n = 0;
 $( "div.enterleave" )
   .mouseenter(function() {
-    $( "p:first", this ).text( "mouse enter" );
-    $( "p:last", this ).text( ++n );
+    $( "p", this ).first().text( "mouse enter" );
+    $( "p", this ).last().text( ++n );
   })
   .mouseleave(function() {
-    $( "p:first", this ).text( "mouse leave" );
+    $( "p", this ).first().text( "mouse leave" );
   });
 ]]>
     
     
     300
diff --git a/entries/mouseout.xml b/entries/mouseout.xml
index 57304cb1..d95273c5 100644
--- a/entries/mouseout.xml
+++ b/entries/mouseout.xml
@@ -85,21 +85,21 @@ $( "#other" ).click(function() {
 var i = 0;
 $( "div.overout" )
   .mouseout(function() {
-    $( "p:first", this ).text( "mouse out" );
-    $( "p:last", this ).text( ++i );
+    $( "p", this ).first().text( "mouse out" );
+    $( "p", this ).last().text( ++i );
   })
   .mouseover(function() {
-    $( "p:first", this ).text( "mouse over" );
+    $( "p", this ).first().text( "mouse over" );
   });
 
 var n = 0;
 $( "div.enterleave" )
   .on( "mouseenter", function() {
-    $( "p:first", this ).text( "mouse enter" );
+    $( "p", this ).first().text( "mouse enter" );
   })
   .on( "mouseleave", function() {
-    $( "p:first", this ).text( "mouse leave" );
-    $( "p:last", this ).text( ++n );
+    $( "p", this ).first().text( "mouse leave" );
+    $( "p", this ).last().text( ++n );
   });
 ]]>
     
     Locate all the divs after the first and give them a class.
     
     
   Selects all elements that are the nth-child of their parent.
   
-    
            Because jQuery's implementation of :nth- selectors is strictly derived from the CSS specification, the value of n is "1-indexed", meaning that the counting starts at 1. For other selector expressions such as :eq() or :even jQuery follows JavaScript's "0-indexed" counting. Given a single <ul> containing two <li>s, $( "li:nth-child(1)" ) selects the first <li> while  $( "li:eq(1)" ) selects the second.
            
-    
            The :nth-child(n) pseudo-class is easily confused with :eq(n), even though the two can result in dramatically different matched elements. With :nth-child(n), all children are counted, regardless of what they are, and the specified element is selected only if it matches the selector attached to the pseudo-class. With :eq(n) only the selector attached to the pseudo-class is counted, not limited to children of any other element, and the (n+1)th one (n is 0-based) is selected.
            
+    
            Because jQuery's implementation of :nth- selectors is strictly derived from the CSS specification, the value of n is "1-indexed", meaning that the counting starts at 1. jQuery methods like .first() or .eq() jQuery follows JavaScript's "0-indexed" counting. Given a single <ul> containing two <li>s, $( "li:nth-child(1)" ) selects the first <li> while  $( "li" ).eq( 1 ) selects the second.
            
+    
            The :nth-child(n) pseudo-class is easily confused with the .eq( n ) call, even though the two can result in dramatically different matched elements. With :nth-child(n), all children are counted, regardless of what they are, and the specified element is selected only if it matches the selector attached to the pseudo-class. With the .eq( n ) call only the selector attached to the pseudo-class is counted, not limited to children of any other element, and the (n+1)th one (n is 0-based) is selected.
            
     
            Further discussion of this unusual usage can be found in the W3C CSS specification.
            
               
   
diff --git a/entries/nth-last-child-selector.xml b/entries/nth-last-child-selector.xml
index 9d63636a..c71dc0be 100644
--- a/entries/nth-last-child-selector.xml
+++ b/entries/nth-last-child-selector.xml
@@ -10,7 +10,7 @@
   
   Selects all elements that are the nth-child of their parent, counting from the last element to the first.
   
-    
            Because jQuery's implementation of :nth- selectors is strictly derived from the CSS specification, the value of n is "1-indexed", meaning that the counting starts at 1. For other selector expressions such as :eq() or :even jQuery follows JavaScript's "0-indexed" counting. Given a single <ul> containing three <li>s, $( "li:nth-last-child(1)" ) selects the third, last, <li>.
            
+    
            Because jQuery's implementation of :nth- selectors is strictly derived from the CSS specification, the value of n is "1-indexed", meaning that the counting starts at 1. For other selector expressions such as .first() or .eq() jQuery follows JavaScript's "0-indexed" counting. Given a single <ul> containing three <li>s, $( "li:nth-last-child(1)" ) selects the third, last, <li>.
            
     
            Further discussion of this usage can be found in the W3C CSS specification.
            
               
   
diff --git a/entries/nth-last-of-type-selector.xml b/entries/nth-last-of-type-selector.xml
index 602d430a..73d488ae 100644
--- a/entries/nth-last-of-type-selector.xml
+++ b/entries/nth-last-of-type-selector.xml
@@ -10,7 +10,7 @@
   
   Selects all the elements that are the nth-child of their parent in relation to siblings with the same element name, counting from the last element to the first.
   
-    
            Because jQuery's implementation of :nth- selectors is strictly derived from the CSS specification, the value of n is "1-indexed", meaning that the counting starts at 1. For other selector expressions such as :eq() or :even jQuery follows JavaScript's "0-indexed" counting. Given a single <ul> containing three <li>s, $('li:nth-last-of-type(1)') selects the third, last, <li>.
            
+    
            Because jQuery's implementation of :nth- selectors is strictly derived from the CSS specification, the value of n is "1-indexed", meaning that the counting starts at 1. For other selector expressions such as .first() or .eq() jQuery follows JavaScript's "0-indexed" counting. Given a single <ul> containing three <li>s, $('li:nth-last-of-type(1)') selects the third, last, <li>.
            
     
            Further discussion of this usage can be found in the W3C CSS specification.
            
               
   
diff --git a/entries/nth-of-type-selector.xml b/entries/nth-of-type-selector.xml
index 89e6d452..0d93ab8c 100644
--- a/entries/nth-of-type-selector.xml
+++ b/entries/nth-of-type-selector.xml
@@ -10,7 +10,7 @@
   
   Selects all elements that are the nth child of their parent in relation to siblings with the same element name.
   
-    
            Because jQuery's implementation of :nth- selectors is strictly derived from the CSS specification, the value of n is "1-indexed", meaning that the counting starts at 1. For other selector expressions such as :eq() or :even jQuery follows JavaScript's "0-indexed" counting. 
            
+    
            Because jQuery's implementation of :nth- selectors is strictly derived from the CSS specification, the value of n is "1-indexed", meaning that the counting starts at 1. For other selector expressions such as .first() or .eq() jQuery follows JavaScript's "0-indexed" counting. 
            
     
            Further discussion of this usage can be found in the W3C CSS specification.
            
               
     
diff --git a/entries/odd-selector.xml b/entries/odd-selector.xml
index 12a75cb8..029f2e72 100644
--- a/entries/odd-selector.xml
+++ b/entries/odd-selector.xml
@@ -1,5 +1,5 @@
 
-
+
   :odd Selector
   :odd
   
@@ -33,4 +33,5 @@ $( "tr:odd" ).css( "background-color", "#bbbbff" );
   
   
   
+  
 
diff --git a/entries/offset.xml b/entries/offset.xml
index 9a588ca2..a115255c 100644
--- a/entries/offset.xml
+++ b/entries/offset.xml
@@ -19,7 +19,7 @@
      
       Access the offset of the second paragraph:
       
@@ -101,7 +101,7 @@ $( "*", document.body ).click(function( event ) {
     
       Set the offset of the second paragraph:
       
       
     Get the outerHeight of a paragraph.
     
diff --git a/entries/outerWidth.xml b/entries/outerWidth.xml
index cfb07bc8..c8e6f87e 100644
--- a/entries/outerWidth.xml
+++ b/entries/outerWidth.xml
@@ -23,8 +23,8 @@
   
     Get the outerWidth of a paragraph.
     
diff --git a/entries/position.xml b/entries/position.xml
index 3eed46b4..60b3e6a2 100644
--- a/entries/position.xml
+++ b/entries/position.xml
@@ -16,9 +16,9 @@
    
     Access the position of the second paragraph:
     
     
     Locate all the divs preceding the last div and give them a class.
     
     To replace all existing classes with another class, we can use .attr( "class", "newClass" ) instead.
            
     
            As of jQuery 1.4, the .removeClass() method allows us to indicate the class to be removed by passing in a function.
            
     
            
-$( "li:last" ).removeClass(function() {
+$( "li" ).last().removeClass(function() {
   return $( this ).prev().attr( "class" );
 });
     
            
@@ -98,7 +98,7 @@ $( "p:odd" ).removeClass( "blue under" );
   
     Remove all the classes from the matched elements.
     
     
     Set a data store for 2 names then remove one of them.
     
     
       Get the scrollLeft of a paragraph.
       
       
       Get the scrollTop of a paragraph.
       
       Animates all divs to slide down and show themselves over 600 milliseconds.
     Animates all divs to slide up, completing the animation within 400 milliseconds.
     If you'd like to prevent forms from being submitted unless a flag variable is set, try:
     
     To trigger the submit event on the first form on the page, try:
     
   
   
diff --git a/entries/text.xml b/entries/text.xml
index 3752dd10..ff9c537e 100644
--- a/entries/text.xml
+++ b/entries/text.xml
@@ -28,8 +28,8 @@
     
       Find the text in the first paragraph (stripping out the html), then set the html of the last paragraph to show it is just text (the red bold is gone).
       
       
     Clicks to button #2 also trigger a click for button #1.
     
     To submit the first form without using the submit() function, try:
     
   
   
     To submit the first form without using the submit() function, try:
     
Date: Mon, 2 Sep 2019 18:19:50 +0200
Subject: [PATCH 562/699] 1.12.42

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 7a361581..eabb5ac2 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "1.12.40",
+  "version": "1.12.42",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 079abd1d..1065425a 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.41",
+  "version": "1.12.42",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From b905a9249b81975d400d3bd8924ec77863ac49f5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Tue, 3 Sep 2019 20:14:25 +0200
Subject: [PATCH 563/699] All: Upgrade jQuery used in examples from 1.10.2 to
 3.4.1

The upgrade is necessary to be able to write examples for newer APIs.
Examples for removed APIs have been removed as they'd no longer work.

Fixes gh-982
Closes gh-1148
---
 entries/andSelf.xml             | 68 ++-------------------------------
 entries/context.xml             |  7 ++--
 entries/deferred.isRejected.xml |  4 +-
 entries/deferred.isResolved.xml |  4 +-
 entries/die.xml                 |  3 ++
 entries/error.xml               |  5 ++-
 entries/jQuery.boxModel.xml     |  8 +++-
 entries/jQuery.browser.xml      |  6 +++
 entries/jQuery.sub.xml          |  6 +--
 entries/live.xml                |  4 +-
 entries/load-event.xml          |  3 ++
 entries/selector.xml            |  4 +-
 entries/size.xml                | 26 ++-----------
 entries/unload.xml              |  3 ++
 entries2html.xsl                |  2 +-
 15 files changed, 50 insertions(+), 103 deletions(-)

diff --git a/entries/andSelf.xml b/entries/andSelf.xml
index 5adfd1ae..967c72ef 100644
--- a/entries/andSelf.xml
+++ b/entries/andSelf.xml
@@ -6,72 +6,10 @@
   
   Add the previous set of elements on the stack to the current set.
   
-    
            Note: This function has been deprecated and is now an alias for .addBack(), which should be used with jQuery 1.8 and later.
            
-    
            As described in the discussion for .end(), jQuery objects maintain an internal stack that keeps track of changes to the matched set of elements. When one of the DOM traversal methods is called, the new set of elements is pushed onto the stack. If the previous set of elements is desired as well, .andSelf() can help.
            
-    
            Consider a page with a simple list on it:
            
-    
            
-<ul>
-  <li>list item 1</li>
-  <li>list item 2</li>
-  <li class="third-item">list item 3</li>
-  <li>list item 4</li>
-  <li>list item 5</li>
-</ul>
-    
            
-    
            The result of the following code is a red background behind items 3, 4 and 5:
            
-    
            
-$( "li.third-item" ).nextAll().andSelf()
-  .css( "background-color", "red" );
-    
            
-    
            First, the initial selector locates item 3, initializing the stack with the set containing just this item. The call to .nextAll() then pushes the set of items 4 and 5 onto the stack. Finally, the .andSelf() invocation merges these two sets together, creating a jQuery object that points to all three items in document order: [ <li.third-item>, <li>, <li> ].
            
+    
            
+      
            Note: This API has been removed in jQuery 3.0; use .addBack() instead, which should work identically.
            
+    
            
               
-  
-    The .andSelf() method causes the previous set of DOM elements in the traversal stack to be added to the current set. In the first example, the top stack contains the set resulting from .find("p"). In the second example, .andSelf() adds the previous set of elements on the stack — in this case $( "div.after-andself" ) — to the current set, selecting both the div and its enclosed paragraphs.
-     p" ).addClass( "border" );
-
-// First Example
-$( "div.before-andself" ).find( "p" ).addClass( "background" );
-
-// Second Example
-$( "div.after-andself" ).find( "p" ).andSelf().addClass( "background" );
-]]>
-    
-    
-  
            Before andSelf()
            
-  
            
-    
            First Paragraph
            
-    
            Second Paragraph
            
-  
            
-
-
            
-  
            After andSelf()
            
-  
            
-    
            First Paragraph
            
-    
            Second Paragraph
            
-  
            
-
            
-]]>
-              
   
   
   
diff --git a/entries/context.xml b/entries/context.xml
index 5fc5362a..496c833a 100644
--- a/entries/context.xml
+++ b/entries/context.xml
@@ -6,7 +6,9 @@
   
   The DOM node context originally passed to jQuery(); if none was passed then context will likely be the document.
   
-    
            The .context property was deprecated in jQuery 1.10 and is only maintained to the extent needed for supporting .live() in the jQuery Migrate plugin. It may be removed without notice in a future version.
            
+    
            
+      
            Note: This API has been removed in jQuery 3.0.
            
+    
            
     
            The .live() method for binding event handlers uses this property to determine the root element to use for its event delegation needs.
            
     
            The value of this property is typically equal to document, as this is the default context for jQuery objects if none is supplied. The context may differ if, for example, the object was created by searching within an <iframe> or XML document.
            
     
            Note that the context property may only apply to the elements originally selected by jQuery(), as it is possible for the user to add elements to the collection via methods such as .add() and these may have a different context.
            
@@ -18,9 +20,6 @@ $( "ul" )
   .append( "
          • " + $( "ul" ).context + "
            • " )
   .append( "
          • " + $( "ul", document.body ).context.nodeName + "
            • " );
 ]]>            
-    
-]]>
               
   
   
diff --git a/entries/deferred.isRejected.xml b/entries/deferred.isRejected.xml
index 5fdd1e95..60ddb77b 100644
--- a/entries/deferred.isRejected.xml
+++ b/entries/deferred.isRejected.xml
@@ -6,7 +6,9 @@
   
    Determine whether a Deferred object has been rejected. 
   
-    
            As of jQuery 1.7 this API has been deprecated; please use deferred.state() instead.
            
+    
            
+      
            Note: This API has been removed in jQuery 1.8; please use deferred.state() instead.
            
+    
            
     
            Returns true if the Deferred object is in the rejected state, meaning that either deferred.reject() or deferred.rejectWith() has been called for the object and the failCallbacks have been called (or are in the process of being called).
            
     
            Note that a Deferred object can be in one of three states: pending, resolved, or rejected; use deferred.isResolved() to determine whether the Deferred object is in the resolved state. These methods are primarily useful for debugging, for example to determine whether a Deferred has already been resolved even though you are inside code that intended to reject it.
            
               
diff --git a/entries/deferred.isResolved.xml b/entries/deferred.isResolved.xml
index b5941322..9c046e5a 100644
--- a/entries/deferred.isResolved.xml
+++ b/entries/deferred.isResolved.xml
@@ -6,7 +6,9 @@
   
    Determine whether a Deferred object has been resolved. 
   
-    
            This API is deprecated as of jQuery 1.7 and removed as of jQuery 1.8; please use deferred.state() instead.
            
+    
            
+      
            Note: This API has been removed in jQuery 1.8; please use deferred.state() instead.
            
+    
            
     
            Returns true if the Deferred object is in the resolved state, meaning that either deferred.resolve() or deferred.resolveWith() has been called for the object and the doneCallbacks have been called (or are in the process of being called).
            
     
            Note that a Deferred object can be in one of three states: pending, resolved, or rejected; use deferred.isRejected() to determine whether the Deferred object is in the rejected state. These methods are primarily useful for debugging, for example to determine whether a Deferred has already been resolved even though you are inside code that intended to reject it.
            
               
diff --git a/entries/die.xml b/entries/die.xml
index a3d038ec..efe2e614 100644
--- a/entries/die.xml
+++ b/entries/die.xml
@@ -21,6 +21,9 @@
     
   
   
+    
            
+      
            Note: This API has been removed in jQuery 1.9; please use on() instead.
            
+    
            
     
            Any handler that has been attached with .live() can be removed with .die(). This method is analogous to calling .off() with no arguments, which is used to remove all handlers attached with .on().
   See the discussions of .live() and .off() for further details.
            
     
            If used without an argument, .die() removes all event handlers previously attached using .live() from the elements.
            
diff --git a/entries/error.xml b/entries/error.xml
index 6f646aa2..47d9e0e9 100644
--- a/entries/error.xml
+++ b/entries/error.xml
@@ -20,8 +20,9 @@
     
   
   
-    
            This method is a shortcut for .on( "error", handler ).
            
-    
            As of jQuery 1.8, the .error() method is deprecated. Use .on( "error", handler ) to attach event handlers to the error event instead.
            
+    
            
+      
            Note: This API has been removed in jQuery 3.0; please use .on( "error", handler ) instead of .error( handler ) and .trigger( "error" ) instead of .error().
            
+    
            
     
            The error event is sent to elements, such as images, that are referenced by a document and loaded by the browser. It is called if the element was not loaded correctly.
            
     
            For example, consider a page with a simple image element:
            
     
            
diff --git a/entries/jQuery.boxModel.xml b/entries/jQuery.boxModel.xml
index ac464850..b80abe29 100644
--- a/entries/jQuery.boxModel.xml
+++ b/entries/jQuery.boxModel.xml
@@ -4,8 +4,12 @@
   
     1.0
   
-  States if the current page, in the user's browser, is being rendered using the W3C CSS Box Model. This property was removed in jQuery 1.8. Please try to use feature detection instead.
-  
+  States if the current page, in the user's browser, is being rendered using the W3C CSS Box Model.
+  
+    
            
+      
            Note: This API has been removed in jQuery 3.0; check if .document.compatMode is equal to "CSS1Compat" instead. Or, even better - always specify a DOCTYPE and avoid using quirks mode which jQuery doesn't support.
            
+    
            
+              
   
   
   
diff --git a/entries/jQuery.browser.xml b/entries/jQuery.browser.xml
index 667ed5f1..11686eae 100644
--- a/entries/jQuery.browser.xml
+++ b/entries/jQuery.browser.xml
@@ -7,6 +7,9 @@
     
     Contains flags for the useragent, read from navigator.userAgent. This property was removed in jQuery 1.9 and is available only through the jQuery.migrate plugin. Please try to use feature detection instead.
     
+      
            
+        
            Note: This API has been removed in jQuery 1.9; please rely on feature detection instead.
            
+      
            
       
            The $.browser property provides information about the web browser that is accessing the page, as reported by the browser itself. It contains flags for each of the four most prevalent browser classes (Internet Explorer, Mozilla, Webkit, and Opera) as well as version information.
            
       
            Available flags are:
            
       
              
@@ -56,6 +59,9 @@ $.browser.msie;
     
     The version number of the rendering engine for the user's browser. This property was removed in jQuery 1.9 and is available only through the jQuery.migrate plugin.
     
+      
              
+        
              Note: This API has been removed in jQuery 1.9; please rely on feature detection instead.
              
+      
              
       
              Here are some typical results:
              
       
                
         
              • Internet Explorer: 6.0, 7.0, 8.0
                • 
diff --git a/entries/jQuery.sub.xml b/entries/jQuery.sub.xml
index a52c9ab6..bc0330e4 100644
--- a/entries/jQuery.sub.xml
+++ b/entries/jQuery.sub.xml
@@ -6,9 +6,9 @@
   
   Creates a new copy of jQuery whose properties and methods can be modified without affecting the original jQuery object.
   
-    
                
-      This method is deprecated as of jQuery 1.7 and will be moved to a plugin in jQuery 1.8.
-    
                
+    
                
+      
                Note: This API has been removed in jQuery 1.9.
                
+    
                
     
                There are two specific use cases for which jQuery.sub() was created. The first was for providing a painless way of overriding jQuery methods without completely destroying the original methods and another was for helping to do encapsulation and basic namespacing for jQuery plugins.
                
     
                Note that jQuery.sub() doesn't attempt to do any sort of isolation - that's not its intention. All the methods on the sub'd version of jQuery will still point to the original jQuery (events bound and triggered will still be through the main jQuery, data will be bound to elements through the main jQuery, Ajax queries and events will run through the main jQuery, etc.).
                
     
                Note that if you're looking to use this for plugin development you should first strongly consider using something like the jQuery UI widget factory which manages both state and plugin sub-methods. Some examples of using the jQuery UI widget factory to build a plugin.
                
diff --git a/entries/live.xml b/entries/live.xml
index 049322e2..e88a67ce 100644
--- a/entries/live.xml
+++ b/entries/live.xml
@@ -32,7 +32,9 @@
     
   
   
-    
                As of jQuery 1.7, the .live() method is deprecated. Use .on() to attach event handlers. Users of older versions of jQuery should use .delegate() in preference to .live().
                
+    
                
+      
                Note: This API has been removed in jQuery 1.9; please use on() instead.
                
+    
                
     
                This method provides a means to attach delegated event handlers to the document element of a page, which simplifies the use of event handlers when content is dynamically added to a page. See the discussion of direct versus delegated events in the .on() method for more information. 
                
     
                Rewriting the .live() method in terms of its successors is straightforward; these are templates for equivalent calls for all three event attachment methods:
                
     
                
diff --git a/entries/load-event.xml b/entries/load-event.xml
index e3739cb7..b9669cc6 100644
--- a/entries/load-event.xml
+++ b/entries/load-event.xml
@@ -20,6 +20,9 @@
     
   
   
+    
                
+      
                Note: This API has been removed in jQuery 3.0; please use .on( "load", handler ) instead of .load( handler ) and .trigger( "load" ) instead of .load().
                
+    
                
     
                This method is a shortcut for .on( "load", handler ).
                
     
                The load event is sent to an element when it and all sub-elements have been completely loaded. This event can be sent to any element associated with a URL: images, scripts, frames, iframes, and the window object.
                
     
                For example, consider a page with a simple image:
                
diff --git a/entries/selector.xml b/entries/selector.xml
index d64fc0aa..229e674b 100644
--- a/entries/selector.xml
+++ b/entries/selector.xml
@@ -6,7 +6,9 @@
   
   A selector representing selector passed to jQuery(), if any, when creating the original set.
   
-    
                The .selector property was deprecated in jQuery 1.7 and is only maintained to the extent needed for supporting .live() in the jQuery Migrate plugin. It may be removed without notice in a future version. The property was never a reliable indicator of the selector that could be used to obtain the set of elements currently contained in the jQuery set where it was a property, since subsequent traversal methods may have changed the set. Plugins that need to use a selector string within their plugin can require it as a parameter of the method. For example, a "foo" plugin could be written as $.fn.foo = function( selector, options ) { /* plugin code goes here */ };, and the person using the plugin would write $( "div.bar" ).foo( "div.bar", {dog: "bark"} ); with the "div.bar" selector repeated as the first argument of .foo().
                
+    
                
+      
                Note: This API has been removed in jQuery 3.0. The property was never a reliable indicator of the selector that could be used to obtain the set of elements currently contained in the jQuery set where it was a property, since subsequent traversal methods may have changed the set. Plugins that need to use a selector string within their plugin can require it as a parameter of the method. For example, a "foo" plugin could be written as $.fn.foo = function( selector, options ) { /* plugin code goes here */ };, and the person using the plugin would write $( "div.bar" ).foo( "div.bar", {dog: "bark"} ); with the "div.bar" selector repeated as the first argument of .foo().
                
+    
                
                   
   
   
diff --git a/entries/size.xml b/entries/size.xml
index e7dd1223..18052147 100644
--- a/entries/size.xml
+++ b/entries/size.xml
@@ -6,7 +6,9 @@
   
   Return the number of elements in the jQuery object.
   
-    
                The .size() method is deprecated as of jQuery 1.8. Use the .length property instead.
                
+    
                
+      
                Note: This method has been removed in jQuery 3.0. Use the .length property instead.
                
+    
                
 
     
                The .size() method is functionally equivalent to the .length property; however, the .length property is preferred because it does not have the overhead of a function call.
                
     
                Given a simple unordered list on the page:
                
@@ -30,7 +32,7 @@ alert( "Size: " + $( "li" ).length );
     
                
                   
   
-    Count the divs. Click to add more.
+    Count the divs.
     
-    
-    
-
                
-]]>
                   
   
   
diff --git a/entries/unload.xml b/entries/unload.xml
index 1306ddd6..b57d14f4 100644
--- a/entries/unload.xml
+++ b/entries/unload.xml
@@ -20,6 +20,9 @@
   
   Bind an event handler to the "unload" JavaScript event.
   
+    
                
+      
                Note: This API has been removed in jQuery 3.0; please use .on( "unload", handler ) instead of .unload( handler ) and .trigger( "unload" ) instead of .unload().
                
+    
                
     
                This method is a shortcut for .on( "unload", handler ).
                
     
                The unload event is sent to the window element when the user navigates away from the page. This could mean one of many things. The user could have clicked on a link to leave the page, or typed in a new URL in the address bar. The forward and back buttons will trigger the event. Closing the browser window will cause the event to be triggered. Even a page reload will first create an unload event.
                
     
                
diff --git a/entries2html.xsl b/entries2html.xsl
index fe2dc09b..8237a92f 100755
--- a/entries2html.xsl
+++ b/entries2html.xsl
@@ -12,7 +12,7 @@
 	<meta charset="utf-8">
 	<title> demo</title>
 	<style>	</style>
-	<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
+	<script src="https://code.jquery.com/jquery-3.4.1.js"></script>
 	<script>
 	
 	</script>

From 28d2e7daf668bf53b54d8ed45b4864cd44f6a17b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Tue, 3 Sep 2019 20:15:21 +0200
Subject: [PATCH 564/699] 1.12.43

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index eabb5ac2..b5140bce 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "1.12.42",
+  "version": "1.12.43",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 1065425a..69a0906c 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.42",
+  "version": "1.12.43",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 7010c4cf78b4333724084720ba536b2b0750e205 Mon Sep 17 00:00:00 2001
From: Andrea Rendine 
Date: Fri, 4 Oct 2019 19:23:44 +0200
Subject: [PATCH 565/699] jQuery.post: Reference $.post instead of $.get

Fixed a copypaste misprint from get to post.

Closes #1151
---
 entries/jQuery.post.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.post.xml b/entries/jQuery.post.xml
index 6152350a..06e353f8 100644
--- a/entries/jQuery.post.xml
+++ b/entries/jQuery.post.xml
@@ -50,7 +50,7 @@ $.post( "ajax/test.html", function( data ) {
     
                This example fetches the requested HTML snippet and inserts it on the page.
                
     
                Pages fetched with POST are never cached, so the cache and ifModified options in jQuery.ajaxSetup() have no effect on these requests.
                
     
                The jqXHR Object
                
-    
                As of jQuery 1.5, all of jQuery's Ajax methods return  a superset of the XMLHTTPRequest object. This jQuery XHR object, or "jqXHR," returned by $.get() implements the Promise interface, giving it all the properties, methods, and behavior of a Promise (see Deferred object for more information). The jqXHR.done() (for success), jqXHR.fail() (for error), and jqXHR.always() (for completion, whether success or error; added in jQuery 1.6) methods take a function argument that is called when the request terminates. For information about the arguments this function receives, see the jqXHR Object section of the $.ajax() documentation.
                
+    
                As of jQuery 1.5, all of jQuery's Ajax methods return  a superset of the XMLHTTPRequest object. This jQuery XHR object, or "jqXHR," returned by $.post() implements the Promise interface, giving it all the properties, methods, and behavior of a Promise (see Deferred object for more information). The jqXHR.done() (for success), jqXHR.fail() (for error), and jqXHR.always() (for completion, whether success or error; added in jQuery 1.6) methods take a function argument that is called when the request terminates. For information about the arguments this function receives, see the jqXHR Object section of the $.ajax() documentation.
                
         
                The Promise interface also allows jQuery's Ajax methods, including $.get(), to chain multiple .done(), .fail(), and .always() callbacks on a single request, and even to assign these callbacks after the request may have completed. If the request is already complete, the callback is fired immediately.
                
     
                
 // Assign handlers immediately after making the request,

From d786cbf630fcbd23894cd9bf0b6ccd659ee84b6f Mon Sep 17 00:00:00 2001
From: Andrea Rendine 
Date: Fri, 4 Oct 2019 19:27:33 +0200
Subject: [PATCH 566/699] jQuery.getJSON: Change the removed jqXHR.complete to
 jqXHR.always

`jqXHR.complete` has been removed in jQuery 3.0.

Closes #1150
---
 entries/jQuery.getJSON.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.getJSON.xml b/entries/jQuery.getJSON.xml
index 07a926cc..1449293d 100644
--- a/entries/jQuery.getJSON.xml
+++ b/entries/jQuery.getJSON.xml
@@ -82,7 +82,7 @@ var jqxhr = $.getJSON( "example.json", function() {
 // Perform other work here ...
 
 // Set another completion function for the request above
-jqxhr.complete(function() {
+jqxhr.always(function() {
   console.log( "second complete" );
 });
     
                

From 9580ed588314195835a72b846a584cb6ea885d6a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Fri, 4 Oct 2019 19:28:01 +0200
Subject: [PATCH 567/699] 1.12.44

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index b5140bce..a6997d27 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "1.12.43",
+  "version": "1.12.44",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 69a0906c..1e74de29 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.43",
+  "version": "1.12.44",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From be6de733d57d67634ef07dcfc38163d18945c0e4 Mon Sep 17 00:00:00 2001
From: Veniamin Krol <153412+vkrol@users.noreply.github.com>
Date: Sat, 5 Oct 2019 15:48:30 +0300
Subject: [PATCH 568/699] jQuery.ajax: Clarify errorThrown and statusText may
 be empty in HTTP/2

Fixes #1063
Closes #1146
---
 entries/jQuery.ajax.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index f75de949..c22347fb 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -109,7 +109,7 @@ $.ajax({
         
         
         
-        A function to be called if the request fails. The function receives three arguments: The jqXHR (in jQuery 1.4.x, XMLHttpRequest) object, a string describing the type of error that occurred and an optional exception object, if one occurred. Possible values for the second argument (besides null) are "timeout", "error", "abort", and "parsererror". When an HTTP error occurs, errorThrown receives the textual portion of the HTTP status, such as "Not Found" or "Internal Server Error."  As of jQuery 1.5, the error setting can accept an array of functions. Each function will be called in turn.  Note: This handler is not called for cross-domain script and cross-domain JSONP requests. This is an Ajax Event.
+        A function to be called if the request fails. The function receives three arguments: The jqXHR (in jQuery 1.4.x, XMLHttpRequest) object, a string describing the type of error that occurred and an optional exception object, if one occurred. Possible values for the second argument (besides null) are "timeout", "error", "abort", and "parsererror". When an HTTP error occurs, errorThrown receives the textual portion of the HTTP status, such as "Not Found" or "Internal Server Error." (in HTTP/2 it may instead be an empty string) As of jQuery 1.5, the error setting can accept an array of functions. Each function will be called in turn.  Note: This handler is not called for cross-domain script and cross-domain JSONP requests. This is an Ajax Event.
       
       
         Whether to trigger global Ajax event handlers for this request. The default is true. Set to false to prevent the global handlers like ajaxStart or ajaxStop from being triggered. This can be used to control various Ajax Events.
@@ -290,7 +290,7 @@ jqxhr.always(function() {
         status
       
       
              • 
-        statusText
+        statusText (may be an empty string in HTTP/2)
       
                • 
       
              • 
         abort( [ statusText ] )

From 660e0a1a87b75dad5da7c878021178b5130852f6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Sat, 5 Oct 2019 14:49:13 +0200
Subject: [PATCH 569/699] 1.12.45

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index a6997d27..2cde7b4e 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "1.12.44",
+  "version": "1.12.45",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 1e74de29..f53f2e26 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.44",
+  "version": "1.12.45",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From b1951ddfd19ceae1746bb91e1f8e5de6486ddfda Mon Sep 17 00:00:00 2001
From: Ed S 
Date: Wed, 13 Nov 2019 17:50:24 +0000
Subject: [PATCH 570/699] jQuery.queue: document it returns an array

Fixes #1153
Closes #1155
---
 entries/jQuery.queue.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.queue.xml b/entries/jQuery.queue.xml
index 3921e020..b15912ab 100644
--- a/entries/jQuery.queue.xml
+++ b/entries/jQuery.queue.xml
@@ -70,7 +70,7 @@ runIt();
     
     
   
-  
+  
     
       1.3
       

From 81f438d5dfc02fcdbfed08f3caa177c23404244a Mon Sep 17 00:00:00 2001
From: Ed S 
Date: Wed, 13 Nov 2019 17:50:58 +0000
Subject: [PATCH 571/699] jQuery.removeData: document it returns undefined

Not to be confused with the `removeData` method, which does return
a jQuery collection.

Fixes #1153
Closes #1154
---
 entries/jQuery.removeData.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.removeData.xml b/entries/jQuery.removeData.xml
index f85d622b..6a92a25f 100644
--- a/entries/jQuery.removeData.xml
+++ b/entries/jQuery.removeData.xml
@@ -1,5 +1,5 @@
 
-
+
   jQuery.removeData()
   
     1.2.3

From 86ddf41e86ee2d2ac4dd16730a9945f467de8a09 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Wed, 13 Nov 2019 18:53:39 +0100
Subject: [PATCH 572/699] 1.12.46

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 2cde7b4e..00769c62 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "1.12.45",
+  "version": "1.12.46",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index f53f2e26..71a1d282 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.45",
+  "version": "1.12.46",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From f79b51cfb1f15f756ca842afcb2d76ed3290a63d Mon Sep 17 00:00:00 2001
From: Theodore Keloglou 
Date: Fri, 28 Feb 2020 12:19:45 +0000
Subject: [PATCH 573/699] insertAfter: Change hyphen with em dash

Closes gh-1158
---
 entries/insertAfter.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/insertAfter.xml b/entries/insertAfter.xml
index 9065d305..8c406cfa 100644
--- a/entries/insertAfter.xml
+++ b/entries/insertAfter.xml
@@ -14,7 +14,7 @@
   
   Insert every element in the set of matched elements after the target.
   
-    
                The .after() and .insertAfter() methods perform the same task. The major difference is in the syntax-specifically, in the placement of the content and target. With .after(), the selector expression preceding the method is the container after which the content is inserted. With .insertAfter(), on the other hand, the content precedes the method, either as a selector expression or as markup created on the fly, and it is inserted after the target container.
                
+    
                The .after() and .insertAfter() methods perform the same task. The major difference is in the syntax—specifically, in the placement of the content and target. With .after(), the selector expression preceding the method is the container after which the content is inserted. With .insertAfter(), on the other hand, the content precedes the method, either as a selector expression or as markup created on the fly, and it is inserted after the target container.
                
     
                Consider the following HTML:
                
     
                
 <div class="container">

From 324e63d55ba02378b881608c69f26ba8d407023a Mon Sep 17 00:00:00 2001
From: Kostiantyn Plakhotia 
Date: Mon, 13 Apr 2020 18:23:59 +0300
Subject: [PATCH 574/699] Types: Update link to QUnit.assert docs

Closes #1159
---
 pages/Types.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pages/Types.html b/pages/Types.html
index fd4df2ca..6221434f 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -666,4 +666,4 @@ 
                Callbacks Object
                
 
                XML Document
                
 
                A document object created by the browser's XML DOM parser, usually from a string representing XML. XML documents have different semantics than HTML documents, but most of the traversing and manipulation methods provided by jQuery will work with them.
                
 
                Assert
                
-
                A reference to or instance of the object holding all of QUnit's assertions. See the API documentation for QUnit.assert for details.
                
+
                A reference to or instance of the object holding all of QUnit's assertions. See the API documentation for QUnit.assert for details.
                

From 0b081f2a3daa2697255045283c54c58fd12beaa7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Fri, 17 Apr 2020 11:53:05 +0200
Subject: [PATCH 575/699] 1.12.47

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 00769c62..d1c4096e 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "1.12.46",
+  "version": "1.12.47",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 71a1d282..63c7e90a 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.46",
+  "version": "1.12.47",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 67942f9092c56edaf01327b21db4405748b24fd7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Wed, 29 Apr 2020 17:42:50 +0200
Subject: [PATCH 576/699] Travis: Test on Node 10 instead of 8 which is EOL

---
 .travis.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index 8b645e42..c4177e89 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,6 +1,6 @@
 language: node_js
 node_js:
-  - "8"
+  - "10"
 addons:
   apt:
     packages:

From 13b661bd061b7c341cc74a44e6653937ebb9f556 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Wed, 29 Apr 2020 17:46:39 +0200
Subject: [PATCH 577/699] All: Updates for jQuery 1.12/2.2-3.5

Fixes #947
Fixes #949
Fixes #950
Fixes #1142
Ref #970
Ref #972
Closes #1160
---
 categories.xml                   | 43 +++++++++++++++++++-
 entries/addClass.xml             | 33 +++++++++++++++-
 entries/contents.xml             |  2 +
 entries/css.xml                  |  4 ++
 entries/eq-selector.xml          |  4 +-
 entries/even-selector.xml        |  5 ++-
 entries/even.xml                 | 47 ++++++++++++++++++++++
 entries/filter.xml               |  4 +-
 entries/first-selector.xml       |  4 +-
 entries/first.xml                | 19 ++++-----
 entries/gt-selector.xml          |  4 +-
 entries/hover.xml                |  4 +-
 entries/jQuery.ajax.xml          |  3 +-
 entries/jQuery.extend.xml        |  2 +
 entries/jQuery.get.xml           |  3 +-
 entries/jQuery.getScript.xml     |  2 +
 entries/jQuery.holdReady.xml     | 13 +++++-
 entries/jQuery.htmlPrefilter.xml | 68 ++------------------------------
 entries/jQuery.isArray.xml       |  6 ++-
 entries/jQuery.isFunction.xml    |  4 +-
 entries/jQuery.isNumeric.xml     |  6 ++-
 entries/jQuery.isWindow.xml      |  6 +++
 entries/jQuery.now.xml           | 10 +++--
 entries/jQuery.post.xml          |  3 +-
 entries/jQuery.proxy.xml         |  6 ++-
 entries/jQuery.trim.xml          |  6 ++-
 entries/jQuery.type.xml          | 14 ++++---
 entries/jQuery.uniqueSort.xml    |  4 +-
 entries/last-selector.xml        |  4 +-
 entries/last.xml                 | 11 ++++--
 entries/lt-selector.xml          |  4 +-
 entries/not.xml                  |  4 +-
 entries/nth-child-selector.xml   | 13 ++++--
 entries/odd-selector.xml         |  5 ++-
 entries/odd.xml                  | 47 ++++++++++++++++++++++
 entries/removeClass.xml          | 44 +++++++++++++++++++--
 entries/toggleClass.xml          | 31 +++++++++++----
 entries2html.xsl                 |  2 +-
 38 files changed, 367 insertions(+), 127 deletions(-)
 create mode 100644 entries/even.xml
 create mode 100644 entries/odd.xml

diff --git a/categories.xml b/categories.xml
index 78f012b1..22dbd59b 100644
--- a/categories.xml
+++ b/categories.xml
@@ -71,6 +71,11 @@
         
                For more information, see the Release Notes/Changelog at https://blog.jquery.com/2016/06/09/jquery-3-0-final-released/
                
       ]]>
     
+    
+      For more information, see the Release Notes/Changelog at https://blog.jquery.com/2017/03/16/jquery-3-2-0-is-out/
                
+      ]]>                
+                    
     
       For more information, see the Release Notes/Changelog at https://blog.jquery.com/2018/01/19/jquery-3-3-0-a-fragrant-bouquet-of-deprecations-and-is-that-a-new-feature/
                
@@ -81,6 +86,11 @@
         
                For more information, see the Release Notes/Changelog at https://blog.jquery.com/2019/04/10/jquery-3-4-0-released/
                
       ]]>                
                     
+    
+      For more information, see the Release Notes/Changelog at https://blog.jquery.com/2020/04/10/jquery-3-5-0-released/
                
+      ]]>                
+                    
   
   
     
@@ -429,7 +439,7 @@ var files = event.originalEvent.dataTransfer.files;
         
                
       ]]>
                     
-    
+    
       Aspects of the API that were changed in the corresponding versions of jQuery. Changes in jQuery 1.12 and 2.2 includes performance improvements of the selector engine, manipulation of class names for SVG elements, support for the Symbol type and iterators added in ES2015, and a new hook has been added for filtering HTML. A jQuery Migrate Plugin was offered to help developers with a transitional upgrade path.
         
                
@@ -447,7 +457,36 @@ var files = event.originalEvent.dataTransfer.files;
                     
     
       jQuery.readyException was added.
                
+        
                Aspects of the API that were changed in the corresponding version of jQuery. Version 3.1 added the jQuery.readyException API.
                
+        
                For more information, see the Release Notes/Changelog
                
+        
                
+      ]]>                
+                    
+    
+      Aspects of the API that were changed in the corresponding version of jQuery. Version 3.2 added support for custom CSS properties, made .contents() work on the <template> element & made .width() & .height() ignore CSS transforms. A few APIs were deprecated. The deprecated module was added back to the slim build.
                
+        
                For more information, see the Release Notes/Changelog
                
+        
                
+      ]]>                
+                    
+    
+      Aspects of the API that were changed in the corresponding version of jQuery. .addClass(), .removeClass() & .toggleClass() now work on arrays of classes; a few APIs were deprecated.
                
+        
                For more information, see the Release Notes/Changelog
                
+        
                
+      ]]>                
+                    
+    
+      Aspects of the API that were changed in the corresponding version of jQuery. nonce & nomodule attributes are now preserved during script manipulation, layout thrashing was eliminated in some cases in .width() & .height() APIs. Radio elements state is now updated before event handlers run. Passing data now works when triggering all events, including focus. A minor security fix is also included.
                
+        
                For more information, see the Release Notes/Changelog
                
+        
                
+      ]]>                
+                    
+    
+      Aspects of the API that were changed in the corresponding version of jQuery. Security fixes, new .even() & .odd() methods; jQuery.globalEval now accepts context; unsuccessful HTTP script responses are no longer evaluated; performance improvements. jQuery.trim is now deprecated.
                
+        
                For more information, see the jQuery Core 3.5 Upgrade guide and the Release Notes/Changelog
                
         
                
       ]]>                
                     
diff --git a/entries/addClass.xml b/entries/addClass.xml
index 3b28a708..9af9723a 100644
--- a/entries/addClass.xml
+++ b/entries/addClass.xml
@@ -7,10 +7,16 @@
       One or more space-separated classes to be added to the class attribute of each matched element.
     
   
+  
+    3.3
+    
+      An array of classes to be added to the class attribute of each matched element.
+    
+  
   
     1.4
     
-      A function returning one or more space-separated class names to be added to the existing class name(s). Receives the index position of the element in the set and the existing class name(s) as arguments. Within the function, this refers to the current element in the set.
+      A function returning one or more space-separated classes or an array of classes to be added to the existing class name(s). Receives the index position of the element in the set and the existing class name(s) as arguments. Within the function, this refers to the current element in the set.
       
       
       
@@ -82,6 +88,29 @@ $( "p" ).last().addClass( "selected highlight" );
 
                Hello
                
 
                and
                
 
                Goodbye
                
+]]>
+  
+  
+    Add the classes "selected" and "highlight" to the matched elements (3.3+ syntax).
+    
+    
+    Hello
                
+
                and
                
+
                Goodbye
                
 ]]>
                   
   
@@ -122,4 +151,6 @@ $( "div" ).addClass(function( index, currentClass ) {
   
   
   
+  
+  
 
diff --git a/entries/contents.xml b/entries/contents.xml
index f4118e0c..950411ba 100644
--- a/entries/contents.xml
+++ b/entries/contents.xml
@@ -8,6 +8,7 @@
   
     
                Given a jQuery object that represents a set of DOM elements, the .contents() method allows us to search through the immediate children of these elements in the DOM tree and construct a new jQuery object from the matching elements. The .contents() and .children() methods are similar, except that the former includes text nodes and comment nodes as well as HTML elements in the resulting jQuery object. Please note that most jQuery operations don't support text nodes and comment nodes. The few that do will have an explicit note on their API documentation page.
                
     
                The .contents() method can also be used to get the content document of an iframe, if the iframe is on the same domain as the main page.
                
+    
                As of jQuery 3.2, .contents() returns contents of <template> elements as well.
                
     
                Consider a simple <div> with a number of text nodes, each of which is separated by two line break elements (<br>):
                
     
                
 <div class="container">
@@ -60,4 +61,5 @@ $( "#frameDemo" ).contents().find( "a" ).css( "background-color", "#BADA55" );
   
   
   
+  
 
diff --git a/entries/css.xml b/entries/css.xml
index 34fc7237..0fd97457 100644
--- a/entries/css.xml
+++ b/entries/css.xml
@@ -23,6 +23,7 @@
       
                Retrieval of shorthand CSS properties (e.g., margin, background, border), although functional with some browsers, is not guaranteed. For example, if you want to retrieve the rendered border-width, use: $( elem ).css( "borderTopWidth" ), $( elem ).css( "borderBottomWidth" ), and so on.
                
       
                An element should be connected to the DOM when calling .css() on it. If it isn't, jQuery may throw an error.
                
       
                As of jQuery 1.9, passing an array of style properties to .css() will result in an object of property-value pairs. For example, to retrieve all four rendered border-width values, you could use $( elem ).css([ "borderTopWidth", "borderRightWidth", "borderBottomWidth", "borderLeftWidth" ]). 
                
+      
                As of jQuery 3.2, CSS Custom Properties (also called CSS Variables) are supported: $( "p" ).css( "--custom-property" ). Note that you need to provide the property name as-is, camelCasing it won't work as it does for regular CSS properties.
                
     
     
       Get the background color of a clicked div.
@@ -106,6 +107,7 @@ $( "div" ).click(function() {
     
     
     
+    
   
   
     
@@ -157,6 +159,7 @@ $( "div.example" ).css( "width", function( index ) {
       
                
       
                This example sets the widths of the matched elements to incrementally larger values.
                
       
                Note: If nothing is returned in the setter function (ie. function( index, style ){} ), or if undefined is returned, the current value is not changed. This is useful for selectively setting values only when certain criteria are met.
                
+      
                As of jQuery 3.2, CSS Custom Properties (also called CSS Variables) are supported: $( "p" ).css( "--custom-property", "value" ). Note that you need to provide the property name as-is, camelCasing it won't work as it does for regular CSS properties.
                
                     
     
       Change the color of any paragraph to red on mouseover event.
@@ -282,5 +285,6 @@ $( "div" ).on( "click", function() {
     
     
     
+    
   
 
diff --git a/entries/eq-selector.xml b/entries/eq-selector.xml
index 0c985fca..a191d31b 100644
--- a/entries/eq-selector.xml
+++ b/entries/eq-selector.xml
@@ -17,7 +17,9 @@
                   
   Select the element at index n within the matched set.
   
-    
                As of jQuery 3.4, the :eq pseudo-class is deprecated. Remove it from your selectors and filter the results later using .eq().
                
+    
                
+      
                As of jQuery 3.4, the :eq pseudo-class is deprecated. Remove it from your selectors and filter the results later using .eq().
                
+    
                
     
                The index-related selectors (:eq(), :lt(), :gt(), :even, :odd) 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 (.myclass) and four elements are returned, these elements are given indices 0 through 3 for the purposes of these selectors.
                
     
                Note that since JavaScript arrays use 0-based indexing, these selectors reflect that fact. This is why $( ".myclass:eq(1)" ) selects the second element in the document with the class myclass, rather than the first. In contrast, :nth-child(n) uses 1-based indexing to conform to the CSS specification.
                
     
                Prior to jQuery 1.8, the :eq(index) selector did not accept a negative value for index (though the .eq(index) method did).
                
diff --git a/entries/even-selector.xml b/entries/even-selector.xml
index ba2dc5d5..bfc8038a 100644
--- a/entries/even-selector.xml
+++ b/entries/even-selector.xml
@@ -5,8 +5,11 @@
   
     1.0
   
-  Selects even elements, zero-indexed.  See also odd.
+  Selects even elements, zero-indexed.  See also :odd.
   
+    
                
+      
                As of jQuery 3.4, the :even pseudo-class is deprecated. Remove it from your selectors and filter the results later using .even() (available in jQuery 3.5.0 or newer).
                
+    
                
     
                In particular, note that the 0-based indexing means that, counter-intuitively, :even selects the first element, third element, and so on within the matched set.
                
                   
   
diff --git a/entries/even.xml b/entries/even.xml
new file mode 100644
index 00000000..cecff9e4
--- /dev/null
+++ b/entries/even.xml
@@ -0,0 +1,47 @@
+
+
+  .even()
+  
+    3.5
+  
+  Reduce the set of matched elements to the even ones in the set, numbered from zero.
+  
+    
                Given a jQuery object that represents a set of DOM elements, the .even() method constructs a new jQuery object from the even elements in that set. Counting starts from zero!
                
+    
                Consider a page with a simple list on it:
                
+    
                
+<ul>
+  <li>list item 1</li>
+  <li>list item 2</li>
+  <li>list item 3</li>
+  <li>list item 4</li>
+  <li>list item 5</li>
+</ul>
+    
                
+    
                We can apply this method to the set of list items:
                
+    
                
+$( "li" ).even().css( "background-color", "red" );
+    
                
+    
                The result of this call is a red background for the first, third & 5th items.
                
+                  
+  
+    Highlight the even items in a list.
+    
+    
+    
+  
              • Look:
                • 
+  
              • This is some text in a list.
                • 
+  
              • This is a note about it.
                • 
+  
              • This is another note about it.
                • 
+
              
+]]>
+  
+  
+  
+
diff --git a/entries/filter.xml b/entries/filter.xml
index 01489193..ed92d385 100644
--- a/entries/filter.xml
+++ b/entries/filter.xml
@@ -42,9 +42,9 @@
     
            
     
            We can apply this method to the set of list items:
            
     
            
-$( "li" ).filter( ":even" ).css( "background-color", "red" );
+$( "li" ).filter( ":nth-child(2n)" ).css( "background-color", "red" );
     
            
-    
            The result of this call is a red background for items 1, 3, and 5, as they match the selector (recall that :even and :odd use 0-based indexing).
            
+    
            The result of this call is a red background for items 2, 4, and 6, as they match the selector.
            
     
            Using a Filter Function
            
     
            The second form of this method allows us to filter elements against a function rather than a selector. For each element, if the function returns true (or a "truthy" value), the element will be included in the filtered set; otherwise, it will be excluded. Suppose we have a somewhat more involved HTML snippet:
            
     
            
diff --git a/entries/first-selector.xml b/entries/first-selector.xml
index ded45ccb..1308ff5e 100644
--- a/entries/first-selector.xml
+++ b/entries/first-selector.xml
@@ -7,7 +7,9 @@
   
   Selects the first matched DOM element.
   
-    
            As of jQuery 3.4, the :first pseudo-class is deprecated. Remove it from your selectors and filter the results later using .first().
            
+    
            
+      
            As of jQuery 3.4, the :first pseudo-class is deprecated. Remove it from your selectors and filter the results later using .first().
            
+    
            
     
            The :first pseudo-class is equivalent to :eq( 0 ). It could also be written as :lt( 1 ). While this matches only a single element, :first-child can match more than one: One for each parent.
            
               
   
diff --git a/entries/first.xml b/entries/first.xml
index f73f8f10..90ac489c 100644
--- a/entries/first.xml
+++ b/entries/first.xml
@@ -24,21 +24,22 @@ $( "li" ).first().css( "background-color", "red" );
     
            The result of this call is a red background for the first item.
            
   
   
-    Highlight the first span in a paragraph.
+    Highlight the first item in a list.
     
     
     
-  Look:
-  This is some text in a paragraph.
-  This is a note about it.
-
            
+
              
+  
            • Look:
              • 
+  
            • This is some text in a list.
              • 
+  
            • This is a note about it.
              • 
+  
            • This is another note about it.
              • 
+
            
 ]]>
               
   
diff --git a/entries/gt-selector.xml b/entries/gt-selector.xml
index 8ad903fc..1aad2e3d 100644
--- a/entries/gt-selector.xml
+++ b/entries/gt-selector.xml
@@ -17,7 +17,9 @@
   
   Select all elements at an index greater than index within the matched set.
   
-    
            As of jQuery 3.4, the :gt pseudo-class is deprecated. Remove it from your selectors and filter the results later using .slice(). For example, :gt(3) can be replaced with a call to .slice( 4 ) (the provided index needs to be increased by one).
            
+    
            
+      
            As of jQuery 3.4, the :gt pseudo-class is deprecated. Remove it from your selectors and filter the results later using .slice(). For example, :gt(3) can be replaced with a call to .slice( 4 ) (the provided index needs to be increased by one).
            
+    
            
     
            
       index-related selectors
     
            
diff --git a/entries/hover.xml b/entries/hover.xml
index f6656b0c..2ddab1fa 100644
--- a/entries/hover.xml
+++ b/entries/hover.xml
@@ -102,10 +102,10 @@ $( selector ).on( "mouseenter mouseleave", handlerInOut );
       Slide the next sibling LI up or down on hover, and toggle a class.
       
             
          • "xml": Returns a XML document that can be processed via jQuery.
            • 
             
          • "html": Returns HTML as plain text; included script tags are evaluated when inserted in the DOM.
            • 
-            
          • "script": Evaluates the response as JavaScript and returns it as plain text. Disables caching by appending a query string parameter, _=[TIMESTAMP], to the URL unless the cache option is set to true. Note: This will turn POSTs into GETs for remote-domain requests.
            • 
+            
          • "script": Evaluates the response as JavaScript and returns it as plain text. Disables caching by appending a query string parameter, _=[TIMESTAMP], to the URL unless the cache option is set to true. Note: This will turn POSTs into GETs for remote-domain requests. Prior to jQuery 3.5.0, unsuccessful HTTP responses with a script Content-Type were still executed.
            • 
             
          • "json": Evaluates the response as JSON and returns a JavaScript object. Cross-domain "json" requests that have a callback placeholder, e.g. ?callback=?, are performed using JSONP unless the request includes jsonp: false in its request options. The JSON data is parsed in a strict manner; any malformed JSON is rejected and a parse error is thrown. As of jQuery 1.9, an empty response is also rejected; the server should return a response of null or {} instead. (See json.org for more information on proper JSON formatting.)
            • 
             
          • "jsonp": Loads in a JSON block using JSONP. Adds an extra "?callback=?" to the end of your URL to specify the callback. Disables caching by appending a query string parameter, "_=[TIMESTAMP]", to the URL unless the cache option is set to true.
            • 
             
          • "text": A plain text string.
            • 
@@ -457,4 +457,5 @@ $.ajax({
   
   
   
+  
 
diff --git a/entries/jQuery.extend.xml b/entries/jQuery.extend.xml
index b28ec2e0..56fbab89 100644
--- a/entries/jQuery.extend.xml
+++ b/entries/jQuery.extend.xml
@@ -35,6 +35,7 @@
     
            Keep in mind that the target object (first argument) will be modified, and will also be returned from $.extend(). If, however, you want to preserve both of the original objects, you can do so by passing an empty object as the target:
            
     
            var object = $.extend({}, object1, object2);
            
     
            The merge performed by $.extend() is not recursive by default; if a property of the first object is itself an object or array, it will be completely overwritten by a property with the same key in the second or subsequent object. The values are not merged. This can be seen in the example below by examining the value of banana. However, by passing true for the first function argument, objects will be recursively merged.
            
+    
            Warning: Versions prior to 3.4 had a security issue where calling jQuery.extend(true, {}, object) on an unsanitized object containing a __proto__ property would extend Object.prototype.
            
     
            Warning: Passing false for the first argument is not supported.
            
     
            Undefined properties are not copied. However, properties inherited from the object's prototype will be copied over. Properties that are an object constructed via new MyCustomObject(args), or built-in JavaScript types such as Date or RegExp, are not re-constructed and will appear as plain Objects in the resulting object or array.
            
     
            On a deep extend, Object and Array are extended, but object wrappers on primitive types such as String, Boolean, and Number are not. Deep-extending a cyclical data structure will result in an error.
            
@@ -106,4 +107,5 @@ $( "#log" ).append( "
            settings -- " + JSON.stringify( settings ) + "<
   
   
   
+  
 
diff --git a/entries/jQuery.get.xml b/entries/jQuery.get.xml
index be1e25a2..55009de2 100644
--- a/entries/jQuery.get.xml
+++ b/entries/jQuery.get.xml
@@ -22,7 +22,7 @@
     
   
   
-    1.12/2.2
+    1.12-and-2.2
     
       A set of key/value pairs that configure the Ajax request. All properties except for url are optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) for a complete list of all settings. The type option will automatically be set to GET.
     
@@ -128,4 +128,5 @@ $.get( "test.php", function( data ) {
   
   
   
+  
 
diff --git a/entries/jQuery.getScript.xml b/entries/jQuery.getScript.xml
index be884042..357b9e1a 100644
--- a/entries/jQuery.getScript.xml
+++ b/entries/jQuery.getScript.xml
@@ -56,6 +56,7 @@ $( "div.log" ).ajaxError(function( e, jqxhr, settings, exception ) {
   }
 });
     
            
+    
            Prior to jQuery 3.5.0, unsuccessful HTTP responses with a script Content-Type were still executed.
            
     
            Caching Responses
            
     
            By default, $.getScript() sets the cache setting to false. This appends a timestamped query parameter to the request URL to ensure that the browser downloads the script each time it is requested. You can override this feature by setting the cache property globally using $.ajaxSetup(): 
            
     
            
@@ -125,4 +126,5 @@ $.getScript( url, function() {
   
   
   
+  
 
diff --git a/entries/jQuery.holdReady.xml b/entries/jQuery.holdReady.xml
index 016e951a..0ba8ceb0 100644
--- a/entries/jQuery.holdReady.xml
+++ b/entries/jQuery.holdReady.xml
@@ -1,5 +1,5 @@
 
-
+
   jQuery.holdReady()
   Holds or releases the execution of jQuery's ready event.
   
@@ -9,6 +9,16 @@
     
   
   
+    
            
+      
            Note: This API has been deprecated in jQuery 3.2. Instead of relying on this global switch, it's better to put explicitly wait for required code. If you need to wait both for the ready state & for a custom promise, use the following pattern:
            
+      
+    
            
     
            The $.holdReady() method allows the caller to delay jQuery's ready event. This advanced feature would typically be used by dynamic script loaders that want to load additional JavaScript such as jQuery plugins before allowing the ready event to occur, even though the DOM may be ready. This method must be called early in the document, such as in the <head> immediately after the jQuery script tag. Calling this method after the ready event has already fired will have no effect. 
            
     
            To delay the ready event, first call $.holdReady( true ). When the ready event should be released to execute, call $.holdReady( false ). Note that multiple holds can be put on the ready event, one for each $.holdReady( true ) call. The ready event will not actually fire until all holds have been released with a corresponding number of $.holdReady( false ) calls and the normal document ready conditions are met. (See ready for more information.)
            
               
@@ -25,4 +35,5 @@ $.getScript( "myplugin.js", function() {
   
   
   
+  
             
diff --git a/entries/jQuery.htmlPrefilter.xml b/entries/jQuery.htmlPrefilter.xml
index 3682ed5b..75381903 100644
--- a/entries/jQuery.htmlPrefilter.xml
+++ b/entries/jQuery.htmlPrefilter.xml
@@ -3,75 +3,15 @@
   jQuery.htmlPrefilter()
   Modify and filter HTML strings passed through jQuery manipulation methods.
   
-    1.12/2.2
+    1.12-and-2.2
     
       The HTML string on which to operate.
     
   
   
-    
            This method rarely needs to be called directly. Instead, use it as an entry point to modify existing jQuery manipulation methods. For instance, to remove all <del> tags from incoming HTML strings, do this:
            
-    
            
-var htmlPrefilter = $.htmlPrefilter,
-  rdel = /<(del)(?=[\s>])[\w\W]*?<\/\1\s*>/gi;
-
-$.htmlPrefilter = function( html ) {
-  return htmlPrefilter.call( this, html ).replace( rdel, "" );
-};
-    
            
-    
            This function can also be overwritten in order to bypass certain edge case issues. The default htmlPrefilter function in jQuery will greedily ensure that all tags are XHTML-compliant. This includes anything that looks like an HTML tag, but is actually within a string (e.g. 
            <a title="<div />"><>
            ). The jQuery.htmlPrefilter() function can be used to bypass this:
            
-    
            
-$.htmlPrefilter = function( html ) {
-  // Return HTML strings unchanged
-  return html;
-};
-    
            
-    
            However, while the above fix is short and simple, it puts the burden on you to ensure XHTML-compliant tags in any HTML strings. A more thorough fix for this issue would be this:
            
-    
            
-var panything = "[\\w\\W]*?",
-
-  // Whitespace
-  // https://html.spec.whatwg.org/multipage/infrastructure.html#space-character
-  pspace = "[\\x20\\t\\r\\n\\f]",
-
-  // End of tag name (whitespace or greater-than)
-  pnameEnd = pspace.replace( "]", ">]" ),
-
-  // Tag name (a leading letter, then almost anything)
-  // https://html.spec.whatwg.org/multipage/syntax.html#tag-open-state
-  // https://html.spec.whatwg.org/multipage/syntax.html#tag-name-state
-  pname = "[a-z]" + pnameEnd.replace( "[", "[^/\\0" ) + "*",
-
-  // Void element (end tag prohibited)
-  // https://html.spec.whatwg.org/multipage/syntax.html#void-elements
-  pvoidName = "(?:area|base|br|col|embed|hr|img|input|keygen|link|menuitem|meta|param|" +
-    "source|track|wbr)(?=" + pnameEnd + ")",
-
-  // Attributes (double-quoted value, single-quoted value, unquoted value, or no value)
-  // https://html.spec.whatwg.org/multipage/syntax.html#attributes-2
-  pattrs = "(?:" + pspace + "+[^\\0-\\x20\\x7f-\\x9f=\"'/>]+(?:" + pspace + "*=" + pspace +
-    "*(?:\"" + panything + "\"|'" + panything + "'|" +
-    pnameEnd.replace( "[", "[^" ) + "*(?!/)" +
-    ")|))*" + pspace + "*",
-
-  // Trailing content of a close tag
-  pcloseTail = "(?:" + pspace + panything + "|)",
-
-  rspecialHtml = new RegExp(
-    // Non-void element that self-closes: $1–$5
-    "(<)(?!" + pvoidName + ")(" + pname + ")(" + pattrs + ")(\\/)(>)|" +
-      // No-innerHTML container (element, comment, or CDATA): $6
-      "(<(script|style|textarea)" + pattrs + ">" + panything + "<\\/\\7" + pcloseTail + ">|" +
-      "<!--" + panything + "--)",
-    "gi"
-  ),
-
-  // "<"; element name; attributes; ">"; "<"; "/"; element name; ">"; no-innerHTML container
-  pspecialReplacement = "$1$2$3$5$1$4$2$5$6";
-
-$.htmlPrefilter = function( html ) {
-  return ( html + "" ).replace( rspecialHtml, pspecialReplacement );
-};
-    
            
+    
            This method rarely needs to be called directly. Instead, use it as an entry point to modify existing jQuery manipulation methods. jQuery calls this method on input HTML before processing it further: it accepts an HTML string & should return a HTML string as well.
            
+    
            This function can also be overwritten in order to bypass certain edge case issues. The default htmlPrefilter function in jQuery leaves input unmodified since 3.5.0. Older versions would greedily ensure that all tags were XHTML-compliant. This included anything that looked like an HTML tag, but was actually within a string (e.g. <a title="<div />"><>), leading to potential security issues. For more information, see the jQuery Core 3.5 Upgrade guide.
            
               
   
+  
             
diff --git a/entries/jQuery.isArray.xml b/entries/jQuery.isArray.xml
index 6f040c4e..6ce958df 100644
--- a/entries/jQuery.isArray.xml
+++ b/entries/jQuery.isArray.xml
@@ -1,5 +1,5 @@
 
-
+
   jQuery.isArray()
   
     1.3
@@ -9,6 +9,9 @@
   
   Determine whether the argument is an array.
   
+    
            
+      
            Note: This API has been deprecated in jQuery 3.2; please use the native Array.isArray method instead.
            
+    
            
     
            $.isArray() returns a Boolean indicating whether the object is a JavaScript array (not an array-like object, such as a jQuery object).
            
               
   
@@ -22,4 +25,5 @@ Is [] an Array? 
   
   
   
+  
             
diff --git a/entries/jQuery.isFunction.xml b/entries/jQuery.isFunction.xml
index 7aed5574..3524ace2 100644
--- a/entries/jQuery.isFunction.xml
+++ b/entries/jQuery.isFunction.xml
@@ -9,7 +9,9 @@
   
   Determines if its argument is callable as a function.
   
-    
            As of jQuery 3.3, jQuery.isFunction() has been deprecated. In most cases, its use can be replaced by typeof x === "function".
            
+    
            
+      
            As of jQuery 3.3, jQuery.isFunction() has been deprecated. In most cases, its use can be replaced by typeof x === "function".
            
+    
            
     
            Note: As of jQuery 1.3, functions provided by the browser like alert() and DOM element methods like getAttribute() are not guaranteed to be detected as functions in browsers such as Internet Explorer.
            
               
   
diff --git a/entries/jQuery.isNumeric.xml b/entries/jQuery.isNumeric.xml
index b51eb84d..7e64d4b7 100644
--- a/entries/jQuery.isNumeric.xml
+++ b/entries/jQuery.isNumeric.xml
@@ -1,5 +1,5 @@
 
-
+
   jQuery.isNumeric()
   Determines whether its argument represents a JavaScript number.
   
@@ -9,6 +9,9 @@
     
   
   
+    
            
+      
            Note: This API has been deprecated in jQuery 3.3.
            
+    
            
     
            The $.isNumeric() method checks whether its argument represents a numeric value. If so, it returns true. Otherwise it returns false. The argument can be of any type.
            
     
            As of jQuery 3.0 $.isNumeric() returns true only if the argument is of type number, or if it's of type string and it can be coerced into finite numbers. In all other cases, it returns false.
            
               
@@ -39,4 +42,5 @@ $.isNumeric( undefined )
               
   
   
+  
             
diff --git a/entries/jQuery.isWindow.xml b/entries/jQuery.isWindow.xml
index ee8ed3b1..e79a95a7 100644
--- a/entries/jQuery.isWindow.xml
+++ b/entries/jQuery.isWindow.xml
@@ -9,6 +9,12 @@
   
   Determine whether the argument is a window.
   
+    
            
+      
            Note: This API has been deprecated in jQuery 3.3; if you need this function, reimplement it by yourself:
            
+      
+    
            
     
            This is used in a number of places in jQuery to determine if we're operating against a browser window (such as the current window or an iframe).
            
               
   
diff --git a/entries/jQuery.now.xml b/entries/jQuery.now.xml
index 6c41af36..b482637c 100644
--- a/entries/jQuery.now.xml
+++ b/entries/jQuery.now.xml
@@ -1,13 +1,17 @@
 
-
+
   jQuery.now()
   
     1.4.3
   
   Return a number representing the current time.
   
-    
            The $.now() method is a shorthand for the number returned by the expression (new Date).getTime().
            
+    
            
+      
            Note: This API has been deprecated in jQuery 3.3; please use the native Date.now() method instead.
            
+    
            
+    
            The $.now() method is an alias for Date.now().
            
               
   
   
-            
\ No newline at end of file
+  
+            
diff --git a/entries/jQuery.post.xml b/entries/jQuery.post.xml
index 06e353f8..9be8d43b 100644
--- a/entries/jQuery.post.xml
+++ b/entries/jQuery.post.xml
@@ -22,7 +22,7 @@
     
   
   
-    1.12/2.2
+    1.12-and-2.2
     
       A set of key/value pairs that configure the Ajax request. All properties except for url are optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) for a complete list of all settings. Type will automatically be set to POST.
     
@@ -167,4 +167,5 @@ $( "#searchForm" ).submit(function( event ) {
   
   
   
+  
 
diff --git a/entries/jQuery.proxy.xml b/entries/jQuery.proxy.xml
index e7c5f0ff..d00748b9 100644
--- a/entries/jQuery.proxy.xml
+++ b/entries/jQuery.proxy.xml
@@ -1,5 +1,5 @@
 
-
+
   jQuery.proxy()
   
     1.4
@@ -46,6 +46,9 @@
 
   Takes a function and returns a new one that will always have a particular context.
   
+    
            
+      
            Note: This API has been deprecated in jQuery 3.3; please use the native Function.prototype.bind method instead.
            
+    
            
     
            This method is most useful for attaching event handlers to an element where the context is pointing back to a different object. Additionally, jQuery makes sure that even if you bind the function returned from jQuery.proxy() it will still unbind the correct function if passed the original.
            
     
            Be aware, however, that jQuery's event binding subsystem assigns a unique id to each event handling function in order to track it when it is used to specify the function to be unbound. The function represented by jQuery.proxy() is seen as a single function by the event subsystem, even when it is used to bind different contexts. To avoid unbinding the wrong handler, use a unique event namespace for binding and unbinding (e.g., "click.myproxy1") rather than specifying the proxied function during unbinding.
            
     
            As of jQuery 1.6, any number of additional arguments may be supplied to $.proxy(), and they will be passed to the function whose context will be changed.
            
@@ -170,4 +173,5 @@ $( "#test" )
   
   
   
+  
             
diff --git a/entries/jQuery.trim.xml b/entries/jQuery.trim.xml
index d0dcfa68..cac7e358 100644
--- a/entries/jQuery.trim.xml
+++ b/entries/jQuery.trim.xml
@@ -1,5 +1,5 @@
 
-
+
   jQuery.trim()
   
     1.0
@@ -9,6 +9,9 @@
   
   Remove the whitespace from the beginning and end of a string.
   
+    
            
+      
            Note: This API has been deprecated in jQuery 3.5; please use the native String.prototype.trim method instead.
            
+    
            
     
            The $.trim() function removes all newlines, spaces (including non-breaking spaces), and tabs from the beginning and end of the supplied string. If these whitespace characters occur in the middle of the string, they are preserved.
            
               
   
@@ -34,4 +37,5 @@ $.trim("    hello, how are you?    ");
   
   
   
+  
             
diff --git a/entries/jQuery.type.xml b/entries/jQuery.type.xml
index 26dbe913..b9ce8a8e 100644
--- a/entries/jQuery.type.xml
+++ b/entries/jQuery.type.xml
@@ -1,5 +1,5 @@
 
-
+
   jQuery.type()
   
     1.4.3
@@ -9,6 +9,9 @@
   
   Determine the internal JavaScript [[Class]] of an object.
   
+    
            
+      
            Note: This API has been deprecated in jQuery 3.3.
            
+    
            
     
            A number of techniques are used to determine the exact return value for an object. The [[Class]] is determined as follows:
            
     
              
       
            • If the object is undefined or null, then "undefined" or "null" is returned accordingly.
@@ -24,16 +27,16 @@
           
            • jQuery.type( true ) === "boolean"
              • 
           
            • jQuery.type( new Boolean() ) === "boolean"
              • 
           
            • jQuery.type( 3 ) === "number"
              • 
-          
            • jQuery.type( new Number(3) ) === "number"
              • 
+          
            • jQuery.type( new Number( 3 ) ) === "number"
              • 
           
            • jQuery.type( "test" ) === "string"
              • 
-          
            • jQuery.type( new String("test") ) === "string"
              • 
-          
            • jQuery.type( function(){} ) === "function"
              • 
+          
            • jQuery.type( new String( "test" ) ) === "string"
              • 
+          
            • jQuery.type( function() {} ) === "function"
              • 
           
            • jQuery.type( [] ) === "array"
              • 
           
            • jQuery.type( new Array() ) === "array"
              • 
           
            • jQuery.type( new Date() ) === "date"
              • 
           
            • jQuery.type( new Error() ) === "error" // as of jQuery 1.9
              • 
           
            • jQuery.type( Symbol() ) === "symbol" // as of jQuery 1.9
              • 
-          
            • jQuery.type( Object(Symbol()) ) === "symbol" // as of jQuery 1.12
              • 
+          
            • jQuery.type( Object( Symbol() ) ) === "symbol" // as of jQuery 1.12
              • 
           
            • jQuery.type( /test/ ) === "regexp"
              • 
         
            
       
@@ -51,4 +54,5 @@ Is it a RegExp? 
               
   
   
+  
 
diff --git a/entries/jQuery.uniqueSort.xml b/entries/jQuery.uniqueSort.xml
index 006b4ad9..9d149af3 100644
--- a/entries/jQuery.uniqueSort.xml
+++ b/entries/jQuery.uniqueSort.xml
@@ -2,7 +2,7 @@
 
   jQuery.uniqueSort()
   
-    1.12-2.2
+    1.12-and-2.2
     
       The Array of DOM elements.
     
@@ -42,5 +42,5 @@ $( "div" ).eq( 2 ).text( "Post-unique there are " + divs.length + " elements." )
 ]]>
   
   
-  
+  
 
diff --git a/entries/last-selector.xml b/entries/last-selector.xml
index 42cd8490..128eec49 100644
--- a/entries/last-selector.xml
+++ b/entries/last-selector.xml
@@ -7,7 +7,9 @@
   
   Selects the last matched element.
   
-    
            As of jQuery 3.4, the :last pseudo-class is deprecated. Remove it from your selectors and filter the results later using .last().
            
+    
            
+      
            As of jQuery 3.4, the :last pseudo-class is deprecated. Remove it from your selectors and filter the results later using .last().
            
+    
            
     
            Note that :last selects a single element by filtering  the current jQuery collection and matching the last element within it.
            
               
   
diff --git a/entries/last.xml b/entries/last.xml
index 4f9b59df..73ddafa5 100644
--- a/entries/last.xml
+++ b/entries/last.xml
@@ -24,17 +24,22 @@ $( "li" ).last().css( "background-color", "red" );
     
            The result of this call is a red background for the final item.
            
   
   
-    Highlight the last span in a paragraph.
+    Highlight the last item in a list.
     
     
     Look: This is some text in a paragraph. This is a note about it.
            
+
              
+  
            • Look:
              • 
+  
            • This is some text in a list.
              • 
+  
            • This is a note about it.
              • 
+  
            • This is another note about it.
              • 
+
            
 ]]>
               
   
diff --git a/entries/lt-selector.xml b/entries/lt-selector.xml
index d8c893ea..703c427f 100644
--- a/entries/lt-selector.xml
+++ b/entries/lt-selector.xml
@@ -17,7 +17,9 @@
   
   Select all elements at an index less than index within the matched set.
   
-    
            As of jQuery 3.4, the :lt pseudo-class is deprecated. Remove it from your selectors and filter the results later using .slice(). For example, :lt(3) can be replaced with a call to .slice( 0, 3 ).
            
+    
            
+      
            As of jQuery 3.4, the :lt pseudo-class is deprecated. Remove it from your selectors and filter the results later using .slice(). For example, :lt(3) can be replaced with a call to .slice( 0, 3 ).
            
+    
            
     
            
       index-related selectors
     
            
diff --git a/entries/not.xml b/entries/not.xml
index a9a0880d..8a41ddf1 100644
--- a/entries/not.xml
+++ b/entries/not.xml
@@ -40,9 +40,9 @@
     
            
     
            We can apply this method to the set of list items:
            
     
            
-$( "li" ).not( ":even" ).css( "background-color", "red" );
+$( "li" ).not( ":nth-child(2n)" ).css( "background-color", "red" );
     
            
-    
            The result of this call is a red background for items 2 and 4, as they do not match the selector (recall that :even and :odd use 0-based indexing).
            
+    
            The result of this call is a red background for items 1, 3 and 5, as they do not match the selector.
            
     
            Removing Specific Elements
            
     
            The second version of the .not() method allows us to remove elements from the matched set, assuming we have found those elements previously by some other means. For example, suppose our list had an id applied to one of its items:
            
     
            
diff --git a/entries/nth-child-selector.xml b/entries/nth-child-selector.xml
index 7ea6c417..741052a1 100644
--- a/entries/nth-child-selector.xml
+++ b/entries/nth-child-selector.xml
@@ -51,12 +51,17 @@ $( "ul li:nth-child(2)" ).append( " - 2nd!" );
 ]]>
   
   
-    This is a playground to see how the selector works with different strings.  Notice that this is different from the :even and :odd which have no regard for parent and just filter the list of elements to every other one.  The :nth-child, however, counts the index of the child to its particular parent.  In any case, it's easier to see than explain so...
+    This is a playground to see how the selector works with different strings.  Notice that this is different from the even and odd which have no regard for parent and just filter the list of elements to every other one.  The :nth-child, however, counts the index of the child to its particular parent.  In any case, it's easier to see than explain so...
     
@@ -94,8 +99,8 @@ $( "button" ).click(function() {
 
            
   
   
-  
-  
+  
+  
 
            
 
 
            
diff --git a/entries/odd-selector.xml b/entries/odd-selector.xml
index 029f2e72..8b907e15 100644
--- a/entries/odd-selector.xml
+++ b/entries/odd-selector.xml
@@ -5,8 +5,11 @@
   
     1.0
   
-  Selects odd elements, zero-indexed.  See also even.
+  Selects odd elements, zero-indexed.  See also :even.
   
+    
            
+      
            As of jQuery 3.4, the :odd pseudo-class is deprecated. Remove it from your selectors and filter the results later using .odd() (available in jQuery 3.5.0 or newer).
            
+    
            
     
            In particular, note that the 0-based indexing means that, counter-intuitively, :odd selects the second element, fourth element, and so on within the matched set.
            
               
   
diff --git a/entries/odd.xml b/entries/odd.xml
new file mode 100644
index 00000000..52fe3baf
--- /dev/null
+++ b/entries/odd.xml
@@ -0,0 +1,47 @@
+
+
+  .odd()
+  
+    3.5
+  
+  Reduce the set of matched elements to the odd ones in the set, numbered from zero.
+  
+    
            Given a jQuery object that represents a set of DOM elements, the .odd() method constructs a new jQuery object from the odd elements in that set. Counting starts from zero!
            
+    
            Consider a page with a simple list on it:
            
+    
            
+<ul>
+  <li>list item 1</li>
+  <li>list item 2</li>
+  <li>list item 3</li>
+  <li>list item 4</li>
+  <li>list item 5</li>
+</ul>
+    
            
+    
            We can apply this method to the set of list items:
            
+    
            
+$( "li" ).odd().css( "background-color", "red" );
+    
            
+    
            The result of this call is a red background for the second & 4th items.
            
+              
+  
+    Highlight the odd items in a list.
+    
+    
+    
+  
          • Look:
            • 
+  
          • This is some text in a list.
            • 
+  
          • This is a note about it.
            • 
+  
          • This is another note about it.
            • 
+
+]]>
+              
+  
+  
+            
diff --git a/entries/removeClass.xml b/entries/removeClass.xml
index c6171f2e..03b02f0c 100644
--- a/entries/removeClass.xml
+++ b/entries/removeClass.xml
@@ -7,18 +7,24 @@
       One or more space-separated classes to be removed from the class attribute of each matched element.
     
   
+  
+    3.3
+    
+      An array of classes to be removed from the class attribute of each matched element.
+    
+  
   
     1.4
     
       
       
       
-      A function returning one or more space-separated class names to be removed. Receives the index position of the element in the set and the old class value as arguments.
+      A function returning one or more space-separated classes or an array of classes to be removed. Receives the index position of the element in the set and the old class value as arguments.
     
   
   Remove a single class, multiple classes, or all classes from each element in the set of matched elements.
   
-    
            If a class name is included as a parameter, then only that class will be removed from the set of matched elements. If no class names are specified in the parameter, all classes will be removed.
            
+    
            If a class name is included as a parameter, then only that class will be removed from the set of matched elements. If no classes are specified in the parameter, all classes will be removed.
            
     
            Before jQuery version 1.12/2.2, the .removeClass() method manipulated the className property of the selected elements, not the class attribute. Once the property was changed, it was the browser that updated the attribute accordingly. This means that when the class attribute was updated and the last class name was removed, the browser might have set the attribute's value to an empty string instead of removing the attribute completely. An implication of this behavior was that this method only worked for documents with HTML DOM semantics (e.g., not pure XML documents).
            
     
            As of jQuery 1.12/2.2, this behavior is changed to improve the support for XML documents, including SVG. Starting from this version, the class attribute is used instead. So, .removeClass() can be used on XML or SVG documents.
            
     
            More than one class may be removed at a time, separated by a space, from the set of matched elements, like so:
            
@@ -42,7 +48,7 @@ $( "li" ).last().removeClass(function() {
   
     Remove the class 'blue' from the matched elements.
     
     
     Remove the class 'blue' and 'under' from the matched elements.
     
+    
+    Hello
            
+
            and
            
+
            then
            
+
            Goodbye
            
+]]>
+              
+  
+    Remove the class 'blue' and 'under' from the matched elements (3.3+ syntax).
+    
     
   
   
+  
+  
 
diff --git a/entries/toggleClass.xml b/entries/toggleClass.xml
index 51bdf746..a1b50ca1 100644
--- a/entries/toggleClass.xml
+++ b/entries/toggleClass.xml
@@ -5,16 +5,31 @@
     
       1.0
       
-        One or more class names (separated by spaces) to be toggled for each element in the matched set.
+        One or more classes (separated by spaces) to be toggled for each element in the matched set.
       
     
     
       1.3
       
-        One or more class names (separated by spaces) to be toggled for each element in the matched set.
+        One or more classes (separated by spaces) to be toggled for each element in the matched set.
       
       
-        A Boolean (not just truthy/falsy) value to determine whether the class should be added or removed.
+        A boolean (not just truthy/falsy) value to determine whether the class should be added or removed.
+      
+    
+    
+      3.3
+      
+        An array of classes to be toggled for each element in the matched set.
+      
+    
+    
+      3.3
+      
+        An array of classes to be toggled for each element in the matched set.
+      
+      
+        A boolean (not just truthy/falsy) value to determine whether the class should be added or removed.
       
     
     
@@ -24,7 +39,7 @@
         
         
         
-        A function that returns class names to be toggled in the class attribute of each element in the matched set. Receives the index position of the element in the set, the old class value, and the state as arguments.
+        A function that returns one or more space-separated classes or an array of classes to be toggled in the class attribute of each element in the matched set. Receives the index position of the element in the set, the old class value, and the state as arguments.
       
       
         A boolean value to determine whether the class should be added or removed.
@@ -32,7 +47,7 @@
     
     Add or remove one or more classes from each element in the set of matched elements, depending on either the class's presence or the value of the state argument.
     
-      
            This method takes one or more class names as its parameter. In the first version, if an element in the matched set of elements already has the class, then it is removed; if an element does not have the class, then it is added. For example, we can apply .toggleClass() to a simple <div>: 
            
+      
            This method takes one or more classes as its parameter. In the first version, if an element in the matched set of elements already has the class, then it is removed; if an element does not have the class, then it is added. For example, we can apply .toggleClass() to a simple <div>: 
            
       
            
 <div class="tumble">Some text.</div>
       
            
@@ -55,7 +70,7 @@ if ( addOrRemove ) {
   $( "#foo" ).removeClass( className );
 }
       
            
-      
            As of jQuery 1.4, if no arguments are passed to .toggleClass(), all class names on the element the first time .toggleClass() is called will be toggled. Also as of jQuery 1.4, the class name to be toggled can be determined by passing in a function.
            
+      
            As of jQuery 1.4, if no arguments are passed to .toggleClass(), all classes on the element the first time .toggleClass() is called will be toggled. Also as of jQuery 1.4, the class name to be toggled can be determined by passing in a function.
            
       
            
 $( "div.foo" ).toggleClass(function() {
   if ( $( this ).parent().is( ".bar" ) ) {
@@ -197,6 +212,8 @@ $( "a" ).on( "click", function( event ) {
     
     
     
+    
+    
   
   
     
@@ -210,4 +227,4 @@ $( "a" ).on( "click", function( event ) {
     
     
   
-
\ No newline at end of file
+
diff --git a/entries2html.xsl b/entries2html.xsl
index 8237a92f..44ddfdbf 100755
--- a/entries2html.xsl
+++ b/entries2html.xsl
@@ -12,7 +12,7 @@
 	<meta charset="utf-8">
 	<title> demo</title>
 	<style>	</style>
-	<script src="https://code.jquery.com/jquery-3.4.1.js"></script>
+	<script src="https://code.jquery.com/jquery-3.5.0.js"></script>
 	<script>
 	
 	</script>

From 5f41b2d722c0120b052dcaf166c682daecdfaa80 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Wed, 29 Apr 2020 17:48:51 +0200
Subject: [PATCH 578/699] 3.0.0

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index d1c4096e..29336a52 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "1.12.47",
+  "version": "3.0.0",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 63c7e90a..1b2ee2b3 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "1.12.47",
+  "version": "3.0.0",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 05679bbe4bb252999b84f07108c852ffc6379273 Mon Sep 17 00:00:00 2001
From: nikolaij 
Date: Fri, 17 Jul 2020 04:53:42 -0400
Subject: [PATCH 579/699] jQuery.post: Indicate POST is mainly for sending
 data, not receiving it

---
 entries/jQuery.post.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.post.xml b/entries/jQuery.post.xml
index 9be8d43b..7d8f86b7 100644
--- a/entries/jQuery.post.xml
+++ b/entries/jQuery.post.xml
@@ -27,7 +27,7 @@
       A set of key/value pairs that configure the Ajax request. All properties except for url are optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) for a complete list of all settings. Type will automatically be set to POST.
     
   
-  Load data from the server using a HTTP POST request.
+  Send data to the server using a HTTP POST request.
   
     
            This is a shorthand Ajax function, which is equivalent to:
            
     
            

From cd40fa30b230f0872e47a5d3c7286cacce7a767f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Fri, 17 Jul 2020 10:54:00 +0200
Subject: [PATCH 580/699] 3.0.1

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 29336a52..3c2567dd 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 1b2ee2b3..7c9ce0a0 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 1cdfd83eab82e8927aa6fe4f194539fa61b26906 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Mon, 20 Jul 2020 18:41:13 +0200
Subject: [PATCH 581/699] jQuery.globalEval: Document the document parameter

Since jQuery 3.5.0, jQuery.globalEval accepts an optional third parameter
accepting a document in which context the code will be evaluated.

This commit also adds the Document type and links it to one of the jQuery
signatures; so far it was using `type="document"` which linked to a non-existent
types section.

Closes gh-1168
Ref jquery/jquery#4601
---
 entries/jQuery.globalEval.xml | 14 ++++++++++++++
 entries/jQuery.xml            |  2 +-
 pages/Types.html              |  2 ++
 3 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/entries/jQuery.globalEval.xml b/entries/jQuery.globalEval.xml
index 1900cd78..19b9f9c9 100644
--- a/entries/jQuery.globalEval.xml
+++ b/entries/jQuery.globalEval.xml
@@ -18,6 +18,20 @@
       
     
   
+  
+    3.5.0
+    
+      The JavaScript code to execute.
+    
+    
+      
+        The nonce attribute passed to the executed script.
+      
+    
+    
+      A document in which context the code will be evaluated.
+    
+  
   Execute some JavaScript code globally.
   
     
            This method behaves differently from using a normal JavaScript eval() in that it's executed within the global context (which is important for loading external scripts dynamically).
            
diff --git a/entries/jQuery.xml b/entries/jQuery.xml
index b31102b5..5e549a7d 100644
--- a/entries/jQuery.xml
+++ b/entries/jQuery.xml
@@ -155,7 +155,7 @@ $( myForm.elements ).hide();
       
         A string of HTML to create on the fly. Note that this parses HTML, not XML.
       
-      
+      
         A document in which the new elements will be created.
       
     
diff --git a/pages/Types.html b/pages/Types.html
index 6221434f..ad8285ae 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -663,6 +663,8 @@ 
             Promise Object
            
 
            
 
            Callbacks Object
            
 
            A multi-purpose object that provides a powerful way to manage callback lists. It supports adding, removing, firing, and disabling callbacks. The Callbacks object is created and returned by the $.Callbacks function and subsequently returned by most of that function's methods. 
            
+
            Document
            
+
            A document object created by the browser's DOM parser, usually from a string representing HTML or XML.
            
 
            XML Document
            
 
            A document object created by the browser's XML DOM parser, usually from a string representing XML. XML documents have different semantics than HTML documents, but most of the traversing and manipulation methods provided by jQuery will work with them.
            
 
            Assert
            

From 44e75edd8c509bdae2b851e11137dd199c97b6d5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Mon, 20 Jul 2020 18:41:33 +0200
Subject: [PATCH 582/699] 3.0.2

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 3c2567dd..5820926b 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 7c9ce0a0..b1f03952 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 1e3b1639dfd141ed985ae0297441294bf3db3308 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Mon, 27 Jul 2020 19:06:59 +0200
Subject: [PATCH 583/699] jQuery: Document the jQuery(selector, selector)
 signature

Fixes gh-1060
Closes gh-1169
---
 entries/jQuery.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/entries/jQuery.xml b/entries/jQuery.xml
index 5e549a7d..a2be2248 100644
--- a/entries/jQuery.xml
+++ b/entries/jQuery.xml
@@ -11,7 +11,8 @@
       
         
         
-        A DOM Element, Document, or jQuery to use as context
+        
+        A DOM Element, Document, jQuery or selector to use as context
       
     
     

From f40063eb0d058562c076fd1b1fd4425fe77e83db Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Mon, 27 Jul 2020 19:07:35 +0200
Subject: [PATCH 584/699] jQuery.extend: Separate the one-argument signature
 from the multiple-arguments one

This is done to reduce the confusion as the single-argument signature behaves
completely differently than the other one.

Ref jquery/jquery#4748
Fixes gh-1164
Closes gh-1170
---
 entries/jQuery.extend.xml | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/entries/jQuery.extend.xml b/entries/jQuery.extend.xml
index 56fbab89..47262615 100644
--- a/entries/jQuery.extend.xml
+++ b/entries/jQuery.extend.xml
@@ -4,9 +4,9 @@
   
     1.0
     
-       An object that will receive the new properties if additional objects are passed in or that will extend the jQuery namespace if it is the sole argument.
+       An object that will receive the new properties.
     
-    
+    
       An object containing additional properties to merge in.
     
     
@@ -28,6 +28,12 @@
       Additional objects containing properties to merge in.
     
   
+  
+    1.0
+    
+       An object to merge onto the jQuery namespace.
+    
+  
   Merge the contents of two or more objects together into the first object.
   
     
            When two or more object arguments are supplied to $.extend(), properties from all of the objects are added to the target object. Arguments that are null or undefined are ignored.
            

From 93102d393d6753df9ad7e8366853ba066e895c60 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Mon, 27 Jul 2020 22:52:28 +0200
Subject: [PATCH 585/699] 3.0.3

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 5820926b..25a7f281 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.0.2",
+  "version": "3.0.3",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index b1f03952..49b85638 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.0.2",
+  "version": "3.0.3",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 2c22351912ac3c9d1f771de8509c94c3b6ad793f Mon Sep 17 00:00:00 2001
From: Rani Kheir <56330674+rani-k@users.noreply.github.com>
Date: Tue, 11 Aug 2020 11:58:20 -0700
Subject: [PATCH 586/699] jQuery.get: Add an example using a root-relative path

Added a `jQuery.get()` example to show how to request a different page
from the root of the same domain.

Closes gh-1152
---
 entries/jQuery.get.xml | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/entries/jQuery.get.xml b/entries/jQuery.get.xml
index 55009de2..16b764d4 100644
--- a/entries/jQuery.get.xml
+++ b/entries/jQuery.get.xml
@@ -116,13 +116,24 @@ $.get( "test.cgi", { name: "John", time: "2pm" } )
 ]]>            
   
   
-     Get the test.php page contents, which has been returned in json format (<?php echo json_encode( array( "name"=>"John","time"=>"2pm" ) ); ?>), and add it to the page.
+    Get the test.php page contents, which has been returned in json format (<?php echo json_encode( array( "name"=>"John","time"=>"2pm" ) ); ?>), and add it to the page.
     
+  
+  
+    Get another page on the same domain. Outputs to console both the data returned and the type of data returned.
+    
   
   

From 77c9c6db7fd7a99a11ae7b3f4323a0c7f67ecb09 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Tue, 11 Aug 2020 20:58:42 +0200
Subject: [PATCH 587/699] 3.0.4

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 25a7f281..6c4eb2fe 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.0.3",
+  "version": "3.0.4",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 49b85638..58c86cbf 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.0.3",
+  "version": "3.0.4",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 5120543c7030f0b8e2db45b0c561cb3e494cbaac Mon Sep 17 00:00:00 2001
From: Sedat Kapanoglu 
Date: Mon, 24 Aug 2020 12:50:59 -0700
Subject: [PATCH 588/699] jQuery.trim: Describe differences between String#trim
 & jQuery.trim

`jQuery.trim` supports non-string arguments while `String#trim`
does not. Note these differences.

Fixes gh-1174
Closes gh-1175
---
 entries/jQuery.trim.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.trim.xml b/entries/jQuery.trim.xml
index cac7e358..6732a155 100644
--- a/entries/jQuery.trim.xml
+++ b/entries/jQuery.trim.xml
@@ -10,7 +10,7 @@
   Remove the whitespace from the beginning and end of a string.
   
     
            
-      
            Note: This API has been deprecated in jQuery 3.5; please use the native String.prototype.trim method instead.
            
+      
            Note: This API has been deprecated in jQuery 3.5; please use the native String.prototype.trim method instead. Unlike jQuery.trim, String.prototype.trim does not work with types other than strings (null, undefined, Number). Make sure that your code is compatible when migrating.
            
     
            
     
            The $.trim() function removes all newlines, spaces (including non-breaking spaces), and tabs from the beginning and end of the supplied string. If these whitespace characters occur in the middle of the string, they are preserved.
            
               

From df1f7b00faf6bd5ea229ac2dd92e032d1ce2c65f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Mon, 24 Aug 2020 21:51:49 +0200
Subject: [PATCH 589/699] jQuery.ajax: Document special handling of a double
 question mark

Fixes gh-999
Closes gh-1171
Ref gh-1005

Co-authored-by: Dave Methvin 
---
 entries/jQuery.ajax.xml | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index dfe7f3cc..991e23ee 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -84,7 +84,12 @@ $.ajax({
         
         
         
-        Data to be sent to the server. It is converted to a query string, if not already a string. It's appended to the url for GET-requests. See processData option to prevent this automatic processing. Object must be Key/Value pairs. If value is an Array, jQuery serializes multiple values with same key based on the value of the traditional setting (described below).
+        
+            
            Data to be sent to the server. If the HTTP method is one that cannot have an entity body, such as GET, the data is appended to the URL.
            
+            
            When data is an object, jQuery generates the data string from the object's key/value pairs unless the processData option is set to false. For example, { a: "bc", d: "e,f" } is converted to the string "a=bc&d=e%2Cf". If the value is an array, jQuery serializes multiple values with same key based on the value of the traditional setting (described below). For example, { a: [1,2] } becomes the string "a%5B%5D=1&a%5B%5D=2" with the default traditional: false setting.
            
+            
            When data is passed as a string it should already be encoded using the correct encoding for contentType, which by default is application/x-www-form-urlencoded.
            
+            
            In requests with dataType: "json" or dataType: "jsonp", if the string contains a double question mark (??) anywhere in the URL or a single question mark (?) in the query string, it is replaced with a value generated by jQuery that is unique for each copy of the library on the page (e.g. jQuery21406515378922229067_1479880736745).
            
+                    
       
       
         

From 17ab5dbe56c677f67fb7c2d08853f1883abbc41b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Mon, 24 Aug 2020 21:53:32 +0200
Subject: [PATCH 590/699] 3.0.5

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 6c4eb2fe..24da4a28 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.0.4",
+  "version": "3.0.5",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 58c86cbf..d9de68ab 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.0.4",
+  "version": "3.0.5",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 9d500d69e3b573d19ea885da14333e2fe6de51c9 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 11 Dec 2020 20:40:50 +0100
Subject: [PATCH 591/699] Build: Bump ini from 1.3.5 to 1.3.7

Bumps [ini](https://github.com/isaacs/ini) from 1.3.5 to 1.3.7.
- [Release notes](https://github.com/isaacs/ini/releases)
- [Commits](https://github.com/isaacs/ini/compare/v1.3.5...v1.3.7)

Closes gh-1179

Signed-off-by: dependabot[bot] 

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 package-lock.json | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 24da4a28..a381061f 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1048,9 +1048,9 @@
       "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="
     },
     "ini": {
-      "version": "1.3.5",
-      "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.5.tgz",
-      "integrity": "sha512-RZY5huIKCMRWDUqZlEi72f/lmXKMvuszcMBduliQ3nnWbx9X/ZBQO7DijMEYS9EhHBb2qacRUMtC7svLwe0lcw=="
+      "version": "1.3.7",
+      "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.7.tgz",
+      "integrity": "sha512-iKpRpXP+CrP2jyrxvg1kMUpXDyRUFDWurxbnVT1vQPx+Wz9uCYsMIqYuSBLV+PAaZG/d7kRLKRFc9oDMsH+mFQ=="
     },
     "interpret": {
       "version": "1.1.0",

From 92dc5273b529f6d9b0629904080933fe5b100452 Mon Sep 17 00:00:00 2001
From: Jian Zhang 
Date: Tue, 19 Jan 2021 05:42:10 +0800
Subject: [PATCH 592/699] Fixed a contradiction about .attr("checked")

Close #288.
---
 entries/attr.xml | 9 +--------
 1 file changed, 1 insertion(+), 8 deletions(-)

diff --git a/entries/attr.xml b/entries/attr.xml
index 2dc8a25e..825fce9b 100644
--- a/entries/attr.xml
+++ b/entries/attr.xml
@@ -49,17 +49,10 @@
         
           
             $( elem ).attr( "checked" )
-            (1.6)
+            (1.6+)
           
           "checked" (String) Initial state of the checkbox; does not change
         
-        
-          
-            $( elem ).attr( "checked" )
-            (1.6.1+)
-          
-          "checked" (String) Will change with checkbox state
-        
         
           
             $( elem ).attr( "checked" )

From e5f5d6ca8f216a037bb9896fa01d8eb766ebf6ec Mon Sep 17 00:00:00 2001
From: Timo Tijhof 
Date: Tue, 16 Mar 2021 02:10:30 +0000
Subject: [PATCH 593/699] 3.0.6

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index a381061f..12cda7a5 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.0.5",
+  "version": "3.0.6",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index d9de68ab..5caf5041 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.0.5",
+  "version": "3.0.6",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From a46c18011a9b9ca82d9a7657f6f02c0e58e01b64 Mon Sep 17 00:00:00 2001
From: Kid <44045911+kidonng@users.noreply.github.com>
Date: Thu, 8 Apr 2021 21:04:27 +0800
Subject: [PATCH 594/699] addClass:removeClass:toggleClass: Update function
 signatures

From jQuery 3.3.0[1], if using a function as a argument for `.addClass`,
`.removeClass` and `.toggleClass`, the function is allowed to return
an `Array`. However, this was not reflected in the return types.
This change documents that new signature.

Closes gh-1183

[1] https://blog.jquery.com/2018/01/19/jquery-3-3-0-a-fragrant-bouquet-of-deprecations-and-is-that-a-new-feature/
---
 entries/addClass.xml    | 12 +++++++++++-
 entries/removeClass.xml | 12 +++++++++++-
 entries/toggleClass.xml | 16 +++++++++++++++-
 3 files changed, 37 insertions(+), 3 deletions(-)

diff --git a/entries/addClass.xml b/entries/addClass.xml
index 9af9723a..39d6a0bf 100644
--- a/entries/addClass.xml
+++ b/entries/addClass.xml
@@ -16,12 +16,22 @@
   
     1.4
     
-      A function returning one or more space-separated classes or an array of classes to be added to the existing class name(s). Receives the index position of the element in the set and the existing class name(s) as arguments. Within the function, this refers to the current element in the set.
+      A function returning one or more space-separated class names to be added to the existing class name(s). Receives the index position of the element in the set and the existing class name(s) as arguments. Within the function, this refers to the current element in the set.
       
       
       
     
   
+  
+    3.3
+    
+      A function returning one or more space-separated class names or an array of class names to be added to the existing class name(s). Receives the index position of the element in the set and the existing class name(s) as arguments. Within the function, this refers to the current element in the set.
+      
+      
+      
+      
+    
+  
   Adds the specified class(es) to each element in the set of matched elements.
   
     
            It's important to note that this method does not replace a class. It simply adds the class, appending it to any which may already be assigned to the elements.
            
diff --git a/entries/removeClass.xml b/entries/removeClass.xml
index 03b02f0c..c2daa31c 100644
--- a/entries/removeClass.xml
+++ b/entries/removeClass.xml
@@ -19,7 +19,17 @@
       
       
       
-      A function returning one or more space-separated classes or an array of classes to be removed. Receives the index position of the element in the set and the old class value as arguments.
+      A function returning one or more space-separated class names to be removed. Receives the index position of the element in the set and the old class value as arguments.
+    
+  
+  
+    3.3
+    
+      
+      
+      
+      
+      A function returning one or more space-separated class names or an array of class names to be removed. Receives the index position of the element in the set and the old class value as arguments.
     
   
   Remove a single class, multiple classes, or all classes from each element in the set of matched elements.
diff --git a/entries/toggleClass.xml b/entries/toggleClass.xml
index a1b50ca1..3ce8196c 100644
--- a/entries/toggleClass.xml
+++ b/entries/toggleClass.xml
@@ -39,7 +39,21 @@
         
         
         
-        A function that returns one or more space-separated classes or an array of classes to be toggled in the class attribute of each element in the matched set. Receives the index position of the element in the set, the old class value, and the state as arguments.
+        A function returning one or more space-separated class names to be toggled in the class attribute of each element in the matched set. Receives the index position of the element in the set, the old class value, and the state as arguments.
+      
+      
+        A boolean value to determine whether the class should be added or removed.
+      
+    
+    
+      3.3
+      
+        
+        
+        
+        
+        
+        A function returning one or more space-separated class names or an array of class names to be toggled in the class attribute of each element in the matched set. Receives the index position of the element in the set, the old class value, and the state as arguments.
       
       
         A boolean value to determine whether the class should be added or removed.

From 07862e9a040f1ec3f3c6a0d2e708aa8542d1bf31 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Thu, 8 Apr 2021 15:05:17 +0200
Subject: [PATCH 595/699] 3.0.7

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 12cda7a5..fe1001fd 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.0.6",
+  "version": "3.0.7",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 5caf5041..31e00bc5 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.0.6",
+  "version": "3.0.7",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From c887da7acdf4d4bb2631b6d96f5e38d046527243 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 7 May 2021 11:15:24 +0200
Subject: [PATCH 596/699] Build: Bump grunt from 1.0.4 to 1.3.0

Bumps [grunt](https://github.com/gruntjs/grunt) from 1.0.4 to 1.3.0.
- [Release notes](https://github.com/gruntjs/grunt/releases)
- [Changelog](https://github.com/gruntjs/grunt/blob/main/CHANGELOG)
- [Commits](https://github.com/gruntjs/grunt/compare/v1.0.4...v1.3.0)

Signed-off-by: dependabot[bot] 

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Closes gh-1186
---
 package-lock.json | 537 ++++++++--------------------------------------
 package.json      |   2 +-
 2 files changed, 91 insertions(+), 448 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index fe1001fd..59f15e7c 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -24,11 +24,11 @@
       "integrity": "sha512-nne9/IiQ/hzIhY6pdDnbBtz7DjPTKrY00P/zvPSm5pOFkl6xuGrGnXn/VtTNNfNtAfZ9/1RtehkszU9qcTii0Q=="
     },
     "ansi-styles": {
-      "version": "3.2.1",
-      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
-      "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
       "requires": {
-        "color-convert": "^1.9.0"
+        "color-convert": "^2.0.1"
       }
     },
     "argparse": {
@@ -66,11 +66,6 @@
       "resolved": "https://registry.npmjs.org/array-each/-/array-each-1.0.1.tgz",
       "integrity": "sha1-p5SvDAWrF1KEbudTofIRoFugxE8="
     },
-    "array-find-index": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/array-find-index/-/array-find-index-1.0.2.tgz",
-      "integrity": "sha1-3wEKoSh+Fku9pvlyOwqWoexBh6E="
-    },
     "array-slice": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/array-slice/-/array-slice-1.1.0.tgz",
@@ -87,9 +82,9 @@
       "integrity": "sha1-WWZ/QfrdTyDMvCu5a41Pf3jsA2c="
     },
     "async": {
-      "version": "1.5.2",
-      "resolved": "https://registry.npmjs.org/async/-/async-1.5.2.tgz",
-      "integrity": "sha1-7GphrlZIDAw8skHJVhjiCJL5Zyo="
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/async/-/async-3.2.0.tgz",
+      "integrity": "sha512-TR2mEZFVOj2pLStYxLht7TyfuRzaydfpxr3k9RpHIzMgw7A64dzsdqCxH1WJyQdoe8T10nDXd9wnEigmiuHIZw=="
     },
     "atob": {
       "version": "2.1.2",
@@ -203,28 +198,13 @@
         "unset-value": "^1.0.0"
       }
     },
-    "camelcase": {
-      "version": "2.1.1",
-      "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-2.1.1.tgz",
-      "integrity": "sha1-fB0W1nmhu+WcoCys7PsBHiAfWh8="
-    },
-    "camelcase-keys": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/camelcase-keys/-/camelcase-keys-2.1.0.tgz",
-      "integrity": "sha1-MIvur/3ygRkFHvodkyITyRuPkuc=",
-      "requires": {
-        "camelcase": "^2.0.0",
-        "map-obj": "^1.0.0"
-      }
-    },
     "chalk": {
-      "version": "2.4.2",
-      "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.2.tgz",
-      "integrity": "sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==",
+      "version": "4.1.1",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.1.tgz",
+      "integrity": "sha512-diHzdDKxcU+bAsUboHLPEDQiw0qEe0qd7SYUn3HgcFlWgbDcfLGswOHYeGrHKzG9z6UYf01d9VFMfZxPM1xZSg==",
       "requires": {
-        "ansi-styles": "^3.2.1",
-        "escape-string-regexp": "^1.0.5",
-        "supports-color": "^5.3.0"
+        "ansi-styles": "^4.1.0",
+        "supports-color": "^7.1.0"
       }
     },
     "cheerio": {
@@ -267,11 +247,6 @@
         }
       }
     },
-    "coffeescript": {
-      "version": "1.10.0",
-      "resolved": "https://registry.npmjs.org/coffeescript/-/coffeescript-1.10.0.tgz",
-      "integrity": "sha1-56qDAZF+9iGzXYo580jc3R234z4="
-    },
     "collection-visit": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/collection-visit/-/collection-visit-1.0.0.tgz",
@@ -282,17 +257,17 @@
       }
     },
     "color-convert": {
-      "version": "1.9.3",
-      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.3.tgz",
-      "integrity": "sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==",
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
+      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
       "requires": {
-        "color-name": "1.1.3"
+        "color-name": "~1.1.4"
       }
     },
     "color-name": {
-      "version": "1.1.3",
-      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz",
-      "integrity": "sha1-p9BVi9icQveV3UIyj3QIMcpTvCU="
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA=="
     },
     "colors": {
       "version": "1.1.2",
@@ -319,22 +294,10 @@
       "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.2.tgz",
       "integrity": "sha1-tf1UIgqivFq1eqtxQMlAdUUDwac="
     },
-    "currently-unhandled": {
-      "version": "0.4.1",
-      "resolved": "https://registry.npmjs.org/currently-unhandled/-/currently-unhandled-0.4.1.tgz",
-      "integrity": "sha1-mI3zP+qxke95mmE2nddsF635V+o=",
-      "requires": {
-        "array-find-index": "^1.0.1"
-      }
-    },
     "dateformat": {
-      "version": "1.0.12",
-      "resolved": "https://registry.npmjs.org/dateformat/-/dateformat-1.0.12.tgz",
-      "integrity": "sha1-nxJLZ1lMk3/3BpMuSmQsyo27/uk=",
-      "requires": {
-        "get-stdin": "^4.0.1",
-        "meow": "^3.3.0"
-      }
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/dateformat/-/dateformat-3.0.3.tgz",
+      "integrity": "sha512-jyCETtSl3VMZMWeRo7iY1FL19ges1t55hMo5yaam4Jrsm5EPL89UQkoQRyiI+Yf4k8r2ZpdngkV8hr1lIdjb3Q=="
     },
     "debug": {
       "version": "2.6.9",
@@ -344,11 +307,6 @@
         "ms": "2.0.0"
       }
     },
-    "decamelize": {
-      "version": "1.2.0",
-      "resolved": "https://registry.npmjs.org/decamelize/-/decamelize-1.2.0.tgz",
-      "integrity": "sha1-9lNNFRSCabIDUue+4m9QH5oZEpA="
-    },
     "decode-uri-component": {
       "version": "0.2.0",
       "resolved": "https://registry.npmjs.org/decode-uri-component/-/decode-uri-component-0.2.0.tgz",
@@ -438,19 +396,6 @@
       "resolved": "https://registry.npmjs.org/entities/-/entities-1.1.2.tgz",
       "integrity": "sha512-f2LZMYl1Fzu7YSBKg+RoROelpOaNrcGmE9AZubeDfrCEia483oW4MI4VyFd5VNHIgQ/7qm1I0wUHK1eJnn2y2w=="
     },
-    "error-ex": {
-      "version": "1.3.2",
-      "resolved": "https://registry.npmjs.org/error-ex/-/error-ex-1.3.2.tgz",
-      "integrity": "sha512-7dFHNmqeFSEt2ZBsCriorKnn3Z2pj+fd9kmI6QoWw4//DL+icEBfc0U7qJCisqrTsKTjw4fNFy2pW9OqStD84g==",
-      "requires": {
-        "is-arrayish": "^0.2.1"
-      }
-    },
-    "escape-string-regexp": {
-      "version": "1.0.5",
-      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz",
-      "integrity": "sha1-G2HAViGQqN/2rjuyzwIAyhMLhtQ="
-    },
     "esprima": {
       "version": "4.0.1",
       "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz",
@@ -610,15 +555,6 @@
         }
       }
     },
-    "find-up": {
-      "version": "1.1.2",
-      "resolved": "https://registry.npmjs.org/find-up/-/find-up-1.1.2.tgz",
-      "integrity": "sha1-ay6YIrGizgpgq2TWEOzK1TyyTQ8=",
-      "requires": {
-        "path-exists": "^2.0.0",
-        "pinkie-promise": "^2.0.0"
-      }
-    },
     "findup-sync": {
       "version": "0.3.0",
       "resolved": "https://registry.npmjs.org/findup-sync/-/findup-sync-0.3.0.tgz",
@@ -684,20 +620,15 @@
       "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz",
       "integrity": "sha1-FQStJSMVjKpA20onh8sBQRmU6k8="
     },
-    "get-stdin": {
-      "version": "4.0.1",
-      "resolved": "https://registry.npmjs.org/get-stdin/-/get-stdin-4.0.1.tgz",
-      "integrity": "sha1-uWjGsKBDhDJJAui/Gl3zJXmkUP4="
-    },
     "get-value": {
       "version": "2.0.6",
       "resolved": "https://registry.npmjs.org/get-value/-/get-value-2.0.6.tgz",
       "integrity": "sha1-3BXKHGcjh8p2vTesCjlbogQqLCg="
     },
     "getobject": {
-      "version": "0.1.0",
-      "resolved": "https://registry.npmjs.org/getobject/-/getobject-0.1.0.tgz",
-      "integrity": "sha1-BHpEl4n6Fg0Bj1SG7ZEyC27HiFw="
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/getobject/-/getobject-1.0.0.tgz",
+      "integrity": "sha512-tbUz6AKKKr2YiMB+fLWIgq5ZeBOobop9YMMAU9dC54/ot2ksMXt3DOFyBuhZw6ptcVszEykgByK20j7W9jHFag=="
     },
     "gilded-wordpress": {
       "version": "1.0.5",
@@ -736,14 +667,14 @@
       }
     },
     "glob": {
-      "version": "7.0.6",
-      "resolved": "https://registry.npmjs.org/glob/-/glob-7.0.6.tgz",
-      "integrity": "sha1-IRuvr0nlJbjNkyYNFKsTYVKz9Xo=",
+      "version": "7.1.7",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-7.1.7.tgz",
+      "integrity": "sha512-OvD9ENzPLbegENnYP5UUfJIirTg4+XwMWGaQfQTY0JenxNvvIKP3U3/tAQSPIu/lHxXYSZmpXlUHeqAIdKzBLQ==",
       "requires": {
         "fs.realpath": "^1.0.0",
         "inflight": "^1.0.4",
         "inherits": "2",
-        "minimatch": "^3.0.2",
+        "minimatch": "^3.0.4",
         "once": "^1.3.0",
         "path-is-absolute": "^1.0.0"
       }
@@ -770,51 +701,26 @@
         "which": "^1.2.14"
       }
     },
-    "graceful-fs": {
-      "version": "4.2.2",
-      "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.2.tgz",
-      "integrity": "sha512-IItsdsea19BoLC7ELy13q1iJFNmd7ofZH5+X/pJr90/nRoPEX0DJo1dHDbgtYWOhJhcCgMDTOw84RZ72q6lB+Q=="
-    },
     "grunt": {
-      "version": "1.0.4",
-      "resolved": "https://registry.npmjs.org/grunt/-/grunt-1.0.4.tgz",
-      "integrity": "sha512-PYsMOrOC+MsdGEkFVwMaMyc6Ob7pKmq+deg1Sjr+vvMWp35sztfwKE7qoN51V+UEtHsyNuMcGdgMLFkBHvMxHQ==",
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/grunt/-/grunt-1.3.0.tgz",
+      "integrity": "sha512-6ILlMXv11/4cxuhSMfSU+SfvbxrPuqZrAtLN64+tZpQ3DAKfSQPQHRbTjSbdtxfyQhGZPtN0bDZJ/LdCM5WXXA==",
       "requires": {
-        "coffeescript": "~1.10.0",
-        "dateformat": "~1.0.12",
+        "dateformat": "~3.0.3",
         "eventemitter2": "~0.4.13",
-        "exit": "~0.1.1",
+        "exit": "~0.1.2",
         "findup-sync": "~0.3.0",
-        "glob": "~7.0.0",
-        "grunt-cli": "~1.2.0",
+        "glob": "~7.1.6",
+        "grunt-cli": "~1.3.2",
         "grunt-known-options": "~1.1.0",
-        "grunt-legacy-log": "~2.0.0",
-        "grunt-legacy-util": "~1.1.1",
+        "grunt-legacy-log": "~3.0.0",
+        "grunt-legacy-util": "~2.0.0",
         "iconv-lite": "~0.4.13",
-        "js-yaml": "~3.13.0",
-        "minimatch": "~3.0.2",
-        "mkdirp": "~0.5.1",
+        "js-yaml": "~3.14.0",
+        "minimatch": "~3.0.4",
+        "mkdirp": "~1.0.4",
         "nopt": "~3.0.6",
-        "path-is-absolute": "~1.0.0",
-        "rimraf": "~2.6.2"
-      },
-      "dependencies": {
-        "grunt-cli": {
-          "version": "1.2.0",
-          "resolved": "https://registry.npmjs.org/grunt-cli/-/grunt-cli-1.2.0.tgz",
-          "integrity": "sha1-VisRnrsGndtGSs4oRVAb6Xs1tqg=",
-          "requires": {
-            "findup-sync": "~0.3.0",
-            "grunt-known-options": "~1.1.0",
-            "nopt": "~3.0.6",
-            "resolve": "~1.1.0"
-          }
-        },
-        "resolve": {
-          "version": "1.1.7",
-          "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.1.7.tgz",
-          "integrity": "sha1-IDEU2CrSxe2ejgQRs5ModeiJ6Xs="
-        }
+        "rimraf": "~3.0.2"
       }
     },
     "grunt-check-modules": {
@@ -886,37 +792,47 @@
       "integrity": "sha512-cHwsLqoighpu7TuYj5RonnEuxGVFnztcUqTqp5rXFGYL4OuPFofwC4Ycg7n9fYwvK6F5WbYgeVOwph9Crs2fsQ=="
     },
     "grunt-legacy-log": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/grunt-legacy-log/-/grunt-legacy-log-2.0.0.tgz",
-      "integrity": "sha512-1m3+5QvDYfR1ltr8hjiaiNjddxGdQWcH0rw1iKKiQnF0+xtgTazirSTGu68RchPyh1OBng1bBUjLmX8q9NpoCw==",
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/grunt-legacy-log/-/grunt-legacy-log-3.0.0.tgz",
+      "integrity": "sha512-GHZQzZmhyq0u3hr7aHW4qUH0xDzwp2YXldLPZTCjlOeGscAOWWPftZG3XioW8MasGp+OBRIu39LFx14SLjXRcA==",
       "requires": {
         "colors": "~1.1.2",
-        "grunt-legacy-log-utils": "~2.0.0",
+        "grunt-legacy-log-utils": "~2.1.0",
         "hooker": "~0.2.3",
-        "lodash": "~4.17.5"
+        "lodash": "~4.17.19"
       }
     },
     "grunt-legacy-log-utils": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/grunt-legacy-log-utils/-/grunt-legacy-log-utils-2.0.1.tgz",
-      "integrity": "sha512-o7uHyO/J+i2tXG8r2bZNlVk20vlIFJ9IEYyHMCQGfWYru8Jv3wTqKZzvV30YW9rWEjq0eP3cflQ1qWojIe9VFA==",
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/grunt-legacy-log-utils/-/grunt-legacy-log-utils-2.1.0.tgz",
+      "integrity": "sha512-lwquaPXJtKQk0rUM1IQAop5noEpwFqOXasVoedLeNzaibf/OPWjKYvvdqnEHNmU+0T0CaReAXIbGo747ZD+Aaw==",
       "requires": {
-        "chalk": "~2.4.1",
-        "lodash": "~4.17.10"
+        "chalk": "~4.1.0",
+        "lodash": "~4.17.19"
       }
     },
     "grunt-legacy-util": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/grunt-legacy-util/-/grunt-legacy-util-1.1.1.tgz",
-      "integrity": "sha512-9zyA29w/fBe6BIfjGENndwoe1Uy31BIXxTH3s8mga0Z5Bz2Sp4UCjkeyv2tI449ymkx3x26B+46FV4fXEddl5A==",
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/grunt-legacy-util/-/grunt-legacy-util-2.0.1.tgz",
+      "integrity": "sha512-2bQiD4fzXqX8rhNdXkAywCadeqiPiay0oQny77wA2F3WF4grPJXCvAcyoWUJV+po/b15glGkxuSiQCK299UC2w==",
       "requires": {
-        "async": "~1.5.2",
-        "exit": "~0.1.1",
-        "getobject": "~0.1.0",
+        "async": "~3.2.0",
+        "exit": "~0.1.2",
+        "getobject": "~1.0.0",
         "hooker": "~0.2.3",
-        "lodash": "~4.17.10",
-        "underscore.string": "~3.3.4",
-        "which": "~1.3.0"
+        "lodash": "~4.17.21",
+        "underscore.string": "~3.3.5",
+        "which": "~2.0.2"
+      },
+      "dependencies": {
+        "which": {
+          "version": "2.0.2",
+          "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
+          "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
+          "requires": {
+            "isexe": "^2.0.0"
+          }
+        }
       }
     },
     "grunt-wordpress": {
@@ -928,9 +844,9 @@
       }
     },
     "has-flag": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
-      "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0="
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
+      "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ=="
     },
     "has-value": {
       "version": "1.0.0",
@@ -984,11 +900,6 @@
       "resolved": "https://registry.npmjs.org/hooker/-/hooker-0.2.3.tgz",
       "integrity": "sha1-uDT3I8xKJCqmWWNFnfbZhMXT2Vk="
     },
-    "hosted-git-info": {
-      "version": "2.8.4",
-      "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-2.8.4.tgz",
-      "integrity": "sha512-pzXIvANXEFrc5oFFXRMkbLPQ2rXRoDERwDLyrcUxGhaZhgP54BBSl9Oheh7Vv0T090cszWBxPjkQQ5Sq1PbBRQ=="
-    },
     "htmlparser2": {
       "version": "3.7.3",
       "resolved": "https://registry.npmjs.org/htmlparser2/-/htmlparser2-3.7.3.tgz",
@@ -1025,14 +936,6 @@
         "safer-buffer": ">= 2.1.2 < 3"
       }
     },
-    "indent-string": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/indent-string/-/indent-string-2.1.0.tgz",
-      "integrity": "sha1-ji1INIdCEhtKghi3oTfppSBJ3IA=",
-      "requires": {
-        "repeating": "^2.0.0"
-      }
-    },
     "inflight": {
       "version": "1.0.6",
       "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz",
@@ -1084,11 +987,6 @@
         }
       }
     },
-    "is-arrayish": {
-      "version": "0.2.1",
-      "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.2.1.tgz",
-      "integrity": "sha1-d8mYQFJ6qOyxqLppe4BkWnqSap0="
-    },
     "is-buffer": {
       "version": "1.1.6",
       "resolved": "https://registry.npmjs.org/is-buffer/-/is-buffer-1.1.6.tgz",
@@ -1139,14 +1037,6 @@
       "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
       "integrity": "sha1-qIwCU1eR8C7TfHahueqXc8gz+MI="
     },
-    "is-finite": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/is-finite/-/is-finite-1.0.2.tgz",
-      "integrity": "sha1-zGZ3aVYCvlUO8R6LSqYwU0K20Ko=",
-      "requires": {
-        "number-is-nan": "^1.0.0"
-      }
-    },
     "is-glob": {
       "version": "3.1.0",
       "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-3.1.0.tgz",
@@ -1197,11 +1087,6 @@
         "unc-path-regex": "^0.1.2"
       }
     },
-    "is-utf8": {
-      "version": "0.2.1",
-      "resolved": "https://registry.npmjs.org/is-utf8/-/is-utf8-0.2.1.tgz",
-      "integrity": "sha1-Sw2hRCEE0bM2NA6AeX6GXPOffXI="
-    },
     "is-windows": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/is-windows/-/is-windows-1.0.2.tgz",
@@ -1223,9 +1108,9 @@
       "integrity": "sha1-TkMekrEalzFjaqH5yNHMvP2reN8="
     },
     "js-yaml": {
-      "version": "3.13.1",
-      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.13.1.tgz",
-      "integrity": "sha512-YfbcO7jXDdyj0DGxYVSlSeQNHbD7XPWvrVWeVUujrQEoZzWJIRrCPoyk6kL6IAjAG2IolMK4T0hNUe0HOUs5Jw==",
+      "version": "3.14.1",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.1.tgz",
+      "integrity": "sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==",
       "requires": {
         "argparse": "^1.0.7",
         "esprima": "^4.0.0"
@@ -1264,31 +1149,10 @@
         }
       }
     },
-    "load-json-file": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/load-json-file/-/load-json-file-1.1.0.tgz",
-      "integrity": "sha1-lWkFcI1YtLq0wiYbBPWfMcmTdMA=",
-      "requires": {
-        "graceful-fs": "^4.1.2",
-        "parse-json": "^2.2.0",
-        "pify": "^2.0.0",
-        "pinkie-promise": "^2.0.0",
-        "strip-bom": "^2.0.0"
-      }
-    },
     "lodash": {
-      "version": "4.17.15",
-      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.15.tgz",
-      "integrity": "sha512-8xOcRHvCjnocdS5cpwXQXVzmmh5e5+saE2QGoeQmbKmRS6J3VQppPOIt0MnmE+4xlZoumy0GPG0D0MVIQbNA1A=="
-    },
-    "loud-rejection": {
-      "version": "1.6.0",
-      "resolved": "https://registry.npmjs.org/loud-rejection/-/loud-rejection-1.6.0.tgz",
-      "integrity": "sha1-W0b4AUft7leIcPCG0Eghz5mOVR8=",
-      "requires": {
-        "currently-unhandled": "^0.4.1",
-        "signal-exit": "^3.0.0"
-      }
+      "version": "4.17.21",
+      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz",
+      "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg=="
     },
     "make-iterator": {
       "version": "1.0.1",
@@ -1303,11 +1167,6 @@
       "resolved": "https://registry.npmjs.org/map-cache/-/map-cache-0.2.2.tgz",
       "integrity": "sha1-wyq9C9ZSXZsFFkW7TyasXcmKDb8="
     },
-    "map-obj": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/map-obj/-/map-obj-1.0.1.tgz",
-      "integrity": "sha1-2TPOuSBdgr3PSIb2dCvcK03qFG0="
-    },
     "map-visit": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/map-visit/-/map-visit-1.0.0.tgz",
@@ -1321,23 +1180,6 @@
       "resolved": "https://registry.npmjs.org/marked/-/marked-0.3.2.tgz",
       "integrity": "sha1-AV2xWIZEOPJKZL3WGgQotBhwbQk="
     },
-    "meow": {
-      "version": "3.7.0",
-      "resolved": "https://registry.npmjs.org/meow/-/meow-3.7.0.tgz",
-      "integrity": "sha1-cstmi0JSKCkKu/qFaJJYcwioAfs=",
-      "requires": {
-        "camelcase-keys": "^2.0.0",
-        "decamelize": "^1.1.2",
-        "loud-rejection": "^1.0.0",
-        "map-obj": "^1.0.1",
-        "minimist": "^1.1.3",
-        "normalize-package-data": "^2.3.4",
-        "object-assign": "^4.0.1",
-        "read-pkg-up": "^1.0.1",
-        "redent": "^1.0.0",
-        "trim-newlines": "^1.0.0"
-      }
-    },
     "micromatch": {
       "version": "3.1.10",
       "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-3.1.10.tgz",
@@ -1366,11 +1208,6 @@
         "brace-expansion": "^1.1.7"
       }
     },
-    "minimist": {
-      "version": "1.2.0",
-      "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.0.tgz",
-      "integrity": "sha1-o1AIsg9BOD7sH7kU9M1d95omQoQ="
-    },
     "mixin-deep": {
       "version": "1.3.2",
       "resolved": "https://registry.npmjs.org/mixin-deep/-/mixin-deep-1.3.2.tgz",
@@ -1391,19 +1228,9 @@
       }
     },
     "mkdirp": {
-      "version": "0.5.1",
-      "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.1.tgz",
-      "integrity": "sha1-MAV0OOrGz3+MR2fzhkjWaX11yQM=",
-      "requires": {
-        "minimist": "0.0.8"
-      },
-      "dependencies": {
-        "minimist": {
-          "version": "0.0.8",
-          "resolved": "https://registry.npmjs.org/minimist/-/minimist-0.0.8.tgz",
-          "integrity": "sha1-hX/Kv8M5fSYluCKCYuhqp6ARsF0="
-        }
-      }
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-1.0.4.tgz",
+      "integrity": "sha512-vVqVZQyf3WLx2Shd0qJ9xuvqgAyKPLAiqITEtqW0oIUjzo3PePDd6fW9iFz30ef7Ysp/oiWqbhszeGWW2T6Gzw=="
     },
     "ms": {
       "version": "2.0.0",
@@ -1436,27 +1263,6 @@
         "abbrev": "1"
       }
     },
-    "normalize-package-data": {
-      "version": "2.5.0",
-      "resolved": "https://registry.npmjs.org/normalize-package-data/-/normalize-package-data-2.5.0.tgz",
-      "integrity": "sha512-/5CMN3T0R4XTj4DcGaexo+roZSdSFW/0AOOTROrjxzCG1wrWXEsGbRKevjlIL+ZDE4sZlJr5ED4YW0yqmkK+eA==",
-      "requires": {
-        "hosted-git-info": "^2.1.4",
-        "resolve": "^1.10.0",
-        "semver": "2 || 3 || 4 || 5",
-        "validate-npm-package-license": "^3.0.1"
-      }
-    },
-    "number-is-nan": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/number-is-nan/-/number-is-nan-1.0.1.tgz",
-      "integrity": "sha1-CXtgK1NCKlIsGvuHkDGDNpQaAR0="
-    },
-    "object-assign": {
-      "version": "4.1.1",
-      "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz",
-      "integrity": "sha1-IQmtx5ZYh8/AXLvUQsrIv7s2CGM="
-    },
     "object-copy": {
       "version": "0.1.0",
       "resolved": "https://registry.npmjs.org/object-copy/-/object-copy-0.1.0.tgz",
@@ -1558,14 +1364,6 @@
         "path-root": "^0.1.1"
       }
     },
-    "parse-json": {
-      "version": "2.2.0",
-      "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-2.2.0.tgz",
-      "integrity": "sha1-9ID0BDTvgHQfhGkJn43qGPVaTck=",
-      "requires": {
-        "error-ex": "^1.2.0"
-      }
-    },
     "parse-passwd": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/parse-passwd/-/parse-passwd-1.0.0.tgz",
@@ -1576,14 +1374,6 @@
       "resolved": "https://registry.npmjs.org/pascalcase/-/pascalcase-0.1.1.tgz",
       "integrity": "sha1-s2PlXoAGym/iF4TS2yK9FdeRfxQ="
     },
-    "path-exists": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-2.1.0.tgz",
-      "integrity": "sha1-D+tsZPD8UY2adU3V77YscCJ2H0s=",
-      "requires": {
-        "pinkie-promise": "^2.0.0"
-      }
-    },
     "path-is-absolute": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz",
@@ -1607,58 +1397,11 @@
       "resolved": "https://registry.npmjs.org/path-root-regex/-/path-root-regex-0.1.2.tgz",
       "integrity": "sha1-v8zcjfWxLcUsi0PsONGNcsBLqW0="
     },
-    "path-type": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/path-type/-/path-type-1.1.0.tgz",
-      "integrity": "sha1-WcRPfuSR2nBNpBXaWkBwuk+P5EE=",
-      "requires": {
-        "graceful-fs": "^4.1.2",
-        "pify": "^2.0.0",
-        "pinkie-promise": "^2.0.0"
-      }
-    },
-    "pify": {
-      "version": "2.3.0",
-      "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz",
-      "integrity": "sha1-7RQaasBDqEnqWISY59yosVMw6Qw="
-    },
-    "pinkie": {
-      "version": "2.0.4",
-      "resolved": "https://registry.npmjs.org/pinkie/-/pinkie-2.0.4.tgz",
-      "integrity": "sha1-clVrgM+g1IqXToDnckjoDtT3+HA="
-    },
-    "pinkie-promise": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/pinkie-promise/-/pinkie-promise-2.0.1.tgz",
-      "integrity": "sha1-ITXW36ejWMBprJsXh3YogihFD/o=",
-      "requires": {
-        "pinkie": "^2.0.0"
-      }
-    },
     "posix-character-classes": {
       "version": "0.1.1",
       "resolved": "https://registry.npmjs.org/posix-character-classes/-/posix-character-classes-0.1.1.tgz",
       "integrity": "sha1-AerA/jta9xoqbAL+q7jB/vfgDqs="
     },
-    "read-pkg": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/read-pkg/-/read-pkg-1.1.0.tgz",
-      "integrity": "sha1-9f+qXs0pyzHAR0vKfXVra7KePyg=",
-      "requires": {
-        "load-json-file": "^1.0.0",
-        "normalize-package-data": "^2.3.2",
-        "path-type": "^1.0.0"
-      }
-    },
-    "read-pkg-up": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/read-pkg-up/-/read-pkg-up-1.0.1.tgz",
-      "integrity": "sha1-nWPBMnbAZZGNV/ACpX9AobZD+wI=",
-      "requires": {
-        "find-up": "^1.0.0",
-        "read-pkg": "^1.0.0"
-      }
-    },
     "readable-stream": {
       "version": "1.1.14",
       "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-1.1.14.tgz",
@@ -1685,15 +1428,6 @@
         "resolve": "^1.1.6"
       }
     },
-    "redent": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/redent/-/redent-1.0.0.tgz",
-      "integrity": "sha1-z5Fqsf1fHxbfsggi3W7H9zDCr94=",
-      "requires": {
-        "indent-string": "^2.1.0",
-        "strip-indent": "^1.0.1"
-      }
-    },
     "regex-not": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/regex-not/-/regex-not-1.0.2.tgz",
@@ -1713,14 +1447,6 @@
       "resolved": "https://registry.npmjs.org/repeat-string/-/repeat-string-1.6.1.tgz",
       "integrity": "sha1-jcrkcOHIirwtYA//Sndihtp15jc="
     },
-    "repeating": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/repeating/-/repeating-2.0.1.tgz",
-      "integrity": "sha1-UhTFOpJtNVJwdSf7q0FdvAjQbdo=",
-      "requires": {
-        "is-finite": "^1.0.0"
-      }
-    },
     "resolve": {
       "version": "1.12.0",
       "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.12.0.tgz",
@@ -1749,26 +1475,11 @@
       "integrity": "sha512-TTlYpa+OL+vMMNG24xSlQGEJ3B/RzEfUlLct7b5G/ytav+wPrplCpVMFuwzXbkecJrb6IYo1iFb0S9v37754mg=="
     },
     "rimraf": {
-      "version": "2.6.3",
-      "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-2.6.3.tgz",
-      "integrity": "sha512-mwqeW5XsA2qAejG46gYdENaxXjx9onRNCfn7L0duuP4hCuTIi/QO7PDK07KJfp1d+izWPrzEJDcSqBa0OZQriA==",
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-3.0.2.tgz",
+      "integrity": "sha512-JZkJMZkAGFFPP2YqXZXPbMlMBgsxzE8ILs4lMIX/2o0L9UBw9O/Y3o6wFw/i9YLapcUJWwqbi3kdxIPdC62TIA==",
       "requires": {
         "glob": "^7.1.3"
-      },
-      "dependencies": {
-        "glob": {
-          "version": "7.1.4",
-          "resolved": "https://registry.npmjs.org/glob/-/glob-7.1.4.tgz",
-          "integrity": "sha512-hkLPepehmnKk41pUGm3sYxoFs/umurYfYJCerbXEyFIWcAzvpipAgVkBqqT9RBKMGjnq6kMuyYwha6csxbiM1A==",
-          "requires": {
-            "fs.realpath": "^1.0.0",
-            "inflight": "^1.0.4",
-            "inherits": "2",
-            "minimatch": "^3.0.4",
-            "once": "^1.3.0",
-            "path-is-absolute": "^1.0.0"
-          }
-        }
       }
     },
     "safe-regex": {
@@ -1789,11 +1500,6 @@
       "resolved": "https://registry.npmjs.org/sax/-/sax-1.2.4.tgz",
       "integrity": "sha512-NqVDv9TpANUjFm0N8uM5GxL36UgKi9/atZw+x7YFnQ8ckwFGKrl4xX4yWtrey3UJm5nP1kUbnYgLopqWNSRhWw=="
     },
-    "semver": {
-      "version": "5.7.1",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-5.7.1.tgz",
-      "integrity": "sha512-sauaDf/PZdVgrLTNYHRtpXa1iRiKcaebiKQ1BJdpQlWH2lCvexQdX55snPFyK7QzpudqbCI0qXFfOasHdyNDGQ=="
-    },
     "set-value": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/set-value/-/set-value-2.0.1.tgz",
@@ -1815,11 +1521,6 @@
         }
       }
     },
-    "signal-exit": {
-      "version": "3.0.2",
-      "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.2.tgz",
-      "integrity": "sha1-tf3AjxKH6hF4Yo5BXiUTK3NkbG0="
-    },
     "snapdragon": {
       "version": "0.8.2",
       "resolved": "https://registry.npmjs.org/snapdragon/-/snapdragon-0.8.2.tgz",
@@ -1944,34 +1645,6 @@
       "resolved": "https://registry.npmjs.org/spawnback/-/spawnback-1.0.0.tgz",
       "integrity": "sha1-9zZi9+VNlTZ+ynTWQmxnfdfqaG8="
     },
-    "spdx-correct": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/spdx-correct/-/spdx-correct-3.1.0.tgz",
-      "integrity": "sha512-lr2EZCctC2BNR7j7WzJ2FpDznxky1sjfxvvYEyzxNyb6lZXHODmEoJeFu4JupYlkfha1KZpJyoqiJ7pgA1qq8Q==",
-      "requires": {
-        "spdx-expression-parse": "^3.0.0",
-        "spdx-license-ids": "^3.0.0"
-      }
-    },
-    "spdx-exceptions": {
-      "version": "2.2.0",
-      "resolved": "https://registry.npmjs.org/spdx-exceptions/-/spdx-exceptions-2.2.0.tgz",
-      "integrity": "sha512-2XQACfElKi9SlVb1CYadKDXvoajPgBVPn/gOQLrTvHdElaVhr7ZEbqJaRnJLVNeaI4cMEAgVCeBMKF6MWRDCRA=="
-    },
-    "spdx-expression-parse": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/spdx-expression-parse/-/spdx-expression-parse-3.0.0.tgz",
-      "integrity": "sha512-Yg6D3XpRD4kkOmTpdgbUiEJFKghJH03fiC1OPll5h/0sO6neh2jqRDVHOQ4o/LMea0tgCkbMgea5ip/e+MkWyg==",
-      "requires": {
-        "spdx-exceptions": "^2.1.0",
-        "spdx-license-ids": "^3.0.0"
-      }
-    },
-    "spdx-license-ids": {
-      "version": "3.0.5",
-      "resolved": "https://registry.npmjs.org/spdx-license-ids/-/spdx-license-ids-3.0.5.tgz",
-      "integrity": "sha512-J+FWzZoynJEXGphVIS+XEh3kFSjZX/1i9gFBaWQcB+/tmpe2qUsSBABpcxqxnAxFdiUFEgAX1bjYGQvIZmoz9Q=="
-    },
     "split-string": {
       "version": "3.1.0",
       "resolved": "https://registry.npmjs.org/split-string/-/split-string-3.1.0.tgz",
@@ -2009,28 +1682,12 @@
       "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz",
       "integrity": "sha1-YuIDvEF2bGwoyfyEMB2rHFMQ+pQ="
     },
-    "strip-bom": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-2.0.0.tgz",
-      "integrity": "sha1-YhmoVhZSBJHzV4i9vxRHqZx+aw4=",
-      "requires": {
-        "is-utf8": "^0.2.0"
-      }
-    },
-    "strip-indent": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/strip-indent/-/strip-indent-1.0.1.tgz",
-      "integrity": "sha1-DHlipq3vp7vUrDZkYKY4VSrhoKI=",
-      "requires": {
-        "get-stdin": "^4.0.1"
-      }
-    },
     "supports-color": {
-      "version": "5.5.0",
-      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz",
-      "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==",
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
+      "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
       "requires": {
-        "has-flag": "^3.0.0"
+        "has-flag": "^4.0.0"
       }
     },
     "to-object-path": {
@@ -2071,11 +1728,6 @@
         "repeat-string": "^1.6.1"
       }
     },
-    "trim-newlines": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/trim-newlines/-/trim-newlines-1.0.0.tgz",
-      "integrity": "sha1-WIeWa7WCpFA6QetST301ARgVphM="
-    },
     "unc-path-regex": {
       "version": "0.1.2",
       "resolved": "https://registry.npmjs.org/unc-path-regex/-/unc-path-regex-0.1.2.tgz",
@@ -2160,15 +1812,6 @@
         "homedir-polyfill": "^1.0.1"
       }
     },
-    "validate-npm-package-license": {
-      "version": "3.0.4",
-      "resolved": "https://registry.npmjs.org/validate-npm-package-license/-/validate-npm-package-license-3.0.4.tgz",
-      "integrity": "sha512-DpKm2Ui/xN7/HQKCtpZxoRWBhZ9Z0kqtygG8XCgNQ8ZlDnxuQmWhj566j8fN4Cu3/JmbhsDo7fcAJq4s9h27Ew==",
-      "requires": {
-        "spdx-correct": "^3.0.0",
-        "spdx-expression-parse": "^3.0.0"
-      }
-    },
     "which": {
       "version": "1.3.1",
       "resolved": "https://registry.npmjs.org/which/-/which-1.3.1.tgz",
diff --git a/package.json b/package.json
index 31e00bc5..d7d80011 100644
--- a/package.json
+++ b/package.json
@@ -24,7 +24,7 @@
     "test": "grunt lint"
   },
   "dependencies": {
-    "grunt": "1.0.4",
+    "grunt": "1.3.0",
     "grunt-cli": "1.3.2",
     "grunt-jquery-content": "3.0.3"
   }

From a3af063201a7d2cf9666621e5312ee45849a9f53 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Thu, 13 May 2021 15:36:44 +0200
Subject: [PATCH 597/699] Build: Update grunt & grunt-cli

---
 package-lock.json | 1024 +++++----------------------------------------
 package.json      |    4 +-
 2 files changed, 102 insertions(+), 926 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 59f15e7c..f614f714 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -46,21 +46,6 @@
         }
       }
     },
-    "arr-diff": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/arr-diff/-/arr-diff-4.0.0.tgz",
-      "integrity": "sha1-1kYQdP6/7HHn4VI1dhoyml3HxSA="
-    },
-    "arr-flatten": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/arr-flatten/-/arr-flatten-1.1.0.tgz",
-      "integrity": "sha512-L3hKV5R/p5o81R7O02IGnwpDmkp6E982XhtbuwSe3O4qOtMMMtodicASA1Cny2U+aCXcNpml+m4dPsvsJ3jatg=="
-    },
-    "arr-union": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/arr-union/-/arr-union-3.1.0.tgz",
-      "integrity": "sha1-45sJrqne+Gao8gbiiK9jkZuuOcQ="
-    },
     "array-each": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/array-each/-/array-each-1.0.1.tgz",
@@ -71,80 +56,15 @@
       "resolved": "https://registry.npmjs.org/array-slice/-/array-slice-1.1.0.tgz",
       "integrity": "sha512-B1qMD3RBP7O8o0H2KbrXDyB0IccejMF15+87Lvlor12ONPRHP6gTjXMNkt/d3ZuOGbAe66hFmaCfECI24Ufp6w=="
     },
-    "array-unique": {
-      "version": "0.3.2",
-      "resolved": "https://registry.npmjs.org/array-unique/-/array-unique-0.3.2.tgz",
-      "integrity": "sha1-qJS3XUvE9s1nnvMkSp/Y9Gri1Cg="
-    },
-    "assign-symbols": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/assign-symbols/-/assign-symbols-1.0.0.tgz",
-      "integrity": "sha1-WWZ/QfrdTyDMvCu5a41Pf3jsA2c="
-    },
     "async": {
       "version": "3.2.0",
       "resolved": "https://registry.npmjs.org/async/-/async-3.2.0.tgz",
       "integrity": "sha512-TR2mEZFVOj2pLStYxLht7TyfuRzaydfpxr3k9RpHIzMgw7A64dzsdqCxH1WJyQdoe8T10nDXd9wnEigmiuHIZw=="
     },
-    "atob": {
-      "version": "2.1.2",
-      "resolved": "https://registry.npmjs.org/atob/-/atob-2.1.2.tgz",
-      "integrity": "sha512-Wm6ukoaOGJi/73p/cl2GvLjTI5JM1k/O14isD73YML8StrH/7/lRFgmg8nICZgD3bZZvjwCGxtMOD3wWNAu8cg=="
-    },
     "balanced-match": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.0.tgz",
-      "integrity": "sha1-ibTRmasr7kneFk6gK4nORi1xt2c="
-    },
-    "base": {
-      "version": "0.11.2",
-      "resolved": "https://registry.npmjs.org/base/-/base-0.11.2.tgz",
-      "integrity": "sha512-5T6P4xPgpp0YDFvSWwEZ4NoE3aM4QBQXDzmVbraCkFj8zHM+mba8SyqB5DbZWyR7mYHo6Y7BdQo3MoA4m0TeQg==",
-      "requires": {
-        "cache-base": "^1.0.1",
-        "class-utils": "^0.3.5",
-        "component-emitter": "^1.2.1",
-        "define-property": "^1.0.0",
-        "isobject": "^3.0.1",
-        "mixin-deep": "^1.2.0",
-        "pascalcase": "^0.1.1"
-      },
-      "dependencies": {
-        "define-property": {
-          "version": "1.0.0",
-          "resolved": "https://registry.npmjs.org/define-property/-/define-property-1.0.0.tgz",
-          "integrity": "sha1-dp66rz9KY6rTr56NMEybvnm/sOY=",
-          "requires": {
-            "is-descriptor": "^1.0.0"
-          }
-        },
-        "is-accessor-descriptor": {
-          "version": "1.0.0",
-          "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-1.0.0.tgz",
-          "integrity": "sha512-m5hnHTkcVsPfqx3AKlyttIPb7J+XykHvJP2B9bZDjlhLIoEq4XoK64Vg7boZlVWYK6LUY94dYPEE7Lh0ZkZKcQ==",
-          "requires": {
-            "kind-of": "^6.0.0"
-          }
-        },
-        "is-data-descriptor": {
-          "version": "1.0.0",
-          "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-1.0.0.tgz",
-          "integrity": "sha512-jbRXy1FmtAoCjQkVmIVYwuuqDFUbaOeDjmed1tOGPrsMhtJA4rD9tkgA0F1qJ3gRFRXcHYVkdeaP50Q5rE/jLQ==",
-          "requires": {
-            "kind-of": "^6.0.0"
-          }
-        },
-        "is-descriptor": {
-          "version": "1.0.2",
-          "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-1.0.2.tgz",
-          "integrity": "sha512-2eis5WqQGV7peooDyLmNEPUrps9+SXX5c9pL3xEB+4e9HnGuDa7mB7kHxHw4CbqS9k1T2hOH3miL8n8WtiYVtg==",
-          "requires": {
-            "is-accessor-descriptor": "^1.0.0",
-            "is-data-descriptor": "^1.0.0",
-            "kind-of": "^6.0.2"
-          }
-        }
-      }
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw=="
     },
     "brace-expansion": {
       "version": "1.1.11",
@@ -156,46 +76,11 @@
       }
     },
     "braces": {
-      "version": "2.3.2",
-      "resolved": "https://registry.npmjs.org/braces/-/braces-2.3.2.tgz",
-      "integrity": "sha512-aNdbnj9P8PjdXU4ybaWLK2IF3jc/EoDYbC7AazW6to3TRsfXxscC9UXOB5iDiEQrkyIbWp2SLQda4+QAa7nc3w==",
-      "requires": {
-        "arr-flatten": "^1.1.0",
-        "array-unique": "^0.3.2",
-        "extend-shallow": "^2.0.1",
-        "fill-range": "^4.0.0",
-        "isobject": "^3.0.1",
-        "repeat-element": "^1.1.2",
-        "snapdragon": "^0.8.1",
-        "snapdragon-node": "^2.0.1",
-        "split-string": "^3.0.2",
-        "to-regex": "^3.0.1"
-      },
-      "dependencies": {
-        "extend-shallow": {
-          "version": "2.0.1",
-          "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
-          "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=",
-          "requires": {
-            "is-extendable": "^0.1.0"
-          }
-        }
-      }
-    },
-    "cache-base": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/cache-base/-/cache-base-1.0.1.tgz",
-      "integrity": "sha512-AKcdTnFSWATd5/GCPRxr2ChwIJ85CeyrEyjRHlKxQ56d4XJMGym0uAiKn0xbLOGOl3+yRpOTi484dVCEc5AUzQ==",
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.2.tgz",
+      "integrity": "sha512-b8um+L1RzM3WDSzvhm6gIz1yfTbBt6YTlcEKAvsmqCZZFw46z626lVj9j1yEPW33H5H+lBQpZMP1k8l+78Ha0A==",
       "requires": {
-        "collection-visit": "^1.0.0",
-        "component-emitter": "^1.2.1",
-        "get-value": "^2.0.6",
-        "has-value": "^1.0.0",
-        "isobject": "^3.0.1",
-        "set-value": "^2.0.0",
-        "to-object-path": "^0.3.0",
-        "union-value": "^1.0.0",
-        "unset-value": "^1.0.0"
+        "fill-range": "^7.0.1"
       }
     },
     "chalk": {
@@ -226,36 +111,6 @@
         }
       }
     },
-    "class-utils": {
-      "version": "0.3.6",
-      "resolved": "https://registry.npmjs.org/class-utils/-/class-utils-0.3.6.tgz",
-      "integrity": "sha512-qOhPa/Fj7s6TY8H8esGu5QNpMMQxz79h+urzrNYN6mn+9BnxlDGf5QZ+XeCDsxSjPqsSR56XOZOJmpeurnLMeg==",
-      "requires": {
-        "arr-union": "^3.1.0",
-        "define-property": "^0.2.5",
-        "isobject": "^3.0.0",
-        "static-extend": "^0.1.1"
-      },
-      "dependencies": {
-        "define-property": {
-          "version": "0.2.5",
-          "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz",
-          "integrity": "sha1-w1se+RjsPJkPmlvFe+BKrOxcgRY=",
-          "requires": {
-            "is-descriptor": "^0.1.0"
-          }
-        }
-      }
-    },
-    "collection-visit": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/collection-visit/-/collection-visit-1.0.0.tgz",
-      "integrity": "sha1-S8A3PBZLwykbTTaMgpzxqApZ3KA=",
-      "requires": {
-        "map-visit": "^1.0.0",
-        "object-visit": "^1.0.0"
-      }
-    },
     "color-convert": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
@@ -274,21 +129,11 @@
       "resolved": "https://registry.npmjs.org/colors/-/colors-1.1.2.tgz",
       "integrity": "sha1-FopHAXVran9RoSzgyXv6KMCE7WM="
     },
-    "component-emitter": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/component-emitter/-/component-emitter-1.3.0.tgz",
-      "integrity": "sha512-Rd3se6QB+sO1TwqZjscQrurpEPIfO0/yYnSin6Q/rD3mOutHvUrCAhJub3r90uNb+SESBuE0QYoB90YdfatsRg=="
-    },
     "concat-map": {
       "version": "0.0.1",
       "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
       "integrity": "sha1-2Klr13/Wjfd5OnMDajug1UBdR3s="
     },
-    "copy-descriptor": {
-      "version": "0.1.1",
-      "resolved": "https://registry.npmjs.org/copy-descriptor/-/copy-descriptor-0.1.1.tgz",
-      "integrity": "sha1-Z29us8OZl8LuGsOpJP1hJHSPV40="
-    },
     "core-util-is": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.2.tgz",
@@ -299,56 +144,6 @@
       "resolved": "https://registry.npmjs.org/dateformat/-/dateformat-3.0.3.tgz",
       "integrity": "sha512-jyCETtSl3VMZMWeRo7iY1FL19ges1t55hMo5yaam4Jrsm5EPL89UQkoQRyiI+Yf4k8r2ZpdngkV8hr1lIdjb3Q=="
     },
-    "debug": {
-      "version": "2.6.9",
-      "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
-      "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
-      "requires": {
-        "ms": "2.0.0"
-      }
-    },
-    "decode-uri-component": {
-      "version": "0.2.0",
-      "resolved": "https://registry.npmjs.org/decode-uri-component/-/decode-uri-component-0.2.0.tgz",
-      "integrity": "sha1-6zkTMzRYd1y4TNGh+uBiEGu4dUU="
-    },
-    "define-property": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/define-property/-/define-property-2.0.2.tgz",
-      "integrity": "sha512-jwK2UV4cnPpbcG7+VRARKTZPUWowwXA8bzH5NP6ud0oeAxyYPuGZUAC7hMugpCdz4BeSZl2Dl9k66CHJ/46ZYQ==",
-      "requires": {
-        "is-descriptor": "^1.0.2",
-        "isobject": "^3.0.1"
-      },
-      "dependencies": {
-        "is-accessor-descriptor": {
-          "version": "1.0.0",
-          "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-1.0.0.tgz",
-          "integrity": "sha512-m5hnHTkcVsPfqx3AKlyttIPb7J+XykHvJP2B9bZDjlhLIoEq4XoK64Vg7boZlVWYK6LUY94dYPEE7Lh0ZkZKcQ==",
-          "requires": {
-            "kind-of": "^6.0.0"
-          }
-        },
-        "is-data-descriptor": {
-          "version": "1.0.0",
-          "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-1.0.0.tgz",
-          "integrity": "sha512-jbRXy1FmtAoCjQkVmIVYwuuqDFUbaOeDjmed1tOGPrsMhtJA4rD9tkgA0F1qJ3gRFRXcHYVkdeaP50Q5rE/jLQ==",
-          "requires": {
-            "kind-of": "^6.0.0"
-          }
-        },
-        "is-descriptor": {
-          "version": "1.0.2",
-          "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-1.0.2.tgz",
-          "integrity": "sha512-2eis5WqQGV7peooDyLmNEPUrps9+SXX5c9pL3xEB+4e9HnGuDa7mB7kHxHw4CbqS9k1T2hOH3miL8n8WtiYVtg==",
-          "requires": {
-            "is-accessor-descriptor": "^1.0.0",
-            "is-data-descriptor": "^1.0.0",
-            "kind-of": "^6.0.2"
-          }
-        }
-      }
-    },
     "detect-file": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/detect-file/-/detect-file-1.0.0.tgz",
@@ -411,38 +206,6 @@
       "resolved": "https://registry.npmjs.org/exit/-/exit-0.1.2.tgz",
       "integrity": "sha1-BjJjj42HfMghB9MKD/8aF8uhzQw="
     },
-    "expand-brackets": {
-      "version": "2.1.4",
-      "resolved": "https://registry.npmjs.org/expand-brackets/-/expand-brackets-2.1.4.tgz",
-      "integrity": "sha1-t3c14xXOMPa27/D4OwQVGiJEliI=",
-      "requires": {
-        "debug": "^2.3.3",
-        "define-property": "^0.2.5",
-        "extend-shallow": "^2.0.1",
-        "posix-character-classes": "^0.1.0",
-        "regex-not": "^1.0.0",
-        "snapdragon": "^0.8.1",
-        "to-regex": "^3.0.1"
-      },
-      "dependencies": {
-        "define-property": {
-          "version": "0.2.5",
-          "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz",
-          "integrity": "sha1-w1se+RjsPJkPmlvFe+BKrOxcgRY=",
-          "requires": {
-            "is-descriptor": "^0.1.0"
-          }
-        },
-        "extend-shallow": {
-          "version": "2.0.1",
-          "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
-          "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=",
-          "requires": {
-            "is-extendable": "^0.1.0"
-          }
-        }
-      }
-    },
     "expand-tilde": {
       "version": "2.0.2",
       "resolved": "https://registry.npmjs.org/expand-tilde/-/expand-tilde-2.0.2.tgz",
@@ -456,103 +219,12 @@
       "resolved": "https://registry.npmjs.org/extend/-/extend-3.0.2.tgz",
       "integrity": "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g=="
     },
-    "extend-shallow": {
-      "version": "3.0.2",
-      "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-3.0.2.tgz",
-      "integrity": "sha1-Jqcarwc7OfshJxcnRhMcJwQCjbg=",
-      "requires": {
-        "assign-symbols": "^1.0.0",
-        "is-extendable": "^1.0.1"
-      },
-      "dependencies": {
-        "is-extendable": {
-          "version": "1.0.1",
-          "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-1.0.1.tgz",
-          "integrity": "sha512-arnXMxT1hhoKo9k1LZdmlNyJdDDfy2v0fXjFlmok4+i8ul/6WlbVge9bhM74OpNPQPMGUToDtz+KXa1PneJxOA==",
-          "requires": {
-            "is-plain-object": "^2.0.4"
-          }
-        }
-      }
-    },
-    "extglob": {
-      "version": "2.0.4",
-      "resolved": "https://registry.npmjs.org/extglob/-/extglob-2.0.4.tgz",
-      "integrity": "sha512-Nmb6QXkELsuBr24CJSkilo6UHHgbekK5UiZgfE6UHD3Eb27YC6oD+bhcT+tJ6cl8dmsgdQxnWlcry8ksBIBLpw==",
-      "requires": {
-        "array-unique": "^0.3.2",
-        "define-property": "^1.0.0",
-        "expand-brackets": "^2.1.4",
-        "extend-shallow": "^2.0.1",
-        "fragment-cache": "^0.2.1",
-        "regex-not": "^1.0.0",
-        "snapdragon": "^0.8.1",
-        "to-regex": "^3.0.1"
-      },
-      "dependencies": {
-        "define-property": {
-          "version": "1.0.0",
-          "resolved": "https://registry.npmjs.org/define-property/-/define-property-1.0.0.tgz",
-          "integrity": "sha1-dp66rz9KY6rTr56NMEybvnm/sOY=",
-          "requires": {
-            "is-descriptor": "^1.0.0"
-          }
-        },
-        "extend-shallow": {
-          "version": "2.0.1",
-          "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
-          "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=",
-          "requires": {
-            "is-extendable": "^0.1.0"
-          }
-        },
-        "is-accessor-descriptor": {
-          "version": "1.0.0",
-          "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-1.0.0.tgz",
-          "integrity": "sha512-m5hnHTkcVsPfqx3AKlyttIPb7J+XykHvJP2B9bZDjlhLIoEq4XoK64Vg7boZlVWYK6LUY94dYPEE7Lh0ZkZKcQ==",
-          "requires": {
-            "kind-of": "^6.0.0"
-          }
-        },
-        "is-data-descriptor": {
-          "version": "1.0.0",
-          "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-1.0.0.tgz",
-          "integrity": "sha512-jbRXy1FmtAoCjQkVmIVYwuuqDFUbaOeDjmed1tOGPrsMhtJA4rD9tkgA0F1qJ3gRFRXcHYVkdeaP50Q5rE/jLQ==",
-          "requires": {
-            "kind-of": "^6.0.0"
-          }
-        },
-        "is-descriptor": {
-          "version": "1.0.2",
-          "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-1.0.2.tgz",
-          "integrity": "sha512-2eis5WqQGV7peooDyLmNEPUrps9+SXX5c9pL3xEB+4e9HnGuDa7mB7kHxHw4CbqS9k1T2hOH3miL8n8WtiYVtg==",
-          "requires": {
-            "is-accessor-descriptor": "^1.0.0",
-            "is-data-descriptor": "^1.0.0",
-            "kind-of": "^6.0.2"
-          }
-        }
-      }
-    },
     "fill-range": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-4.0.0.tgz",
-      "integrity": "sha1-1USBHUKPmOsGpj3EAtJAPDKMOPc=",
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.0.1.tgz",
+      "integrity": "sha512-qOo9F+dMUmC2Lcb4BbVvnKJxTPjCm+RRpe4gDuGrzkL7mEVl/djYSu2OdQ2Pa302N4oqkSg9ir6jaLWJ2USVpQ==",
       "requires": {
-        "extend-shallow": "^2.0.1",
-        "is-number": "^3.0.0",
-        "repeat-string": "^1.6.1",
-        "to-regex-range": "^2.1.0"
-      },
-      "dependencies": {
-        "extend-shallow": {
-          "version": "2.0.1",
-          "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
-          "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=",
-          "requires": {
-            "is-extendable": "^0.1.0"
-          }
-        }
+        "to-regex-range": "^5.0.1"
       }
     },
     "findup-sync": {
@@ -607,23 +279,15 @@
         "for-in": "^1.0.1"
       }
     },
-    "fragment-cache": {
-      "version": "0.2.1",
-      "resolved": "https://registry.npmjs.org/fragment-cache/-/fragment-cache-0.2.1.tgz",
-      "integrity": "sha1-QpD60n8T6Jvn8zeZxrxaCr//DRk=",
-      "requires": {
-        "map-cache": "^0.2.2"
-      }
-    },
     "fs.realpath": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz",
       "integrity": "sha1-FQStJSMVjKpA20onh8sBQRmU6k8="
     },
-    "get-value": {
-      "version": "2.0.6",
-      "resolved": "https://registry.npmjs.org/get-value/-/get-value-2.0.6.tgz",
-      "integrity": "sha1-3BXKHGcjh8p2vTesCjlbogQqLCg="
+    "function-bind": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.1.tgz",
+      "integrity": "sha512-yIovAzMX49sF8Yl58fSCWJ5svSLuaibPxXQJFLmBObTuCr0Mf1KiPopGM9NiFjiYBCbfaa2Fh6breQ6ANVTI0A=="
     },
     "getobject": {
       "version": "1.0.0",
@@ -702,19 +366,19 @@
       }
     },
     "grunt": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/grunt/-/grunt-1.3.0.tgz",
-      "integrity": "sha512-6ILlMXv11/4cxuhSMfSU+SfvbxrPuqZrAtLN64+tZpQ3DAKfSQPQHRbTjSbdtxfyQhGZPtN0bDZJ/LdCM5WXXA==",
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/grunt/-/grunt-1.4.0.tgz",
+      "integrity": "sha512-yRFc0GVCDu9yxqOFzpuXQ2pEdgtLDnFv5Qz54jfIcNnpJ8Z7B7P7kPkT4VMuRvm+N+QOsI8C4v/Q0DSaoj3LgQ==",
       "requires": {
         "dateformat": "~3.0.3",
         "eventemitter2": "~0.4.13",
         "exit": "~0.1.2",
         "findup-sync": "~0.3.0",
         "glob": "~7.1.6",
-        "grunt-cli": "~1.3.2",
-        "grunt-known-options": "~1.1.0",
+        "grunt-cli": "~1.4.2",
+        "grunt-known-options": "~1.1.1",
         "grunt-legacy-log": "~3.0.0",
-        "grunt-legacy-util": "~2.0.0",
+        "grunt-legacy-util": "~2.0.1",
         "iconv-lite": "~0.4.13",
         "js-yaml": "~3.14.0",
         "minimatch": "~3.0.4",
@@ -729,21 +393,21 @@
       "integrity": "sha1-fBZB28ZlSGdqbVl5Ga35C3s11kQ="
     },
     "grunt-cli": {
-      "version": "1.3.2",
-      "resolved": "https://registry.npmjs.org/grunt-cli/-/grunt-cli-1.3.2.tgz",
-      "integrity": "sha512-8OHDiZZkcptxVXtMfDxJvmN7MVJNE8L/yIcPb4HB7TlyFD1kDvjHrb62uhySsU14wJx9ORMnTuhRMQ40lH/orQ==",
+      "version": "1.4.2",
+      "resolved": "https://registry.npmjs.org/grunt-cli/-/grunt-cli-1.4.2.tgz",
+      "integrity": "sha512-wsu6BZh7KCnfeaSkDrKIAvOlqGKxNRTZjc8xfZlvxCByQIqUfZ31kh5uHpPnhQ4NdVgvaWaVxa1LUbVU80nACw==",
       "requires": {
-        "grunt-known-options": "~1.1.0",
+        "grunt-known-options": "~1.1.1",
         "interpret": "~1.1.0",
-        "liftoff": "~2.5.0",
+        "liftup": "~3.0.1",
         "nopt": "~4.0.1",
-        "v8flags": "~3.1.1"
+        "v8flags": "~3.2.0"
       },
       "dependencies": {
         "nopt": {
-          "version": "4.0.1",
-          "resolved": "https://registry.npmjs.org/nopt/-/nopt-4.0.1.tgz",
-          "integrity": "sha1-0NRoWv1UFRk8jHUFYC0NF81kR00=",
+          "version": "4.0.3",
+          "resolved": "https://registry.npmjs.org/nopt/-/nopt-4.0.3.tgz",
+          "integrity": "sha512-CvaGwVMztSMJLOeXPrez7fyfObdZqNUK1cPAEzLHrTybIua9pMdmmPR5YwtfNftIOMv3DPUhFaxsZMNTQO20Kg==",
           "requires": {
             "abbrev": "1",
             "osenv": "^0.1.4"
@@ -843,40 +507,19 @@
         "gilded-wordpress": "1.0.5"
       }
     },
+    "has": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/has/-/has-1.0.3.tgz",
+      "integrity": "sha512-f2dvO0VU6Oej7RkWJGrehjbzMAjFp5/VKPp5tTpWIV4JHHZK1/BxbFRtf/siA2SWTe09caDmVtYYzWEIbBS4zw==",
+      "requires": {
+        "function-bind": "^1.1.1"
+      }
+    },
     "has-flag": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
       "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ=="
     },
-    "has-value": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/has-value/-/has-value-1.0.0.tgz",
-      "integrity": "sha1-GLKB2lhbHFxR3vJMkw7SmgvmsXc=",
-      "requires": {
-        "get-value": "^2.0.6",
-        "has-values": "^1.0.0",
-        "isobject": "^3.0.0"
-      }
-    },
-    "has-values": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/has-values/-/has-values-1.0.0.tgz",
-      "integrity": "sha1-lbC2P+whRmGab+V/51Yo1aOe/k8=",
-      "requires": {
-        "is-number": "^3.0.0",
-        "kind-of": "^4.0.0"
-      },
-      "dependencies": {
-        "kind-of": {
-          "version": "4.0.0",
-          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-4.0.0.tgz",
-          "integrity": "sha1-IIE989cSkosgc3hpGkUGb65y3Vc=",
-          "requires": {
-            "is-buffer": "^1.1.5"
-          }
-        }
-      }
-    },
     "he": {
       "version": "0.5.0",
       "resolved": "https://registry.npmjs.org/he/-/he-0.5.0.tgz",
@@ -951,9 +594,9 @@
       "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="
     },
     "ini": {
-      "version": "1.3.7",
-      "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.7.tgz",
-      "integrity": "sha512-iKpRpXP+CrP2jyrxvg1kMUpXDyRUFDWurxbnVT1vQPx+Wz9uCYsMIqYuSBLV+PAaZG/d7kRLKRFc9oDMsH+mFQ=="
+      "version": "1.3.8",
+      "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.8.tgz",
+      "integrity": "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew=="
     },
     "interpret": {
       "version": "1.1.0",
@@ -969,99 +612,31 @@
         "is-windows": "^1.0.1"
       }
     },
-    "is-accessor-descriptor": {
-      "version": "0.1.6",
-      "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-0.1.6.tgz",
-      "integrity": "sha1-qeEss66Nh2cn7u84Q/igiXtcmNY=",
+    "is-core-module": {
+      "version": "2.4.0",
+      "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.4.0.tgz",
+      "integrity": "sha512-6A2fkfq1rfeQZjxrZJGerpLCTHRNEBiSgnu0+obeJpEPZRUooHgsizvzv0ZjJwOz3iWIHdJtVWJ/tmPr3D21/A==",
       "requires": {
-        "kind-of": "^3.0.2"
-      },
-      "dependencies": {
-        "kind-of": {
-          "version": "3.2.2",
-          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz",
-          "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=",
-          "requires": {
-            "is-buffer": "^1.1.5"
-          }
-        }
+        "has": "^1.0.3"
       }
     },
-    "is-buffer": {
-      "version": "1.1.6",
-      "resolved": "https://registry.npmjs.org/is-buffer/-/is-buffer-1.1.6.tgz",
-      "integrity": "sha512-NcdALwpXkTm5Zvvbk7owOUSvVvBKDgKP5/ewfXEznmQFfs4ZRmanOeKBTjRVjka3QFoN6XJ+9F3USqfHqTaU5w=="
-    },
-    "is-data-descriptor": {
-      "version": "0.1.4",
-      "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-0.1.4.tgz",
-      "integrity": "sha1-C17mSDiOLIYCgueT8YVv7D8wG1Y=",
-      "requires": {
-        "kind-of": "^3.0.2"
-      },
-      "dependencies": {
-        "kind-of": {
-          "version": "3.2.2",
-          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz",
-          "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=",
-          "requires": {
-            "is-buffer": "^1.1.5"
-          }
-        }
-      }
-    },
-    "is-descriptor": {
-      "version": "0.1.6",
-      "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-0.1.6.tgz",
-      "integrity": "sha512-avDYr0SB3DwO9zsMov0gKCESFYqCnE4hq/4z3TdUlukEy5t9C0YRq7HLrsN52NAcqXKaepeCD0n+B0arnVG3Hg==",
-      "requires": {
-        "is-accessor-descriptor": "^0.1.6",
-        "is-data-descriptor": "^0.1.4",
-        "kind-of": "^5.0.0"
-      },
-      "dependencies": {
-        "kind-of": {
-          "version": "5.1.0",
-          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-5.1.0.tgz",
-          "integrity": "sha512-NGEErnH6F2vUuXDh+OlbcKW7/wOcfdRHaZ7VWtqCztfHri/++YKmP51OdWeGPuqCOba6kk2OTe5d02VmTB80Pw=="
-        }
-      }
-    },
-    "is-extendable": {
-      "version": "0.1.1",
-      "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-0.1.1.tgz",
-      "integrity": "sha1-YrEQ4omkcUGOPsNqYX1HLjAd/Ik="
-    },
     "is-extglob": {
       "version": "2.1.1",
       "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
       "integrity": "sha1-qIwCU1eR8C7TfHahueqXc8gz+MI="
     },
     "is-glob": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-3.1.0.tgz",
-      "integrity": "sha1-e6WuJCF4BKxwcHuWkiVnSGzD6Eo=",
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.1.tgz",
+      "integrity": "sha512-5G0tKtBTFImOqDnLB2hG6Bp2qcKEFduo4tZu9MT/H6NQv/ghhy30o55ufafxJ/LdH79LLs2Kfrn85TLKyA7BUg==",
       "requires": {
-        "is-extglob": "^2.1.0"
+        "is-extglob": "^2.1.1"
       }
     },
     "is-number": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/is-number/-/is-number-3.0.0.tgz",
-      "integrity": "sha1-JP1iAaR4LPUFYcgQJ2r8fRLXEZU=",
-      "requires": {
-        "kind-of": "^3.0.2"
-      },
-      "dependencies": {
-        "kind-of": {
-          "version": "3.2.2",
-          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz",
-          "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=",
-          "requires": {
-            "is-buffer": "^1.1.5"
-          }
-        }
-      }
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz",
+      "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng=="
     },
     "is-plain-object": {
       "version": "2.0.4",
@@ -1093,9 +668,9 @@
       "integrity": "sha512-eXK1UInq2bPmjyX6e3VHIzMLobc4J94i4AWn+Hpq3OU5KkrRC96OAcR3PRJ/pGu6m8TRnBHP9dkXQVsT/COVIA=="
     },
     "isarray": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz",
-      "integrity": "sha1-u5NdSFgsuhaMBoNJV6VKPgcSTxE="
+      "version": "0.0.1",
+      "resolved": "https://registry.npmjs.org/isarray/-/isarray-0.0.1.tgz",
+      "integrity": "sha1-ihis/Kmo9Bd+Cav8YDiTmwXR7t8="
     },
     "isexe": {
       "version": "2.0.0",
@@ -1117,33 +692,33 @@
       }
     },
     "kind-of": {
-      "version": "6.0.2",
-      "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.2.tgz",
-      "integrity": "sha512-s5kLOcnH0XqDO+FvuaLX8DDjZ18CGFk7VygH40QoKPUQhW4e2rvM0rwUq0t8IQDOwYSeLK01U90OjzBTme2QqA=="
-    },
-    "liftoff": {
-      "version": "2.5.0",
-      "resolved": "https://registry.npmjs.org/liftoff/-/liftoff-2.5.0.tgz",
-      "integrity": "sha1-IAkpG7Mc6oYbvxCnwVooyvdcMew=",
+      "version": "6.0.3",
+      "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.3.tgz",
+      "integrity": "sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw=="
+    },
+    "liftup": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/liftup/-/liftup-3.0.1.tgz",
+      "integrity": "sha512-yRHaiQDizWSzoXk3APcA71eOI/UuhEkNN9DiW2Tt44mhYzX4joFoCZlxsSOF7RyeLlfqzFLQI1ngFq3ggMPhOw==",
       "requires": {
-        "extend": "^3.0.0",
-        "findup-sync": "^2.0.0",
-        "fined": "^1.0.1",
-        "flagged-respawn": "^1.0.0",
+        "extend": "^3.0.2",
+        "findup-sync": "^4.0.0",
+        "fined": "^1.2.0",
+        "flagged-respawn": "^1.0.1",
         "is-plain-object": "^2.0.4",
-        "object.map": "^1.0.0",
-        "rechoir": "^0.6.2",
-        "resolve": "^1.1.7"
+        "object.map": "^1.0.1",
+        "rechoir": "^0.7.0",
+        "resolve": "^1.19.0"
       },
       "dependencies": {
         "findup-sync": {
-          "version": "2.0.0",
-          "resolved": "https://registry.npmjs.org/findup-sync/-/findup-sync-2.0.0.tgz",
-          "integrity": "sha1-kyaxSIwi0aYIhlCoaQGy2akKLLw=",
+          "version": "4.0.0",
+          "resolved": "https://registry.npmjs.org/findup-sync/-/findup-sync-4.0.0.tgz",
+          "integrity": "sha512-6jvvn/12IC4quLBL1KNokxC7wWTvYncaVUYSoxWw7YykPLuRrnv4qdHcSOywOI5RpkOVGeQRtWM8/q+G6W6qfQ==",
           "requires": {
             "detect-file": "^1.0.0",
-            "is-glob": "^3.1.0",
-            "micromatch": "^3.0.4",
+            "is-glob": "^4.0.0",
+            "micromatch": "^4.0.2",
             "resolve-dir": "^1.0.1"
           }
         }
@@ -1167,37 +742,18 @@
       "resolved": "https://registry.npmjs.org/map-cache/-/map-cache-0.2.2.tgz",
       "integrity": "sha1-wyq9C9ZSXZsFFkW7TyasXcmKDb8="
     },
-    "map-visit": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/map-visit/-/map-visit-1.0.0.tgz",
-      "integrity": "sha1-7Nyo8TFE5mDxtb1B8S80edmN+48=",
-      "requires": {
-        "object-visit": "^1.0.0"
-      }
-    },
     "marked": {
       "version": "0.3.2",
       "resolved": "https://registry.npmjs.org/marked/-/marked-0.3.2.tgz",
       "integrity": "sha1-AV2xWIZEOPJKZL3WGgQotBhwbQk="
     },
     "micromatch": {
-      "version": "3.1.10",
-      "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-3.1.10.tgz",
-      "integrity": "sha512-MWikgl9n9M3w+bpsY3He8L+w9eF9338xRl8IAO5viDizwSzziFEyUzo2xrrloB64ADbTf8uA8vRqqttDTOmccg==",
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.4.tgz",
+      "integrity": "sha512-pRmzw/XUcwXGpD9aI9q/0XOwLNygjETJ8y0ao0wdqprrzDa4YnxLcz7fQRZr8voh8V10kGhABbNcHVk5wHgWwg==",
       "requires": {
-        "arr-diff": "^4.0.0",
-        "array-unique": "^0.3.2",
-        "braces": "^2.3.1",
-        "define-property": "^2.0.2",
-        "extend-shallow": "^3.0.2",
-        "extglob": "^2.0.4",
-        "fragment-cache": "^0.2.1",
-        "kind-of": "^6.0.2",
-        "nanomatch": "^1.2.9",
-        "object.pick": "^1.3.0",
-        "regex-not": "^1.0.0",
-        "snapdragon": "^0.8.1",
-        "to-regex": "^3.0.2"
+        "braces": "^3.0.1",
+        "picomatch": "^2.2.3"
       }
     },
     "minimatch": {
@@ -1208,53 +764,11 @@
         "brace-expansion": "^1.1.7"
       }
     },
-    "mixin-deep": {
-      "version": "1.3.2",
-      "resolved": "https://registry.npmjs.org/mixin-deep/-/mixin-deep-1.3.2.tgz",
-      "integrity": "sha512-WRoDn//mXBiJ1H40rqa3vH0toePwSsGb45iInWlTySa+Uu4k3tYUSxa2v1KqAiLtvlrSzaExqS1gtk96A9zvEA==",
-      "requires": {
-        "for-in": "^1.0.2",
-        "is-extendable": "^1.0.1"
-      },
-      "dependencies": {
-        "is-extendable": {
-          "version": "1.0.1",
-          "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-1.0.1.tgz",
-          "integrity": "sha512-arnXMxT1hhoKo9k1LZdmlNyJdDDfy2v0fXjFlmok4+i8ul/6WlbVge9bhM74OpNPQPMGUToDtz+KXa1PneJxOA==",
-          "requires": {
-            "is-plain-object": "^2.0.4"
-          }
-        }
-      }
-    },
     "mkdirp": {
       "version": "1.0.4",
       "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-1.0.4.tgz",
       "integrity": "sha512-vVqVZQyf3WLx2Shd0qJ9xuvqgAyKPLAiqITEtqW0oIUjzo3PePDd6fW9iFz30ef7Ysp/oiWqbhszeGWW2T6Gzw=="
     },
-    "ms": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
-      "integrity": "sha1-VgiurfwAvmwpAd9fmGF4jeDVl8g="
-    },
-    "nanomatch": {
-      "version": "1.2.13",
-      "resolved": "https://registry.npmjs.org/nanomatch/-/nanomatch-1.2.13.tgz",
-      "integrity": "sha512-fpoe2T0RbHwBTBUOftAfBPaDEi06ufaUai0mE6Yn1kacc3SnTErfb/h+X94VXzI64rKFHYImXSvdwGGCmwOqCA==",
-      "requires": {
-        "arr-diff": "^4.0.0",
-        "array-unique": "^0.3.2",
-        "define-property": "^2.0.2",
-        "extend-shallow": "^3.0.2",
-        "fragment-cache": "^0.2.1",
-        "is-windows": "^1.0.2",
-        "kind-of": "^6.0.2",
-        "object.pick": "^1.3.0",
-        "regex-not": "^1.0.0",
-        "snapdragon": "^0.8.1",
-        "to-regex": "^3.0.1"
-      }
-    },
     "nopt": {
       "version": "3.0.6",
       "resolved": "https://registry.npmjs.org/nopt/-/nopt-3.0.6.tgz",
@@ -1263,42 +777,6 @@
         "abbrev": "1"
       }
     },
-    "object-copy": {
-      "version": "0.1.0",
-      "resolved": "https://registry.npmjs.org/object-copy/-/object-copy-0.1.0.tgz",
-      "integrity": "sha1-fn2Fi3gb18mRpBupde04EnVOmYw=",
-      "requires": {
-        "copy-descriptor": "^0.1.0",
-        "define-property": "^0.2.5",
-        "kind-of": "^3.0.3"
-      },
-      "dependencies": {
-        "define-property": {
-          "version": "0.2.5",
-          "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz",
-          "integrity": "sha1-w1se+RjsPJkPmlvFe+BKrOxcgRY=",
-          "requires": {
-            "is-descriptor": "^0.1.0"
-          }
-        },
-        "kind-of": {
-          "version": "3.2.2",
-          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz",
-          "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=",
-          "requires": {
-            "is-buffer": "^1.1.5"
-          }
-        }
-      }
-    },
-    "object-visit": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/object-visit/-/object-visit-1.0.1.tgz",
-      "integrity": "sha1-95xEk68MU3e1n+OdOV5BBC3QRbs=",
-      "requires": {
-        "isobject": "^3.0.0"
-      }
-    },
     "object.defaults": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/object.defaults/-/object.defaults-1.1.0.tgz",
@@ -1369,11 +847,6 @@
       "resolved": "https://registry.npmjs.org/parse-passwd/-/parse-passwd-1.0.0.tgz",
       "integrity": "sha1-bVuTSkVpk7I9N/QKOC1vFmao5cY="
     },
-    "pascalcase": {
-      "version": "0.1.1",
-      "resolved": "https://registry.npmjs.org/pascalcase/-/pascalcase-0.1.1.tgz",
-      "integrity": "sha1-s2PlXoAGym/iF4TS2yK9FdeRfxQ="
-    },
     "path-is-absolute": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz",
@@ -1397,10 +870,10 @@
       "resolved": "https://registry.npmjs.org/path-root-regex/-/path-root-regex-0.1.2.tgz",
       "integrity": "sha1-v8zcjfWxLcUsi0PsONGNcsBLqW0="
     },
-    "posix-character-classes": {
-      "version": "0.1.1",
-      "resolved": "https://registry.npmjs.org/posix-character-classes/-/posix-character-classes-0.1.1.tgz",
-      "integrity": "sha1-AerA/jta9xoqbAL+q7jB/vfgDqs="
+    "picomatch": {
+      "version": "2.2.3",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.2.3.tgz",
+      "integrity": "sha512-KpELjfwcCDUb9PeigTs2mBJzXUPzAuP2oPcA989He8Rte0+YUAjw1JVedDhuTKPkHjSYzMN3npC9luThGYEKdg=="
     },
     "readable-stream": {
       "version": "1.1.14",
@@ -1411,47 +884,22 @@
         "inherits": "~2.0.1",
         "isarray": "0.0.1",
         "string_decoder": "~0.10.x"
-      },
-      "dependencies": {
-        "isarray": {
-          "version": "0.0.1",
-          "resolved": "https://registry.npmjs.org/isarray/-/isarray-0.0.1.tgz",
-          "integrity": "sha1-ihis/Kmo9Bd+Cav8YDiTmwXR7t8="
-        }
       }
     },
     "rechoir": {
-      "version": "0.6.2",
-      "resolved": "https://registry.npmjs.org/rechoir/-/rechoir-0.6.2.tgz",
-      "integrity": "sha1-hSBLVNuoLVdC4oyWdW70OvUOM4Q=",
+      "version": "0.7.0",
+      "resolved": "https://registry.npmjs.org/rechoir/-/rechoir-0.7.0.tgz",
+      "integrity": "sha512-ADsDEH2bvbjltXEP+hTIAmeFekTFK0V2BTxMkok6qILyAJEXV0AFfoWcAq4yfll5VdIMd/RVXq0lR+wQi5ZU3Q==",
       "requires": {
-        "resolve": "^1.1.6"
+        "resolve": "^1.9.0"
       }
     },
-    "regex-not": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/regex-not/-/regex-not-1.0.2.tgz",
-      "integrity": "sha512-J6SDjUgDxQj5NusnOtdFxDwN/+HWykR8GELwctJ7mdqhcyy1xEc4SRFHUXvxTp661YaVKAjfRLZ9cCqS6tn32A==",
-      "requires": {
-        "extend-shallow": "^3.0.2",
-        "safe-regex": "^1.1.0"
-      }
-    },
-    "repeat-element": {
-      "version": "1.1.3",
-      "resolved": "https://registry.npmjs.org/repeat-element/-/repeat-element-1.1.3.tgz",
-      "integrity": "sha512-ahGq0ZnV5m5XtZLMb+vP76kcAM5nkLqk0lpqAuojSKGgQtn4eRi4ZZGm2olo2zKFH+sMsWaqOCW1dqAnOru72g=="
-    },
-    "repeat-string": {
-      "version": "1.6.1",
-      "resolved": "https://registry.npmjs.org/repeat-string/-/repeat-string-1.6.1.tgz",
-      "integrity": "sha1-jcrkcOHIirwtYA//Sndihtp15jc="
-    },
     "resolve": {
-      "version": "1.12.0",
-      "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.12.0.tgz",
-      "integrity": "sha512-B/dOmuoAik5bKcD6s6nXDCjzUKnaDvdkRyAk6rsmsKLipWj4797iothd7jmmUhWTfinVMU+wc56rYKsit2Qy4w==",
+      "version": "1.20.0",
+      "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.20.0.tgz",
+      "integrity": "sha512-wENBPt4ySzg4ybFQW2TT1zMQucPK95HSh/nq2CFTZVOGut2+pQvSsgtda4d26YrYcr067wjbmzOG8byDPBX63A==",
       "requires": {
+        "is-core-module": "^2.2.0",
         "path-parse": "^1.0.6"
       }
     },
@@ -1464,16 +912,6 @@
         "global-modules": "^1.0.0"
       }
     },
-    "resolve-url": {
-      "version": "0.2.1",
-      "resolved": "https://registry.npmjs.org/resolve-url/-/resolve-url-0.2.1.tgz",
-      "integrity": "sha1-LGN/53yJOv0qZj/iGqkIAGjiBSo="
-    },
-    "ret": {
-      "version": "0.1.15",
-      "resolved": "https://registry.npmjs.org/ret/-/ret-0.1.15.tgz",
-      "integrity": "sha512-TTlYpa+OL+vMMNG24xSlQGEJ3B/RzEfUlLct7b5G/ytav+wPrplCpVMFuwzXbkecJrb6IYo1iFb0S9v37754mg=="
-    },
     "rimraf": {
       "version": "3.0.2",
       "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-3.0.2.tgz",
@@ -1482,14 +920,6 @@
         "glob": "^7.1.3"
       }
     },
-    "safe-regex": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/safe-regex/-/safe-regex-1.1.0.tgz",
-      "integrity": "sha1-QKNmnzsHfR6UPURinhV91IAjvy4=",
-      "requires": {
-        "ret": "~0.1.10"
-      }
-    },
     "safer-buffer": {
       "version": "2.1.2",
       "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
@@ -1500,183 +930,16 @@
       "resolved": "https://registry.npmjs.org/sax/-/sax-1.2.4.tgz",
       "integrity": "sha512-NqVDv9TpANUjFm0N8uM5GxL36UgKi9/atZw+x7YFnQ8ckwFGKrl4xX4yWtrey3UJm5nP1kUbnYgLopqWNSRhWw=="
     },
-    "set-value": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/set-value/-/set-value-2.0.1.tgz",
-      "integrity": "sha512-JxHc1weCN68wRY0fhCoXpyK55m/XPHafOmK4UWD7m2CI14GMcFypt4w/0+NV5f/ZMby2F6S2wwA7fgynh9gWSw==",
-      "requires": {
-        "extend-shallow": "^2.0.1",
-        "is-extendable": "^0.1.1",
-        "is-plain-object": "^2.0.3",
-        "split-string": "^3.0.1"
-      },
-      "dependencies": {
-        "extend-shallow": {
-          "version": "2.0.1",
-          "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
-          "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=",
-          "requires": {
-            "is-extendable": "^0.1.0"
-          }
-        }
-      }
-    },
-    "snapdragon": {
-      "version": "0.8.2",
-      "resolved": "https://registry.npmjs.org/snapdragon/-/snapdragon-0.8.2.tgz",
-      "integrity": "sha512-FtyOnWN/wCHTVXOMwvSv26d+ko5vWlIDD6zoUJ7LW8vh+ZBC8QdljveRP+crNrtBwioEUWy/4dMtbBjA4ioNlg==",
-      "requires": {
-        "base": "^0.11.1",
-        "debug": "^2.2.0",
-        "define-property": "^0.2.5",
-        "extend-shallow": "^2.0.1",
-        "map-cache": "^0.2.2",
-        "source-map": "^0.5.6",
-        "source-map-resolve": "^0.5.0",
-        "use": "^3.1.0"
-      },
-      "dependencies": {
-        "define-property": {
-          "version": "0.2.5",
-          "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz",
-          "integrity": "sha1-w1se+RjsPJkPmlvFe+BKrOxcgRY=",
-          "requires": {
-            "is-descriptor": "^0.1.0"
-          }
-        },
-        "extend-shallow": {
-          "version": "2.0.1",
-          "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
-          "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=",
-          "requires": {
-            "is-extendable": "^0.1.0"
-          }
-        }
-      }
-    },
-    "snapdragon-node": {
-      "version": "2.1.1",
-      "resolved": "https://registry.npmjs.org/snapdragon-node/-/snapdragon-node-2.1.1.tgz",
-      "integrity": "sha512-O27l4xaMYt/RSQ5TR3vpWCAB5Kb/czIcqUFOM/C4fYcLnbZUc1PkjTAMjof2pBWaSTwOUd6qUHcFGVGj7aIwnw==",
-      "requires": {
-        "define-property": "^1.0.0",
-        "isobject": "^3.0.0",
-        "snapdragon-util": "^3.0.1"
-      },
-      "dependencies": {
-        "define-property": {
-          "version": "1.0.0",
-          "resolved": "https://registry.npmjs.org/define-property/-/define-property-1.0.0.tgz",
-          "integrity": "sha1-dp66rz9KY6rTr56NMEybvnm/sOY=",
-          "requires": {
-            "is-descriptor": "^1.0.0"
-          }
-        },
-        "is-accessor-descriptor": {
-          "version": "1.0.0",
-          "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-1.0.0.tgz",
-          "integrity": "sha512-m5hnHTkcVsPfqx3AKlyttIPb7J+XykHvJP2B9bZDjlhLIoEq4XoK64Vg7boZlVWYK6LUY94dYPEE7Lh0ZkZKcQ==",
-          "requires": {
-            "kind-of": "^6.0.0"
-          }
-        },
-        "is-data-descriptor": {
-          "version": "1.0.0",
-          "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-1.0.0.tgz",
-          "integrity": "sha512-jbRXy1FmtAoCjQkVmIVYwuuqDFUbaOeDjmed1tOGPrsMhtJA4rD9tkgA0F1qJ3gRFRXcHYVkdeaP50Q5rE/jLQ==",
-          "requires": {
-            "kind-of": "^6.0.0"
-          }
-        },
-        "is-descriptor": {
-          "version": "1.0.2",
-          "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-1.0.2.tgz",
-          "integrity": "sha512-2eis5WqQGV7peooDyLmNEPUrps9+SXX5c9pL3xEB+4e9HnGuDa7mB7kHxHw4CbqS9k1T2hOH3miL8n8WtiYVtg==",
-          "requires": {
-            "is-accessor-descriptor": "^1.0.0",
-            "is-data-descriptor": "^1.0.0",
-            "kind-of": "^6.0.2"
-          }
-        }
-      }
-    },
-    "snapdragon-util": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/snapdragon-util/-/snapdragon-util-3.0.1.tgz",
-      "integrity": "sha512-mbKkMdQKsjX4BAL4bRYTj21edOf8cN7XHdYUJEe+Zn99hVEYcMvKPct1IqNe7+AZPirn8BCDOQBHQZknqmKlZQ==",
-      "requires": {
-        "kind-of": "^3.2.0"
-      },
-      "dependencies": {
-        "kind-of": {
-          "version": "3.2.2",
-          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz",
-          "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=",
-          "requires": {
-            "is-buffer": "^1.1.5"
-          }
-        }
-      }
-    },
-    "source-map": {
-      "version": "0.5.7",
-      "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.5.7.tgz",
-      "integrity": "sha1-igOdLRAh0i0eoUyA2OpGi6LvP8w="
-    },
-    "source-map-resolve": {
-      "version": "0.5.2",
-      "resolved": "https://registry.npmjs.org/source-map-resolve/-/source-map-resolve-0.5.2.tgz",
-      "integrity": "sha512-MjqsvNwyz1s0k81Goz/9vRBe9SZdB09Bdw+/zYyO+3CuPk6fouTaxscHkgtE8jKvf01kVfl8riHzERQ/kefaSA==",
-      "requires": {
-        "atob": "^2.1.1",
-        "decode-uri-component": "^0.2.0",
-        "resolve-url": "^0.2.1",
-        "source-map-url": "^0.4.0",
-        "urix": "^0.1.0"
-      }
-    },
-    "source-map-url": {
-      "version": "0.4.0",
-      "resolved": "https://registry.npmjs.org/source-map-url/-/source-map-url-0.4.0.tgz",
-      "integrity": "sha1-PpNdfd1zYxuXZZlW1VEo6HtQhKM="
-    },
     "spawnback": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/spawnback/-/spawnback-1.0.0.tgz",
       "integrity": "sha1-9zZi9+VNlTZ+ynTWQmxnfdfqaG8="
     },
-    "split-string": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/split-string/-/split-string-3.1.0.tgz",
-      "integrity": "sha512-NzNVhJDYpwceVVii8/Hu6DKfD2G+NrQHlS/V/qgv763EYudVwEcMQNxd2lh+0VrUByXN/oJkl5grOhYWvQUYiw==",
-      "requires": {
-        "extend-shallow": "^3.0.0"
-      }
-    },
     "sprintf-js": {
       "version": "1.1.2",
       "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.1.2.tgz",
       "integrity": "sha512-VE0SOVEHCk7Qc8ulkWw3ntAzXuqf7S2lvwQaDLRnUeIEaKNQJzV6BwmLKhOqT61aGhfUMrXeaBk+oDGCzvhcug=="
     },
-    "static-extend": {
-      "version": "0.1.2",
-      "resolved": "https://registry.npmjs.org/static-extend/-/static-extend-0.1.2.tgz",
-      "integrity": "sha1-YICcOcv/VTNyJv1eC1IPNB8ftcY=",
-      "requires": {
-        "define-property": "^0.2.5",
-        "object-copy": "^0.1.0"
-      },
-      "dependencies": {
-        "define-property": {
-          "version": "0.2.5",
-          "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz",
-          "integrity": "sha1-w1se+RjsPJkPmlvFe+BKrOxcgRY=",
-          "requires": {
-            "is-descriptor": "^0.1.0"
-          }
-        }
-      }
-    },
     "string_decoder": {
       "version": "0.10.31",
       "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz",
@@ -1690,42 +953,12 @@
         "has-flag": "^4.0.0"
       }
     },
-    "to-object-path": {
-      "version": "0.3.0",
-      "resolved": "https://registry.npmjs.org/to-object-path/-/to-object-path-0.3.0.tgz",
-      "integrity": "sha1-KXWIt7Dn4KwI4E5nL4XB9JmeF68=",
-      "requires": {
-        "kind-of": "^3.0.2"
-      },
-      "dependencies": {
-        "kind-of": {
-          "version": "3.2.2",
-          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz",
-          "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=",
-          "requires": {
-            "is-buffer": "^1.1.5"
-          }
-        }
-      }
-    },
-    "to-regex": {
-      "version": "3.0.2",
-      "resolved": "https://registry.npmjs.org/to-regex/-/to-regex-3.0.2.tgz",
-      "integrity": "sha512-FWtleNAtZ/Ki2qtqej2CXTOayOH9bHDQF+Q48VpWyDXjbYxA4Yz8iDB31zXOBUlOHHKidDbqGVrTUvQMPmBGBw==",
-      "requires": {
-        "define-property": "^2.0.2",
-        "extend-shallow": "^3.0.2",
-        "regex-not": "^1.0.2",
-        "safe-regex": "^1.1.0"
-      }
-    },
     "to-regex-range": {
-      "version": "2.1.1",
-      "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-2.1.1.tgz",
-      "integrity": "sha1-fIDBe53+vlmeJzZ+DU3VWQFB2zg=",
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
+      "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==",
       "requires": {
-        "is-number": "^3.0.0",
-        "repeat-string": "^1.6.1"
+        "is-number": "^7.0.0"
       }
     },
     "unc-path-regex": {
@@ -1742,72 +975,15 @@
         "util-deprecate": "^1.0.2"
       }
     },
-    "union-value": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/union-value/-/union-value-1.0.1.tgz",
-      "integrity": "sha512-tJfXmxMeWYnczCVs7XAEvIV7ieppALdyepWMkHkwciRpZraG/xwT+s2JN8+pr1+8jCRf80FFzvr+MpQeeoF4Xg==",
-      "requires": {
-        "arr-union": "^3.1.0",
-        "get-value": "^2.0.6",
-        "is-extendable": "^0.1.1",
-        "set-value": "^2.0.1"
-      }
-    },
-    "unset-value": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/unset-value/-/unset-value-1.0.0.tgz",
-      "integrity": "sha1-g3aHP30jNRef+x5vw6jtDfyKtVk=",
-      "requires": {
-        "has-value": "^0.3.1",
-        "isobject": "^3.0.0"
-      },
-      "dependencies": {
-        "has-value": {
-          "version": "0.3.1",
-          "resolved": "https://registry.npmjs.org/has-value/-/has-value-0.3.1.tgz",
-          "integrity": "sha1-ex9YutpiyoJ+wKIHgCVlSEWZXh8=",
-          "requires": {
-            "get-value": "^2.0.3",
-            "has-values": "^0.1.4",
-            "isobject": "^2.0.0"
-          },
-          "dependencies": {
-            "isobject": {
-              "version": "2.1.0",
-              "resolved": "https://registry.npmjs.org/isobject/-/isobject-2.1.0.tgz",
-              "integrity": "sha1-8GVWEJaj8dou9GJy+BXIQNh+DIk=",
-              "requires": {
-                "isarray": "1.0.0"
-              }
-            }
-          }
-        },
-        "has-values": {
-          "version": "0.1.4",
-          "resolved": "https://registry.npmjs.org/has-values/-/has-values-0.1.4.tgz",
-          "integrity": "sha1-bWHeldkd/Km5oCCJrThL/49it3E="
-        }
-      }
-    },
-    "urix": {
-      "version": "0.1.0",
-      "resolved": "https://registry.npmjs.org/urix/-/urix-0.1.0.tgz",
-      "integrity": "sha1-2pN/emLiH+wf0Y1Js1wpNQZ6bHI="
-    },
-    "use": {
-      "version": "3.1.1",
-      "resolved": "https://registry.npmjs.org/use/-/use-3.1.1.tgz",
-      "integrity": "sha512-cwESVXlO3url9YWlFW/TA9cshCEhtu7IKJ/p5soJ/gGpj7vbvFrAY/eIioQ6Dw23KjZhYgiIo8HOs1nQ2vr/oQ=="
-    },
     "util-deprecate": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
       "integrity": "sha1-RQ1Nyfpw3nMnYvvS1KKJgUGaDM8="
     },
     "v8flags": {
-      "version": "3.1.3",
-      "resolved": "https://registry.npmjs.org/v8flags/-/v8flags-3.1.3.tgz",
-      "integrity": "sha512-amh9CCg3ZxkzQ48Mhcb8iX7xpAfYJgePHxWMQCBWECpOSqJUXgY26ncA61UTV0BkPqfhcy6mzwCIoP4ygxpW8w==",
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/v8flags/-/v8flags-3.2.0.tgz",
+      "integrity": "sha512-mH8etigqMfiGWdeXpaaqGfs6BndypxusHHcv2qSHyZkGEznCd/qAXCWWRzeowtL54147cktFOC4P5y+kl8d8Jg==",
       "requires": {
         "homedir-polyfill": "^1.0.1"
       }
diff --git a/package.json b/package.json
index d7d80011..36813e14 100644
--- a/package.json
+++ b/package.json
@@ -24,8 +24,8 @@
     "test": "grunt lint"
   },
   "dependencies": {
-    "grunt": "1.3.0",
-    "grunt-cli": "1.3.2",
+    "grunt": "1.4.0",
+    "grunt-cli": "1.4.2",
     "grunt-jquery-content": "3.0.3"
   }
 }

From 912b852f0ee81455b0bbe7fc3dc6355200990c90 Mon Sep 17 00:00:00 2001
From: Timmy Willison <4timmywil@gmail.com>
Date: Thu, 13 May 2021 15:46:15 -0400
Subject: [PATCH 598/699] removeProp: clarify recommendations regarding native
 properties

Ref https://github.com/jquery/jquery/issues/4887
Close gh-1189
---
 entries/removeProp.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/removeProp.xml b/entries/removeProp.xml
index 987ab339..cc918d29 100644
--- a/entries/removeProp.xml
+++ b/entries/removeProp.xml
@@ -10,8 +10,8 @@
   Remove a property for the set of matched elements.
   
     
            The .removeProp() method removes properties set by the .prop() method.
            
-    
            With some built-in properties of a DOM element or window object, browsers may generate an error if an attempt is made to remove the property. jQuery first assigns the value undefined to the property and ignores any error the browser generates. In general, it is only necessary to remove custom properties that have been set on an object, and not built-in (native) properties.
            
-    
            Note: Do not use this method to remove native properties such as checked, disabled, or selected. This will remove the property completely and, once removed, cannot be added again to element. Use .prop() to set these properties to false instead.
            
+    
            Note:This method should not be used to remove built-in (native) properties such as "checked", "disabled", "selected", or others. This can lead to unexpected behavior.
            
+    
            It's almost always better to use .prop() to set native properties to false instead of removing them.
            
               
   
   

From 17cdeda09f351226be6a8f75893ac59ff2354e01 Mon Sep 17 00:00:00 2001
From: Timmy Willison <4timmywil@gmail.com>
Date: Fri, 14 May 2021 11:23:35 -0400
Subject: [PATCH 599/699] prop: change wording about removeProp

Ref gh-1189
---
 entries/prop.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/prop.xml b/entries/prop.xml
index 49ccceda..775b8062 100644
--- a/entries/prop.xml
+++ b/entries/prop.xml
@@ -144,7 +144,7 @@ $( "input" ).prop( "disabled", false );
 $( "input" ).prop( "checked", true );
 $( "input" ).val( "someValue" );
       
            
-      
            Important: the .removeProp() method should not be used to set these properties to false. Once a native property is removed, it cannot be added again. See .removeProp() for more information.
            
+      
            Important: the .removeProp() method should not be used to remove native properties. This will lead to unexpected behavior. See .removeProp() for more information.
            
       
            Computed property values
            
       
            By using a function to set properties, you can compute the value based on other properties of the element. For example, to toggle all checkboxes based off their individual values:
            
       
            

From 2eec5a9cbfcdc0950f589aa54f8ea63001c640ca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Mon, 17 May 2021 18:33:01 +0200
Subject: [PATCH 600/699] CSS: Make it clear !important is not guaranteed to
 not work with `.css()`

Closes gh-1188
---
 entries/css.xml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/entries/css.xml b/entries/css.xml
index 0fd97457..896cd4ca 100644
--- a/entries/css.xml
+++ b/entries/css.xml
@@ -19,7 +19,7 @@
     
       
            The .css() method is a convenient way to get a computed style property from the first matched element, especially in light of the different ways browsers access most of those properties (the getComputedStyle() method in standards-based browsers versus the currentStyle and runtimeStyle properties in Internet Explorer prior to version 9) and the different terms browsers use for certain properties. For example, Internet Explorer's DOM implementation refers to the float property as styleFloat, while W3C standards-compliant browsers refer to it as cssFloat. For consistency, you can simply use "float", and jQuery will translate it to the correct value for each browser.
            
       
            Also, jQuery can equally interpret the CSS and DOM formatting of multiple-word properties. For example, jQuery understands and returns the correct value for both .css( "background-color" ) and .css( "backgroundColor" ). This means mixed case has a special meaning, .css( "WiDtH" ) won't do the same as .css( "width" ), for example.
            
-	  
            Note that the computed style of an element may not be the same as the value specified for that element in a style sheet. For example, computed styles of dimensions are almost always pixels, but they can be specified as em, ex, px or % in a style sheet. Different browsers may return CSS color values that are logically but not textually equal, e.g., #FFF, #ffffff, and rgb(255,255,255).
            
+      
            Note that the computed style of an element may not be the same as the value specified for that element in a style sheet. For example, computed styles of dimensions are almost always pixels, but they can be specified as em, ex, px or % in a style sheet. Different browsers may return CSS color values that are logically but not textually equal, e.g., #FFF, #ffffff, and rgb(255,255,255).
            
       
            Retrieval of shorthand CSS properties (e.g., margin, background, border), although functional with some browsers, is not guaranteed. For example, if you want to retrieve the rendered border-width, use: $( elem ).css( "borderTopWidth" ), $( elem ).css( "borderBottomWidth" ), and so on.
            
       
            An element should be connected to the DOM when calling .css() on it. If it isn't, jQuery may throw an error.
            
       
            As of jQuery 1.9, passing an array of style properties to .css() will result in an object of property-value pairs. For example, to retrieve all four rendered border-width values, you could use $( elem ).css([ "borderTopWidth", "borderRightWidth", "borderBottomWidth", "borderLeftWidth" ]). 
            
@@ -130,7 +130,7 @@ $( "div" ).click(function() {
         A function returning the value to set. this is the current element. Receives the index position of the element in the set and the old value as arguments.
         
         
-          
+        
           
           
         
@@ -148,7 +148,7 @@ $( "div" ).click(function() {
       
            Also, jQuery can equally interpret the CSS and DOM formatting of multiple-word properties. For example, jQuery understands and returns the correct value for both .css({ "background-color": "#ffe", "border-left": "5px solid #ccc" }) and .css({backgroundColor: "#ffe", borderLeft: "5px solid #ccc" }). Notice that with the DOM notation, quotation marks around the property names are optional, but with CSS notation they're required due to the hyphen in the name.
            
       
            When a number is passed as the value, jQuery will convert it to a string and add px to the end of that string. If the property requires units other than px, convert the value to a string and add the appropriate units before calling the method.
            
       
            When using .css() as a setter, jQuery modifies the element's style property. For example,  $( "#mydiv" ).css( "color", "green" ) is equivalent to document.getElementById( "mydiv" ).style.color = "green". Setting the value of a style property to an empty string — e.g. $( "#mydiv" ).css( "color", "" ) — removes that property from an element if it has already been directly applied, whether in the HTML style attribute, through jQuery's .css() method, or through direct DOM manipulation of the style property. As a consequence, the element's style for that property will be restored to whatever value was applied. So, this method can be used to cancel any style modification you have previously performed. It does not, however, remove a style that has been applied with a CSS rule in a stylesheet or <style> element. Warning: one notable exception is that, for IE 8 and below, removing a shorthand property such as border or background will remove that style entirely from the element, regardless of what is set in a stylesheet or <style> element.
            
-      
            Note: .css() ignores !important declarations. So, the statement $( "p" ).css( "color", "red !important" ) does not turn the color of all paragraphs in the page to red. It's strongly advised to use classes instead; otherwise use a jQuery plugin.
            
+      
            Note: .css() doesn't support !important declarations. So, the statement $( "p" ).css( "color", "red !important" ) does not turn the color of all paragraphs in the page to red as of jQuery 3.6.0. Do not depend on that not working, though, as a future version of jQuery may add support for such declarations. It's strongly advised to use classes instead; otherwise use a jQuery plugin.
            
       
            As of jQuery 1.8, the .css() setter will automatically take care of prefixing the property name. For example, take .css( "user-select", "none" ) in Chrome/Safari will set it as -webkit-user-select, Firefox will use -moz-user-select, and IE10 will use -ms-user-select.
            
       
            As of jQuery 1.6, .css() accepts relative values similar to .animate(). Relative values are a string starting with += or -= to increment or decrement the current value. For example, if an element's padding-left was 10px, .css( "padding-left", "+=15" ) would result in a total padding-left of 25px.
            
       
            As of jQuery 1.4, .css() allows us to pass a function as the property value:
            

From ab8a2d3c0de868a30e1828247520e4f6e0361dda Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Thu, 20 May 2021 18:06:11 +0200
Subject: [PATCH 601/699] removeClass: Separate the signature with no
 parameters

signatures until one read the description.

Closes gh-1187
---
 entries/removeClass.xml | 369 +++++++++++++++++++++-------------------
 1 file changed, 194 insertions(+), 175 deletions(-)

diff --git a/entries/removeClass.xml b/entries/removeClass.xml
index c2daa31c..2edb382d 100644
--- a/entries/removeClass.xml
+++ b/entries/removeClass.xml
@@ -1,177 +1,196 @@
 
-
-  .removeClass()
-  
-    1.0
-    
-      One or more space-separated classes to be removed from the class attribute of each matched element.
-    
-  
-  
-    3.3
-    
-      An array of classes to be removed from the class attribute of each matched element.
-    
-  
-  
-    1.4
-    
-      
-      
-      
-      A function returning one or more space-separated class names to be removed. Receives the index position of the element in the set and the old class value as arguments.
-    
-  
-  
-    3.3
-    
-      
-      
-      
-      
-      A function returning one or more space-separated class names or an array of class names to be removed. Receives the index position of the element in the set and the old class value as arguments.
-    
-  
+
   Remove a single class, multiple classes, or all classes from each element in the set of matched elements.
-  
-    
            If a class name is included as a parameter, then only that class will be removed from the set of matched elements. If no classes are specified in the parameter, all classes will be removed.
            
-    
            Before jQuery version 1.12/2.2, the .removeClass() method manipulated the className property of the selected elements, not the class attribute. Once the property was changed, it was the browser that updated the attribute accordingly. This means that when the class attribute was updated and the last class name was removed, the browser might have set the attribute's value to an empty string instead of removing the attribute completely. An implication of this behavior was that this method only worked for documents with HTML DOM semantics (e.g., not pure XML documents).
            
-    
            As of jQuery 1.12/2.2, this behavior is changed to improve the support for XML documents, including SVG. Starting from this version, the class attribute is used instead. So, .removeClass() can be used on XML or SVG documents.
            
-    
            More than one class may be removed at a time, separated by a space, from the set of matched elements, like so:
            
-    
            
-$( "p" ).removeClass( "myClass yourClass" )
-    
            
-    
            This method is often used with .addClass() to switch elements' classes from one to another, like so:
            
-    
            
-$( "p" ).removeClass( "myClass noClass" ).addClass( "yourClass" );
-    
            
-    
            Here, the myClass and noClass classes are removed from all paragraphs, while yourClass is added.
            
-    
            To replace all existing classes with another class, we can use .attr( "class", "newClass" ) instead.
            
-    
            As of jQuery 1.4, the .removeClass() method allows us to indicate the class to be removed by passing in a function.
            
-    
            
-$( "li" ).last().removeClass(function() {
-  return $( this ).prev().attr( "class" );
-});
-    
            
-    
            This example removes the class name of the penultimate <li> from the last <li>.
            
-              
-  
-    Remove the class 'blue' from the matched elements.
-    
-    
-    Hello
            
-
            and
            
-
            then
            
-
            Goodbye
            
-]]>
-              
-  
-    Remove the class 'blue' and 'under' from the matched elements.
-    
-    
-    Hello
            
-
            and
            
-
            then
            
-
            Goodbye
            
-]]>
-              
-  
-    Remove the class 'blue' and 'under' from the matched elements (3.3+ syntax).
-    
-    
-    Hello
            
-
            and
            
-
            then
            
-
            Goodbye
            
-]]>
-              
-  
-    Remove all the classes from the matched elements.
-    
-    
-    Hello
            
-
            and
            
-
            then
            
-
            Goodbye
            
-]]>
-              
-  
-  
-  
-  
-  
-  
-  
-            
+  
+    .removeClass( classes )
+    
+      1.0
+      
+        One or more space-separated classes to be removed from the class attribute of each matched element.
+      
+    
+    
+      3.3
+      
+        An array of classes to be removed from the class attribute of each matched element.
+      
+    
+    
+      1.4
+      
+        
+        
+        
+        A function returning one or more space-separated class names to be removed. Receives the index position of the element in the set and the old class value as arguments.
+      
+    
+    
+      3.3
+      
+        
+        
+        
+        
+        A function returning one or more space-separated class names or an array of class names to be removed. Receives the index position of the element in the set and the old class value as arguments.
+      
+    
+    Remove a single class or multiple classes from each element in the set of matched elements.
+    
+      
            Before jQuery version 1.12/2.2, the .removeClass() method manipulated the className property of the selected elements, not the class attribute. Once the property was changed, it was the browser that updated the attribute accordingly. This means that when the class attribute was updated and the last class name was removed, the browser might have set the attribute's value to an empty string instead of removing the attribute completely. An implication of this behavior was that this method only worked for documents with HTML DOM semantics (e.g., not pure XML documents).
            
+      
            As of jQuery 1.12/2.2, this behavior is changed to improve the support for XML documents, including SVG. Starting from this version, the class attribute is used instead. So, .removeClass() can be used on XML or SVG documents.
            
+      
            More than one class may be removed at a time, separated by a space, from the set of matched elements, like so:
            
+      
            
+  $( "p" ).removeClass( "myClass yourClass" )
+      
            
+      
            This method is often used with .addClass() to switch elements' classes from one to another, like so:
            
+      
            
+  $( "p" ).removeClass( "myClass noClass" ).addClass( "yourClass" );
+      
            
+      
            Here, the myClass and noClass classes are removed from all paragraphs, while yourClass is added.
            
+      
            To replace all existing classes with another class, we can use .attr( "class", "newClass" ) instead.
            
+      
            As of jQuery 1.4, the .removeClass() method allows us to indicate the class to be removed by passing in a function.
            
+      
            
+  $( "li" ).last().removeClass(function() {
+    return $( this ).prev().attr( "class" );
+  });
+      
            
+      
            This example removes the class name of the penultimate <li> from the last <li>.
            
+                
+    
+      Remove the class 'blue' from the matched elements.
+      
+      
+      Hello
            
+  
            and
            
+  
            then
            
+  
            Goodbye
            
+  ]]>
+                
+    
+      Remove the class 'blue' and 'under' from the matched elements.
+      
+      
+      Hello
            
+  
            and
            
+  
            then
            
+  
            Goodbye
            
+  ]]>
+                
+    
+      Remove the class 'blue' and 'under' from the matched elements (3.3+ syntax).
+      
+      
+      Hello
            
+  
            and
            
+  
            then
            
+  
            Goodbye
            
+  ]]>
+                
+    
+    
+    
+    
+    
+    
+    
+              
+
+  
+    .removeClass()
+    
+      1.0
+    
+    Remove all classes from each matched element.
+    
+      
            Before jQuery version 1.12/2.2, the .removeClass() method manipulated the className property of the selected elements, not the class attribute. Once the property was changed, it was the browser that updated the attribute accordingly. This means that when the class attribute was updated and the last class name was removed, the browser might have set the attribute's value to an empty string instead of removing the attribute completely. An implication of this behavior was that this method only worked for documents with HTML DOM semantics (e.g., not pure XML documents).
            
+      
            As of jQuery 1.12/2.2, this behavior is changed to improve the support for XML documents, including SVG. Starting from this version, the class attribute is used instead. So, .removeClass() can be used on XML or SVG documents.
            
+                
+    
+      Remove all the classes from the matched elements.
+      
+      
+      Hello
            
+  
            and
            
+  
            then
            
+  
            Goodbye
            
+  ]]>
+                
+    
+    
+    
+    
+    
+              
+

From fe9ac2ac73d63e89b107dc0c6819308187fc535a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Thu, 20 May 2021 18:16:09 +0200
Subject: [PATCH 602/699] 3.0.8

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index f614f714..5f77e2f5 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.0.7",
+  "version": "3.0.8",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 36813e14..f6ef8074 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.0.7",
+  "version": "3.0.8",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 4ee9b17c32188be3c045b4c596efedeea2b54ea5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Thu, 20 May 2021 18:21:19 +0200
Subject: [PATCH 603/699] removeClass: Tweak the page title

---
 entries/removeClass.xml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/entries/removeClass.xml b/entries/removeClass.xml
index 2edb382d..d66b9891 100644
--- a/entries/removeClass.xml
+++ b/entries/removeClass.xml
@@ -2,7 +2,7 @@
 
   Remove a single class, multiple classes, or all classes from each element in the set of matched elements.
   
-    .removeClass( classes )
+    .removeClass()
     
       1.0
       
@@ -150,7 +150,6 @@
   
 
   
-    .removeClass()
     
       1.0
     

From e7ae1b435f896d2ed422d7e12f4f9bae9dd914ff Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Thu, 20 May 2021 18:22:14 +0200
Subject: [PATCH 604/699] 3.0.9

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 5f77e2f5..3b35a43c 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.0.8",
+  "version": "3.0.9",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index f6ef8074..0ee5e5db 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.0.8",
+  "version": "3.0.9",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From e7bd4f80cc2f33d833d24250465697504aa36d7f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Sat, 22 May 2021 03:13:35 +0200
Subject: [PATCH 605/699] 3.0.10

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 3b35a43c..2e823ed5 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.0.9",
+  "version": "3.0.10",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 0ee5e5db..61477766 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.0.9",
+  "version": "3.0.10",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 2afc51e3c8373c2776a5e0200599124af2320742 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Sat, 22 May 2021 12:53:30 +0200
Subject: [PATCH 606/699] Build: Update grunt-jquery-content

Fixes gh-1184
Closes gh-1190
---
 package-lock.json | 314 ++++++++++++++++++++++++++--------------------
 package.json      |   2 +-
 2 files changed, 182 insertions(+), 134 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 2e823ed5..b638410f 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -4,20 +4,6 @@
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
-    "CSSselect": {
-      "version": "0.4.1",
-      "resolved": "https://registry.npmjs.org/CSSselect/-/CSSselect-0.4.1.tgz",
-      "integrity": "sha1-+Kt+H4QYzmPNput713ioXX7EkrI=",
-      "requires": {
-        "CSSwhat": "0.4",
-        "domutils": "1.4"
-      }
-    },
-    "CSSwhat": {
-      "version": "0.4.7",
-      "resolved": "https://registry.npmjs.org/CSSwhat/-/CSSwhat-0.4.7.tgz",
-      "integrity": "sha1-hn2g/zn3eGEyQsRM/qg/CqTr35s="
-    },
     "abbrev": {
       "version": "1.1.1",
       "resolved": "https://registry.npmjs.org/abbrev/-/abbrev-1.1.1.tgz",
@@ -66,6 +52,11 @@
       "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
       "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw=="
     },
+    "boolbase": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/boolbase/-/boolbase-1.0.0.tgz",
+      "integrity": "sha1-aN/1++YMUes3cl6p4+0xDcwed24="
+    },
     "brace-expansion": {
       "version": "1.1.11",
       "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz",
@@ -93,22 +84,26 @@
       }
     },
     "cheerio": {
-      "version": "0.17.0",
-      "resolved": "https://registry.npmjs.org/cheerio/-/cheerio-0.17.0.tgz",
-      "integrity": "sha1-+lrkLMYBIRM9KW0LRtmDIV9yaOo=",
+      "version": "0.22.0",
+      "resolved": "https://registry.npmjs.org/cheerio/-/cheerio-0.22.0.tgz",
+      "integrity": "sha1-qbqoYKP5tZWmuBsahocxIe06Jp4=",
       "requires": {
-        "CSSselect": "~0.4.0",
-        "dom-serializer": "~0.0.0",
+        "css-select": "~1.2.0",
+        "dom-serializer": "~0.1.0",
         "entities": "~1.1.1",
-        "htmlparser2": "~3.7.2",
-        "lodash": "~2.4.1"
-      },
-      "dependencies": {
-        "lodash": {
-          "version": "2.4.2",
-          "resolved": "https://registry.npmjs.org/lodash/-/lodash-2.4.2.tgz",
-          "integrity": "sha1-+t2DS5aDBz2hebPq5tnA0VBT9z4="
-        }
+        "htmlparser2": "^3.9.1",
+        "lodash.assignin": "^4.0.9",
+        "lodash.bind": "^4.1.4",
+        "lodash.defaults": "^4.0.1",
+        "lodash.filter": "^4.4.0",
+        "lodash.flatten": "^4.2.0",
+        "lodash.foreach": "^4.3.0",
+        "lodash.map": "^4.4.0",
+        "lodash.merge": "^4.4.0",
+        "lodash.pick": "^4.2.1",
+        "lodash.reduce": "^4.4.0",
+        "lodash.reject": "^4.4.0",
+        "lodash.some": "^4.4.0"
       }
     },
     "color-convert": {
@@ -134,10 +129,21 @@
       "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
       "integrity": "sha1-2Klr13/Wjfd5OnMDajug1UBdR3s="
     },
-    "core-util-is": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.2.tgz",
-      "integrity": "sha1-tf1UIgqivFq1eqtxQMlAdUUDwac="
+    "css-select": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/css-select/-/css-select-1.2.0.tgz",
+      "integrity": "sha1-KzoRBTnFNV8c2NMUYj6HCxIeyFg=",
+      "requires": {
+        "boolbase": "~1.0.0",
+        "css-what": "2.1",
+        "domutils": "1.5.1",
+        "nth-check": "~1.0.1"
+      }
+    },
+    "css-what": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/css-what/-/css-what-2.1.3.tgz",
+      "integrity": "sha512-a+EPoD+uZiNfh+5fxw2nO9QwFa6nJe2Or35fGY6Ipw1R3R4AGz1d1TEZrCegvw2YTmZ0jXirGYlzxxpYSHwpEg=="
     },
     "dateformat": {
       "version": "3.0.3",
@@ -150,19 +156,12 @@
       "integrity": "sha1-8NZtA2cqglyxtzvbP+YjEMjlUrc="
     },
     "dom-serializer": {
-      "version": "0.0.1",
-      "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-0.0.1.tgz",
-      "integrity": "sha1-lYmCfx4y0iw3yCmtq9WbMkevjq8=",
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-0.1.1.tgz",
+      "integrity": "sha512-l0IU0pPzLWSHBcieZbpOKgkIn3ts3vAh7ZuFyXNwJxJXk/c4Gwj9xaTJwIDVQCXawWD0qb3IzMGH5rglQaO0XA==",
       "requires": {
-        "domelementtype": "~1.1.1",
-        "entities": "~1.1.1"
-      },
-      "dependencies": {
-        "domelementtype": {
-          "version": "1.1.3",
-          "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-1.1.3.tgz",
-          "integrity": "sha1-vSh3PiZCiBrsUVRJJCmcXNgiGFs="
-        }
+        "domelementtype": "^1.3.0",
+        "entities": "^1.1.1"
       }
     },
     "domelementtype": {
@@ -171,18 +170,19 @@
       "integrity": "sha512-BSKB+TSpMpFI/HOxCNr1O8aMOTZ8hT3pM3GQ0w/mWRmkhEDSFJkkyzz4XQsBV44BChwGkrDfMyjVD0eA2aFV3w=="
     },
     "domhandler": {
-      "version": "2.2.1",
-      "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-2.2.1.tgz",
-      "integrity": "sha1-Wd+dzSJ+gIs2Wuc+H2aErD2Ub8I=",
+      "version": "2.4.2",
+      "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-2.4.2.tgz",
+      "integrity": "sha512-JiK04h0Ht5u/80fdLMCEmV4zkNh2BcoMFBmZ/91WtYZ8qVXSKjiw7fXMgFPnHcSZgOo3XdinHvmnDUeMf5R4wA==",
       "requires": {
         "domelementtype": "1"
       }
     },
     "domutils": {
-      "version": "1.4.3",
-      "resolved": "https://registry.npmjs.org/domutils/-/domutils-1.4.3.tgz",
-      "integrity": "sha1-CGVRN5bGswYDGFDhdVFrr4C3Km8=",
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/domutils/-/domutils-1.5.1.tgz",
+      "integrity": "sha1-3NhIiib1Y9YQeeSMn3t+Mjc2gs8=",
       "requires": {
+        "dom-serializer": "0",
         "domelementtype": "1"
       }
     },
@@ -416,37 +416,30 @@
       }
     },
     "grunt-jquery-content": {
-      "version": "3.0.3",
-      "resolved": "https://registry.npmjs.org/grunt-jquery-content/-/grunt-jquery-content-3.0.3.tgz",
-      "integrity": "sha1-sqFpjFTz6QZyO3cPuuRJ/ZIRXqM=",
-      "requires": {
-        "async": "0.9.0",
-        "cheerio": "0.17.0",
-        "grunt-check-modules": "1.1.0",
-        "grunt-wordpress": "2.1.3",
-        "he": "0.5.0",
-        "highlight.js": "7.3.0",
-        "marked": "0.3.2",
-        "rimraf": "2.2.8",
-        "spawnback": "1.0.0",
-        "which": "1.0.5",
-        "wordpress": "1.3.0"
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/grunt-jquery-content/-/grunt-jquery-content-3.1.0.tgz",
+      "integrity": "sha512-9FIYqv0ML0fokZqOts7ecYR3I7pyKmvFP0WrEKcZUvgN13lBiI0JtvLfWwM3FrpiQUCIa9kZWJPJj55OPi+KMQ==",
+      "requires": {
+        "async": "^3.2.0",
+        "cheerio": "^0.22.0",
+        "grunt-check-modules": "^1.1.0",
+        "grunt-wordpress": "^2.1.3",
+        "he": "^1.2.0",
+        "highlight.js": "^10.7.2",
+        "marked": "^2.0.3",
+        "rimraf": "^3.0.2",
+        "spawnback": "^1.0.1",
+        "which": "^2.0.2",
+        "wordpress": "^1.4.1"
       },
       "dependencies": {
-        "async": {
-          "version": "0.9.0",
-          "resolved": "https://registry.npmjs.org/async/-/async-0.9.0.tgz",
-          "integrity": "sha1-rDYTsdqb7RtHUQu0ZRuJMeRxRsc="
-        },
-        "rimraf": {
-          "version": "2.2.8",
-          "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-2.2.8.tgz",
-          "integrity": "sha1-5Dm+Kq7jJzIZUnMPmaiSnk/FBYI="
-        },
         "which": {
-          "version": "1.0.5",
-          "resolved": "https://registry.npmjs.org/which/-/which-1.0.5.tgz",
-          "integrity": "sha1-VjDWgZ3aaS8UZEYueVbLQsCEJzk="
+          "version": "2.0.2",
+          "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
+          "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
+          "requires": {
+            "isexe": "^2.0.0"
+          }
         }
       }
     },
@@ -521,14 +514,14 @@
       "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ=="
     },
     "he": {
-      "version": "0.5.0",
-      "resolved": "https://registry.npmjs.org/he/-/he-0.5.0.tgz",
-      "integrity": "sha1-LAX/rvkLaOhg8/0rVO9YCYknfuI="
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/he/-/he-1.2.0.tgz",
+      "integrity": "sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw=="
     },
     "highlight.js": {
-      "version": "7.3.0",
-      "resolved": "https://registry.npmjs.org/highlight.js/-/highlight.js-7.3.0.tgz",
-      "integrity": "sha1-bF8PZOcHj2ZAK82/yJEQw/0bqZ8="
+      "version": "10.7.2",
+      "resolved": "https://registry.npmjs.org/highlight.js/-/highlight.js-10.7.2.tgz",
+      "integrity": "sha512-oFLl873u4usRM9K63j4ME9u3etNF0PLiJhSQ8rdfuL51Wn3zkD6drf9ZW0dOzjnZI22YYG24z30JcmfCZjMgYg=="
     },
     "homedir-polyfill": {
       "version": "1.0.3",
@@ -544,31 +537,16 @@
       "integrity": "sha1-uDT3I8xKJCqmWWNFnfbZhMXT2Vk="
     },
     "htmlparser2": {
-      "version": "3.7.3",
-      "resolved": "https://registry.npmjs.org/htmlparser2/-/htmlparser2-3.7.3.tgz",
-      "integrity": "sha1-amTHdjfAjG8w7CqBV6UzM758sF4=",
-      "requires": {
-        "domelementtype": "1",
-        "domhandler": "2.2",
-        "domutils": "1.5",
-        "entities": "1.0",
-        "readable-stream": "1.1"
-      },
-      "dependencies": {
-        "domutils": {
-          "version": "1.5.1",
-          "resolved": "https://registry.npmjs.org/domutils/-/domutils-1.5.1.tgz",
-          "integrity": "sha1-3NhIiib1Y9YQeeSMn3t+Mjc2gs8=",
-          "requires": {
-            "dom-serializer": "0",
-            "domelementtype": "1"
-          }
-        },
-        "entities": {
-          "version": "1.0.0",
-          "resolved": "https://registry.npmjs.org/entities/-/entities-1.0.0.tgz",
-          "integrity": "sha1-sph6o4ITR/zeZCsk/fyeT7cSvyY="
-        }
+      "version": "3.10.1",
+      "resolved": "https://registry.npmjs.org/htmlparser2/-/htmlparser2-3.10.1.tgz",
+      "integrity": "sha512-IgieNijUMbkDovyoKObU1DUhm1iwNYE/fuifEoEHfd1oZKZDaONBSkal7Y01shxsM49R4XaMdGez3WnF9UfiCQ==",
+      "requires": {
+        "domelementtype": "^1.3.1",
+        "domhandler": "^2.3.0",
+        "domutils": "^1.5.1",
+        "entities": "^1.1.1",
+        "inherits": "^2.0.1",
+        "readable-stream": "^3.1.1"
       }
     },
     "iconv-lite": {
@@ -667,11 +645,6 @@
       "resolved": "https://registry.npmjs.org/is-windows/-/is-windows-1.0.2.tgz",
       "integrity": "sha512-eXK1UInq2bPmjyX6e3VHIzMLobc4J94i4AWn+Hpq3OU5KkrRC96OAcR3PRJ/pGu6m8TRnBHP9dkXQVsT/COVIA=="
     },
-    "isarray": {
-      "version": "0.0.1",
-      "resolved": "https://registry.npmjs.org/isarray/-/isarray-0.0.1.tgz",
-      "integrity": "sha1-ihis/Kmo9Bd+Cav8YDiTmwXR7t8="
-    },
     "isexe": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
@@ -729,6 +702,66 @@
       "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz",
       "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg=="
     },
+    "lodash.assignin": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/lodash.assignin/-/lodash.assignin-4.2.0.tgz",
+      "integrity": "sha1-uo31+4QesKPoBEIysOJjqNxqKKI="
+    },
+    "lodash.bind": {
+      "version": "4.2.1",
+      "resolved": "https://registry.npmjs.org/lodash.bind/-/lodash.bind-4.2.1.tgz",
+      "integrity": "sha1-euMBfpOWIqwxt9fX3LGzTbFpDTU="
+    },
+    "lodash.defaults": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/lodash.defaults/-/lodash.defaults-4.2.0.tgz",
+      "integrity": "sha1-0JF4cW/+pN3p5ft7N/bwgCJ0WAw="
+    },
+    "lodash.filter": {
+      "version": "4.6.0",
+      "resolved": "https://registry.npmjs.org/lodash.filter/-/lodash.filter-4.6.0.tgz",
+      "integrity": "sha1-ZosdSYFgOuHMWm+nYBQ+SAtMSs4="
+    },
+    "lodash.flatten": {
+      "version": "4.4.0",
+      "resolved": "https://registry.npmjs.org/lodash.flatten/-/lodash.flatten-4.4.0.tgz",
+      "integrity": "sha1-8xwiIlqWMtK7+OSt2+8kCqdlph8="
+    },
+    "lodash.foreach": {
+      "version": "4.5.0",
+      "resolved": "https://registry.npmjs.org/lodash.foreach/-/lodash.foreach-4.5.0.tgz",
+      "integrity": "sha1-Gmo16s5AEoDH8G3d7DUWWrJ+PlM="
+    },
+    "lodash.map": {
+      "version": "4.6.0",
+      "resolved": "https://registry.npmjs.org/lodash.map/-/lodash.map-4.6.0.tgz",
+      "integrity": "sha1-dx7Hg540c9nEzeKLGTlMNWL09tM="
+    },
+    "lodash.merge": {
+      "version": "4.6.2",
+      "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz",
+      "integrity": "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ=="
+    },
+    "lodash.pick": {
+      "version": "4.4.0",
+      "resolved": "https://registry.npmjs.org/lodash.pick/-/lodash.pick-4.4.0.tgz",
+      "integrity": "sha1-UvBWEP/53tQiYRRB7R/BI6AwAbM="
+    },
+    "lodash.reduce": {
+      "version": "4.6.0",
+      "resolved": "https://registry.npmjs.org/lodash.reduce/-/lodash.reduce-4.6.0.tgz",
+      "integrity": "sha1-8atrg5KZrUj3hKu/R2WW8DuRTTs="
+    },
+    "lodash.reject": {
+      "version": "4.6.0",
+      "resolved": "https://registry.npmjs.org/lodash.reject/-/lodash.reject-4.6.0.tgz",
+      "integrity": "sha1-gNZJLcFHCGS79YNTO2UfQqn1JBU="
+    },
+    "lodash.some": {
+      "version": "4.6.0",
+      "resolved": "https://registry.npmjs.org/lodash.some/-/lodash.some-4.6.0.tgz",
+      "integrity": "sha1-G7nzFO9ri63tE7VJFpsqlF62jk0="
+    },
     "make-iterator": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/make-iterator/-/make-iterator-1.0.1.tgz",
@@ -743,9 +776,9 @@
       "integrity": "sha1-wyq9C9ZSXZsFFkW7TyasXcmKDb8="
     },
     "marked": {
-      "version": "0.3.2",
-      "resolved": "https://registry.npmjs.org/marked/-/marked-0.3.2.tgz",
-      "integrity": "sha1-AV2xWIZEOPJKZL3WGgQotBhwbQk="
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/marked/-/marked-2.0.5.tgz",
+      "integrity": "sha512-yfCEUXmKhBPLOzEC7c+tc4XZdIeTdGoRCZakFMkCxodr7wDXqoapIME4wjcpBPJLNyUnKJ3e8rb8wlAgnLnaDw=="
     },
     "micromatch": {
       "version": "4.0.4",
@@ -777,6 +810,14 @@
         "abbrev": "1"
       }
     },
+    "nth-check": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/nth-check/-/nth-check-1.0.2.tgz",
+      "integrity": "sha512-WeBOdju8SnzPN5vTUJYxYUxLeXpCaVP5i5e0LF8fg7WORF2Wd7wFX/pk0tYZk7s8T+J7VLy0Da6J1+wCT0AtHg==",
+      "requires": {
+        "boolbase": "~1.0.0"
+      }
+    },
     "object.defaults": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/object.defaults/-/object.defaults-1.1.0.tgz",
@@ -876,14 +917,13 @@
       "integrity": "sha512-KpELjfwcCDUb9PeigTs2mBJzXUPzAuP2oPcA989He8Rte0+YUAjw1JVedDhuTKPkHjSYzMN3npC9luThGYEKdg=="
     },
     "readable-stream": {
-      "version": "1.1.14",
-      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-1.1.14.tgz",
-      "integrity": "sha1-fPTFTvZI44EwhMY23SB54WbAgdk=",
+      "version": "3.6.0",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.0.tgz",
+      "integrity": "sha512-BViHy7LKeTz4oNnkcLJ+lVSL6vpiFeX6/d3oSH8zCW7UxP2onchk+vTGB143xuFjHS3deTgkKoXXymXqymiIdA==",
       "requires": {
-        "core-util-is": "~1.0.0",
-        "inherits": "~2.0.1",
-        "isarray": "0.0.1",
-        "string_decoder": "~0.10.x"
+        "inherits": "^2.0.3",
+        "string_decoder": "^1.1.1",
+        "util-deprecate": "^1.0.1"
       }
     },
     "rechoir": {
@@ -920,6 +960,11 @@
         "glob": "^7.1.3"
       }
     },
+    "safe-buffer": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
+      "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ=="
+    },
     "safer-buffer": {
       "version": "2.1.2",
       "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
@@ -931,9 +976,9 @@
       "integrity": "sha512-NqVDv9TpANUjFm0N8uM5GxL36UgKi9/atZw+x7YFnQ8ckwFGKrl4xX4yWtrey3UJm5nP1kUbnYgLopqWNSRhWw=="
     },
     "spawnback": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/spawnback/-/spawnback-1.0.0.tgz",
-      "integrity": "sha1-9zZi9+VNlTZ+ynTWQmxnfdfqaG8="
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/spawnback/-/spawnback-1.0.1.tgz",
+      "integrity": "sha512-340ZqtqJzWAZtHwaCC2gx4mdQOnkUWAWNDp7y0bCEatdjmgQ4j7b0qQ7qO5WIJWx/luNrKcrYzpKbH3NTR030A=="
     },
     "sprintf-js": {
       "version": "1.1.2",
@@ -941,9 +986,12 @@
       "integrity": "sha512-VE0SOVEHCk7Qc8ulkWw3ntAzXuqf7S2lvwQaDLRnUeIEaKNQJzV6BwmLKhOqT61aGhfUMrXeaBk+oDGCzvhcug=="
     },
     "string_decoder": {
-      "version": "0.10.31",
-      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz",
-      "integrity": "sha1-YuIDvEF2bGwoyfyEMB2rHFMQ+pQ="
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",
+      "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==",
+      "requires": {
+        "safe-buffer": "~5.2.0"
+      }
     },
     "supports-color": {
       "version": "7.2.0",
@@ -997,9 +1045,9 @@
       }
     },
     "wordpress": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/wordpress/-/wordpress-1.3.0.tgz",
-      "integrity": "sha1-0LxIUVOktTh3B+O8yRZqDBPpcS8=",
+      "version": "1.4.1",
+      "resolved": "https://registry.npmjs.org/wordpress/-/wordpress-1.4.1.tgz",
+      "integrity": "sha512-U2zADxCSyyYcpgc5i7ipiDzNx6/e0zq2ldWyqTqr8n88Nj+iHd5JT/WavZkIQ+x0b9QlBv9lHoXyrqxdbckIrw==",
       "requires": {
         "xmlrpc": "1.3.2"
       }
diff --git a/package.json b/package.json
index 61477766..25d27679 100644
--- a/package.json
+++ b/package.json
@@ -26,6 +26,6 @@
   "dependencies": {
     "grunt": "1.4.0",
     "grunt-cli": "1.4.2",
-    "grunt-jquery-content": "3.0.3"
+    "grunt-jquery-content": "3.1.0"
   }
 }

From 9ff4827283f7af4eeea2585ae5f4a74bb4eb9d60 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Sat, 22 May 2021 12:54:41 +0200
Subject: [PATCH 607/699] 3.1.0

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index b638410f..1129ee61 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.0.10",
+  "version": "3.1.0",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 25d27679..8001061f 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.0.10",
+  "version": "3.1.0",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 0a70489c15c90f5e721e4a5f19520f20eac21dfd Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 11 Aug 2021 18:39:02 +0200
Subject: [PATCH 608/699] Build: Bump path-parse from 1.0.6 to 1.0.7

Bumps [path-parse](https://github.com/jbgutierrez/path-parse) from 1.0.6 to 1.0.7.
- [Release notes](https://github.com/jbgutierrez/path-parse/releases)
- [Commits](https://github.com/jbgutierrez/path-parse/commits/v1.0.7)

Closes gh-1193

---
updated-dependencies:
- dependency-name: path-parse
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] 

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 package-lock.json | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 1129ee61..521a330d 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -894,9 +894,9 @@
       "integrity": "sha1-F0uSaHNVNP+8es5r9TpanhtcX18="
     },
     "path-parse": {
-      "version": "1.0.6",
-      "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.6.tgz",
-      "integrity": "sha512-GSmOT2EbHrINBf9SR7CDELwlJ8AENk3Qn7OikK4nFYAu3Ote2+JYNVvkpAEQm3/TLNEJFD/xZJjzyxg3KBWOzw=="
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz",
+      "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw=="
     },
     "path-root": {
       "version": "0.1.1",

From 5e4ea0d9dc22ef49b0712dc07b5376114abe8b07 Mon Sep 17 00:00:00 2001
From: jayschmidgall <89083942+jayschmidgall@users.noreply.github.com>
Date: Tue, 17 Aug 2021 11:11:40 -0500
Subject: [PATCH 609/699] Update attr example in prop.xml

Closes #1194
---
 entries/prop.xml | 9 +--------
 1 file changed, 1 insertion(+), 8 deletions(-)

diff --git a/entries/prop.xml b/entries/prop.xml
index 775b8062..09ee042c 100644
--- a/entries/prop.xml
+++ b/entries/prop.xml
@@ -42,17 +42,10 @@
         
           
             $( elem ).attr( "checked" )
-            (1.6)
+            (1.6+)
           
           "checked" (String) Initial state of the checkbox; does not change
         
-        
-          
-            $( elem ).attr( "checked" )
-            (1.6.1+)
-          
-          "checked" (String) Will change with checkbox state
-        
         
           
             $( elem ).attr( "checked" )

From ae855972e765f433d9d17e559eba7db6b7adeab7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Thu, 18 Nov 2021 13:47:51 +0100
Subject: [PATCH 610/699] jQuery.getScript: Update the jQuery Color link to a
 versioned one

---
 entries/jQuery.getScript.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.getScript.xml b/entries/jQuery.getScript.xml
index 357b9e1a..906f03e4 100644
--- a/entries/jQuery.getScript.xml
+++ b/entries/jQuery.getScript.xml
@@ -92,7 +92,7 @@ $.cachedScript( "ajax/test.js" ).done(function( script, textStatus ) {
   
     Load the official jQuery Color Animation plugin dynamically and bind some color animations to occur once the new functionality is loaded.
     
Date: Thu, 18 Nov 2021 13:48:15 +0100
Subject: [PATCH 611/699] 3.1.1

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 521a330d..876ec538 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 8001061f..720284ce 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From bcc3593339727f479e93279d8c4a1e1901153be1 Mon Sep 17 00:00:00 2001
From: Timo Tijhof 
Date: Wed, 27 Apr 2022 01:46:34 +0200
Subject: [PATCH 612/699] Ajax Events: Promote on() instead of bind() (#1202)

Closes gh-1202
---
 pages/Ajax_Events.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pages/Ajax_Events.html b/pages/Ajax_Events.html
index 26a59f0f..6b1249be 100644
--- a/pages/Ajax_Events.html
+++ b/pages/Ajax_Events.html
@@ -19,9 +19,9 @@ 
            Local Events
            
 
            
 
            Global Events
            
 
            These events are triggered on the document, calling any handlers which may be listening. You can listen for these events like so:
            
-
             $(document).bind("ajaxSend", function(){
+
             $(document).on("ajaxSend", function(){
    $("#loading").show();
- }).bind("ajaxComplete", function(){
+ }).on("ajaxComplete", function(){
    $("#loading").hide();
  });
 
            

From 1940bb86d41d89386b7952319cc4d23339790734 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 27 Apr 2022 14:49:35 +0200
Subject: [PATCH 613/699] Build: Bump grunt from 1.4.0 to 1.5.2

Bumps [grunt](https://github.com/gruntjs/grunt) from 1.4.0 to 1.5.2.
- [Release notes](https://github.com/gruntjs/grunt/releases)
- [Changelog](https://github.com/gruntjs/grunt/blob/main/CHANGELOG)
- [Commits](https://github.com/gruntjs/grunt/compare/v1.4.0...v1.5.2)

Closes gh-1203

---
updated-dependencies:
- dependency-name: grunt
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] 

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 package-lock.json | 60 +++++++++++++++++++++++++++++++++++------------
 package.json      |  2 +-
 2 files changed, 46 insertions(+), 16 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 876ec538..895cfa1e 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -75,9 +75,9 @@
       }
     },
     "chalk": {
-      "version": "4.1.1",
-      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.1.tgz",
-      "integrity": "sha512-diHzdDKxcU+bAsUboHLPEDQiw0qEe0qd7SYUn3HgcFlWgbDcfLGswOHYeGrHKzG9z6UYf01d9VFMfZxPM1xZSg==",
+      "version": "4.1.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
+      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
       "requires": {
         "ansi-styles": "^4.1.0",
         "supports-color": "^7.1.0"
@@ -290,9 +290,9 @@
       "integrity": "sha512-yIovAzMX49sF8Yl58fSCWJ5svSLuaibPxXQJFLmBObTuCr0Mf1KiPopGM9NiFjiYBCbfaa2Fh6breQ6ANVTI0A=="
     },
     "getobject": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/getobject/-/getobject-1.0.0.tgz",
-      "integrity": "sha512-tbUz6AKKKr2YiMB+fLWIgq5ZeBOobop9YMMAU9dC54/ot2ksMXt3DOFyBuhZw6ptcVszEykgByK20j7W9jHFag=="
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/getobject/-/getobject-1.0.2.tgz",
+      "integrity": "sha512-2zblDBaFcb3rB4rF77XVnuINOE2h2k/OnqXAiy0IrTxUfV1iFp3la33oAQVY9pCpWU268WFYVt2t71hlMuLsOg=="
     },
     "gilded-wordpress": {
       "version": "1.0.5",
@@ -366,17 +366,17 @@
       }
     },
     "grunt": {
-      "version": "1.4.0",
-      "resolved": "https://registry.npmjs.org/grunt/-/grunt-1.4.0.tgz",
-      "integrity": "sha512-yRFc0GVCDu9yxqOFzpuXQ2pEdgtLDnFv5Qz54jfIcNnpJ8Z7B7P7kPkT4VMuRvm+N+QOsI8C4v/Q0DSaoj3LgQ==",
+      "version": "1.5.2",
+      "resolved": "https://registry.npmjs.org/grunt/-/grunt-1.5.2.tgz",
+      "integrity": "sha512-XCtfaIu72OyDqK24MjWiGC9SwlkuhkS1mrULr1xzuJ2XqAFhP3ZAchZGHJeSCY6mkaOXU4F7SbmmCF7xIVoC9w==",
       "requires": {
         "dateformat": "~3.0.3",
         "eventemitter2": "~0.4.13",
         "exit": "~0.1.2",
         "findup-sync": "~0.3.0",
         "glob": "~7.1.6",
-        "grunt-cli": "~1.4.2",
-        "grunt-known-options": "~1.1.1",
+        "grunt-cli": "~1.4.3",
+        "grunt-known-options": "~2.0.0",
         "grunt-legacy-log": "~3.0.0",
         "grunt-legacy-util": "~2.0.1",
         "iconv-lite": "~0.4.13",
@@ -385,6 +385,36 @@
         "mkdirp": "~1.0.4",
         "nopt": "~3.0.6",
         "rimraf": "~3.0.2"
+      },
+      "dependencies": {
+        "grunt-cli": {
+          "version": "1.4.3",
+          "resolved": "https://registry.npmjs.org/grunt-cli/-/grunt-cli-1.4.3.tgz",
+          "integrity": "sha512-9Dtx/AhVeB4LYzsViCjUQkd0Kw0McN2gYpdmGYKtE2a5Yt7v1Q+HYZVWhqXc/kGnxlMtqKDxSwotiGeFmkrCoQ==",
+          "requires": {
+            "grunt-known-options": "~2.0.0",
+            "interpret": "~1.1.0",
+            "liftup": "~3.0.1",
+            "nopt": "~4.0.1",
+            "v8flags": "~3.2.0"
+          },
+          "dependencies": {
+            "nopt": {
+              "version": "4.0.3",
+              "resolved": "https://registry.npmjs.org/nopt/-/nopt-4.0.3.tgz",
+              "integrity": "sha512-CvaGwVMztSMJLOeXPrez7fyfObdZqNUK1cPAEzLHrTybIua9pMdmmPR5YwtfNftIOMv3DPUhFaxsZMNTQO20Kg==",
+              "requires": {
+                "abbrev": "1",
+                "osenv": "^0.1.4"
+              }
+            }
+          }
+        },
+        "grunt-known-options": {
+          "version": "2.0.0",
+          "resolved": "https://registry.npmjs.org/grunt-known-options/-/grunt-known-options-2.0.0.tgz",
+          "integrity": "sha512-GD7cTz0I4SAede1/+pAbmJRG44zFLPipVtdL9o3vqx9IEyb7b4/Y3s7r6ofI3CchR5GvYJ+8buCSioDv5dQLiA=="
+        }
       }
     },
     "grunt-check-modules": {
@@ -1015,11 +1045,11 @@
       "integrity": "sha1-5z3T17DXxe2G+6xrCufYxqadUPo="
     },
     "underscore.string": {
-      "version": "3.3.5",
-      "resolved": "https://registry.npmjs.org/underscore.string/-/underscore.string-3.3.5.tgz",
-      "integrity": "sha512-g+dpmgn+XBneLmXXo+sGlW5xQEt4ErkS3mgeN2GFbremYeMBSJKr9Wf2KJplQVaiPY/f7FN6atosWYNm9ovrYg==",
+      "version": "3.3.6",
+      "resolved": "https://registry.npmjs.org/underscore.string/-/underscore.string-3.3.6.tgz",
+      "integrity": "sha512-VoC83HWXmCrF6rgkyxS9GHv8W9Q5nhMKho+OadDJGzL2oDYbYEppBaCMH6pFlwLeqj2QS+hhkw2kpXkSdD1JxQ==",
       "requires": {
-        "sprintf-js": "^1.0.3",
+        "sprintf-js": "^1.1.1",
         "util-deprecate": "^1.0.2"
       }
     },
diff --git a/package.json b/package.json
index 720284ce..485bfa55 100644
--- a/package.json
+++ b/package.json
@@ -24,7 +24,7 @@
     "test": "grunt lint"
   },
   "dependencies": {
-    "grunt": "1.4.0",
+    "grunt": "1.5.2",
     "grunt-cli": "1.4.2",
     "grunt-jquery-content": "3.1.0"
   }

From bf40aa39ca5f9d8a429b18d9fae78c50b22a4d09 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 27 Jun 2022 17:36:28 +0200
Subject: [PATCH 614/699] Build: Bump grunt from 1.5.2 to 1.5.3

Bumps [grunt](https://github.com/gruntjs/grunt) from 1.5.2 to 1.5.3.
- [Release notes](https://github.com/gruntjs/grunt/releases)
- [Changelog](https://github.com/gruntjs/grunt/blob/main/CHANGELOG)
- [Commits](https://github.com/gruntjs/grunt/compare/v1.5.2...v1.5.3)

Closes gh-1204

---
updated-dependencies:
- dependency-name: grunt
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] 

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 package-lock.json | 6 +++---
 package.json      | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 895cfa1e..e02106bf 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -366,9 +366,9 @@
       }
     },
     "grunt": {
-      "version": "1.5.2",
-      "resolved": "https://registry.npmjs.org/grunt/-/grunt-1.5.2.tgz",
-      "integrity": "sha512-XCtfaIu72OyDqK24MjWiGC9SwlkuhkS1mrULr1xzuJ2XqAFhP3ZAchZGHJeSCY6mkaOXU4F7SbmmCF7xIVoC9w==",
+      "version": "1.5.3",
+      "resolved": "https://registry.npmjs.org/grunt/-/grunt-1.5.3.tgz",
+      "integrity": "sha512-mKwmo4X2d8/4c/BmcOETHek675uOqw0RuA/zy12jaspWqvTp4+ZeQF1W+OTpcbncnaBsfbQJ6l0l4j+Sn/GmaQ==",
       "requires": {
         "dateformat": "~3.0.3",
         "eventemitter2": "~0.4.13",
diff --git a/package.json b/package.json
index 485bfa55..0c97e7d3 100644
--- a/package.json
+++ b/package.json
@@ -24,7 +24,7 @@
     "test": "grunt lint"
   },
   "dependencies": {
-    "grunt": "1.5.2",
+    "grunt": "1.5.3",
     "grunt-cli": "1.4.2",
     "grunt-jquery-content": "3.1.0"
   }

From 5274a1135ff2afad208783de25cc1c96298a6201 Mon Sep 17 00:00:00 2001
From: vlakoff 
Date: Fri, 18 Nov 2022 13:24:40 +0100
Subject: [PATCH 615/699] jQuery.getScript: Script has been executed before the
 `success` callback

When executing a callback provided to the optional `success` parameter of
`$.getScript()`, we can assume the script has been executed already.

Just like when using `.done()` on the returned jqXHR object.

Fixes gh-1207
Closes gh-1209
---
 entries/jQuery.getScript.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/jQuery.getScript.xml b/entries/jQuery.getScript.xml
index 906f03e4..a234e9d1 100644
--- a/entries/jQuery.getScript.xml
+++ b/entries/jQuery.getScript.xml
@@ -27,7 +27,7 @@ $.ajax({
     
            
         Success Callback
       
            
-    
            The callback is fired once the script has been loaded but not necessarily executed.
            
+    
            The callback is fired once the script has been loaded and executed.
            
     
            Scripts are included and run by referencing the file name:
            
     
            
 $.getScript( "ajax/test.js", function( data, textStatus, jqxhr ) {

From b15e83e412351d9271a7ee4c7b16bb20958f7b66 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Fri, 18 Nov 2022 13:26:03 +0100
Subject: [PATCH 616/699] 3.1.2

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index e02106bf..19b7b10d 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.1.1",
+  "version": "3.1.2",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 0c97e7d3..4e291494 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.1.1",
+  "version": "3.1.2",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From de6fdcb76b3b0cf064aa5b27e715706fa4c53eaa Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 18 Nov 2022 13:28:31 +0100
Subject: [PATCH 617/699] Build: Bump async from 3.2.0 to 3.2.4

Bumps [async](https://github.com/caolan/async) from 3.2.0 to 3.2.4.
- [Release notes](https://github.com/caolan/async/releases)
- [Changelog](https://github.com/caolan/async/blob/master/CHANGELOG.md)
- [Commits](https://github.com/caolan/async/compare/v3.2.0...v3.2.4)

Closes gh-1213

---
updated-dependencies:
- dependency-name: async
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] 

Signed-off-by: dependabot[bot] 
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 package-lock.json | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 19b7b10d..aa4f92df 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -43,9 +43,9 @@
       "integrity": "sha512-B1qMD3RBP7O8o0H2KbrXDyB0IccejMF15+87Lvlor12ONPRHP6gTjXMNkt/d3ZuOGbAe66hFmaCfECI24Ufp6w=="
     },
     "async": {
-      "version": "3.2.0",
-      "resolved": "https://registry.npmjs.org/async/-/async-3.2.0.tgz",
-      "integrity": "sha512-TR2mEZFVOj2pLStYxLht7TyfuRzaydfpxr3k9RpHIzMgw7A64dzsdqCxH1WJyQdoe8T10nDXd9wnEigmiuHIZw=="
+      "version": "3.2.4",
+      "resolved": "https://registry.npmjs.org/async/-/async-3.2.4.tgz",
+      "integrity": "sha512-iAB+JbDEGXhyIUavoDl9WP/Jj106Kz9DEn1DPgYw5ruDn0e3Wgi3sKFm55sASdGBNOQB8F59d9qQ7deqrHA8wQ=="
     },
     "balanced-match": {
       "version": "1.0.2",
@@ -307,7 +307,7 @@
         "async": {
           "version": "0.9.2",
           "resolved": "https://registry.npmjs.org/async/-/async-0.9.2.tgz",
-          "integrity": "sha1-rqdNXmHB+JlhO/ZL2mbUx48v0X0="
+          "integrity": "sha512-l6ToIJIotphWahxxHyzK9bnLR6kM4jJIIgLShZeqLY7iboHoGkdgFl7W2/Ivi4SkMJYGKqW8vSuk0uKUj6qsSw=="
         },
         "glob": {
           "version": "4.5.3",

From 6d46d38962fde24bd8d4d913736149d12eb5541f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Fri, 18 Nov 2022 13:28:40 +0100
Subject: [PATCH 618/699] 3.1.3

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index aa4f92df..ea007635 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.1.2",
+  "version": "3.1.3",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 4e291494..5a227e51 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.1.2",
+  "version": "3.1.3",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 3706b06bd7bb3f9f70a57c4d23abab70c9c0423f Mon Sep 17 00:00:00 2001
From: Andrew Dawes 
Date: Fri, 18 Nov 2022 13:29:51 +0100
Subject: [PATCH 619/699] mousemove: Fix a typo

Closes gh-1210
---
 entries/mousemove.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/mousemove.xml b/entries/mousemove.xml
index d2341e65..f6e33860 100644
--- a/entries/mousemove.xml
+++ b/entries/mousemove.xml
@@ -66,7 +66,7 @@ $( "#other" ).click(function() {
     
            
     
            When tracking mouse movement, you usually need to know the actual position of the mouse pointer. The event object that is passed to the handler contains some information about the mouse coordinates. Properties such as .clientX, .offsetX, and .pageX are available, but support for them differs between browsers. Fortunately, jQuery normalizes the .pageX and .pageY properties so that they can be used in all browsers. These properties provide the X and Y coordinates of the mouse pointer relative to the top-left corner of the document, as illustrated in the example output above.
            
     
            Keep in mind that the mousemove event is triggered whenever the mouse pointer moves, even for a pixel. This means that hundreds of events can be generated over a very small amount of time. If the handler has to do any significant processing, or if multiple handlers for the event exist, this can be a serious performance drain on the browser. It is important, therefore, to optimize mousemove handlers as much as possible, and to unbind them as soon as they are no longer needed.
            
-    
            A common pattern is to bind the mousemove handler from within a mousedown hander, and to unbind it from a corresponding mouseup handler. If implementing this sequence of events, remember that the mouseup event might be sent to a different HTML element than the mousemove event was. To account for this, the mouseup handler should typically be bound to an element high up in the DOM tree, such as <body>.
            
+    
            A common pattern is to bind the mousemove handler from within a mousedown handler, and to unbind it from a corresponding mouseup handler. If implementing this sequence of events, remember that the mouseup event might be sent to a different HTML element than the mousemove event was. To account for this, the mouseup handler should typically be bound to an element high up in the DOM tree, such as <body>.
            
   
   
   

From ce90864c03b0a1aae4ab7fe8f616f250efab3f34 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Fri, 18 Nov 2022 13:31:29 +0100
Subject: [PATCH 620/699] Build: Update package-lock.json

---
 package-lock.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package-lock.json b/package-lock.json
index ea007635..7dd81f2e 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -307,7 +307,7 @@
         "async": {
           "version": "0.9.2",
           "resolved": "https://registry.npmjs.org/async/-/async-0.9.2.tgz",
-          "integrity": "sha512-l6ToIJIotphWahxxHyzK9bnLR6kM4jJIIgLShZeqLY7iboHoGkdgFl7W2/Ivi4SkMJYGKqW8vSuk0uKUj6qsSw=="
+          "integrity": "sha1-rqdNXmHB+JlhO/ZL2mbUx48v0X0="
         },
         "glob": {
           "version": "4.5.3",

From 57a7ff7e539dd463fee7e0a1a62f47c0e8694af8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Fri, 18 Nov 2022 13:31:34 +0100
Subject: [PATCH 621/699] 3.1.4

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 7dd81f2e..96119daa 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.1.3",
+  "version": "3.1.4",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 5a227e51..45cdbada 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.1.3",
+  "version": "3.1.4",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 9f6bbf1c186557e253120544b7bf8904a053be6d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Mon, 19 Dec 2022 22:20:06 +0100
Subject: [PATCH 622/699] prevAll: Document issues with reverse doc order

`.prevAll()` returns elements in the reverse document order. This
can pose issues when used with APIs like `.append()` or `.wrapAll()`.
Document how to deal with the issue with help from `jQuery.uniqueSort()`.

Ref jquery/jquery#5149
Closes gh-1215
---
 entries/prevAll.xml | 95 ++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 94 insertions(+), 1 deletion(-)

diff --git a/entries/prevAll.xml b/entries/prevAll.xml
index 73f3f3f5..4b5f6062 100644
--- a/entries/prevAll.xml
+++ b/entries/prevAll.xml
@@ -7,7 +7,7 @@
       A string containing a selector expression to match elements against.
     
   
-  Get all preceding siblings of each element in the set of matched elements, optionally filtered by a selector.
+  Get all preceding siblings of each element in the set of matched elements, optionally filtered by a selector, in the reverse document order.
   
     
            Given a jQuery object that represents a set of DOM elements, the .prevAll() method searches through the predecessors of these elements in the DOM tree and construct a new jQuery object from the matching elements; the elements are returned in order beginning with the closest sibling.
            
     
            The method optionally accepts a selector expression of the same type that we can pass to the $() function. If the selector is supplied, the elements will be filtered by testing whether they match it.
            
@@ -26,6 +26,36 @@
 $( "li.third-item" ).prevAll().css( "background-color", "red" );
     
            
     
            The result of this call is a red background behind items 1 and 2. Since we do not supply a selector expression, these preceding elements are unequivocally included as part of the object. If we had supplied one, the elements would be tested for a match before they were included.
            
+    
            Note: Many APIs, like append or wrapAll process node in the order in which they appear in the jQuery object. This can pose issues with APIs like .prevAll() in which the reverse document order is used. Consider the following example:
            
+    
            
+<div>
+  <div>First</div>
+  <div>Second</div>
+  <div class="last-item">Last</div>
+</div>
+    
            
+    
            The following call:
            
+    
            
+$( ".last-item" )
+  .prevAll()
+  .wrapAll( "<div class='wrapper'></div>" );
+    
            
+    
            would result in the following HTML:
            
+    
            
+<div>
+  <div class="wrapper">
+    <div>Second</div>
+    <div>First</div>
+  </div>
+  <div class="last-item">Last</div>
+</div>
+    
            
+    
            because "Item 2" gets appended to the wrapper div first. To work around the issue, you may use $.uniqueSort() on the .prevAll() output first:
            
+    
            
+var prevSiblings = $( ".last-item" ).prevAll();
+$.uniqueSort( prevSiblings );
+prevSiblings.wrapAll( "<div class='wrapper'></div>" );
+    
            
   
   
     Locate all the divs preceding the last div and give them a class.
@@ -50,6 +80,69 @@ $( "div" ).last().prevAll().addClass( "before" );
 
            
 
            
 
            
+]]>
+              
+  
+    Locate all the divs preceding the last item and wrap them with a div with class wrapper - with or without $.uniqueSort().
+    " );
+
+var prevSiblings = $( "#container-2" )
+  .find( ".item" )
+  .last()
+  .prevAll();
+$.uniqueSort( prevSiblings );
+prevSiblings.wrapAll( "
            " );
+]]>            
+    
+    
+  
            1
            
+  
            2
            
+  
            3
            
+
+
+
            
+  
            1
            
+  
            2
            
+  
            3
            
+
            
 ]]>
               
   

From a9dbdbcf660bccd90de9c81c171547201dd8f932 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Mon, 19 Dec 2022 22:20:24 +0100
Subject: [PATCH 623/699] 3.1.5

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 96119daa..864b3e95 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.1.4",
+  "version": "3.1.5",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 45cdbada..e4e29229 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.1.4",
+  "version": "3.1.5",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 9685f8ad8656f7e51923add83406539a28696726 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Mon, 9 Jan 2023 18:49:23 +0100
Subject: [PATCH 624/699] jQuery.map:jQuery.uniqueSort: Accept array-like
 input, fix typos

Changes:
* `jQuery.map`: Accept array-like input
* `jQuery.uniqueSort`: Accept array-like input, fix typos.
    Apart from array-like inputs being officially allowed in
    `jQuery.uniqueSort` now, in a few places in examples
    it used to be referred to as `unique` instead of `uniqueSort`.

Closes gh-1214
---
 entries/jQuery.map.xml        | 17 +++++++----------
 entries/jQuery.uniqueSort.xml | 14 +++++++-------
 2 files changed, 14 insertions(+), 17 deletions(-)

diff --git a/entries/jQuery.map.xml b/entries/jQuery.map.xml
index 3c499e6c..2016df87 100644
--- a/entries/jQuery.map.xml
+++ b/entries/jQuery.map.xml
@@ -3,8 +3,8 @@
   jQuery.map()
   
     1.0
-    
-      The Array to translate.
+    
+      The Array or an Array-like object to translate.
     
     
       
@@ -16,7 +16,7 @@
   
     1.6
     
-      The Object to translate.
+      The non-Array-like Object to translate.
     
     
       
@@ -28,16 +28,13 @@
   Translate all items in an array or object to new array of items.
   
     
            If you wish to process a jQuery object — for example, $('div').map( callback ); — use .map() instead. 
            
-    
            The $.map() method applies a function to each item in an array or object and maps the results into a new array. Prior to jQuery 1.6, $.map() supports traversing arrays only. As of jQuery 1.6 it also traverses objects.
            
-    
            Array-like objects — those with a .length property and a value on the .length - 1 index — must be converted to actual arrays before being passed to $.map(). The jQuery library provides $.makeArray() for such conversions.
            
+    
            The $.map() method applies a function to each item in an array or object and maps the results into a new array. Prior to jQuery 1.6, $.map() supports traversing arrays and array-like objects only. As of jQuery 1.6 it also traverses objects.
            
+    
            Array-like objects — those with a .length property and a value on the .length - 1 index — may be passed to $.map().
            
     
            
-// The following object masquerades as an array.
+// The following object is array-like.
 var fakeArray = { "length": 2, 0: "Addy", 1: "Subtracty" };
 
-// Therefore, convert it to a real array
-var realArray = $.makeArray( fakeArray )
-
-// Now it can be used reliably with $.map()
+// It can be used reliably with $.map()
 $.map( realArray, function( val, i ) {
   // Do something
 });
diff --git a/entries/jQuery.uniqueSort.xml b/entries/jQuery.uniqueSort.xml
index 9d149af3..4cc08664 100644
--- a/entries/jQuery.uniqueSort.xml
+++ b/entries/jQuery.uniqueSort.xml
@@ -3,28 +3,28 @@
   jQuery.uniqueSort()
   
     1.12-and-2.2
-    
-      The Array of DOM elements.
+    
+      The Array or an Array-like object of DOM elements.
     
   
-  Sorts an array of DOM elements, in place, with the duplicates removed. Note that this only works on arrays of DOM elements, not strings or numbers.
+  Sorts an array or an array-like object of DOM elements, in place, with the duplicates removed. Note that this only works on arrays/array-likes of DOM elements, not strings or numbers.
   
-    
            The $.uniqueSort() function searches through an array of objects, sorting the array, and removing any duplicate nodes. A node is considered a duplicate if it is the exact same node as one already in the array; two different nodes with identical attributes are not considered to be duplicates. This function only works on plain JavaScript arrays of DOM elements, and is chiefly used internally by jQuery. You probably will never need to use it.
            
+    
            The $.uniqueSort() function searches through an array or an array-like object of DOM elements, sorting the array/array-like, and removing any duplicate nodes. A node is considered a duplicate if it is the exact same node as one already in the input; two different nodes with identical attributes are not considered to be duplicates. This function only works on plain JavaScript arrays/array-like objects of DOM elements, and is chiefly used internally by jQuery. You probably will never need to use it.
            
     
            Prior to jQuery 3.0, this method was called jQuery.unique().
            
     
            As of jQuery 1.4 the results will always be returned in document order.
            
               
   
     Removes any duplicate elements from the array of divs.
     
     
Date: Mon, 9 Jan 2023 18:50:07 +0100
Subject: [PATCH 625/699] 3.1.6

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 864b3e95..5c1d6814 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.1.5",
+  "version": "3.1.6",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index e4e29229..3a8268db 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.1.5",
+  "version": "3.1.6",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 8cb4210b5bc77b7ea58d3f9dd9fddc1d90e1db35 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Sun, 15 Jan 2023 22:09:27 +0100
Subject: [PATCH 626/699] All: Update jQuery in examples from 3.5.0 to 3.6.3

---
 entries2html.xsl | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries2html.xsl b/entries2html.xsl
index 44ddfdbf..8b06fadf 100755
--- a/entries2html.xsl
+++ b/entries2html.xsl
@@ -12,7 +12,7 @@
 	<meta charset="utf-8">
 	<title> demo</title>
 	<style>	</style>
-	<script src="https://code.jquery.com/jquery-3.5.0.js"></script>
+	<script src="https://code.jquery.com/jquery-3.6.3.js"></script>
 	<script>
 	
 	</script>

From 8b7a184e25601d1ce2d77a00c860239057991f10 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Sun, 15 Jan 2023 22:09:33 +0100
Subject: [PATCH 627/699] 3.1.7

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 5c1d6814..95ceee66 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.1.6",
+  "version": "3.1.7",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 3a8268db..1d6a6e5b 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.1.6",
+  "version": "3.1.7",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 29bf132340c6f5db7e839ac2788de9456cf0f312 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Mon, 3 Apr 2023 18:45:10 +0200
Subject: [PATCH 628/699] contains-selector: Mark :contains() as a jQuery
 extension

For some reason, the relevant category was missing despite
`:contains()` definitely not being a standard pseudo.

Closes gh-1219
---
 entries/contains-selector.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/entries/contains-selector.xml b/entries/contains-selector.xml
index e1488269..c471083f 100644
--- a/entries/contains-selector.xml
+++ b/entries/contains-selector.xml
@@ -25,5 +25,6 @@ $( "div:contains('John')" ).css( "text-decoration", "underline" );
 ]]>
   
   
+  
   
 

From b415ca6c0f1988da1341467694f3f7927d2a7f00 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Mon, 3 Apr 2023 18:45:41 +0200
Subject: [PATCH 629/699] 3.1.8

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 95ceee66..458a6801 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.1.7",
+  "version": "3.1.8",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 1d6a6e5b..a4ee7333 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.1.7",
+  "version": "3.1.8",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 56301c125ec36d5c9b7b5d61fb7b0f2206aeaa94 Mon Sep 17 00:00:00 2001
From: Timo Tijhof 
Date: Fri, 14 Apr 2023 17:53:53 -0700
Subject: [PATCH 630/699] Build: Add `typesense` and `spider-check` jobs

Ref https://github.com/qunitjs/qunitjs.com/blob/main/docsearch.config.json
Ref https://github.com/jquery/infrastructure-puppet/blob/staging/doc/search.md
---
 .github/workflows/spider-check.yaml | 28 +++++++++++++++++
 .github/workflows/typesense.yaml    | 30 ++++++++++++++++++
 .travis.yml                         |  7 -----
 docsearch.config.json               | 48 +++++++++++++++++++++++++++++
 4 files changed, 106 insertions(+), 7 deletions(-)
 create mode 100644 .github/workflows/spider-check.yaml
 create mode 100644 .github/workflows/typesense.yaml
 delete mode 100644 .travis.yml
 create mode 100644 docsearch.config.json

diff --git a/.github/workflows/spider-check.yaml b/.github/workflows/spider-check.yaml
new file mode 100644
index 00000000..daa13e89
--- /dev/null
+++ b/.github/workflows/spider-check.yaml
@@ -0,0 +1,28 @@
+name: spider-check
+on:
+  # Once a week on Friday at 00:00
+  schedule:
+    - cron: '0 0 * * 5'
+  # Or manually
+  workflow_dispatch:
+  # Or when developing this workflow
+  push:
+    paths:
+      - .github/workflows/spider-check.yaml
+  pull_request:
+    paths:
+      - .github/workflows/spider-check.yaml
+
+jobs:
+  spider-check:
+    env:
+      MY_SITE: https://api.jquery.com
+    runs-on: ubuntu-latest
+    if: ${{ github.repository_owner == 'jquery' }} # skip on forks
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          repository: jquery/hydra-link-checker
+          ref: v2.0.0
+      - name: Run hydra-link-checker
+        run: python3 hydra.py "$MY_SITE"
diff --git a/.github/workflows/typesense.yaml b/.github/workflows/typesense.yaml
new file mode 100644
index 00000000..7d39b05a
--- /dev/null
+++ b/.github/workflows/typesense.yaml
@@ -0,0 +1,30 @@
+name: typesense
+on:
+  # Once a day at 11:30 UTC 
+  schedule:
+    - cron: '30 11 * * *'
+  # Or after a deployment
+  push:
+    branches:
+      - main
+  # Or manually
+  workflow_dispatch:
+
+jobs:
+  typesense:
+    name: Update Typesense
+    if: ${{ github.repository_owner == 'jquery' }} # skip on forks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Docsearch Scraper
+        shell: bash
+        run: |
+          # 0.6.0.rc1: https://github.com/typesense/typesense-docsearch-scraper/issues/36
+          docker run \
+            -e TYPESENSE_API_KEY=${{ secrets.TYPESENSE_ADMIN_KEY }} \
+            -e TYPESENSE_HOST="${{ secrets.TYPESENSE_HOST }}" \
+            -e TYPESENSE_PORT="443" \
+            -e TYPESENSE_PROTOCOL="https" \
+            -e CONFIG="$(cat docsearch.config.json | jq -r tostring)" \
+            typesense/docsearch-scraper:0.6.0.rc2
diff --git a/.travis.yml b/.travis.yml
deleted file mode 100644
index c4177e89..00000000
--- a/.travis.yml
+++ /dev/null
@@ -1,7 +0,0 @@
-language: node_js
-node_js:
-  - "10"
-addons:
-  apt:
-    packages:
-    - libxml2-utils
diff --git a/docsearch.config.json b/docsearch.config.json
new file mode 100644
index 00000000..5325f6f7
--- /dev/null
+++ b/docsearch.config.json
@@ -0,0 +1,48 @@
+{
+  "index_name": "jquery_com",
+  "start_urls": [
+    { "url": "https://jquery.com" },
+    { "url": "https://api.jquery.com", "selectors_key": "api" }
+  ],
+  "stop_urls": [
+    ".com/category/"
+  ],
+  "selectors": {
+    "default": {
+      "lvl0": {
+        "selector": "#menu-top .menu-item.current > a",
+        "global": true,
+        "default_value": "Documentation"
+      },
+      "lvl1": "#content h1",
+      "lvl2": "#content h2",
+      "lvl3": "#content h3",
+      "lvl4": "#content h4",
+      "lvl5": "#content h5",
+      "text": "#content p, #content li, #content tr"
+    },
+    "api": {
+      "lvl0": {
+        "selector": "#categories .cat-item.current-cat > a",
+        "global": true,
+        "default_value": "API"
+      },
+      "lvl1": "#content h1",
+      "lvl2": "#content h2, #content h4.name",
+      "lvl3": "#content h3, #content h4:not(.name)",
+      "lvl4": "#content h5, #content strong:first-child",
+      "text": ".entry-content p, .entry-content li"
+    }
+  },
+  "selectors_exclude": [
+    "header ~ article",
+    ".returns",
+    ".version-details",
+    ".section-title",
+    ".icon-link.toc-link",
+    "[class^=toclevel]",
+    "#toctitle"
+  ],
+  "min_indexed_level": 2,
+  "scrape_start_urls": false
+}

From c149300c7e427aa83a8c38b163f3557f32eadd21 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Mon, 24 Apr 2023 18:43:54 +0200
Subject: [PATCH 631/699] All: Mark event aliases as deprecated

Mark all event shorthands as deprecated, including the AJAX ones. Create
separate pages for deprecated shorthands, for example:
* `/click/` describes the `click` event and how to use it with `.on()` or
  `.trigger()`
* `/click-shorthand/` describes the deprecated `.click()` method
* `/ajaxStart/` describes the `ajaxStart` event and how to use it with `.on()`
* `/ajaxStart-shorthand/` describes the deprecated `.ajaxStart()` method

The reason for such an approach is that event pages often contained useful
information about those specific events and we didn't want to lose that. Also,
the new shorthand pages all look the same and mostly redirect to the event
pages so we didn't want to treat them as the primary page to go to when
searching for an event.

To make it less confusing, both the event page & its associated shorthand
method page link to each other.

Separate shorthand pages have also been created for `.load()`, `.unload()`
and `.error()` methods. Those methods have already been removed in jQuery 3.0
but they also contained useful info about the associated events so it made
sense to treat them like other event shorthands.

Because there's no way to include both `.on()` & `.trigger()` usage in a single
entry, event pages (except for AJAX ones) now have two entries each. This
required wrapping the previous single `` with the new ``. To
maintain Git history, the inner `` tags are left de-indented.

Usage of deprecated event shorthand methods have been removed across all
API entries.

Fixes gh-1205
Closes gh-1223
---
 entries/ajaxComplete-shorthand.xml            | 19 +++++
 entries/ajaxComplete.xml                      | 37 +++++----
 entries/ajaxError-shorthand.xml               | 19 +++++
 entries/ajaxError.xml                         | 36 ++++----
 entries/ajaxSend-shorthand.xml                | 19 +++++
 entries/ajaxSend.xml                          | 37 +++++----
 entries/ajaxStart-shorthand.xml               | 19 +++++
 entries/ajaxStart.xml                         | 33 +++++---
 entries/ajaxStop-shorthand.xml                | 19 +++++
 entries/ajaxStop.xml                          | 31 ++++---
 entries/ajaxSuccess-shorthand.xml             | 19 +++++
 entries/ajaxSuccess.xml                       | 35 ++++----
 entries/animate.xml                           | 24 +++---
 entries/animated-selector.xml                 |  2 +-
 entries/attr.xml                              |  6 +-
 entries/bind.xml                              |  4 +-
 entries/blur-shorthand.xml                    | 37 +++++++++
 entries/blur.xml                              | 72 ++++++++++------
 entries/button-selector.xml                   |  4 +-
 entries/change-shorthand.xml                  | 36 ++++++++
 entries/change.xml                            | 77 ++++++++++-------
 entries/checkbox-selector.xml                 |  4 +-
 entries/children.xml                          |  4 +-
 entries/clearQueue.xml                        |  4 +-
 entries/click-shorthand.xml                   | 36 ++++++++
 entries/click.xml                             | 71 +++++++++-------
 entries/contextmenu-shorthand.xml             | 36 ++++++++
 entries/contextmenu.xml                       | 59 ++++++++-----
 entries/css.xml                               |  4 +-
 entries/data.xml                              |  2 +-
 entries/dblclick-shorthand.xml                | 36 ++++++++
 entries/dblclick.xml                          | 73 ++++++++++-------
 entries/delay.xml                             |  2 +-
 entries/delegate.xml                          |  2 +-
 entries/dequeue.xml                           |  2 +-
 entries/detach.xml                            |  4 +-
 entries/each.xml                              | 12 +--
 entries/empty.xml                             |  4 +-
 entries/error-shorthand.xml                   | 37 +++++++++
 entries/error.xml                             | 58 ++++++++-----
 entries/event.currentTarget.xml               |  4 +-
 entries/event.isDefaultPrevented.xml          |  2 +-
 .../event.isImmediatePropagationStopped.xml   |  2 +-
 entries/event.isPropagationStopped.xml        |  4 +-
 entries/event.metaKey.xml                     |  2 +-
 entries/event.namespace.xml                   |  2 +-
 entries/event.preventDefault.xml              |  2 +-
 entries/event.relatedTarget.xml               |  4 +-
 entries/event.result.xml                      |  4 +-
 entries/event.stopImmediatePropagation.xml    |  6 +-
 entries/event.stopPropagation.xml             |  2 +-
 entries/event.target.xml                      |  4 +-
 entries/event.timeStamp.xml                   |  2 +-
 entries/event.type.xml                        |  2 +-
 entries/fadeIn.xml                            |  8 +-
 entries/fadeOut.xml                           | 10 +--
 entries/fadeTo.xml                            | 22 ++---
 entries/fadeToggle.xml                        | 10 +--
 entries/file-selector.xml                     |  8 +-
 entries/focus-shorthand.xml                   | 37 +++++++++
 entries/focus.xml                             | 82 +++++++++++--------
 entries/focusin-shorthand.xml                 | 37 +++++++++
 entries/focusin.xml                           | 52 ++++++++----
 entries/focusout-shorthand.xml                | 37 +++++++++
 entries/focusout.xml                          | 64 +++++++++------
 entries/get.xml                               |  2 +-
 entries/height.xml                            |  6 +-
 entries/hide.xml                              | 12 +--
 entries/hover.xml                             | 19 +++--
 entries/html.xml                              |  2 +-
 entries/image-selector.xml                    |  8 +-
 entries/index.xml                             |  2 +-
 entries/input-selector.xml                    |  4 +-
 entries/is.xml                                |  8 +-
 entries/jQuery.ajax.xml                       |  2 +-
 entries/jQuery.ajaxSetup.xml                  |  2 +-
 entries/jQuery.data.xml                       |  4 +-
 entries/jQuery.dequeue.xml                    |  2 +-
 entries/jQuery.fx.interval.xml                |  2 +-
 entries/jQuery.fx.off.xml                     |  6 +-
 entries/jQuery.getScript.xml                  |  8 +-
 entries/jQuery.post.xml                       |  6 +-
 entries/jQuery.queue.xml                      | 14 ++--
 entries/jQuery.sub.xml                        |  2 +-
 entries/jQuery.xml                            |  4 +-
 entries/keydown-shorthand.xml                 | 36 ++++++++
 entries/keydown.xml                           | 75 ++++++++++-------
 entries/keypress-shorthand.xml                | 36 ++++++++
 entries/keypress.xml                          | 75 ++++++++++-------
 entries/keyup-shorthand.xml                   | 36 ++++++++
 entries/keyup.xml                             | 77 ++++++++++-------
 entries/length.xml                            |  4 +-
 entries/live.xml                              |  2 +-
 entries/load-event.xml                        | 63 ++++++++------
 entries/load-shorthand.xml                    | 40 +++++++++
 entries/map.xml                               |  4 +-
 entries/mousedown-shorthand.xml               | 36 ++++++++
 entries/mousedown.xml                         | 69 ++++++++++------
 entries/mouseenter-shorthand.xml              | 36 ++++++++
 entries/mouseenter.xml                        | 75 ++++++++++-------
 entries/mouseleave-shorthand.xml              | 36 ++++++++
 entries/mouseleave.xml                        | 75 ++++++++++-------
 entries/mousemove-shorthand.xml               | 36 ++++++++
 entries/mousemove.xml                         | 75 ++++++++++-------
 entries/mouseout-shorthand.xml                | 36 ++++++++
 entries/mouseout.xml                          | 73 ++++++++++-------
 entries/mouseover-shorthand.xml               | 36 ++++++++
 entries/mouseover.xml                         | 75 ++++++++++-------
 entries/mouseup-shorthand.xml                 | 36 ++++++++
 entries/mouseup.xml                           | 69 ++++++++++------
 entries/nth-child-selector.xml                |  2 +-
 entries/nth-last-child-selector.xml           |  2 +-
 entries/nth-last-of-type-selector.xml         |  2 +-
 entries/off.xml                               |  4 +-
 entries/offset.xml                            |  2 +-
 entries/on.xml                                |  2 +-
 entries/parents.xml                           |  2 +-
 entries/password-selector.xml                 |  8 +-
 entries/prev.xml                              |  2 +-
 entries/prop.xml                              |  4 +-
 entries/queue.xml                             | 14 ++--
 entries/radio-selector.xml                    |  8 +-
 entries/remove.xml                            |  6 +-
 entries/removeAttr.xml                        |  2 +-
 entries/replaceWith.xml                       |  4 +-
 entries/reset-selector.xml                    |  8 +-
 entries/resize-shorthand.xml                  | 36 ++++++++
 entries/resize.xml                            | 57 ++++++++-----
 entries/scroll-shorthand.xml                  | 36 ++++++++
 entries/scroll.xml                            | 69 ++++++++++------
 entries/select-shorthand.xml                  | 36 ++++++++
 entries/select.xml                            | 69 ++++++++++------
 entries/selected-selector.xml                 |  6 +-
 entries/serializeArray.xml                    | 10 +--
 entries/show.xml                              | 16 ++--
 entries/size.xml                              |  6 +-
 entries/slice.xml                             |  2 +-
 entries/slideDown.xml                         | 18 ++--
 entries/slideToggle.xml                       |  6 +-
 entries/slideUp.xml                           |  8 +-
 entries/stop.xml                              |  6 +-
 entries/submit-selector.xml                   | 10 +--
 entries/submit-shorthand.xml                  | 36 ++++++++
 entries/submit.xml                            | 67 +++++++++------
 entries/text-selector.xml                     |  8 +-
 entries/toggle.xml                            | 10 +--
 entries/toggleClass.xml                       | 10 +--
 entries/trigger.xml                           | 12 +--
 entries/triggerHandler.xml                    | 12 +--
 entries/unbind.xml                            |  4 +-
 entries/undelegate.xml                        |  4 +-
 entries/unload-shorthand.xml                  | 37 +++++++++
 entries/unload.xml                            | 55 ++++++++-----
 entries/unwrap.xml                            |  2 +-
 entries/val.xml                               | 10 +--
 entries/visible-selector.xml                  |  8 +-
 entries/width.xml                             | 12 +--
 notes.xsl                                     |  9 +-
 pages/Types.html                              | 10 +--
 159 files changed, 2497 insertions(+), 1042 deletions(-)
 create mode 100644 entries/ajaxComplete-shorthand.xml
 create mode 100644 entries/ajaxError-shorthand.xml
 create mode 100644 entries/ajaxSend-shorthand.xml
 create mode 100644 entries/ajaxStart-shorthand.xml
 create mode 100644 entries/ajaxStop-shorthand.xml
 create mode 100644 entries/ajaxSuccess-shorthand.xml
 create mode 100644 entries/blur-shorthand.xml
 create mode 100644 entries/change-shorthand.xml
 create mode 100644 entries/click-shorthand.xml
 create mode 100644 entries/contextmenu-shorthand.xml
 create mode 100644 entries/dblclick-shorthand.xml
 create mode 100644 entries/error-shorthand.xml
 create mode 100644 entries/focus-shorthand.xml
 create mode 100644 entries/focusin-shorthand.xml
 create mode 100644 entries/focusout-shorthand.xml
 create mode 100644 entries/keydown-shorthand.xml
 create mode 100644 entries/keypress-shorthand.xml
 create mode 100644 entries/keyup-shorthand.xml
 create mode 100644 entries/load-shorthand.xml
 create mode 100644 entries/mousedown-shorthand.xml
 create mode 100644 entries/mouseenter-shorthand.xml
 create mode 100644 entries/mouseleave-shorthand.xml
 create mode 100644 entries/mousemove-shorthand.xml
 create mode 100644 entries/mouseout-shorthand.xml
 create mode 100644 entries/mouseover-shorthand.xml
 create mode 100644 entries/mouseup-shorthand.xml
 create mode 100644 entries/resize-shorthand.xml
 create mode 100644 entries/scroll-shorthand.xml
 create mode 100644 entries/select-shorthand.xml
 create mode 100644 entries/submit-shorthand.xml
 create mode 100644 entries/unload-shorthand.xml

diff --git a/entries/ajaxComplete-shorthand.xml b/entries/ajaxComplete-shorthand.xml
new file mode 100644
index 00000000..73d766d5
--- /dev/null
+++ b/entries/ajaxComplete-shorthand.xml
@@ -0,0 +1,19 @@
+
+
+  .ajaxComplete()
+  Register a handler to be called when Ajax requests complete. This is an AjaxEvent.
+  
+    1.0
+    
+      The function to be invoked.
+    
+  
+  
+    
            
+      
            This API is deprecated. Use .on( "ajaxComplete", handler ) instead.
            
+    
            
+              
+  
+  
+  
+            
diff --git a/entries/ajaxComplete.xml b/entries/ajaxComplete.xml
index f96dc4cf..168865e7 100644
--- a/entries/ajaxComplete.xml
+++ b/entries/ajaxComplete.xml
@@ -1,8 +1,12 @@
 
-
-  .ajaxComplete()
+
+  ajaxComplete event
+  Register a handler to be called when Ajax requests complete. This is an AjaxEvent.
   
-    1.0
+    1.7
+    
+      The string "ajaxComplete".
+    
           
       
       
@@ -10,9 +14,11 @@
       The function to be invoked.
     
   
-  Register a handler to be called when Ajax requests complete. This is an AjaxEvent.
   
-    
            Whenever an Ajax request completes, jQuery triggers the ajaxComplete event. Any and all handlers that have been registered with the .ajaxComplete() method are executed at this time.
            
+    
            
+      
            This page describes the ajaxComplete event. For the deprecated .ajaxComplete() method, see .ajaxComplete().
            
+    
            
+    
            Whenever an Ajax request completes, jQuery triggers the ajaxComplete event. Any and all registered ajaxComplete handlers are executed at this time.
            
     
            To observe this method in action, set up a basic Ajax load request:
            
     
            
 <div class="trigger">Trigger</div>
@@ -21,38 +27,39 @@
     
            
     
            Attach the event handler to the document:
            
     
            
-$( document ).ajaxComplete(function() {
+$( document ).on( "ajaxComplete", function() {
   $( ".log" ).text( "Triggered ajaxComplete handler." );
-});
+} );
     
            
     
            Now, make an Ajax request using any jQuery method:
            
     
            
-$( ".trigger" ).click(function() {
+$( ".trigger)" ).on( "click", function() {
   $( ".result" ).load( "ajax/test.html" );
-});
+} );
     
            
     
            When the user clicks the element with class trigger and the Ajax request completes, the log message is displayed.
            
     
            All ajaxComplete handlers are invoked, regardless of what Ajax request was completed. If you must differentiate between the requests, use the parameters passed to the handler. Each time an ajaxComplete handler is executed, it is passed the event object, the XMLHttpRequest object, and the settings object that was used in the creation of the request. For example, you can restrict the callback to only handling events dealing with a particular URL:
            
     
            
-$( document ).ajaxComplete(function( event, xhr, settings ) {
+$( document ).on( "ajaxComplete", function( event, xhr, settings ) {
   if ( settings.url === "ajax/test.html" ) {
     $( ".log" ).text( "Triggered ajaxComplete handler. The result is " +
       xhr.responseText );
   }
-});
+} );
     
            
     
            Note: You can get the returned Ajax contents by looking at xhr.responseText.
            
               
-  
-  
+  
+  
   
     Show a message when an Ajax request completes.
     Request Complete." );
-});
+} );
 ]]>
   
   
   
+  
             
diff --git a/entries/ajaxError-shorthand.xml b/entries/ajaxError-shorthand.xml
new file mode 100644
index 00000000..c1a306bd
--- /dev/null
+++ b/entries/ajaxError-shorthand.xml
@@ -0,0 +1,19 @@
+
+
+  .ajaxError()
+  Register a handler to be called when Ajax requests complete with an error. This is an Ajax Event.
+  
+    1.0
+    
+      The function to be invoked.
+    
+  
+  
+    
            
+      
            This API is deprecated. Use .on( "ajaxError", handler ) instead.
            
+    
            
+              
+  
+  
+  
+            
diff --git a/entries/ajaxError.xml b/entries/ajaxError.xml
index 19abee09..d18cf977 100644
--- a/entries/ajaxError.xml
+++ b/entries/ajaxError.xml
@@ -1,8 +1,12 @@
 
-
-  .ajaxError()
+
+  ajaxError event
+  Register a handler to be called when Ajax requests complete with an error. This is an Ajax Event.
   
-    1.0
+    1.7
+    
+      The string "ajaxError".
+    
     
       The function to be invoked.
       
@@ -11,9 +15,11 @@
          
     
   
-  Register a handler to be called when Ajax requests complete with an error. This is an Ajax Event.
   
-    
            Whenever an Ajax request completes with an error, jQuery triggers the ajaxError event. Any and all handlers that have been registered with the .ajaxError() method are executed at this time. Note: This handler is not called for cross-domain script and cross-domain JSONP requests.
            
+    
            
+      
            This page describes the ajaxError event. For the deprecated .ajaxError() method, see .ajaxError().
            
+    
            
+    
            Whenever an Ajax request completes with an error, jQuery triggers the ajaxError event. Any and all registered ajaxError handlers are executed at this time. Note: This handler is not called for cross-domain script and cross-domain JSONP requests.
            
     
            To observe this method in action, set up a basic Ajax load request.
            
     
            
 <button class="trigger">Trigger</button>
@@ -22,35 +28,37 @@
     
            
     
            Attach the event handler to the document:
            
     
            
-$( document ).ajaxError(function() {
+$( document ).on( "ajaxError", function() {
   $( ".log" ).text( "Triggered ajaxError handler." );
-});
+} );
     
            
     
            Now, make an Ajax request using any jQuery method:
            
     
            
 $( "button.trigger" ).on( "click", function() {
   $( "div.result" ).load( "ajax/missing.html" );
-});
+} );
     
            
     
            When the user clicks the button and the Ajax request fails, because the requested file is missing, the log message is displayed.
            
     
            All ajaxError handlers are invoked, regardless of what Ajax request was completed. To differentiate between the requests, use the parameters passed to the handler. Each time an ajaxError handler is executed, it is passed the event object, the jqXHR object (prior to jQuery 1.5, the XHR object), and the settings object that was used in the creation of the request. When an HTTP error occurs, the fourth argument (thrownError) receives the textual portion of the HTTP status, such as "Not Found" or "Internal Server Error." For example, to restrict the error callback to only handling events dealing with a particular URL:
            
     
            
-$( document ).ajaxError(function( event, jqxhr, settings, thrownError ) {
+$( document ).on( "ajaxError", function( event, jqxhr, settings, thrownError ) {
   if ( settings.url == "ajax/missing.html" ) {
     $( "div.log" ).text( "Triggered ajaxError handler." );
   }
-});
            
+} );
+    
            
               
-  
-  
+  
+  
   
     Show a message when an Ajax request fails.
     Error requesting page " + settings.url + "" );
-});
+} );
 ]]>
   
   
   
+  
 
diff --git a/entries/ajaxSend-shorthand.xml b/entries/ajaxSend-shorthand.xml
new file mode 100644
index 00000000..4c1dc9cc
--- /dev/null
+++ b/entries/ajaxSend-shorthand.xml
@@ -0,0 +1,19 @@
+
+
+  .ajaxSend()
+  Attach a function to be executed before an Ajax request is sent. This is an Ajax Event.
+  
+    1.0
+    
+      The function to be invoked.
+    
+  
+  
+    
            
+      
            This API is deprecated. Use .on( "ajaxSend", handler ) instead.
            
+    
            
+              
+  
+  
+  
+            
diff --git a/entries/ajaxSend.xml b/entries/ajaxSend.xml
index db814fee..ad01194e 100644
--- a/entries/ajaxSend.xml
+++ b/entries/ajaxSend.xml
@@ -1,8 +1,12 @@
 
-
-  .ajaxSend()
+
+  ajaxSend event
+  Attach a function to be executed before an Ajax request is sent. This is an Ajax Event.
   
-    1.0
+    1.7
+    
+      The string "ajaxSend".
+    
     
       The function to be invoked.
       
@@ -10,9 +14,11 @@
       
     
   
-  Attach a function to be executed before an Ajax request is sent. This is an Ajax Event.
   
-    
            Whenever an Ajax request is about to be sent, jQuery triggers the ajaxSend event. Any and all handlers that have been registered with the .ajaxSend() method are executed at this time.
            
+    
            
+      
            This page describes the ajaxSend event. For the deprecated .ajaxSend() method, see .ajaxSend().
            
+    
            
+    
            Whenever an Ajax request is about to be sent, jQuery triggers the ajaxSend event. Any and all registerd ajaxSend handlers are executed at this time.
            
     
            To observe this method in action, set up a basic Ajax load request:
            
     
            
 <div class="trigger">Trigger</div>
@@ -21,36 +27,37 @@
     
            
     
            Attach the event handler to the document:
            
     
            
-$( document ).ajaxSend(function() {
+$( document ).on( "ajaxSend", function() {
   $( ".log" ).text( "Triggered ajaxSend handler." );
-});
+} );
     
            
     
            Now, make an Ajax request using any jQuery method:
            
     
            
-$( ".trigger" ).click(function() {
+$( ".trigger)" ).on( "click", function() {
   $( ".result" ).load( "ajax/test.html" );
-});
+} );
     
            
     
            When the user clicks the element with class trigger and the Ajax request is about to begin, the log message is displayed.
            
     
            All ajaxSend handlers are invoked, regardless of what Ajax request is to be sent. If you must differentiate between the requests, use the parameters passed to the handler. Each time an ajaxSend handler is executed, it is passed the event object, the jqXHR object (in version 1.4, XMLHttpRequestobject), and the settings object that was used in the creation of the Ajax request. For example, you can restrict the callback to only handling events dealing with a particular URL:
            
     
            
-$( document ).ajaxSend(function( event, jqxhr, settings ) {
+$( document ).on( "ajaxSend", function( event, jqxhr, settings ) {
   if ( settings.url == "ajax/test.html" ) {
     $( ".log" ).text( "Triggered ajaxSend handler." );
   }
-});
+} );
     
            
               
-  
-  
+  
+  
   
     Show a message before an Ajax request is sent.
     Starting request at " + settings.url + "" );
-});
+} );
 ]]>
   
   
   
+  
             
diff --git a/entries/ajaxStart-shorthand.xml b/entries/ajaxStart-shorthand.xml
new file mode 100644
index 00000000..41c7c71a
--- /dev/null
+++ b/entries/ajaxStart-shorthand.xml
@@ -0,0 +1,19 @@
+
+
+  .ajaxStart()
+  Register a handler to be called when the first Ajax request begins. This is an Ajax Event.
+  
+    1.0
+    
+      The function to be invoked.
+    
+  
+  
+    
            
+      
            This API is deprecated. Use .on( "ajaxStart", handler ) instead.
            
+    
            
+              
+  
+  
+  
+            
diff --git a/entries/ajaxStart.xml b/entries/ajaxStart.xml
index bf7fc14a..3d8f4df4 100644
--- a/entries/ajaxStart.xml
+++ b/entries/ajaxStart.xml
@@ -1,15 +1,21 @@
 
-
-  .ajaxStart()
+
+  ajaxStart event
+  Register a handler to be called when the first Ajax request begins. This is an Ajax Event.
   
-    1.0
+    1.7
+    
+      The string "ajaxStart".
+    
     
       The function to be invoked.
     
   
-  Register a handler to be called when the first Ajax request begins. This is an Ajax Event.
   
-    
            Whenever an Ajax request is about to be sent, jQuery checks whether there are any other outstanding Ajax requests. If none are in progress, jQuery triggers the ajaxStart event. Any and all handlers that have been registered with the .ajaxStart() method are executed at this time.
            
+    
            
+      
            This page describes the ajaxStart event. For the deprecated .ajaxStart() method, see .ajaxStart().
            
+    
            
+    
            Whenever an Ajax request is about to be sent, jQuery checks whether there are any other outstanding Ajax requests. If none are in progress, jQuery triggers the ajaxStart event. Any and all handlers that have been registered with .on( "ajaxStart", ... ) are executed at this time.
            
     
            To observe this method in action, set up a basic Ajax load request:
            
     
            
 <div class="trigger">Trigger</div>
@@ -18,28 +24,29 @@
     
            
     
            Attach the event handler to any element:
            
     
            
-$( document ).ajaxStart(function() {
+$( document ).on( "ajaxStart", function() {
   $( ".log" ).text( "Triggered ajaxStart handler." );
-});
+} );
     
            
     
            Now, make an Ajax request using any jQuery method:
            
     
            
-$( ".trigger" ).click(function() {
+$( ".trigger" ).on( "click", function() {
   $( ".result" ).load( "ajax/test.html" );
-});
+} );
     
            
     
            When the user clicks the element with class trigger and the Ajax request is sent, the log message is displayed.
            
               
-  
-  
+  
+  
   
     Show a loading message whenever an Ajax request starts (and none is already active).
     
   
   
   
+  
             
diff --git a/entries/ajaxStop-shorthand.xml b/entries/ajaxStop-shorthand.xml
new file mode 100644
index 00000000..e4b5ab83
--- /dev/null
+++ b/entries/ajaxStop-shorthand.xml
@@ -0,0 +1,19 @@
+
+
+  .ajaxStop()
+  Register a handler to be called when all Ajax requests have completed. This is an Ajax Event.
+  
+    1.0
+    
+      The function to be invoked.
+    
+  
+  
+    
            
+      
            This API is deprecated. Use .on( "ajaxStop", handler ) instead.
            
+    
            
+              
+  
+  
+  
+            
diff --git a/entries/ajaxStop.xml b/entries/ajaxStop.xml
index 073dd208..f42c7444 100644
--- a/entries/ajaxStop.xml
+++ b/entries/ajaxStop.xml
@@ -1,15 +1,21 @@
 
-
-  .ajaxStop()
+
+  ajaxStop event
   Register a handler to be called when all Ajax requests have completed. This is an Ajax Event.
   
-    1.0
+    1.7
+    
+      The string "ajaxStop".
+    
     
       The function to be invoked.
     
   
   
-    
            Whenever an Ajax request completes, jQuery checks whether there are any other outstanding Ajax requests. If none remain, jQuery triggers the ajaxStop event. Any and all handlers that have been registered with the .ajaxStop() method are executed at this time. The ajaxStop event is also triggered if the last outstanding Ajax request is cancelled by returning false within the beforeSend callback function. 
            
+    
            
+      
            This page describes the ajaxStop event. For the deprecated .ajaxStop() method, see .ajaxStop().
            
+    
            
+    
            Whenever an Ajax request completes, jQuery checks whether there are any other outstanding Ajax requests. If none remain, jQuery triggers the ajaxStop event. Any and all registered ajaxStop handlers are executed at this time. The ajaxStop event is also triggered if the last outstanding Ajax request is cancelled by returning false within the beforeSend callback function. 
            
     
            To observe this method in action, set up a basic Ajax load request:
            
     
            
 <div class="trigger">Trigger</div>
@@ -18,28 +24,29 @@
     
            
     
            Attach the event handler to the document:
            
     
            
-$( document ).ajaxStop(function() {
+$( document ).on( "ajaxStop", function() {
   $( ".log" ).text( "Triggered ajaxStop handler." );
-});
+} );
     
            
     
            Now, make an Ajax request using any jQuery method:
            
     
            
-$( ".trigger" ).click(function() {
+$( ".trigger" ).on( "click", function() {
   $( ".result" ).load( "ajax/test.html" );
-});
+} );
     
            
     
            When the user clicks the element with class trigger and the Ajax request completes, the log message is displayed.
            
               
-  
-  
+  
+  
   
     Hide a loading message after all the Ajax requests have stopped.
     
   
   
   
+  
             
diff --git a/entries/ajaxSuccess-shorthand.xml b/entries/ajaxSuccess-shorthand.xml
new file mode 100644
index 00000000..358b5ff5
--- /dev/null
+++ b/entries/ajaxSuccess-shorthand.xml
@@ -0,0 +1,19 @@
+
+
+  .ajaxSuccess()
+  Attach a function to be executed whenever an Ajax request completes successfully. This is an Ajax Event.
+  
+    1.0
+    
+      The function to be invoked.
+    
+  
+  
+    
            
+      
            This API is deprecated. Use .on( "ajaxSuccess", handler ) instead.
            
+    
            
+              
+  
+  
+  
+            
diff --git a/entries/ajaxSuccess.xml b/entries/ajaxSuccess.xml
index 840ec028..e92a1269 100644
--- a/entries/ajaxSuccess.xml
+++ b/entries/ajaxSuccess.xml
@@ -1,8 +1,12 @@
 
-
-  .ajaxSuccess()
+
+  ajaxSuccess event
+  Attach a function to be executed whenever an Ajax request completes successfully. This is an Ajax Event.
   
-    1.0
+    1.7
+    
+      The string "ajaxSuccess".
+    
     
       The function to be invoked.
       
@@ -11,9 +15,11 @@
         
     
   
-  Attach a function to be executed whenever an Ajax request completes successfully. This is an Ajax Event.
   
-    
            Whenever an Ajax request completes successfully, jQuery triggers the ajaxSuccess event. Any and all handlers that have been registered with the .ajaxSuccess() method are executed at this time.
            
+    
            
+      
            This page describes the ajaxSuccess event. For the deprecated .ajaxSuccess() method, see .ajaxSuccess().
            
+    
            
+    
            Whenever an Ajax request completes successfully, jQuery triggers the ajaxSuccess event. Any and all registered ajaxSuccess handlers are executed at this time.
            
     
            To observe this method in action, set up a basic Ajax load request:
            
     
            
 <div class="trigger">Trigger</div>
@@ -22,38 +28,39 @@
     
            
     
            Attach the event handler to any element:
            
     
            
-$(document).ajaxSuccess(function() {
+$( document ).on( "ajaxSuccess", function() {
   $( ".log" ).text( "Triggered ajaxSuccess handler." );
-});
+} );
     
            
     
            Now, make an Ajax request using any jQuery method:
            
     
            
 $( ".trigger" ).on( "click", function() {
   $( ".result" ).load( "ajax/test.html" );
-});
+} );
     
            
     
            When the user clicks the element with class trigger and the Ajax request completes successfully, the log message is displayed.
            
     
            All ajaxSuccess handlers are invoked, regardless of what Ajax request was completed. If you must differentiate between the requests, you can use the parameters passed to the handler. Each time an ajaxSuccess handler is executed, it is passed the event object, the XMLHttpRequest object, and the settings object that was used in the creation of the request. For example, you can restrict the callback to only handling events dealing with a particular URL:
            
     
            
-$( document ).ajaxSuccess(function( event, xhr, settings ) {
+$( document ).on( "ajaxSuccess", function( event, xhr, settings ) {
   if ( settings.url == "ajax/test.html" ) {
     $( ".log" ).text( "Triggered ajaxSuccess handler. The Ajax response was: " +
       xhr.responseText );
   }
-});
+} );
     
            
     
            Note: You can get the returned Ajax contents by looking at xhr.responseXML or xhr.responseText for xml and html respectively.
            
               
-  
-  
+  
+  
   
     Show a message when an Ajax request completes successfully.
     Successful Request!" );
-});
+} );
 ]]>
   
   
   
+  
             
diff --git a/entries/animate.xml b/entries/animate.xml
index 57af4823..1ece251c 100644
--- a/entries/animate.xml
+++ b/entries/animate.xml
@@ -45,7 +45,7 @@
     
            
     
            To animate the opacity, left offset, and height of the image simultaneously:
            
     
            
-$( "#clickme" ).click(function() {
+$( "#clickme)" ).on( "click", function() {
   $( "#book" ).animate({
     opacity: 0.25,
     left: "+=50",
@@ -101,7 +101,7 @@ $( "li" ).animate({
     
            As of jQuery version 1.4, you can set per-property easing functions within a single .animate() call. In the first version of .animate(), each property can take an array as its value: The first member of the array is the CSS property and the second member is an easing function.  If a per-property easing function is not defined for a particular property, it uses the value of the .animate() method's optional easing argument. If the easing argument is not defined, the default swing function is used.
            
     
            For example, to simultaneously animate the width and height with the swing easing function and the opacity with the linear easing function:
            
     
            
-$( "#clickme" ).click(function() {
+$( "#clickme)" ).on( "click", function() {
   $( "#book" ).animate({
     width: [ "toggle", "swing" ],
     height: [ "toggle", "swing" ],
@@ -113,7 +113,7 @@ $( "#clickme" ).click(function() {
     
            
     
            In the second version of .animate(), the options object can include the specialEasing property, which is itself an object of CSS properties and their corresponding easing functions.  For example, to simultaneously animate the width using the linear easing function and the height using the easeOutBounce easing function:
            
     
            
-$( "#clickme" ).click(function() {
+$( "#clickme)" ).on( "click", function() {
   $( "#book" ).animate({
     width: "toggle",
     height: "toggle"
@@ -137,7 +137,7 @@ $( "#clickme" ).click(function() {
     
     Animates a div's left property with a relative value. Click several times on the buttons to see the relative animations queued up.
     
@@ -191,7 +191,7 @@ $( "#left" ).click(function(){
 
 The second button starts a traditional chained animation, where each animation will start once the previous animation on the element has completed.
     
     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. 
     
     Change the color of any div that is animated.
     Display the checked attribute and property of a checkbox as it changes.
       " + $input.attr( "checked" ) + "
            " +
       ".prop( 'checked' ): " + $input.prop( "checked" ) + "
            " +
       ".is( ':checked' ): " + $input.is( ":checked" ) + "" );
-  })
-  .change();
+  } )
+  .trigger( "change" );
 ]]>            
       As of jQuery 3.0, .bind() has been deprecated. It was superseded by the .on() method for attaching event handlers to a document since jQuery 1.7, so its use was already discouraged. For earlier versions, the .bind() method is used for attaching an event handler directly to elements. Handlers are attached to the currently selected elements in the jQuery object, so those elements must exist at the point the call to .bind() occurs. For more flexible event binding, see the discussion of event delegation in .on().
            
     
            Any string is legal for eventType; if the string is not the name of a native DOM event, then the handler is bound to a custom event. These events are never called by the browser, but may be triggered manually from other JavaScript code using .trigger() or .triggerHandler().
            
     
            If the eventType string contains a period (.) character, then the event is namespaced. The period character separates the event from its namespace. For example, in the call .bind( "click.name", handler ), the string click is the event type, and the string name is the namespace. Namespacing allows us to unbind or trigger some events of a type without affecting others. See the discussion of .unbind() for more information.
            
-    
            There are shorthand methods for some standard browser events such as .click() that can be used to attach or trigger event handlers. For a complete list of shorthand methods, see the events category.
            
+    
            Some events have dedicated pages, describing specifics of their usage. For a complete list of those events, see the events category.
            
     
            When an event reaches an element, all handlers bound to that event type for the element are fired. If there are multiple handlers registered, they will always execute in the order in which they were bound. After all handlers have executed, the event continues along the normal event propagation path.
            
     
            A basic usage of .bind() is:
            
     
            
@@ -221,7 +221,7 @@ $( "p" ).bind( "myCustomEvent", function( e, myName, myValue ) {
     .fadeIn( 30 )
     .fadeOut( 1000 );
   });
-$( "button" ).click(function() {
+$( "button)" ).on( "click", function() {
   $( "p" ).trigger( "myCustomEvent", [ "John" ] );
 });
 ]]>
diff --git a/entries/blur-shorthand.xml b/entries/blur-shorthand.xml
new file mode 100644
index 00000000..589a1ceb
--- /dev/null
+++ b/entries/blur-shorthand.xml
@@ -0,0 +1,37 @@
+
+
+  .blur()
+  Bind an event handler to the "blur" event, or trigger that event on an element.
+  
+    1.0
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.4.3
+    
+      An object containing data that will be passed to the event handler.
+    
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.0
+  
+  
+    
            
+      
            This API is deprecated.
            
+      
            Instead of .blur( handler ) or .blur( eventData, handler ), use .on( "blur", handler ) or .on( "blur", eventData, handler ), respectively.
            
+      
            Instead of .blur(), use .trigger( "blur" ).
            
+    
            
+              
+  
+  
+  
+  
+  
+            
diff --git a/entries/blur.xml b/entries/blur.xml
index 11afbd6a..d99003e9 100644
--- a/entries/blur.xml
+++ b/entries/blur.xml
@@ -1,16 +1,15 @@
 
-
-  .blur()
-  Bind an event handler to the "blur" JavaScript event, or trigger that event on an element.
+
+
+Bind an event handler to the "blur" event, or trigger that event on an element.
+
+  blur event
+  Bind an event handler to the "blur" event.
   
-    1.0
-    
-      A function to execute each time the event is triggered.
-      
+    1.7
+    
+      The string "blur".
     
-  
-  
-    1.4.3
     
       An object containing data that will be passed to the event handler.
     
@@ -19,11 +18,10 @@
       
     
   
-  
-    1.0
-  
   
-    
            This method is a shortcut for .on( "blur", handler ) in the first two variations, and .trigger( "blur" ) in the third.
            
+    
            
+      
            This page describes the blur event. For the deprecated .blur() method, see .blur().
            
+    
            
     
            The blur event is sent to an element when it loses focus. Originally, this event was only applicable to form elements, such as <input>. In recent browsers, the domain of the event has been extended to include all element types. An element can lose focus via keyboard commands, such as the Tab key, or by mouse clicks elsewhere on the page.
            
     
            For example, consider the HTML:
            
     
            
@@ -34,33 +32,53 @@
 <div id="other">
   Trigger the handler
 </div>
-The event handler can be bound to the first input field:
-$( "#target" ).blur(function() {
-  alert( "Handler for .blur() called." );
-});
+    
            
+    
            The event handler can be bound to the first input field:
            
+    
            
+$( "#target" ).on( "blur", function() {
+  alert( "Handler for `blur` called." );
+} );
     
            
     
            Now if the first field has the focus, clicking elsewhere or tabbing away from it displays the alert:
            
     
            
-      Handler for .blur() called.
+      Handler for `blur` called.
     
            
-    
            To trigger the event programmatically, apply .blur() without an argument:
            
+    
            To trigger the event programmatically, call .trigger( "blur" ):
            
     
            
-$( "#other" ).click(function() {
-  $( "#target" ).blur();
-});
+$( "#other" ).on( "click", function() {
+  $( "#target" ).trigger( "blur" );
+} );
     
            
     
            After this code executes, clicks on Trigger the handler will also alert the message.
            
-    
            The blur event does not bubble in Internet Explorer. Therefore, scripts that rely on event delegation with the blur event will not work consistently across browsers. As of version 1.4.2, however, jQuery works around this limitation by mapping blur to the focusout event in its event delegation methods, .live() and .delegate().
            
+    
            The blur event does not bubble. As of version 1.4.2, jQuery works around this limitation by mapping blur to the focusout event in its event delegation methods.
            
               
-  
   
     To trigger the blur event on all paragraphs:
     
   
   
   
   
-  
+  
+            
+
+
+  blur event
+  Trigger the "blur" event on an element.
+  
+    1.0
+    
+      The string "blur".
+    
+  
+  
+    
            See the description for .on( "blur", ... ).
            
+              
+  
+  
+  
             
+
+            
diff --git a/entries/button-selector.xml b/entries/button-selector.xml
index 858522e5..12c8471c 100644
--- a/entries/button-selector.xml
+++ b/entries/button-selector.xml
@@ -16,9 +16,9 @@
 var input = $( ":button" ).addClass( "marked" );
 $( "div" ).text( "For this type jQuery found " + input.length + "." );
 // Prevent the form from submitting
-$( "form" ).submit(function( event ) {
+$( "form" ).on( "submit", function( event ) {
   event.preventDefault();
-});
+} );
 ]]>            
     
+
+  .change()
+  Bind an event handler to the "change" event, or trigger that event on an element.
+  
+    1.0
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.4.3
+    
+      An object containing data that will be passed to the event handler.
+    
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.0
+  
+  
+    
            
+      
            This API is deprecated.
            
+      
            Instead of .change( handler ) or .change( eventData, handler ), use .on( "change", handler ) or .on( "change", eventData, handler ), respectively.
            
+      
            Instead of .change(), use .trigger( "change" ).
            
+    
            
+              
+  
+  
+  
+  
+            
diff --git a/entries/change.xml b/entries/change.xml
index 67d521d9..e179c506 100644
--- a/entries/change.xml
+++ b/entries/change.xml
@@ -1,16 +1,15 @@
 
-
-  .change()
-  Bind an event handler to the "change" JavaScript event, or trigger that event on an element.
+
+Bind an event handler to the "change" event, or trigger that event on an element.
+
+
+  change event
+  Bind an event handler to the "change" event.
   
-    1.0
-    
-      A function to execute each time the event is triggered.
-      
+    1.7
+    
+      The string "change".
     
-  
-  
-    1.4.3
     
       An object containing data that will be passed to the event handler.
     
@@ -19,11 +18,10 @@
       
     
   
-  
-    1.0
-  
   
-    
            This method is a shortcut for .on( "change", handler ) in the first two variations, and .trigger( "change" ) in the third.
            
+    
            
+      
            This page describes the change event. For the deprecated .change() method, see .change().
            
+    
            
     
            The change event is sent to an element when its value changes. This event is limited to <input> elements, <textarea> boxes and <select> elements. For select boxes, checkboxes, and radio buttons, the event is fired immediately when the user makes a selection with the mouse, but for the other element types the event is deferred until the element loses focus.
            
     
            For example, consider the HTML:
            
     
            
@@ -40,35 +38,34 @@
     
            
     
            The event handler can be bound to the text input and the select box:
            
     
            
-$( ".target" ).change(function() {
-  alert( "Handler for .change() called." );
-});
+$( ".target" ).on( "change", function() {
+  alert( "Handler for `change` called." );
+} );
     
            
-    
            Now when the second option is selected from the dropdown, the alert is displayed. It is also displayed if you change the text in the field and then click away. If the field loses focus without the contents having changed, though, the event is not triggered. To trigger the event manually, apply .change() without arguments:
            
+    
            Now when the second option is selected from the dropdown, the alert is displayed. It is also displayed if you change the text in the field and then click away. If the field loses focus without the contents having changed, though, the event is not triggered. To trigger the event manually, use .trigger( "change" ):
            
     
            
-$( "#other" ).click(function() {
-  $( ".target" ).change();
-});
+$( "#other" ).on( "click", function() {
+  $( ".target" ).trigger( "change" );
+} );
     
            
     
            After this code executes, clicks on Trigger the handler will also alert the message. The message will display twice, because the handler has been bound to the change event on both of the form elements.
            
     
            As of jQuery 1.4, the change event bubbles in Internet Explorer, behaving consistently with the event in other modern browsers.
            
     
            
-	  
            Note: Changing the value of an input element using JavaScript, using .val() for example, won't fire the event.
            
+      
            Note: Changing the value of an input element using JavaScript, using .val() for example, won't fire the event.
            
     
            
               
-  
   
     Attaches a change event to the select that gets the text for each selected option and writes them in the div.  It then triggers the event for the initial text draw.
     
     
     To add a validity test to all text input elements:
     
   
   
   
   
-  
+  
+            
+
+
+  change event
+  Trigger the "change" event on an element.
+  
+    1.0
+    
+      The string "change".
+    
+  
+  
+    
            See the description for .on( "change", ... ).
            
+              
+  
+  
             
+
+            
diff --git a/entries/checkbox-selector.xml b/entries/checkbox-selector.xml
index 843cdaf7..ba0fd815 100644
--- a/entries/checkbox-selector.xml
+++ b/entries/checkbox-selector.xml
@@ -26,9 +26,9 @@ $( "div" )
   .css( "color", "red" );
 
 // Prevent the form from submitting
-$( "form" ).submit(function( event ) {
+$( "form" ).on( "submit", function( event ) {
     event.preventDefault();
-});
+} );
 ]]>            
     
     Find all children of the clicked element.
     
     
     Empty the queue.
     
+
+  .click()
+  Bind an event handler to the "click" event, or trigger that event on an element.
+  
+    1.0
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.4.3
+    
+      An object containing data that will be passed to the event handler.
+    
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.0
+  
+  
+    
            
+      
            This API is deprecated.
            
+      
            Instead of .click( handler ) or .click( eventData, handler ), use .on( "click", handler ) or .on( "click", eventData, handler ), respectively.
            
+      
            Instead of .click(), use .trigger( "click" ).
            
+    
            
+              
+  
+  
+  
+  
+            
diff --git a/entries/click.xml b/entries/click.xml
index 56475da4..c5f9deb2 100644
--- a/entries/click.xml
+++ b/entries/click.xml
@@ -1,16 +1,15 @@
 
-
-  .click()
-  Bind an event handler to the "click" JavaScript event, or trigger that event on an element.
+
+
+Bind an event handler to the "click" event, or trigger that event on an element.
+
+  click event
+  Bind an event handler to the "click" event.
   
-    1.0
-    
-      A function to execute each time the event is triggered.
-      
+    1.7
+    
+      The string "click".
     
-  
-  
-    1.4.3
     
       An object containing data that will be passed to the event handler.
     
@@ -19,12 +18,11 @@
       
     
   
-  
-    1.0
-  
   
-    
            This method is a shortcut for .on( "click", handler ) in the first two variations, and .trigger( "click" ) in the third.
-    The click event is sent to an element when the mouse pointer is over the element, and the mouse button is pressed and released. Any HTML element can receive this event.
+    
            
+      
            This page describes the click event. For the deprecated .click() method, see .click().
            
+    
            
+    
            The click event is sent to an element when the mouse pointer is over the element, and the mouse button is pressed and released. Any HTML element can receive this event.
     For example, consider the HTML:
            
     
            
 <div id="target">
@@ -40,19 +38,19 @@
     
            
     
            The event handler can be bound to any <div>:
            
     
            
-$( "#target" ).click(function() {
-  alert( "Handler for .click() called." );
-});
+$( "#target" ).on( "click", function() {
+  alert( "Handler for `click` called." );
+} );
     
            
     
            Now if we click on this element, the alert is displayed:
            
     
            
-      Handler for .click() called.
+      Handler for `click` called.
     
            
     
            We can also trigger the event when a different element is clicked:
            
     
            
-$( "#other" ).click(function() {
-  $( "#target" ).click();
-});
+$( "#other" ).on( "click", function() {
+  $( "#target" ).trigger( "click" );
+} );
     
            
     
            After this code executes, clicking on Trigger the handler will also alert the message.
            
     
            The click event is only triggered after this exact series of events:
            
@@ -62,13 +60,12 @@ $( "#other" ).click(function() {
     
     
            This is usually the desired sequence before taking an action. If this is not required, the mousedown or mouseup event may be more suitable.
            
               
-  
   
     Hide paragraphs on a page when they are clicked:
     
     
   
   
-    Trigger the click event on all of the paragraphs on the page:
+    Trigger the click event on all the paragraphs on the page:
     
   
   
   
-  
+  
+
+
+
+  click event
+  Trigger the "click" event on an element.
+  
+    1.0
+    
+      The string "click".
+    
+  
+  
+    
            See the description for .on( "click", ... ).
            
+              
+  
+  
             
+
+
diff --git a/entries/contextmenu-shorthand.xml b/entries/contextmenu-shorthand.xml
new file mode 100644
index 00000000..9b1f4873
--- /dev/null
+++ b/entries/contextmenu-shorthand.xml
@@ -0,0 +1,36 @@
+
+
+  .contextmenu()
+  Bind an event handler to the "contextmenu" event, or trigger that event on an element.
+  
+    1.0
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.4.3
+    
+      An object containing data that will be passed to the event handler.
+    
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.0
+  
+  
+    
            
+      
            This API is deprecated.
            
+      
            Instead of .contextmenu( handler ) or .contextmenu( eventData, handler ), use .on( "contextmenu", handler ) or .on( "contextmenu", eventData, handler ), respectively.
            
+      
            Instead of .contextmenu(), use .trigger( "contextmenu" ).
            
+    
            
+              
+  
+  
+  
+  
+            
diff --git a/entries/contextmenu.xml b/entries/contextmenu.xml
index 9849f7e9..63d9c179 100644
--- a/entries/contextmenu.xml
+++ b/entries/contextmenu.xml
@@ -1,7 +1,10 @@
 
-
-  .contextmenu()
-  Bind an event handler to the "contextmenu" JavaScript event, or trigger that event on an element.
+
+Bind an event handler to the "contextmenu" event, or trigger that event on an element.
+
+
+  contextmenu event
+  Bind an event handler to the "contextmenu" event.
   
     1.0
     
@@ -19,12 +22,11 @@
       
     
   
-  
-    1.0
-  
   
-    
            This method is a shortcut for .on( "contextmenu", handler ) in the first two variations, and .trigger( "contextmenu" ) in the third.
-    The contextmenu event is sent to an element when the right button of the mouse is clicked on it, but before the context menu is displayed. In case the context menu key is pressed, the event is triggered on the html element or the currently focused element. Any HTML element can receive this event.
+    
            
+      
            This page describes the contextmenu event. For the deprecated .contextmenu() method, see .contextmenu().
            
+    
            
+    
            The contextmenu event is sent to an element when the right button of the mouse is clicked on it, but before the context menu is displayed. In case the context menu key is pressed, the event is triggered on the html element or the currently focused element. Any HTML element can receive this event.
     For example, consider the HTML:
            
     
            
 <div id="target">
@@ -33,35 +35,34 @@
     
            
     
            The event handler can be bound to the <div> as follows:
            
     
            
-$( "#target" ).contextmenu(function() {
-  alert( "Handler for .contextmenu() called." );
-});
+$( "#target" ).on( "contextmenu", function() {
+  alert( "Handler for `contextmenu` called." );
+} );
     
            
     
            Now right-clicking on this element displays the alert:
            
     
            
-      Handler for .contextmenu() called.
+      Handler for `contextmenu` called.
     
            
-    
            To trigger the event manually, call .contextmenu() without an argument:
            
+    
            To trigger the event manually, use .trigger( "contextmenu" ):
            
     
            
-$( "#target" ).contextmenu();
+$( "#target" ).trigger( "contextmenu" );
     
            
               
-  
   
     To show a "Hello World!" alert box when the contextmenu event is triggered on a paragraph on the page:
     
   
   
     Right click to toggle background color.
     
     
   
   
-  
+  
+            
+
+
+  contextmenu event
+  Trigger the "contextmenu" event on an element.
+  
+    1.0
+    
+      The string "contextmenu".
+    
+  
+  
+    
            See the description for .on( "contextmenu", ... ).
            
+              
+  
+  
             
+
+            
diff --git a/entries/css.xml b/entries/css.xml
index 896cd4ca..0ffce808 100644
--- a/entries/css.xml
+++ b/entries/css.xml
@@ -28,7 +28,7 @@
     
       Get the background color of a clicked div.
       " + color + "." );
@@ -54,7 +54,7 @@ $( "div" ).click(function() {
     
       Get the width, height, text color, and background color of a clicked div.
       
       Get the data named "blah" stored at for an element.
       
+
+  .dblclick()
+  Bind an event handler to the "dblclick" event, or trigger that event on an element.
+  
+    1.0
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.4.3
+    
+      An object containing data that will be passed to the event handler.
+    
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.0
+  
+  
+    
            
+      
            This API is deprecated.
            
+      
            Instead of .dblclick( handler ) or .dblclick( eventData, handler ), use .on( "dblclick", handler ) or .on( "dblclick", eventData, handler ), respectively.
            
+      
            Instead of .dblclick(), use .trigger( "dblclick" ).
            
+    
            
+              
+  
+  
+  
+  
+            
diff --git a/entries/dblclick.xml b/entries/dblclick.xml
index 73833172..9c4cf59a 100644
--- a/entries/dblclick.xml
+++ b/entries/dblclick.xml
@@ -1,16 +1,15 @@
 
-
-  .dblclick()
-  Bind an event handler to the "dblclick" JavaScript event, or trigger that event on an element.
+
+
+Bind an event handler to the "dblclick" event, or trigger that event on an element.
+
+  dblclick event
+  Bind an event handler to the "dblclick" event.
   
-    1.0
-    
-      A function to execute each time the event is triggered.
-      
+    1.7
+    
+      The string "dblclick".
     
-  
-  
-    1.4.3
     
       An object containing data that will be passed to the event handler.
     
@@ -19,12 +18,11 @@
       
     
   
-  
-    1.0
-  
   
-    
            This method is a shortcut for .on( "dblclick", handler ) in the first two variations, and .trigger( "dblclick" ) in the third.
-    The dblclick event is sent to an element when the element is double-clicked. Any HTML element can receive this event.
+    
            
+      
            This page describes the dblclick event. For the deprecated .dblclick() method, see .dblclick().
            
+    
            
+    
            The dblclick event is sent to an element when the element is double-clicked. Any HTML element can receive this event.
     For example, consider the HTML:
            
     
            
 <div id="target">
@@ -40,19 +38,19 @@
     
     
            The event handler can be bound to any <div>:
            
     
            
-$( "#target" ).dblclick(function() {
-  alert( "Handler for .dblclick() called." );
-});
+$( "#target" ).on( "dblclick", function() {
+  alert( "Handler for `dblclick` called." );
+} );
     
            
     
            Now double-clicking on this element displays the alert:
            
     
            
-      Handler for .dblclick() called.
+      Handler for `dblclick` called.
     
            
-    
            To trigger the event manually, call .dblclick() without an argument:
            
+    
            To trigger the event manually, call .trigger( "dblclick" ):
            
     
            
-$( "#other" ).click(function() {
-  $( "#target" ).dblclick();
-});
+$( "#other" ).on( "click", function() {
+  $( "#target" ).trigger( "dblclick" );
+} );
     
            
     
            After this code executes, (single) clicks on Trigger the handler will also alert the message.
            
     
            The dblclick event is only triggered after this exact series of events:
            
@@ -65,22 +63,21 @@ $( "#other" ).click(function() {
     
            It is inadvisable to bind handlers to both the click and dblclick events for the same element. The sequence of events triggered varies from browser to browser, with some receiving two click events before the dblclick and others only one. Double-click sensitivity (maximum time between clicks that is detected as a double click) can vary by operating system and browser, and is often user-configurable.
     
            
   
-  
   
     To bind a "Hello World!" alert box to the dblclick event on every paragraph on the page:
     
   
   
     Double click to toggle background color.
     
     
   
   
-  
+  
+
+
+
+  dblclick event
+  Trigger the "dblclick" event on an element.
+  
+    1.0
+    
+      The string "dblclick".
+    
+  
+  
+    
            See the description for .on( "dblclick", ... ).
            
+              
+  
+  
             
+
+
diff --git a/entries/delay.xml b/entries/delay.xml
index c94b2a0b..2f996d78 100644
--- a/entries/delay.xml
+++ b/entries/delay.xml
@@ -44,7 +44,7 @@ $( "#foo" ).slideUp( 300 ).delay( 800 ).fadeIn( 400 );
   }
 ]]>            
     
diff --git a/entries/dequeue.xml b/entries/dequeue.xml
index 7caca4e3..24f89c3a 100644
--- a/entries/dequeue.xml
+++ b/entries/dequeue.xml
@@ -14,7 +14,7 @@
   
     Use dequeue to end a custom queue function which allows the queue to keep going.
     
     Detach all paragraphs from the DOM
     
     Iterate over three divs and sets their color property.
     
     
     To access a jQuery object instead of the regular DOM element, use $( this ). For example:
     (click here to change)
   
     Use return false to break out of each() loops early.
     
     Removes all child nodes (including text nodes) from all paragraphs
     
     
+
+  .error()
+  Bind an event handler to the "error" event, or trigger that event on an element.
+  
+    1.0
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.4.3
+    
+      An object containing data that will be passed to the event handler.
+    
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.0
+  
+  
+    
            
+      
            This API has been removed in jQuery 3.0.
            
+      
            Instead of .error( handler ) or .error( eventData, handler ), use .on( "error", handler ) or .on( "error", eventData, handler ), respectively.
            
+      
            Instead of .error(), use .trigger( "error" ).
            
+    
            
+              
+  
+  
+  
+  
+  
+            
diff --git a/entries/error.xml b/entries/error.xml
index 47d9e0e9..d1f9493e 100644
--- a/entries/error.xml
+++ b/entries/error.xml
@@ -1,16 +1,15 @@
 
-
-  .error()
-  Bind an event handler to the "error" JavaScript event.
+
+Bind an event handler to the "error" event, or trigger that event on an element.
+
+
+  error event
+  Bind an event handler to the "error" event.
   
-    1.0
-    
-      A function to execute when the event is triggered.
-      
+    1.7
+    
+      The string "error".
     
-  
-  
-    1.4.3
     
       An object containing data that will be passed to the event handler.
     
@@ -21,7 +20,7 @@
   
   
     
            
-      
            Note: This API has been removed in jQuery 3.0; please use .on( "error", handler ) instead of .error( handler ) and .trigger( "error" ) instead of .error().
            
+      
            This page describes the error event. For the .error() method removed in jQuery 3.0, see .error().
            
     
            
     
            The error event is sent to elements, such as images, that are referenced by a document and loaded by the browser. It is called if the element was not loaded correctly.
            
     
            For example, consider a page with a simple image element:
            
@@ -31,35 +30,50 @@
     
            The event handler can be bound to the image:
            
     
            
 $( "#book" )
-  .error(function() {
-    alert( "Handler for .error() called." )
-  })
+  .on( "error", function() {
+    alert( "Handler for `error` called." )
+  } )
   .attr( "src", "missing.png" );
     
            
     
            If the image cannot be loaded (for example, because it is not present at the supplied URL), the alert is displayed:
            
     
            
-      Handler for .error() called.
+      Handler for `error` called.
     
            
     
            
       
            The event handler must be attached before the browser fires the error event, which is why the example sets the src attribute after attaching the handler. Also, the error event may not be correctly fired when the page is served locally; error relies on HTTP status codes and will generally not be triggered if the URL uses the file: protocol.
            
     
            
     
            Note: A jQuery error event handler should not be attached to the window object. The browser fires the window's error event when a script error occurs. However, the window error event receives different arguments and has different return value requirements than conventional event handlers. Use window.onerror instead.
            
               
-  
   
-    To replace all the missing images with another, you can update the src attribute inside the callback passed to .error(). Be sure that the replacement image exists; otherwise the error event will be triggered indefinitely.
+    To replace all the missing images with another, you can update the src attribute inside the error handler. Be sure that the replacement image exists; otherwise the error event will be triggered indefinitely.
     
   
   
   
-  
-  
-  
+  
+            
+
+
+  error event
+  Trigger the "error" event on an element.
+  
+    1.0
+    
+      The string "error".
+    
+  
+  
+    
            See the description for .on( "error", ... ).
            
+              
+  
+  
             
+
+            
diff --git a/entries/event.currentTarget.xml b/entries/event.currentTarget.xml
index f70a8626..859cb8d4 100644
--- a/entries/event.currentTarget.xml
+++ b/entries/event.currentTarget.xml
@@ -14,11 +14,11 @@
   
     Alert that currentTarget matches the `this` keyword.
     
   
   
   
-            
\ No newline at end of file
+
diff --git a/entries/event.isDefaultPrevented.xml b/entries/event.isDefaultPrevented.xml
index 676b31f3..d9ada314 100644
--- a/entries/event.isDefaultPrevented.xml
+++ b/entries/event.isDefaultPrevented.xml
@@ -9,7 +9,7 @@
   
     Checks whether event.preventDefault() was called.
     " + msg + "" );
 }
 
-$( "button" ).click(function( event ) {
+$( "button" ).on( "click", function( event ) {
   immediatePropStopped( event );
   event.stopImmediatePropagation();
   immediatePropStopped( event );
diff --git a/entries/event.isPropagationStopped.xml b/entries/event.isPropagationStopped.xml
index 26a85b76..c6c270b4 100644
--- a/entries/event.isPropagationStopped.xml
+++ b/entries/event.isPropagationStopped.xml
@@ -21,11 +21,11 @@ function propStopped( event ) {
   $( "#stop-log" ).append( "
            " + msg + "
            " );
 }
 
-$( "button" ).click(function(event) {
+$( "button" ).on( "click", function( event ) {
   propStopped( event );
   event.stopPropagation();
   propStopped( event );
-});
+} );
 ]]>            
     click me
diff --git a/entries/event.metaKey.xml b/entries/event.metaKey.xml
index f27b6e46..0c00d6b9 100644
--- a/entries/event.metaKey.xml
+++ b/entries/event.metaKey.xml
@@ -26,7 +26,7 @@
 
            
 ]]>
     
diff --git a/entries/event.namespace.xml b/entries/event.namespace.xml
index ed661c92..bbebcda4 100644
--- a/entries/event.namespace.xml
+++ b/entries/event.namespace.xml
@@ -14,7 +14,7 @@
 $( "p" ).on( "test.something", function( event ) {
   alert( event.namespace );
 });
-$( "button" ).click(function( event ) {
+$( "button" ).on( "click", function( event ) {
   $( "p" ).trigger( "test.something" );
 });
 ]]>            
diff --git a/entries/event.preventDefault.xml b/entries/event.preventDefault.xml
index ac534fcb..82b4e104 100644
--- a/entries/event.preventDefault.xml
+++ b/entries/event.preventDefault.xml
@@ -11,7 +11,7 @@
   
     Cancel the default action (navigation) of the click.
     " )
     .append( "default " + event.type + " prevented" )
diff --git a/entries/event.relatedTarget.xml b/entries/event.relatedTarget.xml
index 97908df7..e4ee9eaf 100644
--- a/entries/event.relatedTarget.xml
+++ b/entries/event.relatedTarget.xml
@@ -11,9 +11,9 @@
   
     On mouseout of anchors, alert the element type being entered.
     
   
   
diff --git a/entries/event.result.xml b/entries/event.result.xml
index fa5cd9ad..40bd1872 100644
--- a/entries/event.result.xml
+++ b/entries/event.result.xml
@@ -11,10 +11,10 @@
   
     Display previous handler's return value
     
diff --git a/entries/event.stopImmediatePropagation.xml b/entries/event.stopImmediatePropagation.xml
index e5b53eba..dd86bd7c 100644
--- a/entries/event.stopImmediatePropagation.xml
+++ b/entries/event.stopImmediatePropagation.xml
@@ -25,14 +25,14 @@
   }
 ]]>            
     
     Kill the bubbling on the click event.
     
     Display the tag's name on click
     
@@ -40,7 +40,7 @@ function handler( event ) {
     target.children().toggle();
   }
 }
-$( "ul" ).click( handler ).find( "ul" ).hide();
+$( "ul" ).on( "click", handler ).find( "ul" ).hide();
 ]]>
     
diff --git a/entries/event.timeStamp.xml b/entries/event.timeStamp.xml
index f63b62ce..089997ba 100644
--- a/entries/event.timeStamp.xml
+++ b/entries/event.timeStamp.xml
@@ -22,7 +22,7 @@
 ]]>
     " );
diff --git a/entries/event.type.xml b/entries/event.type.xml
index 8bde7559..a51cc1c8 100644
--- a/entries/event.type.xml
+++ b/entries/event.type.xml
@@ -9,7 +9,7 @@
   
     On all anchor clicks, alert the event type.
     
diff --git a/entries/fadeIn.xml b/entries/fadeIn.xml
index a73fdc06..4af0872f 100644
--- a/entries/fadeIn.xml
+++ b/entries/fadeIn.xml
@@ -29,7 +29,7 @@
 <img id="book" src="book.png" alt="" width="100" height="123">
 
 // With the element initially hidden, we can show it slowly:
-$( "#clickme" ).click(function() {
+$( "#clickme)" ).on( "click", function() {
   $( "#book" ).fadeIn( "slow", function() {
     // Animation complete
   });
@@ -52,9 +52,9 @@ $( "#clickme" ).click(function() {
   
     Animates hidden divs to fade in one by one, completing each animation within 600 milliseconds.
     
     
     Fades a red block in over the text. Once the animation is done, it quickly fades in more text on top.
     
            
     
            With the element initially shown, we can hide it slowly:
            
     
            
-$( "#clickme" ).click(function() {
+$( "#clickme)" ).on( "click", function() {
   $( "#book" ).fadeOut( "slow", function() {
     // Animation complete.
   });
@@ -56,7 +56,7 @@ $( "#clickme" ).click(function() {
   
     Animates all paragraphs to fade out, completing the animation within 600 milliseconds.
     
@@ -76,7 +76,7 @@ $( "p" ).click(function() {
   
     Fades out spans in one section that you click on.
     
     Fades out two divs, one with a "linear" easing and one with the default, "swing," easing.
     " ).text( this.id ).appendTo( "#log" );
   }
@@ -121,7 +121,7 @@ $( "#btn1" ).click(function() {
   $( "#box2" ).fadeOut( 1600, complete );
 });
 
-$( "#btn2" ).click(function() {
+$( "#btn2)" ).on( "click", function() {
   $( "div" ).show();
   $( "#log" ).empty();
 });
diff --git a/entries/fadeTo.xml b/entries/fadeTo.xml
index bb72eed2..b21cda8a 100644
--- a/entries/fadeTo.xml
+++ b/entries/fadeTo.xml
@@ -44,7 +44,7 @@
 </div>
 <img id="book" src="book.png" alt="" width="100" height="123">
 // With the element initially shown, we can dim it slowly:
-$( "#clickme" ).click(function() {
+$( "#clickme)" ).on( "click", function() {
   $( "#book" ).fadeTo( "slow" , 0.5, function() {
     // Animation complete.
   });
@@ -63,9 +63,9 @@ $( "#clickme" ).click(function() {
   
     Animates first paragraph to fade to an opacity of 0.33 (33%, about one third visible), completing the animation within 600 milliseconds.
     
     
@@ -80,7 +80,7 @@ Compare to this one that won't fade.
   
     Fade div to a random opacity on each click, completing the animation within 200 milliseconds.
     
@@ -131,23 +131,23 @@ $( "p" ).each(function( n ) {
   $( this ).text( $( "p" ).eq( r ).text() );
   $( "p" ).eq( r ).text( tmp );
   $( this ).css( "left", getPos( n ) );
-});
+} );
 $( "div" )
   .each(function( n ) {
     $( this ).css( "left", getPos( n ) );
-  })
+  } )
   .css( "cursor", "pointer" )
-  .click( function() {
+  .on( "click", function() {
     $( this ).fadeTo( 250, 0.25, function() {
       $( this )
         .css( "cursor", "" )
         .prev()
-          .css({
+          .css( {
             "font-weight": "bolder",
             "font-style": "italic"
-          });
-    });
-  });
+          } );
+    } );
+  } );
 ]]>
     
     Fades first paragraph in or out, completing the animation within 600 milliseconds and using a linear easing. Fades last paragraph in or out for 200 milliseconds, inserting a "finished" message upon completion. 
     finished" );
-  });
-});
+  } );
+} );
 ]]>
     fadeToggle p1
diff --git a/entries/file-selector.xml b/entries/file-selector.xml
index db9c7b86..c5295eca 100644
--- a/entries/file-selector.xml
+++ b/entries/file-selector.xml
@@ -13,16 +13,16 @@
   
     Finds all file inputs.
     
     
+
+  .focus()
+  Bind an event handler to the "focus" event, or trigger that event on an element.
+  
+    1.0
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.4.3
+    
+      An object containing data that will be passed to the event handler.
+    
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.0
+  
+  
+    
            
+      
            This API is deprecated.
            
+      
            Instead of .focus( handler ) or .focus( eventData, handler ), use .on( "focus", handler ) or .on( "focus", eventData, handler ), respectively.
            
+      
            Instead of .focus(), use .trigger( "focus" ).
            
+    
            
+              
+  
+  
+  
+  
+  
+            
diff --git a/entries/focus.xml b/entries/focus.xml
index 1db6b643..21d6b2c2 100644
--- a/entries/focus.xml
+++ b/entries/focus.xml
@@ -1,16 +1,15 @@
 
-
-  .focus()
-  Bind an event handler to the "focus" JavaScript event, or trigger that event on an element.
+
+
+Bind an event handler to the "focus" event, or trigger that event on an element.
+
+  focus event
+  Bind an event handler to the "focus" event.
   
-    1.0
-    
-      A function to execute each time the event is triggered.
-      
+    1.7
+    
+      The string "focus".
     
-  
-  
-    1.4.3
     
       An object containing data that will be passed to the event handler.
     
@@ -19,17 +18,16 @@
       
     
   
-  
-    1.0
-  
   
+    
            
+      
            This page describes the focus event. For the deprecated .focus() method, see .focus().
            
+    
            
     
              
-      
            • This method is a shortcut for .on( "focus", handler ) in the first and second variations, and .trigger( "focus" ) in the third.
              • 
       
            • The focus event is sent to an element when it gains focus. This event is implicitly applicable to a limited set of elements, such as  form elements (<input>, <select>, etc.) and links (<a href>). In recent browser versions, the event can be extended to include all element types by explicitly setting the element's tabindex property. An element can gain focus via keyboard commands, such as the Tab key, or by mouse clicks on the element.
              • 
       
            • Elements with focus are usually highlighted in some way by the browser, for example with a dotted line surrounding the element. The focus is used to determine which element is the first to receive keyboard-related events.
              • 
     
            
     
            
-      
            Attempting to set focus to a hidden element causes an error in Internet Explorer. Take care to only use .focus() on elements that are visible. To run an element's focus event handlers without setting focus to the element, use .triggerHandler( "focus" ) instead of .focus().
            
+      
            Attempting to set focus to a hidden element causes an error in Internet Explorer. Take care to only use .trigger( "focus" ) on elements that are visible. To run an element's focus event handlers without setting focus to the element, use .triggerHandler( "focus" ) instead of .trigger( "focus" ).
            
     
            
     
            For example, consider the HTML:
            
     
            
@@ -43,24 +41,23 @@
     
            
     
            The event handler can be bound to the first input field:
            
     
            
-$( "#target" ).focus(function() {
-  alert( "Handler for .focus() called." );
-});
+$( "#target" ).on( "focus", function() {
+  alert( "Handler for `focus` called." );
+} );
     
            
     
            Now clicking on the first field, or tabbing to it from another field, displays the alert:
            
     
            
-      Handler for .focus() called.
+      Handler for `focus` called.
     
            
     
            We can trigger the event when another element is clicked:
            
     
            
-$( "#other" ).click(function() {
-  $( "#target" ).focus();
-});
+$( "#other" ).on( "click", function() {
+  $( "#target" ).trigger( "focus" );
+} );
     
            
     
            After this code executes, clicks on Trigger the handler will also alert the message.
            
-    
            The focus event does not bubble in Internet Explorer. Therefore, scripts that rely on event delegation with the focus event will not work consistently across browsers. As of version 1.4.2, however, jQuery works around this limitation by mapping focus to the focusin event in its event delegation methods, .live() and .delegate().
            
+    
            The focus event does not bubble. As of version 1.4.2, jQuery works around this limitation by mapping focus to the focusin event in its event delegation methods.
            
               
-  
   
     Fire focus.
     
     
      focus fire
            
@@ -81,21 +78,40 @@ $( "input" ).focus(function() {
   
     To stop people from writing in text input boxes, try:
     
   
   
     To focus on a login input box with id 'login' on page startup, try:
     
   
   
   
   
-  
+  
+            
+
+
+  focus event
+  Trigger the "focus" event on an element.
+  
+    1.0
+    
+      The string "focus".
+    
+  
+  
+    
            See the description for .on( "focus", ... ).
            
+              
+  
+  
+  
             
+
+            
diff --git a/entries/focusin-shorthand.xml b/entries/focusin-shorthand.xml
new file mode 100644
index 00000000..ff8f548e
--- /dev/null
+++ b/entries/focusin-shorthand.xml
@@ -0,0 +1,37 @@
+
+
+  .focusin()
+  Bind an event handler to the "focusin" event, or trigger that event on an element.
+  
+    1.0
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.4.3
+    
+      An object containing data that will be passed to the event handler.
+    
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.0
+  
+  
+    
            
+      
            This API is deprecated.
            
+      
            Instead of .focusin( handler ) or .focusin( eventData, handler ), use .on( "focusin", handler ) or .on( "focusin", eventData, handler ), respectively.
            
+      
            Instead of .focusin(), use .trigger( "focusin" ).
            
+    
            
+              
+  
+  
+  
+  
+  
+            
diff --git a/entries/focusin.xml b/entries/focusin.xml
index aaff429d..7b5288f6 100644
--- a/entries/focusin.xml
+++ b/entries/focusin.xml
@@ -1,16 +1,15 @@
 
-
-  .focusin()
+
+
+Bind an event handler to the "focusin" event, or trigger that event on an element.
+
+  focusin event
   Bind an event handler to the "focusin" event.
   
-    1.4
-    
-      A function to execute each time the event is triggered.
-      
+    1.7
+    
+      The string "focusin".
     
-  
-  
-    1.4.3
     
       An object containing data that will be passed to the event handler.
     
@@ -19,15 +18,13 @@
       
     
   
-  
-    1.0
-  
   
-    
            This method is a shortcut for .on( "focusin", handler ) in the first two variations, and .trigger( "focusin" ) in the third.
            
+    
            
+      
            This page describes the focusin event. For the deprecated .focusin() method, see .focusin().
            
+    
            
     
            The focusin event is sent to an element when it, or any element inside of it, gains focus. This is distinct from the focus event in that it supports detecting the focus event on parent elements (in other words, it supports event bubbling).
            
     
            This event will likely be used together with the focusout event.
            
               
-  
   
     Watch for a focus to occur within the paragraphs on the page.
     
     
      focusin fire
            
@@ -47,6 +44,27 @@ $( "p" ).focusin(function() {
               
   
   
+  
+  
+  
+            
+
+
+  focusin event
+  Trigger the "focusin" event on an element.
+  
+    1.0
+    
+      The string "focusin".
+    
+  
+  
+    
            See the description for .on( "focusin", ... ).
            
+              
+  
+  
+  
   
-  
             
+
+            
diff --git a/entries/focusout-shorthand.xml b/entries/focusout-shorthand.xml
new file mode 100644
index 00000000..6114a08b
--- /dev/null
+++ b/entries/focusout-shorthand.xml
@@ -0,0 +1,37 @@
+
+
+  .focusout()
+  Bind an event handler to the "focusout" event, or trigger that event on an element.
+  
+    1.0
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.4.3
+    
+      An object containing data that will be passed to the event handler.
+    
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.0
+  
+  
+    
            
+      
            This API is deprecated.
            
+      
            Instead of .focusout( handler ) or .focusout( eventData, handler ), use .on( "focusout", handler ) or .on( "focusout", eventData, handler ), respectively.
            
+      
            Instead of .focusout(), use .trigger( "focusout" ).
            
+    
            
+              
+  
+  
+  
+  
+  
+            
diff --git a/entries/focusout.xml b/entries/focusout.xml
index 6b633c89..7b90cb82 100644
--- a/entries/focusout.xml
+++ b/entries/focusout.xml
@@ -1,16 +1,15 @@
 
-
-  .focusout()
-  Bind an event handler to the "focusout" JavaScript event.
+
+
+Bind an event handler to the "focusout" event, or trigger that event on an element.
+
+  focusout event
+  Bind an event handler to the "focusout" event.
   
-    1.4
-    
-      A function to execute each time the event is triggered.
-      
+    1.7
+    
+      The string "focusout".
     
-  
-  
-    1.4.3
     
       An object containing data that will be passed to the event handler.
     
@@ -19,15 +18,13 @@
       
     
   
-  
-    1.0
-  
   
-    
            This method is a shortcut for .on( "focusout", handler ) when passed arguments, and .trigger( "focusout" ) when no arguments are passed.
            
+    
            
+      
            This page describes the focusout event. For the deprecated .focusout() method, see .focusout().
            
+    
            
     
            The focusout event is sent to an element when it, or any element inside of it, loses focus. This is distinct from the blur event in that it supports detecting the loss of focus on descendant elements (in other words, it supports event bubbling).
            
     
            This event will likely be used together with the focusin event.
            
               
-  
   
     Watch for a loss of focus to occur inside paragraphs and note the difference between the focusout count and the blur count. (The blur count does not change because those events do not bubble.)
     
     
     
@@ -68,6 +65,27 @@ $( "p" )
   
   
   
+  
+  
+  
+            
+
+
+  focusout event
+  Trigger the "focuout" event on an element.
+  
+    1.0
+    
+      The string "focusout".
+    
+  
+  
+    
            See the description for .on( "focusout", ... ).
            
+              
+  
+  
+  
   
-  
             
+
+            
diff --git a/entries/get.xml b/entries/get.xml
index 006d6de5..cb52eb2d 100644
--- a/entries/get.xml
+++ b/entries/get.xml
@@ -43,7 +43,7 @@ console.log( $( "li" ).get( -1 ) );
     
       Display the tag name of the click element.
       
diff --git a/entries/hide.xml b/entries/hide.xml
index b90aed05..53aab56d 100644
--- a/entries/hide.xml
+++ b/entries/hide.xml
@@ -49,7 +49,7 @@ $( ".target" ).hide();
     
            
     
            
 // With the element initially shown, we can hide it slowly:
-$( "#clickme" ).click(function() {
+$( "#clickme)" ).on( "click", function() {
   $( "#book" ).hide( "slow", function() {
     alert( "Animation complete." );
   });
@@ -68,7 +68,7 @@ $( "#clickme" ).click(function() {
     Hides all paragraphs then the link on click.
     
     Animates all shown paragraphs to hide slowly, completing the animation within 600 milliseconds.
     
@@ -101,13 +101,13 @@ $( "button" ).click(function() {
   
     Animates all spans (words in this case) to hide fastly, completing each animation within 200 milliseconds. Once each animation is done, it starts the next one.
     
@@ -134,7 +134,7 @@ $( "#shower" ).click(function() {
 for ( var i = 0; i < 5; i++ ) {
   $( "
            " ).appendTo( document.body );
 }
-$( "div" ).click(function() {
+$( "div)" ).on( "click", function() {
   $( this ).hide( 2000, function() {
     $( this ).remove();
   });
diff --git a/entries/hover.xml b/entries/hover.xml
index 2ddab1fa..a924d368 100644
--- a/entries/hover.xml
+++ b/entries/hover.xml
@@ -1,7 +1,7 @@
 
 
   Bind one or two handlers to the matched elements, to be executed when the mouse pointer enters and leaves the elements.
-  
+  
     .hover()
     Bind two handlers to the matched elements, to be executed when the mouse pointer enters and leaves the elements.
     
@@ -16,12 +16,15 @@
       
     
     
+      
            
+        
            This API is deprecated. Use .on( "mouseenter", handlerIn ).on( "mouseleave", handlerOut ) instead.
            
+      
            
       
            The .hover() method binds handlers for both mouseenter and mouseleave events. You can use it to simply apply behavior to an element during the time the mouse is within the element.
            
       
            Calling $( selector ).hover( handlerIn, handlerOut ) is shorthand for:
            
       
            
-$( selector ).mouseenter( handlerIn ).mouseleave( handlerOut );
+$( selector ).on( "mouseenter", handlerIn ).on( "mouseleave", handlerOut );
       
            
-      
            See the discussions for .mouseenter() and .mouseleave() for more details.
            
+      
            See the discussions for mouseenter and mouseleave for more details.
            
                 
     
       To add a special style to list items that are being hovered over, try:
@@ -80,8 +83,10 @@ $( "td" ).off( "mouseenter mouseleave" );
     
     
     
+    
               
-  
+ 
+  
     Bind a single handler to the matched elements, to be executed when the mouse pointer enters or leaves the elements.
     
       1.4
@@ -91,12 +96,15 @@ $( "td" ).off( "mouseenter mouseleave" );
       
     
     
+      
            
+        
            This API is deprecated. Use .on( "mouseenter mouseleave", handlerInOut ) instead.
            
+      
            
       
            The .hover() method, when passed a single function, will execute that handler for both mouseenter and mouseleave events. This allows the user to use jQuery's various toggle methods within the handler or to respond differently within the handler depending on the event.type.
            
       
            Calling $(selector).hover(handlerInOut) is shorthand for:
            
       
            
 $( selector ).on( "mouseenter mouseleave", handlerInOut );
       
            
-      
            See the discussions for .mouseenter() and .mouseleave() for more details.
            
+      
            See the discussions for mouseenter and mouseleave for more details.
            
                 
     
       Slide the next sibling LI up or down on hover, and toggle a class.
@@ -143,5 +151,6 @@ $( "li" )
     
     
     
+    
               
             
diff --git a/entries/html.xml b/entries/html.xml
index b830c566..4be065f3 100644
--- a/entries/html.xml
+++ b/entries/html.xml
@@ -29,7 +29,7 @@ $( "div.demo-container" ).html();
     
       Click a paragraph to convert it from html to text.
       
     Finds all image inputs.
     
     
     On click, returns the index (zero-based) of that div in the page.
      *" );
 $( "#messages" ).text( "Found " + allInputs.length + " inputs and the form has " +
   formChildren.length + " children." );
 
-$( "form" ).submit(function( event ) {
+$( "form" ).on( "submit", function( event ) {
   event.preventDefault();
-});
+} );
 ]]>
     
            
     
            You can attach a click handler to the <ul> element, and then limit the code to be triggered only when a list item itself, not one of its children, is clicked:
            
     
            
-$( "ul" ).click(function( event ) {
+$( "ul" ).on( "click", function( event ) {
   var target = $( event.target );
   if ( target.is( "li" ) ) {
     target.css( "background-color", "red" );
@@ -63,7 +63,7 @@ $( "ul" ).click(function( event ) {
     
            
     
            You can attach a click handler to every <li> that evaluates the number of <strong> elements within the clicked <li> at that time like so:
            
     
            
-$( "li" ).click(function() {
+$( "li)" ).on( "click", function() {
   var li = $( this ),
     isWithTwo = li.is(function() {
       return $( "strong", this ).length === 2;
@@ -177,7 +177,7 @@ $( "div" ).text( "isFormParent = " + isFormParent );
     Checks against an existing collection of alternating list elements. Blue, alternating list elements slide up while others turn red.
     An alternate way to achieve the above example using an element rather than a jQuery object. Checks against an existing collection of alternating list elements. Blue, alternating list elements slide up while others turn red.
     By default, Ajax requests are sent using the GET HTTP method. If the POST method is required, the method can be specified by setting a value for the type option. This option affects how the contents of the data option are sent to the server. POST data will always be transmitted to the server using UTF-8 charset, per the W3C XMLHTTPRequest standard.
            
     
            The data option can contain either a query string of the form key1=value1&key2=value2, or an object of the form {key1: 'value1', key2: 'value2'}. If the latter form is used, the data is converted into a query string using jQuery.param() before it is sent. This processing can be circumvented by setting processData to false.  The processing might be undesirable if you wish to send an XML object to the server; in this case, change the contentType option from application/x-www-form-urlencoded to a more appropriate MIME type.
            
     
            Advanced Options
            
-    
            The global option prevents handlers registered using .ajaxSend(), .ajaxError(), and similar methods from firing when this request would trigger them. This can be useful to, for example, suppress a loading indicator that was implemented with .ajaxSend() if the requests are frequent and brief. With cross-domain script and JSONP requests, the global option is automatically set to false. See the descriptions of these methods below for more details.
            
+    
            The global option prevents handlers registered for the ajaxSend, ajaxError, and similar events from firing when this request would trigger them. This can be useful to, for example, suppress a loading indicator that was implemented with an ajaxSend handler if the requests are frequent and brief. With cross-domain script and JSONP requests, the global option is automatically set to false. See the descriptions of these methods below for more details.
            
     
            If the server performs HTTP authentication before providing a response, the user name and password pair can be sent via the username and password options.
            
     
            Ajax requests are time-limited, so errors can be caught and handled to provide a better user experience. Request timeouts are usually either left at their default or set as a global default using $.ajaxSetup() rather than being overridden for specific requests with the timeout option.
            
     
            By default, requests are always issued, but the browser may serve results out of its cache. To disallow use of the cached results, set cache to false. To cause the request to report failure if the asset has not been modified since the last request, set ifModified to true.
            
diff --git a/entries/jQuery.ajaxSetup.xml b/entries/jQuery.ajaxSetup.xml
index d175c54a..b0b54447 100644
--- a/entries/jQuery.ajaxSetup.xml
+++ b/entries/jQuery.ajaxSetup.xml
@@ -26,7 +26,7 @@ $.ajax({
 });
     
            
     
            
-      
            Note: Global callback functions should be set with their respective global Ajax event handler methods—.ajaxStart(), .ajaxStop(), .ajaxComplete(), .ajaxError(), .ajaxSuccess(), .ajaxSend()—rather than within the options object for $.ajaxSetup().
            
+      
            Note: Global callback functions should be set via .on() with their respective global Ajax events—ajaxStart, ajaxStop, ajaxComplete, ajaxError, ajaxSuccess, ajaxSend—rather than within the options object for $.ajaxSetup().
            
     
            
               
   
diff --git a/entries/jQuery.data.xml b/entries/jQuery.data.xml
index 8e275146..5207c8b8 100644
--- a/entries/jQuery.data.xml
+++ b/entries/jQuery.data.xml
@@ -92,7 +92,7 @@ alert( jQuery.data( document.body ) );
     
       Get the data named "blah" stored at for an element.
       
       
     Use jQuery.dequeue() to end a custom queue function which allows the queue to keep going.
     Cause all animations to run with less frames.
     
diff --git a/entries/jQuery.fx.off.xml b/entries/jQuery.fx.off.xml
index 74bfd60a..3c93466d 100644
--- a/entries/jQuery.fx.off.xml
+++ b/entries/jQuery.fx.off.xml
@@ -20,10 +20,10 @@ var toggleFx = function() {
   $.fx.off = !$.fx.off;
 };
 toggleFx();
-$( "button" ).click( toggleFx );
-$( "input" ).click(function() {
+$( "button" ).on( "click", toggleFx );
+$( "input)" ).on( "click", function() {
   $( "div" ).toggle( "slow" );
-});
+} );
 ]]>
            -

            Prior to jQuery 1.5, the global .ajaxError() callback event had to be used in order to handle $.getScript() errors:

            +

            Prior to jQuery 1.5, the global ajaxError callback event had to be used in order to handle $.getScript() errors:

            
-$( "div.log" ).ajaxError(function( e, jqxhr, settings, exception ) {
+$( "div.log" ).on( "ajaxError", function( e, jqxhr, settings, exception ) {
   if ( settings.dataType == "script" ) {
     $( this ).text( "Triggered ajaxError handler." );
   }
-});
+} );

            Prior to jQuery 3.5.0, unsuccessful HTTP responses with a script Content-Type were still executed.

            Caching Responses

            @@ -94,7 +94,7 @@ $.cachedScript( "ajax/test.js" ).done(function( script, textStatus ) { Post a form using Ajax and put results in a div diff --git a/entries/jQuery.queue.xml b/entries/jQuery.queue.xml index b15912ab..8f3a093f 100644 --- a/entries/jQuery.queue.xml +++ b/entries/jQuery.queue.xml @@ -19,7 +19,7 @@ Show the length of the queue. Queue a custom function. Set a queue array to delete the queue. Selector Context

            By default, selectors perform their searches within the DOM starting at the document root. However, an alternate context can be given for the search by using the optional second parameter to the $() function. For example, to do a search within an event handler, the search can be restricted like so:

            
-$( "div.foo" ).click(function() {
+$( "div.foo)" ).on( "click", function() {
   $( "span", this ).addClass( "bar" );
 });
            @@ -62,7 +62,7 @@ $( "div.foo" ).click(function() {

            Please note that although you can pass text nodes and comment nodes into a jQuery collection this way, most operations don't support them. The few that do will have an explicit note on their API documentation page.

            A common use of single-DOM-element construction is to call jQuery methods on an element that has been passed to a callback function through the keyword this:

            
-$( "div.foo" ).click(function() {
+$( "div.foo)" ).on( "click", function() {
   $( this ).slideUp();
 });
            diff --git a/entries/keydown-shorthand.xml b/entries/keydown-shorthand.xml new file mode 100644 index 00000000..98b125b3 --- /dev/null +++ b/entries/keydown-shorthand.xml @@ -0,0 +1,36 @@ + + + .keydown() + Bind an event handler to the "keydown" event, or trigger that event on an element. + + 1.0 + + A function to execute each time the event is triggered. + + + + + 1.4.3 + + An object containing data that will be passed to the event handler. + + + A function to execute each time the event is triggered. + + + + + 1.0 + + +
            +

            This API is deprecated.

            +

            Instead of .keydown( handler ) or .keydown( eventData, handler ), use .on( "keydown", handler ) or .on( "keydown", eventData, handler ), respectively.

            +

            Instead of .keydown(), use .trigger( "keydown" ).

            +
            +             + + + + +             diff --git a/entries/keydown.xml b/entries/keydown.xml index f21ae4e0..576a1ad0 100644 --- a/entries/keydown.xml +++ b/entries/keydown.xml @@ -1,15 +1,15 @@ - - .keydown() + +Bind an event handler to the "keydown" event, or trigger that event on an element. + + + keydown event + Bind an event handler to the "keydown" event. - 1.0 - - A function to execute each time the event is triggered. - + 1.7 + + The string "keydown". - - - 1.4.3 An object containing data that will be passed to the event handler. @@ -18,12 +18,10 @@ - - 1.0 - - Bind an event handler to the "keydown" JavaScript event, or trigger that event on an element. -

            This method is a shortcut for .on( "keydown", handler ) in the first and second variations, and .trigger( "keydown" ) in the third.

            +
            +

            This page describes the keydown event. For the deprecated .keydown() method, see .keydown().

            +

            The keydown event is sent to an element when the user presses a key on the keyboard. If the key is kept pressed, the event is sent every time the operating system repeats the key. It can be attached to any element, but the event is only sent to the element that has the focus. Focusable elements can vary between browsers, but form elements can always get focus so are reasonable candidates for this event type.

            For example, consider the HTML:

            
@@ -36,42 +34,41 @@

            The event handler can be bound to the input field:

            
-$( "#target" ).keydown(function() {
-  alert( "Handler for .keydown() called." );
-});
+$( "#target" ).on( "keydown", function() {
+  alert( "Handler for `keydown` called." );
+} );

            Now when the insertion point is inside the field, pressing a key displays the alert:

            - Handler for .keydown() called. + Handler for `keydown` called.

            -

            To trigger the event manually, apply .keydown() without an argument:

            +

            To trigger the event manually, use .trigger( "keydown" ):

            
-$( "#other" ).click(function() {
-  $( "#target" ).keydown();
-});
+$( "#other" ).on( "click", function() {
+  $( "#target" ).trigger( "keydown" );
+} );

            After this code executes, clicks on Trigger the handler will also alert the message.

            If key presses anywhere need to be caught (for example, to implement global shortcut keys on a page), it is useful to attach this behavior to the document object. Because of event bubbling, all key presses will make their way up the DOM to the document object unless explicitly stopped.

            To determine which key was pressed, examine the event object that is passed to the handler function. While browsers use differing properties to store this information, jQuery normalizes the .which property so you can reliably use it to retrieve the key code. This code corresponds to a key on the keyboard, including codes for special keys such as arrows. For catching actual text entry, .keypress() may be a better choice.

             - Show the event object for the keydown handler when a key is pressed in the input. - +             + + + keydown event + Trigger the "keydown" event on an element. + + 1.0 + + The string "keydown". + + + +

            See the description for .on( "keydown", ... ).

            +             + + +             + +             diff --git a/entries/keypress-shorthand.xml b/entries/keypress-shorthand.xml new file mode 100644 index 00000000..56a0d1d8 --- /dev/null +++ b/entries/keypress-shorthand.xml @@ -0,0 +1,36 @@ + + + .keypress() + Bind an event handler to the "keypress" event, or trigger that event on an element. + + 1.0 + + A function to execute each time the event is triggered. + + + + + 1.4.3 + + An object containing data that will be passed to the event handler. + + + A function to execute each time the event is triggered. + + + + + 1.0 + + +
            +

            This API is deprecated.

            +

            Instead of .keypress( handler ) or .keypress( eventData, handler ), use .on( "keypress", handler ) or .on( "keypress", eventData, handler ), respectively.

            +

            Instead of .keypress(), use .trigger( "keypress" ).

            +
            +             + + + + +             diff --git a/entries/keypress.xml b/entries/keypress.xml index 0fd28cf3..16cf4303 100644 --- a/entries/keypress.xml +++ b/entries/keypress.xml @@ -1,16 +1,15 @@ - - .keypress() - Bind an event handler to the "keypress" JavaScript event, or trigger that event on an element. + +Bind an event handler to the "keypress" event, or trigger that event on an element. + + + keypress event + Bind an event handler to the "keypress" event. - 1.0 - - A function to execute each time the event is triggered. - + 1.7 + + The string "keyup". - - - 1.4.3 An object containing data that will be passed to the event handler. @@ -19,12 +18,11 @@ - - 1.0 - +
            +

            This page describes the keypress event. For the deprecated .keypress() method, see .keypress().

            +

            Note: as the keypress event isn't covered by any official specification, the actual behavior encountered when using it may differ across browsers, browser versions, and platforms.

            -

            This method is a shortcut for .on( "keypress", handler ) in the first two variations, and .trigger( "keypress" ) in the third.

            The keypress event is sent to an element when the browser registers keyboard input. This is similar to the keydown event, except that modifier and non-printing keys such as Shift, Esc, and delete trigger keydown events but not keypress events. Other differences between the two events may arise depending on platform and browser.

            A keypress event handler can be attached to any element, but the event is only sent to the element that has the focus. Focusable elements can vary between browsers, but form controls can always get focus so are reasonable candidates for this event type.

            For example, consider the HTML:

            @@ -40,43 +38,42 @@

            The event handler can be bound to the input field:

            
-$( "#target" ).keypress(function() {
-  console.log( "Handler for .keypress() called." );
-});
+$( "#target" ).on( "keypress", function() {
+  console.log( "Handler for `keypress` called." );
+} );

            Now when the insertion point is inside the field, pressing a key displays the log:

            - Handler for .keypress() called. + Handler for `keypress` called.

            -

            To trigger the event manually, apply .keypress() without an argument:

            +

            To trigger the event manually, use .trigger( "keypress" ):

            
-$( "#other" ).click(function() {
-  $( "#target" ).keypress();
-});
+$( "#other" ).on( "click", function() {
+  $( "#target" ).trigger( "keypress" );
+} );

            After this code executes, clicks on the Trigger the handler div will also log the message.

            If key presses anywhere need to be caught (for example, to implement global shortcut keys on a page), it is useful to attach this behavior to the document object. Because of event bubbling, all key presses will make their way up the DOM to the document object unless explicitly stopped.

            To determine which character was entered, examine the event object that is passed to the handler function. While browsers use differing properties to store this information, jQuery normalizes the .which property so you can reliably use it to retrieve the character code.

            Note that keydown and keyup provide a code indicating which key is pressed, while keypress indicates which character was entered. For example, a lowercase "a" will be reported as 65 by keydown and keyup, but as 97 by keypress. An uppercase "A" is reported as 65 by all events. Because of this distinction, when catching special keystrokes such as arrow keys, .keydown() or .keyup() is a better choice.

             - Show the event object when a key is pressed in the input. Note: This demo relies on a simple $.print() plugin (https://api.jquery.com/resources/events.js) for the event object's output. - + + + + keyup event + Trigger the "keyup" event on an element. + + 1.0 + + The string "keyup". + + + +

            See the description for .on( "keyup", ... ).

            +             + + +             + + diff --git a/entries/keyup-shorthand.xml b/entries/keyup-shorthand.xml new file mode 100644 index 00000000..965dbeb8 --- /dev/null +++ b/entries/keyup-shorthand.xml @@ -0,0 +1,36 @@ + + + .keyup() + Bind an event handler to the "keyup" event, or trigger that event on an element. + + 1.0 + + A function to execute each time the event is triggered. + + + + + 1.4.3 + + An object containing data that will be passed to the event handler. + + + A function to execute each time the event is triggered. + + + + + 1.0 + + +
            +

            This API is deprecated.

            +

            Instead of .keyup( handler ) or .keyup( eventData, handler ), use .on( "keyup", handler ) or .on( "keyup", eventData, handler ), respectively.

            +

            Instead of .keyup(), use .trigger( "keyup" ).

            +
            +             + + + + +             diff --git a/entries/keyup.xml b/entries/keyup.xml index 91193b53..b0d6399f 100644 --- a/entries/keyup.xml +++ b/entries/keyup.xml @@ -1,16 +1,15 @@ - - .keyup() - Bind an event handler to the "keyup" JavaScript event, or trigger that event on an element. + +Bind an event handler to the "keyup" event, or trigger that event on an element. + + + keyup event + Bind an event handler to the "keyup" event. - 1.0 - - A function to execute each time the event is triggered. - + 1.7 + + The string "keyup". - - - 1.4.3 An object containing data that will be passed to the event handler. @@ -19,11 +18,10 @@ - - 1.0 - -

            This method is a shortcut for .on( "keyup", handler ) in the first two variations, and .trigger( "keyup" ) in the third.

            +
            +

            This page describes the keyup event. For the deprecated .keyup() method, see .keyup().

            +

            The keyup event is sent to an element when the user releases a key on the keyboard. It can be attached to any element, but the event is only sent to the element that has the focus. Focusable elements can vary between browsers, but form elements can always get focus so are reasonable candidates for this event type.

            For example, consider the HTML:

            
@@ -36,43 +34,42 @@

            The event handler can be bound to the input field:

            
-$( "#target" ).keyup(function() {
-  alert( "Handler for .keyup() called." );
-});
+$( "#target" ).on( "keyup", function() {
+  alert( "Handler for `keyup` called." );
+} );

            Now when the insertion point is inside the field and a key is pressed and released, the alert is displayed:

            - Handler for .keyup() called. + Handler for `keyup` called.

            -

            To trigger the event manually, apply .keyup() without arguments:

            +

            To trigger the event manually, use .trigger( "keyup" ):

            
-$( "#other" ).click(function() {
-  $( "#target" ).keyup();
-});
+$( "#other" ).on( "click", function() {
+  $( "#target" ).trigger( "keyup" );
+} );

            After this code executes, clicks on Trigger the handler will also alert the message.

            If key presses anywhere need to be caught (for example, to implement global shortcut keys on a page), it is useful to attach this behavior to the document object. Because of event bubbling, all key presses will make their way up the DOM to the document object unless explicitly stopped.

            To determine which key was pressed, examine the event object that is passed to the handler function. While browsers use differing properties to store this information, jQuery normalizes the .which property so you can reliably use it to retrieve the key code. This code corresponds to a key on the keyboard, including codes for special keys such as arrows. For catching actual text entry, .keypress() may be a better choice.

             - Show the event object for the keyup handler (using a simple $.print plugin) when a key is released in the input. - +             + + + keyup event + Trigger the "keyup" event on an element. + + 1.0 + + The string "keyup". + + + +

            See the description for .on( "keyup", ... ).

            +             + + +             + +             diff --git a/entries/length.xml b/entries/length.xml index 105f23d8..37a2d54c 100644 --- a/entries/length.xml +++ b/entries/length.xml @@ -12,12 +12,12 @@ Count the divs. Click to add more. " ) ); var n = $( "div" ).length; $( "span" ).text( "There are " + n + " divs." + "Click to add more."); - }) + } ) // Trigger the click to start .trigger( "click" ); ]]> diff --git a/entries/live.xml b/entries/live.xml index e88a67ce..26e7a563 100644 --- a/entries/live.xml +++ b/entries/live.xml @@ -104,7 +104,7 @@ $( "p" ).live( "myCustomEvent", function( event, myName, myValue ) { .fadeIn( 30 ) .fadeOut( 1000 ); }); -$( "button" ).click(function() { +$( "button)" ).on( "click", function() { $( "p" ).trigger( "myCustomEvent" ); }); ]]>             diff --git a/entries/load-event.xml b/entries/load-event.xml index b9669cc6..f7dbc65a 100644 --- a/entries/load-event.xml +++ b/entries/load-event.xml @@ -1,16 +1,15 @@ - - .load() - Bind an event handler to the "load" JavaScript event. + +Bind an event handler to the "load" event, or trigger that event on an element. + + + load event + Bind an event handler to the "load" event. - 1.0 - - A function to execute when the event is triggered. - + 1.7 + + The string "load". - - - 1.4.3 An object containing data that will be passed to the event handler. @@ -21,9 +20,8 @@
            -

            Note: This API has been removed in jQuery 3.0; please use .on( "load", handler ) instead of .load( handler ) and .trigger( "load" ) instead of .load().

            +

            This page describes the load event. For the .load() method removed in jQuery 3.0, see .load().

            -

            This method is a shortcut for .on( "load", handler ).

            The load event is sent to an element when it and all sub-elements have been completely loaded. This event can be sent to any element associated with a URL: images, scripts, frames, iframes, and the window object.

            For example, consider a page with a simple image:

            
@@ -31,20 +29,17 @@

            The event handler can be bound to the image:

            
-$( "#book" ).load(function() {
-  // Handler for .load() called.
-});
+$( "#book" ).on( "load", function() {
+  // Handler for `load` called.
+} );

            As soon as the image has been loaded, the handler is called.

            In general, it is not necessary to wait for all images to be fully loaded. If code can be executed earlier, it is usually best to place it in a handler sent to the .ready() method.

            -
            -

            The Ajax module also has a method named .load(). Which one is fired depends on the set of arguments passed.

            -

            Caveats of the load event when used with images -

            A common challenge developers attempt to solve using the .load() shortcut is to execute a function when an image (or collection of images) have completely loaded. There are several known caveats with this that should be noted. These are:

            +

            A common challenge developers attempt to solve using the load shortcut is to execute a function when an image (or collection of images) have completely loaded. There are several known caveats with this that should be noted. These are:

            • It doesn't work consistently nor reliably cross-browser
            • It doesn't fire correctly in WebKit if the image src is set to the same src as before
              • @@ -60,24 +55,40 @@ $( "#book" ).load(function() { Run a function when the page is fully loaded including graphics. Add the class bigImg to all images with height greater than 100 upon each image load. 100) { $( this ).addClass( "bigImg" ); } -}); +} ); ]]> - - - + + + + + load event + Trigger the "load" event on an element. + + 1.0 + + The string "load". + + + +

              See the description for .on( "load", ... ).

              +               + +               + + diff --git a/entries/load-shorthand.xml b/entries/load-shorthand.xml new file mode 100644 index 00000000..1c5873cb --- /dev/null +++ b/entries/load-shorthand.xml @@ -0,0 +1,40 @@ + + + .load() + Bind an event handler to the "load" event, or trigger that event on an element. + + 1.0 + + A function to execute each time the event is triggered. + + + + + 1.4.3 + + An object containing data that will be passed to the event handler. + + + A function to execute each time the event is triggered. + + + + + 1.0 + + +
              +

              This API has been removed in jQuery 3.0.

              +

              Instead of .load( handler ) or .load( eventData, handler ), use .on( "load", handler ) or .on( "load", eventData, handler ), respectively.

              +

              Instead of .load(), use .trigger( "load" ).

              +
              +
              +

              The Ajax module also has a method named .load(). Which one is fired depends on the set of arguments passed.

              +
              +               + + + + + +               diff --git a/entries/map.xml b/entries/map.xml index c151e831..101fa001 100644 --- a/entries/map.xml +++ b/entries/map.xml @@ -135,9 +135,9 @@ $.fn.equalizeHeights = function() { return this.height( Math.max.apply( this, maxHeight ) ); }; -$( "input" ).click(function() { +$( "input" ).on( "click", function() { $( "div" ).equalizeHeights(); -}); +} ); ]]> + + .mousedown() + Bind an event handler to the "mousedown" event, or trigger that event on an element. + + 1.0 + + A function to execute each time the event is triggered. + + + + + 1.4.3 + + An object containing data that will be passed to the event handler. + + + A function to execute each time the event is triggered. + + + + + 1.0 + + +
              +

              This API is deprecated.

              +

              Instead of .mousedown( handler ) or .mousedown( eventData, handler ), use .on( "mousedown", handler ) or .on( "mousedown", eventData, handler ), respectively.

              +

              Instead of .mousedown(), use .trigger( "mousedown" ).

              +
              +               + + + + +               diff --git a/entries/mousedown.xml b/entries/mousedown.xml index ea8d9a0e..5ce0e273 100644 --- a/entries/mousedown.xml +++ b/entries/mousedown.xml @@ -1,16 +1,15 @@ - - .mousedown() - Bind an event handler to the "mousedown" JavaScript event, or trigger that event on an element. + +Bind an event handler to the "mousedown" event, or trigger that event on an element. + + + mousedown event + Bind an event handler to the "mousedown" event. - 1.0 - - A function to execute each time the event is triggered. - + 1.7 + + The string "mousedown". - - - 1.4.3 An object containing data that will be passed to the event handler. @@ -19,11 +18,10 @@ - - 1.0 - -

              This method is a shortcut for .on( "mousedown", handler) in the first variation, and .trigger( "mousedown" ) in the second.

              +
              +

              This page describes the mousedown event. For the deprecated .mousedown() method, see .mousedown().

              +

              The mousedown event is sent to an element when the mouse pointer is over the element, and the mouse button is pressed. Any HTML element can receive this event.

              For example, consider the HTML:

              <div id="target">
@@ -39,36 +37,35 @@
     
     
              The event handler can be bound to any <div>:
              
     
              
-$( "#target" ).mousedown(function() {
-  alert( "Handler for .mousedown() called." );
-});
+$( "#target" ).on( "mousedown", function() {
+  alert( "Handler for `mousedown` called." );
+} );
     
              
     
              Now if we click on this element, the alert is displayed:
              
     
              
-      Handler for .mousedown() called.
+      Handler for `mousedown` called.
     
              
     
              We can also trigger the event when a different element is clicked:
              
     
              
-$( "#other" ).click(function() {
-  $( "#target" ).mousedown();
-});
+$( "#other" ).on( "click", function() {
+  $( "#target" ).trigger( "mousedown" );
+} );
     
              
     
              After this code executes, clicks on Trigger the handler will also alert the message.
              
     
              The mousedown event is sent when any mouse button is clicked. To act only on specific buttons, we can use the event object's which property. Not all browsers support this property (Internet Explorer uses button instead), but jQuery normalizes the property so that it is safe to use in any browser. The value of which will be 1 for the left button, 2 for the middle button, or 3 for the right button.
              
     
              This event is primarily useful for ensuring that the primary button was used to begin a drag operation; if ignored, strange results can occur when the user attempts to use a context menu. While the middle and right buttons can be detected with these properties, this is not reliable. In Opera and Safari, for example, right mouse button clicks are not detectable by default.
              
     
              If the user clicks on an element, drags away from it, and releases the button, this is still counted as a mousedown event. This sequence of actions is treated as a "canceling" of the button press in most user interfaces, so it is usually better to use the click event unless we know that the mousedown event is preferable for a particular situation.
              
   
-  
   
     Show texts when mouseup and mousedown event triggering.
     Mouse up." );
-  })
-  .mousedown(function() {
+  } )
+  .on( "mousedown", function() {
     $( this ).append( "Mouse down." );
-  });
+  } );
 ]]>
     Press mouse and release here.
              
@@ -76,5 +73,23 @@ $( "p" )
                 
   
   
-  
+  
+
+
+
+  mousedown event
+  Trigger the "mousedown" event on an element.
+  
+    1.0
+    
+      The string "mousedown".
+    
+  
+  
+    
              See the description for .on( "mousedown", ... ).
              
+                
+  
+  
               
+
+
diff --git a/entries/mouseenter-shorthand.xml b/entries/mouseenter-shorthand.xml
new file mode 100644
index 00000000..49b2285a
--- /dev/null
+++ b/entries/mouseenter-shorthand.xml
@@ -0,0 +1,36 @@
+
+
+  .mouseenter()
+  Bind an event handler to the "mouseenter" event, or trigger that event on an element.
+  
+    1.0
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.4.3
+    
+      An object containing data that will be passed to the event handler.
+    
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.0
+  
+  
+    
              
+      
              This API is deprecated.
              
+      
              Instead of .mouseenter( handler ) or .mouseenter( eventData, handler ), use .on( "mouseenter", handler ) or .on( "mouseenter", eventData, handler ), respectively.
              
+      
              Instead of .mouseenter(), use .trigger( "mouseenter" ).
              
+    
              
+                
+  
+  
+  
+  
+              
diff --git a/entries/mouseenter.xml b/entries/mouseenter.xml
index 08bb0632..d2232926 100644
--- a/entries/mouseenter.xml
+++ b/entries/mouseenter.xml
@@ -1,16 +1,15 @@
 
-
-  .mouseenter()
-  Bind an event handler to be fired when the mouse enters an element, or trigger that handler on an element.
+
+Bind an event handler to be fired when the mouse enters an element, or trigger that handler on an element.
+
+
+  mouseenter event
+  Bind an event handler to be fired when the mouse enters an element.
   
-    1.0
-    
-      A function to execute each time the event is triggered.
-      
+    1.7
+    
+      The string "mouseenter".
     
-  
-  
-    1.4.3
     
       An object containing data that will be passed to the event handler.
     
@@ -19,11 +18,10 @@
       
     
   
-  
-    1.0
-  
   
-    
              This method is a shortcut for .on( "mouseenter", handler ) in the first two variations, and .trigger( "mouseenter" ) in the third.
              
+    
              
+      
              This page describes the mouseenter event. For the deprecated .mouseenter() method, see .mouseenter().
              
+    
              
     
              The mouseenter JavaScript event is proprietary to Internet Explorer. Because of the event's general utility, jQuery simulates this event so that it can be used regardless of browser. This event is sent to an element when the mouse pointer enters the element. Any HTML element can receive this event.
              
     
              For example, consider the HTML:
              
     
              
@@ -43,20 +41,19 @@
     
     
              The event handler can be bound to any element:
              
     
              
-$( "#outer" ).mouseenter(function() {
-  $( "#log" ).append( "<div>Handler for .mouseenter() called.</div>" );
-});
+$( "#outer" ).on( "mouseenter", function() {
+  $( "#log" ).append( "<div>Handler for `mouseenter` called.</div>" );
+} );
     
              
     
              Now when the mouse pointer moves over the Outer <div>, the message is appended to <div id="log">. You can also trigger the event when another element is clicked:
              
     
              
-$( "#other" ).click(function() {
-  $( "#outer" ).mouseenter();
-});
+$( "#other" ).on( "click", function() {
+  $( "#outer" ).trigger( "mouseenter" );
+} );
     
              
     
              After this code executes, clicks on Trigger the handler will also append the message.
              
     
              The mouseenter event differs from mouseover in the way it handles event bubbling. If mouseover were used in this example, then when the mouse pointer moved over the Inner element, the handler would be triggered. This is usually undesirable behavior. The mouseenter event, on the other hand, only triggers its handler when the mouse enters the element it is bound to, not a descendant. So in this example, the handler is triggered when the mouse enters the Outer element, but not the Inner element.
              
   
-  
   
     Show texts when mouseenter and mouseout event triggering.
     mouseover fires when the pointer moves into the child element as well, while mouseenter fires only when the pointer moves into the bound element.
@@ -83,23 +80,23 @@ $( "#other" ).click(function() {
     
     
@@ -117,5 +114,23 @@ $( "div.enterleave" )
   
   
   
-  
+  
 
+
+
+  mouseenter event
+  Trigger the "mouseenter" event on an element.
+  
+    1.0
+    
+      The string "mouseenter".
+    
+  
+  
+    
              See the description for .on( "mouseenter", ... ).
              
+                
+  
+  
+              
+
+
diff --git a/entries/mouseleave-shorthand.xml b/entries/mouseleave-shorthand.xml
new file mode 100644
index 00000000..9ff235eb
--- /dev/null
+++ b/entries/mouseleave-shorthand.xml
@@ -0,0 +1,36 @@
+
+
+  .mouseleave()
+  Bind an event handler to the "mouseleave" event, or trigger that event on an element.
+  
+    1.0
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.4.3
+    
+      An object containing data that will be passed to the event handler.
+    
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.0
+  
+  
+    
              
+      
              This API is deprecated.
              
+      
              Instead of .mouseleave( handler ) or .mouseleave( eventData, handler ), use .on( "mouseleave", handler ) or .on( "mouseleave", eventData, handler ), respectively.
              
+      
              Instead of .mouseleave(), use .trigger( "mouseleave" ).
              
+    
              
+                
+  
+  
+  
+  
+              
diff --git a/entries/mouseleave.xml b/entries/mouseleave.xml
index 45302078..98c1ff97 100644
--- a/entries/mouseleave.xml
+++ b/entries/mouseleave.xml
@@ -1,16 +1,15 @@
 
-
-  .mouseleave()
-  Bind an event handler to be fired when the mouse leaves an element, or trigger that handler on an element.
+
+Bind an event handler to be fired when the mouse leaves an element, or trigger that handler on an element.
+
+
+  mouseleave event
+  Bind an event handler to be fired when the mouse leaves an element.
   
-    1.0
-    
-      A function to execute each time the event is triggered.
-      
+    1.7
+    
+      The string "mouseleave".
     
-  
-  
-    1.4.3
     
       An object containing data that will be passed to the event handler.
     
@@ -19,11 +18,10 @@
       
     
   
-  
-    1.0
-  
   
-    
              This method is a shortcut for .on('mouseleave', handler) in the first two variations, and .trigger('mouseleave') in the third.
              
+    
              
+      
              This page describes the mouseleave event. For the deprecated .mouseleave() method, see .mouseleave().
              
+    
              
     
              The mouseleave JavaScript event is proprietary to Internet Explorer. Because of the event's general utility, jQuery simulates this event so that it can be used regardless of browser. This event is sent to an element when the mouse pointer leaves the element. Any HTML element can receive this event.
              
     
              For example, consider the HTML:
              
     
              
@@ -43,20 +41,19 @@
     
     
              The event handler can be bound to any element:
              
     
              
-$( "#outer" ).mouseleave(function() {
-  $( "#log" ).append( "<div>Handler for .mouseleave() called.</div>" );
-});
+$( "#outer" ).on( "mouseleave", function() {
+  $( "#log" ).append( "<div>Handler for `mouseleave` called.</div>" );
+} );
     
              
     
              Now when the mouse pointer moves out of the Outer <div>, the message is appended to <div id="log">. You can also trigger the event when another element is clicked:
              
     
              
-$( "#other" ).click(function() {
-  $( "#outer" ).mouseleave();
-});
+$( "#other" ).on( "click", function() {
+  $( "#outer" ).trigger( "mouseleave" );
+} );
     
              
     
              After this code executes, clicks on Trigger the handler will also append the message.
              
     
              The mouseleave event differs from mouseout in the way it handles event bubbling. If mouseout were used in this example, then when the mouse pointer moved out of the Inner element, the handler would be triggered. This is usually undesirable behavior. The mouseleave event, on the other hand, only triggers its handler when the mouse leaves the element it is bound to, not a descendant. So in this example, the handler is triggered when the mouse leaves the Outer element, but not the Inner element.
              
   
-  
   
     Show number of times mouseout and mouseleave events are triggered. mouseout fires when the pointer moves out of child element as well, while mouseleave fires only when the pointer moves out of the bound element.
                   
     
@@ -115,5 +112,23 @@ $( "div.enterleave" )
   
   
   
-  
+  
 
+
+
+  mouseleave event
+  Trigger the "mouseleave" event on an element.
+  
+    1.0
+    
+      The string "mouseleave".
+    
+  
+  
+    
              See the description for .on( "mouseleave", ... ).
              
+                
+  
+  
+              
+
+
diff --git a/entries/mousemove-shorthand.xml b/entries/mousemove-shorthand.xml
new file mode 100644
index 00000000..7b5e5c31
--- /dev/null
+++ b/entries/mousemove-shorthand.xml
@@ -0,0 +1,36 @@
+
+
+  .mousemove()
+  Bind an event handler to the "mousemove" event, or trigger that event on an element.
+  
+    1.0
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.4.3
+    
+      An object containing data that will be passed to the event handler.
+    
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.0
+  
+  
+    
              
+      
              This API is deprecated.
              
+      
              Instead of .mousemove( handler ) or .mousemove( eventData, handler ), use .on( "mousemove", handler ) or .on( "mousemove", eventData, handler ), respectively.
              
+      
              Instead of .mousemove(), use .trigger( "mousemove" ).
              
+    
              
+                
+  
+  
+  
+  
+              
diff --git a/entries/mousemove.xml b/entries/mousemove.xml
index f6e33860..5aaeef0b 100644
--- a/entries/mousemove.xml
+++ b/entries/mousemove.xml
@@ -1,16 +1,15 @@
 
-
-  .mousemove()
-  Bind an event handler to the "mousemove" JavaScript event, or trigger that event on an element.
+
+Bind an event handler to the "mousemove" event, or trigger that event on an element.
+
+
+  mousemove event
+  Bind an event handler to the "mousemove" event.
   
-    1.0
-    
-      A function to execute each time the event is triggered.
-      
+    1.7
+    
+      The string "mousemove".
     
-  
-  
-    1.4.3
     
       An object containing data that will be passed to the event handler.
     
@@ -19,11 +18,10 @@
       
     
   
-  
-    1.0
-  
   
-    
              This method is a shortcut for .on( "mousemove", handler ) in the first two variations, and .trigger( "mousemove" ) in the third.
              
+    
              
+      
              This page describes the mousemove event. For the deprecated .mousemove() method, see .mousemove().
              
+    
              
     
              The mousemove event is sent to an element when the mouse pointer moves inside the element. Any HTML element can receive this event.
              
     
              For example, consider the HTML:
              
     
              
@@ -37,47 +35,46 @@
     
              
     
              The event handler can be bound to the target:
              
     
              
-$( "#target" ).mousemove(function( event ) {
-  var msg = "Handler for .mousemove() called at ";
+$( "#target" ).on( "mousemove", function( event ) {
+  var msg = "Handler for `mousemove` called at ";
   msg += event.pageX + ", " + event.pageY;
   $( "#log" ).append( "<div>" + msg + "</div>" );
-});
+} );
     
              
     
              Now when the mouse pointer moves within the target button, the messages are appended to <div id="log">:
              
     
              
-      Handler for .mousemove() called at (399, 48)
+      Handler for `mousemove` called at (399, 48)
       
              
-      Handler for .mousemove() called at (398, 46)
+      Handler for `mousemove` called at (398, 46)
       
              
-      Handler for .mousemove() called at (397, 44)
+      Handler for `mousemove` called at (397, 44)
       
              
-      Handler for .mousemove() called at (396, 42)
+      Handler for `mousemove` called at (396, 42)
       
              
     
              
-    
              To trigger the event manually, apply .mousemove() without an argument:
              
+    
              To trigger the event manually, use .trigger( "mousemove" ):
              
     
              
-$( "#other" ).click(function() {
-  $( "#target" ).mousemove();
-});
+$( "#other" ).on( "click", function() {
+  $( "#target" ).trigger( "mousemove" );
+} );
     
              
     
              After this code executes, clicks on the Trigger button will also append the message:
              
     
              
-      Handler for .mousemove() called at (undefined, undefined)
+      Handler for `mousemove` called at (undefined, undefined)
     
              
     
              When tracking mouse movement, you usually need to know the actual position of the mouse pointer. The event object that is passed to the handler contains some information about the mouse coordinates. Properties such as .clientX, .offsetX, and .pageX are available, but support for them differs between browsers. Fortunately, jQuery normalizes the .pageX and .pageY properties so that they can be used in all browsers. These properties provide the X and Y coordinates of the mouse pointer relative to the top-left corner of the document, as illustrated in the example output above.
              
     
              Keep in mind that the mousemove event is triggered whenever the mouse pointer moves, even for a pixel. This means that hundreds of events can be generated over a very small amount of time. If the handler has to do any significant processing, or if multiple handlers for the event exist, this can be a serious performance drain on the browser. It is important, therefore, to optimize mousemove handlers as much as possible, and to unbind them as soon as they are no longer needed.
              
     
              A common pattern is to bind the mousemove handler from within a mousedown handler, and to unbind it from a corresponding mouseup handler. If implementing this sequence of events, remember that the mouseup event might be sent to a different HTML element than the mousemove event was. To account for this, the mouseup handler should typically be bound to an element high up in the DOM tree, such as <body>.
              
                 
-  
   
     Show the mouse coordinates when the mouse is moved over the yellow div.  Coordinates are relative to the window, which in this case is the iframe.
     
     300
     
   
   
-  
+  
+              
+
+
+  mousemove event
+  Trigger the "mousemove" event on an element.
+  
+    1.0
+    
+      The string "mousemove".
+    
+  
+  
+    
              See the description for .on( "mousemove", ... ).
              
+                
+  
+  
               
+
+              
diff --git a/entries/mouseout-shorthand.xml b/entries/mouseout-shorthand.xml
new file mode 100644
index 00000000..25761ce4
--- /dev/null
+++ b/entries/mouseout-shorthand.xml
@@ -0,0 +1,36 @@
+
+
+  .mouseout()
+  Bind an event handler to the "mouseout" event, or trigger that event on an element.
+  
+    1.0
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.4.3
+    
+      An object containing data that will be passed to the event handler.
+    
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.0
+  
+  
+    
              
+      
              This API is deprecated.
              
+      
              Instead of .mouseout( handler ) or .mouseout( eventData, handler ), use .on( "mouseout", handler ) or .on( "mouseout", eventData, handler ), respectively.
              
+      
              Instead of .mouseout(), use .trigger( "mouseout" ).
              
+    
              
+                
+  
+  
+  
+  
+              
diff --git a/entries/mouseout.xml b/entries/mouseout.xml
index d95273c5..3b014828 100644
--- a/entries/mouseout.xml
+++ b/entries/mouseout.xml
@@ -1,16 +1,15 @@
 
-
-  .mouseout()
-  Bind an event handler to the "mouseout" JavaScript event, or trigger that event on an element.
+
+Bind an event handler to the "mouseout" event, or trigger that event on an element.
+
+
+  mouseout event
+  Bind an event handler to the "mouseout" event.
   
-    1.0
-    
-      A function to execute each time the event is triggered.
-      
+    1.7
+    
+      The string "mouseout".
     
-  
-  
-    1.4.3
     
       An object containing data that will be passed to the event handler.
     
@@ -19,11 +18,10 @@
       
     
   
-  
-    1.0
-  
   
-    
              This method is a shortcut for .on( "mouseout", handler ) in the first two variation, and .trigger( "mouseout" ) in the third.
              
+    
              
+      
              This page describes the mouseout event. For the deprecated .mouseout() method, see .mouseout().
              
+    
              
     
              The mouseout event is sent to an element when the mouse pointer leaves the element. Any HTML element can receive this event.
              
     
              For example, consider the HTML:
              
     
              
@@ -44,20 +42,19 @@
     
     
              The event handler can be bound to any element:
              
     
              
-$( "#outer" ).mouseout(function() {
-  $( "#log" ).append( "Handler for .mouseout() called." );
-});
+$( "#outer" ).on( "mouseout", function() {
+  $( "#log" ).append( "Handler for `mouseout` called." );
+} );
     
              
-    
              Now when the mouse pointer moves out of the Outer <div>, the message is appended to <div id="log">. To trigger the event manually, apply .mouseout() without an argument::
              
+    
              Now when the mouse pointer moves out of the Outer <div>, the message is appended to <div id="log">. To trigger the event manually, use .trigger( "mouseout" ):
              
     
              
-$( "#other" ).click(function() {
-  $( "#outer" ).mouseout();
-});
+$( "#other" ).on( "click", function() {
+  $( "#outer" ).trigger( "mouseout" );
+} );
     
              
     
              After this code executes, clicks on Trigger the handler will also append the message.
              
     
              This event type can cause many headaches due to event bubbling. For instance, when the mouse pointer moves out of the Inner element in this example, a mouseout event will be sent to that, then trickle up to Outer. This can trigger the bound mouseout handler at inopportune times. See the discussion for .mouseleave() for a useful alternative.
              
   
-  
   
     Show the number of times mouseout and mouseleave events are triggered.
   mouseout fires when the pointer moves out of the child element as well, while mouseleave fires only when the pointer moves out of the bound element.
@@ -84,23 +81,23 @@ $( "#other" ).click(function() {
     
     
@@ -118,5 +115,23 @@ $( "div.enterleave" )
   
   
   
-  
+  
 
+
+
+  mouseout event
+  Trigger the "mouseout" event on an element.
+  
+    1.0
+    
+      The string "mouseout".
+    
+  
+  
+    
              See the description for .on( "mouseout", ... ).
              
+                
+  
+  
+              
+
+
diff --git a/entries/mouseover-shorthand.xml b/entries/mouseover-shorthand.xml
new file mode 100644
index 00000000..25bc4c01
--- /dev/null
+++ b/entries/mouseover-shorthand.xml
@@ -0,0 +1,36 @@
+
+
+  .mouseover()
+  Bind an event handler to the "mouseover" event, or trigger that event on an element.
+  
+    1.0
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.4.3
+    
+      An object containing data that will be passed to the event handler.
+    
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.0
+  
+  
+    
              
+      
              This API is deprecated.
              
+      
              Instead of .mouseover( handler ) or .mouseover( eventData, handler ), use .on( "mouseover", handler ) or .on( "mouseover", eventData, handler ), respectively.
              
+      
              Instead of .mouseover(), use .trigger( "mouseover" ).
              
+    
              
+                
+  
+  
+  
+  
+              
diff --git a/entries/mouseover.xml b/entries/mouseover.xml
index 88ddb981..6897db06 100644
--- a/entries/mouseover.xml
+++ b/entries/mouseover.xml
@@ -1,16 +1,15 @@
 
-
-  .mouseover()
-  Bind an event handler to the "mouseover" JavaScript event, or trigger that event on an element.
+
+Bind an event handler to the "mouseover" event, or trigger that event on an element.
+
+
+  mouseover event
+  Bind an event handler to the "mouseover" event.
   
-    1.0
-    
-      A function to execute each time the event is triggered.
-      
+    1.7
+    
+      The string "mouseover".
     
-  
-  
-    1.4.3
     
       An object containing data that will be passed to the event handler.
     
@@ -19,11 +18,10 @@
       
     
   
-  
-    1.0
-  
   
-    
              This method is a shortcut for .on( "mouseover", handler ) in the first two variations, and .trigger( "mouseover" ) in the third.
              
+    
              
+      
              This page describes the mouseover event. For the deprecated .mouseover() method, see .mouseover().
              
+    
              
     
              The mouseover event is sent to an element when the mouse pointer enters the element. Any HTML element can receive this event.
              
     
              For example, consider the HTML:
              
     
              
@@ -44,20 +42,19 @@
     
     
              The event handler can be bound to any element:
              
     
              
-$( "#outer" ).mouseover(function() {
-  $( "#log" ).append( "<div>Handler for .mouseover() called.</div>" );
-});
+$( "#outer" ).on( "mouseover", function() {
+  $( "#log" ).append( "<div>Handler for `mouseover` called.</div>" );
+} );
     
              
     
              Now when the mouse pointer moves over the Outer <div>, the message is appended to <div id="log">. We can also trigger the event when another element is clicked:
              
     
              
-$( "#other" ).click(function() {
-  $( "#outer" ).mouseover();
-});
+$( "#other" ).on( "click", function() {
+  $( "#outer" ).trigger( "mouseover" );
+} );
     
              
     
              After this code executes, clicks on Trigger the handler will also append the message.
              
     
              This event type can cause many headaches due to event bubbling. For instance, when the mouse pointer moves over the Inner element in this example, a mouseover event will be sent to that, then trickle up to Outer. This can trigger our bound mouseover handler at inopportune times. See the discussion for .mouseenter() for a useful alternative.
              
   
-  
   
     Show the number of times mouseover and mouseenter events are triggered.
 mouseover fires when the pointer moves into the child element as well, while mouseenter fires only when the pointer moves into the bound element.
@@ -84,23 +81,23 @@ $( "#other" ).click(function() {
     
     
@@ -118,5 +115,23 @@ $( "div.enterleave" )
   
   
   
-  
+  
+
+
+
+  mouseover event
+  Trigger the "mouseover" event on an element.
+  
+    1.0
+    
+      The string "mouseover".
+    
+  
+  
+    
              See the description for .on( "mouseover", ... ).
              
+                
+  
+  
               
+  
+
diff --git a/entries/mouseup-shorthand.xml b/entries/mouseup-shorthand.xml
new file mode 100644
index 00000000..edbf836c
--- /dev/null
+++ b/entries/mouseup-shorthand.xml
@@ -0,0 +1,36 @@
+
+
+  .mouseup()
+  Bind an event handler to the "mouseup" event, or trigger that event on an element.
+  
+    1.0
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.4.3
+    
+      An object containing data that will be passed to the event handler.
+    
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.0
+  
+  
+    
              
+      
              This API is deprecated.
              
+      
              Instead of .mouseup( handler ) or .mouseup( eventData, handler ), use .on( "mouseup", handler ) or .on( "mouseup", eventData, handler ), respectively.
              
+      
              Instead of .mouseup(), use .trigger( "mouseup" ).
              
+    
              
+                
+  
+  
+  
+  
+              
diff --git a/entries/mouseup.xml b/entries/mouseup.xml
index e18080a6..205c0794 100644
--- a/entries/mouseup.xml
+++ b/entries/mouseup.xml
@@ -1,16 +1,15 @@
 
-
-  .mouseup()
-  Bind an event handler to the "mouseup" JavaScript event, or trigger that event on an element.
+
+Bind an event handler to the "mouseup" event, or trigger that event on an element.
+
+
+  mouseup event
+  Bind an event handler to the "mouseup" event.
   
-    1.0
-    
-      A function to execute each time the event is triggered.
-      
+    1.7
+    
+      The string "mouseup".
     
-  
-  
-    1.4.3
     
       An object containing data that will be passed to the event handler.
     
@@ -19,11 +18,10 @@
       
     
   
-  
-    1.0
-  
   
-    
              This method is a shortcut for .on('mouseup', handler) in the first variation, and .trigger('mouseup') in the second.
              
+    
              
+      
              This page describes the mouseup event. For the deprecated .mouseup() method, see .mouseup().
              
+    
              
     
              The mouseup event is sent to an element when the mouse pointer is over the element, and the mouse button is released. Any HTML element can receive this event.
              
     
              For example, consider the HTML:
              
     
              
@@ -40,34 +38,33 @@
     
     
              The event handler can be bound to any <div>:
              
     
              
-$( "#target" ).mouseup(function() {
-  alert( "Handler for .mouseup() called." );
-});
+$( "#target" ).on( "mouseup", function() {
+  alert( "Handler for `mouseup` called." );
+} );
     
              
     
              Now if we click on this element, the alert is displayed:
              
     
              
-      Handler for .mouseup() called.
+      Handler for `mouseup` called.
     
              
     
              We can also trigger the event when a different element is clicked:
              
     
              
-$( "#other" ).click(function() {
-  $( "#target" ).mouseup();
-});
+$( "#other" ).on( "click", function() {
+  $( "#target" ).trigger( "mouseup" );
+} );
     
              
     
              After this code executes, clicks on Trigger the handler will also alert the message.
              
     
              If the user clicks outside an element, drags onto it, and releases the button, this is still counted as a mouseup event. This sequence of actions is not treated as a button press in most user interfaces, so it is usually better to use the click event unless we know that the mouseup event is preferable for a particular situation.
              
   
-  
   
     Show texts when mouseup and mousedown event triggering.
     Mouse up." );
-  })
-  .mousedown(function() {
+  } )
+  .on( "mousedown", function() {
     $( this ).append( "Mouse down." );
-  });
+  } );
 ]]>
     Press mouse and release here.
              
@@ -75,5 +72,23 @@ $( "p" )
                 
   
   
-  
+  
+
+
+
+  mouseup event
+  Trigger the "mouseup" event on an element.
+  
+    1.0
+    
+      The string "mouseup".
+    
+  
+  
+    
              See the description for .on( "mouseup", ... ).
              
+                
+  
+  
               
+
+
diff --git a/entries/nth-child-selector.xml b/entries/nth-child-selector.xml
index 741052a1..e2994d7d 100644
--- a/entries/nth-child-selector.xml
+++ b/entries/nth-child-selector.xml
@@ -53,7 +53,7 @@ $( "ul li:nth-child(2)" ).append( " - 2nd!" );
   
     This is a playground to see how the selector works with different strings.  Notice that this is different from the even and odd which have no regard for parent and just filter the list of elements to every other one.  The :nth-child, however, counts the index of the child to its particular parent.  In any case, it's easier to see than explain so...
      - 2nd to last!" );
   
     This is a playground to see how the selector works with different strings. 
      - 2nd to last!" );
   
     This is a playground to see how the selector works with different strings. 
     
       Click to see the offset.
       Attaching many delegated event handlers near the top of the document tree can degrade performance. Each time the event occurs, jQuery must compare all selectors of all attached events of that type to every element in the path from the event target up to the top of the document. For best performance, attach delegated events at a document location as close as possible to the target elements. Avoid excessive use of document or document.body for delegated events on large documents.
              
     
              jQuery can process simple selectors of the form tag#id.class very quickly when they are used to filter delegated events. So, "#myForm", "a.external", and "button" are all fast selectors. Delegated events that use more complex selectors, particularly hierarchical ones, can be several times slower--although they are still fast enough for most applications. Hierarchical selectors can often be avoided simply by attaching the handler to a more appropriate point in the document. For example, instead of $( "body" ).on( "click", "#commentForm .addNew", addComment ) use $( "#commentForm" ).on( "click", ".addNew", addComment ).
              
     
              Additional notes
              
-    
              There are shorthand methods for some events such as .click() that can be used to attach or trigger event handlers. For a complete list of shorthand methods, see the events category.
              
+    
              Some events have dedicated pages, describing specifics of their usage. For a complete list of those events, see the events category.
              
     
              Deprecated in jQuery 1.8, removed in 1.9: The name "hover" used as a shorthand for the string "mouseenter mouseleave". It attaches a single event handler for those two events, and the handler must examine event.type to determine whether the event is mouseenter or mouseleave. Do not confuse the "hover" pseudo-event-name with the .hover() method, which accepts one or two functions.
              
     
              jQuery's event system requires that a DOM element allow attaching data via a property on the element, so that events can be tracked and delivered. The object, embed, and applet elements cannot attach data, and therefore cannot have jQuery events bound to them.
              
     
              The focus and blur events are specified by the W3C to not bubble, but jQuery defines cross-browser focusin and focusout events that do bubble. When focus and blur are used to attach delegated event handlers, jQuery maps the names and delivers them as focusin and focusout respectively. For consistency and clarity, use the bubbling event type names.
              
diff --git a/entries/parents.xml b/entries/parents.xml
index 403b2393..57b860b4 100644
--- a/entries/parents.xml
+++ b/entries/parents.xml
@@ -82,7 +82,7 @@ function showParents() {
       .length;
   $( "b" ).text( "Unique div parents: " + len );
 }
-$( "span" ).click(function() {
+$( "span)" ).on( "click", function() {
   $( this ).toggleClass( "selected" );
   showParents();
 });
diff --git a/entries/password-selector.xml b/entries/password-selector.xml
index 8d632b8f..053e0dc2 100644
--- a/entries/password-selector.xml
+++ b/entries/password-selector.xml
@@ -13,18 +13,18 @@
   
     Finds all password inputs.
     
     
       Display the checked property and attribute of a checkbox as it changes.
       " + $input.attr( "checked" ) + "
              " +
     ".prop( \"checked\" ): " + $input.prop( "checked" ) + "
              " +
     ".is( \":checked\" ): " + $input.is( ":checked" ) + "" );
-}).change();
+} ).trigger( "change" );
 ]]>              
       
       Queue a custom function.
       
       
       Set a queue array to delete the queue.
       " )
   .parent()
-    .css({
+    .css( {
       background: "yellow",
       border: "3px red solid"
-    });
+    } );
 
 $( "div" )
   .text( "For this type jQuery found " + input.length + "." )
   .css( "color", "red" );
 
 // Prevent form submission
-$( "form" ).submit(function( event ) {
+$( "form" ).on( "submit", function( event ) {
   event.preventDefault();
-});
+} );
 ]]>
     
     Removes all paragraphs from the DOM
     
     
     Removes all paragraphs that contain "Hello" from the DOM.  Analogous to doing $("p").filter(":contains('Hello')").remove().
     
diff --git a/entries/removeAttr.xml b/entries/removeAttr.xml
index 92a92b22..46ce85b2 100644
--- a/entries/removeAttr.xml
+++ b/entries/removeAttr.xml
@@ -22,7 +22,7 @@ console.log( "onclick property: ", $element[ 0 ].onclick );
     
     On click, replace the button with a div containing the same word.
     " + $( this ).text() + "
            " ); }); ]]> @@ -108,7 +108,7 @@ $( "p" ).replaceWith( "Paragraph. " ); On click, replace each paragraph with a div that is already in the DOM and selected with the $() function. Notice it doesn't clone the object but rather moves it to replace the paragraph. diff --git a/entries/reset-selector.xml b/entries/reset-selector.xml index 301b0e5e..db558608 100644 --- a/entries/reset-selector.xml +++ b/entries/reset-selector.xml @@ -13,18 +13,18 @@ Finds all reset inputs. + + .resize() + Bind an event handler to the "resize" event, or trigger that event on an element. + + 1.0 + + A function to execute each time the event is triggered. + + + + + 1.4.3 + + An object containing data that will be passed to the event handler. + + + A function to execute each time the event is triggered. + + + + + 1.0 + + +
            +

            This API is deprecated.

            +

            Instead of .resize( handler ) or .resize( eventData, handler ), use .on( "resize", handler ) or .on( "resize", eventData, handler ), respectively.

            +

            Instead of .resize(), use .trigger( "resize" ).

            +
            +             + + + + +             diff --git a/entries/resize.xml b/entries/resize.xml index 3c4f844d..74cc61fe 100644 --- a/entries/resize.xml +++ b/entries/resize.xml @@ -1,16 +1,15 @@ - - .resize() - Bind an event handler to the "resize" JavaScript event, or trigger that event on an element. + + +Bind an event handler to the "resize" event, or trigger that event on an element. + + resize event + Bind an event handler to the "resize" event. - 1.0 - - A function to execute each time the event is triggered. - + 1.7 + + The string "resize". - - - 1.4.3 An object containing data that will be passed to the event handler. @@ -19,30 +18,46 @@ - - 1.0 - -

            This method is a shortcut for .on('resize', handler) in the first and second variations, and .trigger( "resize" ) in the third.

            +
            +

            This page describes the resize event. For the deprecated .resize() method, see .resize().

            +

            The resize event is sent to the window element when the size of the browser window changes:

            
-$( window ).resize(function() {
-  $( "#log" ).append( "<div>Handler for .resize() called.</div>" );
-});
+$( window ).on( "resize", function() {
+  $( "#log" ).append( "<div>Handler for `resize` called.</div>" );
+} );

            Now whenever the browser window's size is changed, the message is appended to <div id="log"> one or more times, depending on the browser.

            Code in a resize handler should never rely on the number of times the handler is called. Depending on implementation, resize events can be sent continuously as the resizing is in progress (the typical behavior in Internet Explorer and WebKit-based browsers such as Safari and Chrome), or only once at the end of the resize operation (the typical behavior in some other browsers such as Opera).

             - To see the window width while (or after) it is resized, try: " + $( window ).width() + "" ); -}); +} ); ]]> - + +             + + + resize event + Trigger the "resize" event on an element. + + 1.0 + + The string "resize". + + + +

            See the description for .on( "resize", ... ).

            +             + +             + +             diff --git a/entries/scroll-shorthand.xml b/entries/scroll-shorthand.xml new file mode 100644 index 00000000..67b7997e --- /dev/null +++ b/entries/scroll-shorthand.xml @@ -0,0 +1,36 @@ + + + .scroll() + Bind an event handler to the "scroll" event, or trigger that event on an element. + + 1.0 + + A function to execute each time the event is triggered. + + + + + 1.4.3 + + An object containing data that will be passed to the event handler. + + + A function to execute each time the event is triggered. + + + + + 1.0 + + +
            +

            This API is deprecated.

            +

            Instead of .scroll( handler ) or .scroll( eventData, handler ), use .on( "scroll", handler ) or .on( "scroll", eventData, handler ), respectively.

            +

            Instead of .scroll(), use .trigger( "scroll" ).

            +
            +             + + + + +             diff --git a/entries/scroll.xml b/entries/scroll.xml index 8529cb0c..5f46ddfe 100644 --- a/entries/scroll.xml +++ b/entries/scroll.xml @@ -1,16 +1,15 @@ - - .scroll() - Bind an event handler to the "scroll" JavaScript event, or trigger that event on an element. + + +Bind an event handler to the "scroll" event, or trigger that event on an element. + + scroll event + Bind an event handler to the "scroll" event. - 1.0 - - A function to execute each time the event is triggered. - + 1.7 + + The string "scroll". - - - 1.4.3 An object containing data that will be passed to the event handler. @@ -19,11 +18,10 @@ - - 1.0 - -

            This method is a shortcut for .on( "scroll", handler ) in the first and second variations, and .trigger( "scroll" ) in the third.

            +
            +

            This page describes the scroll event. For the deprecated .scroll() method, see .scroll().

            +

            The scroll event is sent to an element when the user scrolls to a different place in the element. It applies to window objects, but also to scrollable frames and elements with the overflow CSS property set to scroll (or auto when the element's explicit height or width is less than the height or width of its contents).

            For example, consider the HTML:

            
@@ -41,7 +39,7 @@
   Trigger the handler
 </div>
 <div id="log"></div>
-
            +

            The style definition is present to make the target element small enough to be scrollable:

            @@ -49,33 +47,32 @@

            The scroll event handler can be bound to this element:

            
-$( "#target" ).scroll(function() {
-  $( "#log" ).append( "<div>Handler for .scroll() called.</div>" );
-});
+$( "#target" ).on( "scroll", function() {
+  $( "#log" ).append( "<div>Handler for `scroll` called.</div>" );
+} );

            Now when the user scrolls the text up or down, one or more messages are appended to <div id="log"></div>:

            - Handler for .scroll() called. + Handler for `scroll` called.

            -

            To trigger the event manually, apply .scroll() without an argument:

            +

            To trigger the event manually, use .trigger( "scroll" ):

            
-$( "#other" ).click(function() {
-  $( "#target" ).scroll();
-});
+$( "#other" ).on( "click", function() {
+  $( "#target" ).trigger( "scroll" );
+} );

            After this code executes, clicks on Trigger the handler will also append the message.

            A scroll event is sent whenever the element's scroll position changes, regardless of the cause. A mouse click or drag on the scroll bar, dragging inside the element, pressing the arrow keys, or using the mouse's scroll wheel could cause this event.

             - To do something when your page is scrolled: - + +             + + + scroll event + Trigger the "scroll" event on an element. + + 1.0 + + The string "scroll". + + + +

            See the description for .on( "scroll", ... ).

            +             + +             + +             diff --git a/entries/select-shorthand.xml b/entries/select-shorthand.xml new file mode 100644 index 00000000..e3fb0227 --- /dev/null +++ b/entries/select-shorthand.xml @@ -0,0 +1,36 @@ + + + .select() + Bind an event handler to the "select" event, or trigger that event on an element. + + 1.0 + + A function to execute each time the event is triggered. + + + + + 1.4.3 + + An object containing data that will be passed to the event handler. + + + A function to execute each time the event is triggered. + + + + + 1.0 + + +
            +

            This API is deprecated.

            +

            Instead of .select( handler ) or .select( eventData, handler ), use .on( "select", handler ) or .on( "select", eventData, handler ), respectively.

            +

            Instead of .select(), use .trigger( "select" ).

            +
            +             + + + + +             diff --git a/entries/select.xml b/entries/select.xml index 244cee7c..60573881 100644 --- a/entries/select.xml +++ b/entries/select.xml @@ -1,16 +1,15 @@ - - .select() - Bind an event handler to the "select" JavaScript event, or trigger that event on an element. + +Bind an event handler to the "select" event, or trigger that event on an element. + + + select event + Bind an event handler to the "select" event. - 1.0 - - A function to execute each time the event is triggered. - + 1.7 + + The string "select". - - - 1.4.3 An object containing data that will be passed to the event handler. @@ -19,11 +18,10 @@ - - 1.0 - -

            This method is a shortcut for .on( "select", handler ) in the first two variations, and .trigger( "select" ) in the third.

            +
            +

            This page describes the select event. For the deprecated .select() method, see .select().

            +

            The select event is sent to an element when the user makes a text selection inside it. This event is limited to <input type="text"> fields and <textarea> boxes.

            For example, consider the HTML:

            
@@ -35,32 +33,31 @@
 </div>

            The event handler can be bound to the text input:

            
-$( "#target" ).select(function() {
-  alert( "Handler for .select() called." );
-});
+$( "#target" ).on( "select", function() {
+  alert( "Handler for `select` called." );
+} );
            -

            Now when any portion of the text is selected, the alert is displayed. Merely setting the location of the insertion point will not trigger the event. To trigger the event manually, apply .select() without an argument:

            +

            Now when any portion of the text is selected, the alert is displayed. Merely setting the location of the insertion point will not trigger the event. To trigger the event manually, use .trigger( "select" ):

            
-$( "#other").click(function() {
-  $( "#target" ).select();
-});
+$( "#other").on( "click", function() {
+  $( "#target" ).trigger( "select" );
+} );

            After this code executes, clicks on the Trigger button will also alert the message:

            - Handler for .select() called. + Handler for `select` called.

            In addition, the default select action on the field will be fired, so the entire text field will be selected.

            The method for retrieving the current selected text differs from one browser to another. A number of jQuery plug-ins offer cross-platform solutions.

             - To do something when text in input boxes is selected: To trigger the select event on all input elements, try: - + +             + + + select event + Trigger the "select" event on an element. + + 1.0 + + The string "select". + + + +

            See the description for .on( "select", ... ).

            +             + +             + +             diff --git a/entries/selected-selector.xml b/entries/selected-selector.xml index c96bf422..5eb6cef8 100644 --- a/entries/selected-selector.xml +++ b/entries/selected-selector.xml @@ -14,13 +14,13 @@ Attaches a change event to the select that gets the text for each selected option and writes them in the div. It then triggers the event for the initial text draw. The .serializeArray() method uses the standard W3C rules for successful controls to determine which elements it should include; in particular the element cannot be disabled and must contain a name attribute. No submit button value is serialized since the form was not submitted using a button. Data from file select elements is not serialized. Elements that do not contain a value attribute are represented with the empty string value.

            This method can act on a jQuery object that has selected individual form controls, such as <input>, <textarea>, and <select>. However, it is typically easier to select the <form> element itself for serialization:

            
-$( "form" ).submit(function( event ) {
+$( "form" ).on( "submit", function( event ) {
   console.log( $( this ).serializeArray() );
   event.preventDefault();
-});
+} );

            This produces the following data structure (provided that the browser supports console.log):

            
@@ -70,11 +70,11 @@ $( "form" ).submit(function( event ) {
     $( "#results" ).empty();
     jQuery.each( fields, function( i, field ) {
       $( "#results" ).append( field.value + " " );
-    });
+    } );
   }
 
-  $( ":checkbox, :radio" ).click( showValues );
-  $( "select" ).change( showValues );
+  $( ":checkbox, :radio" ).on( "click", showValues );
+  $( "select" ).on( "change", showValues );
   showValues();
 ]]>
     
     Animates all hidden paragraphs to show slowly, completing the animation within 600 milliseconds.
     
@@ -84,13 +84,13 @@ $( "button" ).click(function() {
   
     Show the first div, followed by each next adjacent sibling div in order, with a 200ms animation. Each animation starts when the previous sibling div's animation ends.
     
@@ -120,19 +120,19 @@ function doIt() {
   $( "span,div" ).show( "slow" );
 }
 // Can pass in function name
-$( "button" ).click( doIt );
+$( "button" ).on( "click", doIt );
 
-$( "form" ).submit(function( event ) {
+$( "form" ).on( "submit", function( event ) {
   if ( $( "input" ).val() === "yes" ) {
     $( "p" ).show( 4000, function() {
       $( this ).text( "Ok, DONE! (now showing)" );
-    });
+    } );
   }
   $( "span,div" ).hide( "fast" );
 
   // Prevent form submission
   event.preventDefault();
-});
+} );
 ]]>
     Count the divs.
     " ) );
     var n = $( "div" ).size();
     $( "span" ).text( "There are " + n + " divs. Click to add more." );
-  })
+  } )
 
   // Trigger the click to start
-  .click();
+  .trigger( "click" );
 ]]>
   
   
diff --git a/entries/slice.xml b/entries/slice.xml
index 81d76c98..8f94ce16 100644
--- a/entries/slice.xml
+++ b/entries/slice.xml
@@ -62,7 +62,7 @@ function colorEm() {
     ").css( 'background', 'yellow' );" );
 }
 
-$( "button" ).click( colorEm );
+$( "button" ).on( "click", colorEm );
 ]]>

            With the element initially hidden, we can show it slowly:

            
-$( "#clickme" ).click(function() {
+$( "#clickme)" ).on( "click", function() {
   $( "#book" ).slideDown( "slow", function() {
     // Animation complete.
   });
@@ -54,13 +54,13 @@ $( "#clickme" ).click(function() {
   
     Animates all divs to slide down and show themselves over 600 milliseconds.
     
     
     Animates all inputs to slide down, completing the animation within 1000 milliseconds. Once the animation is done, the input look is changed especially if it is the middle input which gets the focus.

            We will cause .slideToggle() to be called when another element is clicked:

            
-$( "#clickme" ).click(function() {
+$( "#clickme)" ).on( "click", function() {
   $( "#book" ).slideToggle( "slow", function() {
     // Animation complete.
   });
@@ -63,7 +63,7 @@ $( "#clickme" ).click(function() {
   
     Animates all paragraphs to slide up or down, completing the animation within 600 milliseconds.
     
@@ -84,7 +84,7 @@ $( "button" ).click(function() {
   
     Animates divs between dividers with a toggle that makes some appear and some disappear.

            With the element initially shown, we can hide it slowly:

            
-$( "#clickme" ).click(function() {
+$( "#clickme)" ).on( "click", function() {
   $( "#book" ).slideUp( "slow", function() {
     // Animation complete.
   });
@@ -54,13 +54,13 @@ $( "#clickme" ).click(function() {
   
     Animates all divs to slide up, completing the animation within 400 milliseconds.
     
     
     Animates the parent paragraph to slide up, completing the animation within 200 milliseconds. Once the animation is done, it displays an alert.
     Click the Go button once to start the animation, then click the STOP button to stop it where it's currently positioned.  Another option is to click several buttons to queue them up and see that stop just kills the currently playing one.
     
diff --git a/entries/submit-selector.xml b/entries/submit-selector.xml
index a4c9aa01..f6c48b8f 100644
--- a/entries/submit-selector.xml
+++ b/entries/submit-selector.xml
@@ -15,25 +15,25 @@
     " + inputEl[ 0 ].nodeName + inputType + "" );
-})
+} );
 ]]>
     
+
+  .submit()
+  Bind an event handler to the "submit" event, or trigger that event on an element.
+  
+    1.0
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.4.3
+    
+      An object containing data that will be passed to the event handler.
+    
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.0
+  
+  
+    
            
+      
            This API is deprecated.
            
+      
            Instead of .submit( handler ) or .submit( eventData, handler ), use .on( "submit", handler ) or .on( "submit", eventData, handler ), respectively.
            
+      
            Instead of .submit(), use .trigger( "submit" ).
            
+    
            
+              
+  
+  
+  
+  
+            
diff --git a/entries/submit.xml b/entries/submit.xml
index f4626f5b..42a32ea1 100644
--- a/entries/submit.xml
+++ b/entries/submit.xml
@@ -1,16 +1,15 @@
 
-
-  .submit()
-  Bind an event handler to the "submit" JavaScript event, or trigger that event on an element.
+
+Bind an event handler to the "submit" event, or trigger that event on an element.
+
+
+  submit event
+  Bind an event handler to the "submit" event.
   
-    1.0
-    
-      A function to execute each time the event is triggered.
-      
+    1.7
+    
+      The string "submit".
     
-  
-  
-    1.4.3
     
       An object containing data that will be passed to the event handler.
     
@@ -19,11 +18,10 @@
       
     
   
-  
-    1.0
-  
   
-    
            This method is a shortcut for .on( "submit", handler ) in the first variation, and .trigger( "submit" ) in the third.
            
+    
            
+      
            This page describes the submit event. For the deprecated .submit() method, see .submit().
            
+    
            
     
            The submit event is sent to an element when the user is attempting to submit a form. It can only be attached to <form> elements. Forms can be submitted either by clicking an explicit <input type="submit">, <input type="image">, or <button type="submit">, or by pressing Enter when certain form elements have focus.
            
     
            
       
            Depending on the browser, the Enter key may only cause a form submission if the form has exactly one text field, or only when there is a submit button present. The interface should not rely on a particular behavior for this key unless the issue is forced by observing the keypress event for presses of the Enter key.
            
@@ -39,26 +37,25 @@
 </div>

            The event handler can be bound to the form:

            
-$( "#target" ).submit(function( event ) {
-  alert( "Handler for .submit() called." );
+$( "#target" ).on( "submit", function( event ) {
+  alert( "Handler for `submit` called." );
   event.preventDefault();
 });

            Now when the form is submitted, the message is alerted. This happens prior to the actual submission, so we can cancel the submit action by calling .preventDefault() on the event object or by returning false from our handler. We can trigger the event manually when another element is clicked:

            
-$( "#other" ).click(function() {
-  $( "#target" ).submit();
-});
+$( "#other" ).on( "click", function() {
+  $( "#target" ).trigger( "submit" );
+} );

            After this code executes, clicks on Trigger the handler will also display the message. In addition, the default submit action on the form will be fired, so the form will be submitted.

            The JavaScript submit event does not bubble in Internet Explorer. However, scripts that rely on event delegation with the submit event will work consistently across browsers as of jQuery 1.4, which has normalized the event's behavior.

            - If you'd like to prevent forms from being submitted unless a flag variable is set, try: If you'd like to prevent forms from being submitted unless a flag variable is set, try: To trigger the submit event on the first form on the page, try: - +             + + + submit event + Trigger the "submit" event on an element. + + 1.0 + + The string "submit". + + + +

            See the description for .on( "submit", ... ).

            +             + + +             + + diff --git a/entries/text-selector.xml b/entries/text-selector.xml index 9af4dc44..4886c3a5 100644 --- a/entries/text-selector.xml +++ b/entries/text-selector.xml @@ -19,19 +19,19 @@ $( "<input>" ).is( ":text" ); // true Finds all text inputs.

            We will cause .toggle() to be called when another element is clicked:

            
-$( "#clickme" ).click(function() {
+$( "#clickme)" ).on( "click", function() {
   $( "#book" ).toggle( "slow", function() {
     // Animation complete.
   });
@@ -92,9 +92,9 @@ if ( display === true ) {
   
     Toggles all paragraphs.
     
     Toggle
@@ -105,7 +105,7 @@ $( "button" ).click(function() {
   
     Animates all paragraphs to be shown if they are hidden and hidden if they are visible, completing the animation within 600 milliseconds.
     
@@ -126,7 +126,7 @@ $( "button" ).click(function() {
     Shows all paragraphs, then hides them all, back and forth.
     
diff --git a/entries/toggleClass.xml b/entries/toggleClass.xml
index 3ce8196c..fcb8da42 100644
--- a/entries/toggleClass.xml
+++ b/entries/toggleClass.xml
@@ -99,7 +99,7 @@ $( "div.foo" ).toggleClass(function() {
     
       Toggle the class 'highlight' when a paragraph is clicked.
       
@@ -128,15 +128,15 @@ $( "p" ).click(function() {
       Add the "highlight" class to the clicked paragraph on every third click of that paragraph, remove it every first and second click.
       
       
     Clicks to button #2 also trigger a click for button #1.
     To pass arbitrary data to an event:
     
   
diff --git a/entries/triggerHandler.xml b/entries/triggerHandler.xml
index d72516a8..fb2da985 100644
--- a/entries/triggerHandler.xml
+++ b/entries/triggerHandler.xml
@@ -37,15 +37,15 @@
   
     If you called .triggerHandler() on a focus event - the browser's default focus action would not be triggered, only the event handlers bound to the focus event.
     Focused!" ).appendTo( "body" ).fadeOut( 1000 );
-});
+} );
 ]]>
     .trigger( "focus" )
diff --git a/entries/unbind.xml b/entries/unbind.xml
index 8b91e66a..bbec1688 100644
--- a/entries/unbind.xml
+++ b/entries/unbind.xml
@@ -102,12 +102,12 @@ This example is also an illustration of a closure. Since the handler refers to t
 function aClick() {
   $( "div" ).show().fadeOut( "slow" );
 }
-$( "#bind" ).click(function() {
+$( "#bind)" ).on( "click", function() {
   $( "#theone" )
     .bind( "click", aClick )
     .text( "Can Click!" );
 });
-$( "#unbind" ).click(function() {
+$( "#unbind)" ).on( "click", function() {
   $( "#theone" )
     .unbind( "click", aClick )
     .text( "Does nothing..." );
diff --git a/entries/undelegate.xml b/entries/undelegate.xml
index f97e6b01..454e1ef3 100644
--- a/entries/undelegate.xml
+++ b/entries/undelegate.xml
@@ -52,12 +52,12 @@
 function aClick() {
   $( "div" ).show().fadeOut( "slow" );
 }
-$( "#bind" ).click(function() {
+$( "#bind)" ).on( "click", function() {
   $( "body" )
     .delegate( "#theone", "click", aClick )
     .find( "#theone" ).text( "Can Click!" );
 });
-$( "#unbind" ).click(function() {
+$( "#unbind)" ).on( "click", function() {
   $( "body" )
     .undelegate( "#theone", "click", aClick )
     .find( "#theone" ).text( "Does nothing..." );
diff --git a/entries/unload-shorthand.xml b/entries/unload-shorthand.xml
new file mode 100644
index 00000000..693768ec
--- /dev/null
+++ b/entries/unload-shorthand.xml
@@ -0,0 +1,37 @@
+
+
+  .unload()
+  Bind an event handler to the "unload" event, or trigger that event on an element.
+  
+    1.0
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.4.3
+    
+      An object containing data that will be passed to the event handler.
+    
+    
+      A function to execute each time the event is triggered.
+      
+    
+  
+  
+    1.0
+  
+  
+    
            
+      
            This API has been removed in jQuery 3.0.
            
+      
            Instead of .unload( handler ) or .unload( eventData, handler ), use .on( "unload", handler ) or .on( "unload", eventData, handler ), respectively.
            
+      
            Instead of .unload(), use .trigger( "unload" ).
            
+    
            
+              
+  
+  
+  
+  
+  
+            
diff --git a/entries/unload.xml b/entries/unload.xml
index b57d14f4..05d1c27a 100644
--- a/entries/unload.xml
+++ b/entries/unload.xml
@@ -1,15 +1,15 @@
 
-
-  .unload()
+
+Bind an event handler to the "unload" event, or trigger that event on an element.
+
+
+  unload event
+  Bind an event handler to the "unload" event.
   
-    1.0
-    
-      A function to execute when the event is triggered.
-      
+    1.7
+    
+      The string "unload".
     
-  
-  
-    1.4.3
     
       A plain object of data that will be passed to the event handler.
     
@@ -18,36 +18,49 @@
       
     
   
-  Bind an event handler to the "unload" JavaScript event.
   
     
            
-      
            Note: This API has been removed in jQuery 3.0; please use .on( "unload", handler ) instead of .unload( handler ) and .trigger( "unload" ) instead of .unload().
            
+      
            This page describes the unload event. For the .unload() method removed in jQuery 3.0, see .unload().
            
     
            
-    
            This method is a shortcut for .on( "unload", handler ).
            
     
            The unload event is sent to the window element when the user navigates away from the page. This could mean one of many things. The user could have clicked on a link to leave the page, or typed in a new URL in the address bar. The forward and back buttons will trigger the event. Closing the browser window will cause the event to be triggered. Even a page reload will first create an unload event.
            
     
            
       
            The exact handling of the unload event has varied from version to version of browsers. For example, some versions of Firefox trigger the event when a link is followed, but not when the window is closed. In practical usage, behavior should be tested on all supported browsers and contrasted with the similar beforeunload event.
            
     
            
     
            Any unload event handler should be bound to the window object:
            
     
            
-$( window ).unload(function() {
-  return "Handler for .unload() called.";
-});
+$( window ).on( "unload", function() {
+  return "Handler for `unload` called.";
+} );
     
            
     
            This event is available so that scripts can perform cleanup when the user leaves the page. Most browsers will ignore calls to alert(), confirm() and prompt() inside the event handler. The string you return may be used in a confirmation dialog, but not all browsers support this. It is not possible to cancel the unload event with .preventDefault().
            
               
-  
   
     To display an alert when a page is unloaded:
     
   
   
   
-  
-  
-  
+  
+            
+
+
+  unload event
+  Trigger the "unload" event on an element.
+  
+    1.0
+    
+      The string "unload".
+    
+  
+  
+    
            See the description for .on( "unload", ... ).
            
+              
+  
+  
             
+
+            
diff --git a/entries/unwrap.xml b/entries/unwrap.xml
index ff6d6100..1ba959aa 100644
--- a/entries/unwrap.xml
+++ b/entries/unwrap.xml
@@ -18,7 +18,7 @@
     Wrap/unwrap a div around each of the paragraphs.
     Multiple: " + multipleValues.join( ", " ) );
 }
 
-$( "select" ).change( displayVals );
+$( "select" ).on( "change", displayVals );
 displayVals();
 ]]>
       Find the value of an input box.
       
       
       Set the value of an input box.
       
     Make all visible divs turn yellow on click.
     
     
       
 		
-			If a request with  returns an error code, it will fail silently unless the script has also called the global .ajaxError()  method. Alternatively, as of jQuery 1.5, the .error() method of the jqXHR object returned by  is also available for error handling.
+			If a request with  returns an error code, it will fail silently unless the script has also called the global ajaxError event. Alternatively, as of jQuery 1.5, the .error() method of the jqXHR object returned by  is also available for error handling.
 		
 		
-			If $.ajax() or $.ajaxSetup() is called with the global option set to false, the  method will not fire.
+			If $.ajax() or $.ajaxSetup() is called with the global option set to false, the  event will not fire.
 		
 		
 			If  is called on an unordered list (<ul>) and its <li> elements have position (relative, absolute, or fixed), the effect may not work properly in IE6 through at least IE9 unless the <ul> has "layout." To remedy the problem, add the position: relative; and zoom: 1; CSS declarations to the ul.
@@ -64,11 +64,8 @@
 		
 			Using this selector heavily can have performance implications, as it may force the browser to re-render the page before it can determine visibility. Tracking the visibility of elements via other methods, using a class for example, can provide better performance.
 		
-		
-			As the .() method is just a shorthand for .on( "", handler ), detaching is possible using .off( "" ).
-		
 		
-			As of jQuery 1.9, all the handlers for the jQuery global Ajax events, including those added with the  method, must be attached to document.
+			As of jQuery 1.9, all the handlers for the jQuery global Ajax events, including those added with .on( "", ... ), must be attached to document.
 		
 		
 			jQuery doesn't officially support SVG. Using jQuery methods on SVG documents, unless explicitly documented for that method, might cause unexpected behaviors. Examples of methods that support SVG as of jQuery 3.0 are addClass and removeClass.
diff --git a/pages/Types.html b/pages/Types.html
index ad8285ae..969d154a 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -459,7 +459,7 @@ 
             Function 
            
 
            You see a lot of anonymous functions in jQuery code:
 
            
 
            $( document ).ready(function() {});
-$( "a" ).click(function() {});
+$( "a)" ).on( "click", function() {});
 $.ajax({
   url: "someurl.php",
   success: function() {}
@@ -490,7 +490,7 @@ 
             Context, Call and Apply 
            
 
            $( document ).ready(function() {
   // this refers to window.document
 });
-$( "a" ).click(function() {
+$( "a)" ).on( "click", function() {
   // this refers to an anchor DOM element
 });
 
            
@@ -554,7 +554,7 @@ 
             Proxy Pattern 
            
 
             Callback 
            
 
            A callback is a plain JavaScript function passed to some method as an argument or option. Some callbacks are just events, called to give the user a chance to react when a certain state is triggered. jQuery's event system uses such callbacks everywhere:
 
            
-
            $( "body" ).click(function( event ) {
+
            $( "body" ).on( "click", function( event ) {
   console.log( "clicked: " + event.target );
 });
 
            
@@ -562,9 +562,9 @@ 
             Callback 
            
 
            
 
            Some callbacks are required to return something, others make that return value optional. To prevent a form submission, a submit event handler can return false:
 
            
-
            $( "#myform" ).submit(function() {
+
            $( "#myform" ).on( "submit", function() {
   return false;
-});
+} );
 
            
 
            Instead of always returning false, the callback could check fields of the form for validity, and return false only when the form is invalid.
 
            

From 92bad3bb64ee5481579436dff5bd7fc5ff9f9480 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Mon, 24 Apr 2023 18:48:17 +0200
Subject: [PATCH 632/699] 3.2.0

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 458a6801..3c4265b8 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.1.8",
+  "version": "3.2.0",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index a4ee7333..2850202e 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.1.8",
+  "version": "3.2.0",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From d9e0da7e544b752933c3f4877d8b5f62b15d92df Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Mon, 24 Apr 2023 19:03:32 +0200
Subject: [PATCH 633/699] All: Mark AJAX event shorthands as deprecated in 3.5

Previously, they've been incorrectly marked as deprecated in 3.3.

Ref gh-1205
Ref gh-1223
---
 entries/ajaxComplete-shorthand.xml | 2 +-
 entries/ajaxError-shorthand.xml    | 2 +-
 entries/ajaxSend-shorthand.xml     | 2 +-
 entries/ajaxStart-shorthand.xml    | 2 +-
 entries/ajaxStop-shorthand.xml     | 2 +-
 entries/ajaxSuccess-shorthand.xml  | 2 +-
 6 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/entries/ajaxComplete-shorthand.xml b/entries/ajaxComplete-shorthand.xml
index 73d766d5..8e9cc6bf 100644
--- a/entries/ajaxComplete-shorthand.xml
+++ b/entries/ajaxComplete-shorthand.xml
@@ -15,5 +15,5 @@
   
   
   
-  
+  
 
diff --git a/entries/ajaxError-shorthand.xml b/entries/ajaxError-shorthand.xml
index c1a306bd..c1794365 100644
--- a/entries/ajaxError-shorthand.xml
+++ b/entries/ajaxError-shorthand.xml
@@ -15,5 +15,5 @@
   
   
   
-  
+  
 
diff --git a/entries/ajaxSend-shorthand.xml b/entries/ajaxSend-shorthand.xml
index 4c1dc9cc..37d39222 100644
--- a/entries/ajaxSend-shorthand.xml
+++ b/entries/ajaxSend-shorthand.xml
@@ -15,5 +15,5 @@
   
   
   
-  
+  
 
diff --git a/entries/ajaxStart-shorthand.xml b/entries/ajaxStart-shorthand.xml
index 41c7c71a..496152b3 100644
--- a/entries/ajaxStart-shorthand.xml
+++ b/entries/ajaxStart-shorthand.xml
@@ -15,5 +15,5 @@
   
   
   
-  
+  
 
diff --git a/entries/ajaxStop-shorthand.xml b/entries/ajaxStop-shorthand.xml
index e4b5ab83..d5fe7f30 100644
--- a/entries/ajaxStop-shorthand.xml
+++ b/entries/ajaxStop-shorthand.xml
@@ -15,5 +15,5 @@
   
   
   
-  
+  
 
diff --git a/entries/ajaxSuccess-shorthand.xml b/entries/ajaxSuccess-shorthand.xml
index 358b5ff5..95fa6e0e 100644
--- a/entries/ajaxSuccess-shorthand.xml
+++ b/entries/ajaxSuccess-shorthand.xml
@@ -15,5 +15,5 @@
   
   
   
-  
+  
 

From a8581e2f19a289abb3698d220c5c1a7f8e8b5031 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Mon, 24 Apr 2023 19:04:12 +0200
Subject: [PATCH 634/699] 3.2.1

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 3c4265b8..382479f8 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.2.0",
+  "version": "3.2.1",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 2850202e..c628acd1 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.2.0",
+  "version": "3.2.1",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From a71164b950e76735604c13f8542f0e3949a1a1a7 Mon Sep 17 00:00:00 2001
From: Christopher Bonnell 
Date: Wed, 3 May 2023 17:37:25 -0400
Subject: [PATCH 635/699] All: Fix button selectors

A few selectors erroneously used `button)` instead of `button`.
This has been fixed.

Fixes gh-1226
Closes gh-1227
---
 entries/bind.xml                      | 2 +-
 entries/data.xml                      | 2 +-
 entries/delay.xml                     | 2 +-
 entries/delegate.xml                  | 2 +-
 entries/dequeue.xml                   | 2 +-
 entries/detach.xml                    | 2 +-
 entries/each.xml                      | 4 ++--
 entries/hide.xml                      | 2 +-
 entries/jQuery.dequeue.xml            | 2 +-
 entries/live.xml                      | 2 +-
 entries/nth-child-selector.xml        | 2 +-
 entries/nth-last-child-selector.xml   | 2 +-
 entries/nth-last-of-type-selector.xml | 2 +-
 entries/prev.xml                      | 2 +-
 entries/remove.xml                    | 2 +-
 entries/removeAttr.xml                | 2 +-
 entries/replaceWith.xml               | 2 +-
 entries/show.xml                      | 2 +-
 entries/slideToggle.xml               | 2 +-
 entries/slideUp.xml                   | 2 +-
 entries/toggle.xml                    | 4 ++--
 entries/unwrap.xml                    | 2 +-
 entries/val.xml                       | 2 +-
 entries/visible-selector.xml          | 2 +-
 24 files changed, 26 insertions(+), 26 deletions(-)

diff --git a/entries/bind.xml b/entries/bind.xml
index def89e62..aa45c455 100644
--- a/entries/bind.xml
+++ b/entries/bind.xml
@@ -221,7 +221,7 @@ $( "p" ).bind( "myCustomEvent", function( e, myName, myValue ) {
     .fadeIn( 30 )
     .fadeOut( 1000 );
   });
-$( "button)" ).on( "click", function() {
+$( "button" ).on( "click", function() {
   $( "p" ).trigger( "myCustomEvent", [ "John" ] );
 });
 ]]>            
diff --git a/entries/data.xml b/entries/data.xml
index 5a4c4181..d998d38c 100644
--- a/entries/data.xml
+++ b/entries/data.xml
@@ -111,7 +111,7 @@ $( "div" ).data( "options" ).name === "John";
     
       Get the data named "blah" stored at for an element.
       
     
diff --git a/entries/dequeue.xml b/entries/dequeue.xml
index 24f89c3a..c54401c7 100644
--- a/entries/dequeue.xml
+++ b/entries/dequeue.xml
@@ -14,7 +14,7 @@
   
     Use dequeue to end a custom queue function which allows the queue to keep going.
     
       A function to execute for each matched element.
       
-            
+      
     
   
   Iterate over a jQuery object, executing a function for each matched element. 
@@ -106,7 +106,7 @@ To do list: (click here to change)
   
     Use return false to break out of each() loops early.
     
     Animates all shown paragraphs to hide slowly, completing the animation within 600 milliseconds.
     
diff --git a/entries/jQuery.dequeue.xml b/entries/jQuery.dequeue.xml
index d88b0779..c9b6faf2 100644
--- a/entries/jQuery.dequeue.xml
+++ b/entries/jQuery.dequeue.xml
@@ -18,7 +18,7 @@
   
     Use jQuery.dequeue() to end a custom queue function which allows the queue to keep going.
     
diff --git a/entries/nth-child-selector.xml b/entries/nth-child-selector.xml
index e2994d7d..8a5efc4c 100644
--- a/entries/nth-child-selector.xml
+++ b/entries/nth-child-selector.xml
@@ -53,7 +53,7 @@ $( "ul li:nth-child(2)" ).append( " - 2nd!" );
   
     This is a playground to see how the selector works with different strings.  Notice that this is different from the even and odd which have no regard for parent and just filter the list of elements to every other one.  The :nth-child, however, counts the index of the child to its particular parent.  In any case, it's easier to see than explain so...
      - 2nd to last!" );
   
     This is a playground to see how the selector works with different strings. 
      - 2nd to last!" );
   
     This is a playground to see how the selector works with different strings. 
     
     Removes all paragraphs that contain "Hello" from the DOM.  Analogous to doing $("p").filter(":contains('Hello')").remove().
     
diff --git a/entries/removeAttr.xml b/entries/removeAttr.xml
index 46ce85b2..6df34820 100644
--- a/entries/removeAttr.xml
+++ b/entries/removeAttr.xml
@@ -22,7 +22,7 @@ console.log( "onclick property: ", $element[ 0 ].onclick );
     
     On click, replace the button with a div containing the same word.
     " + $( this ).text() + "" );
 });
 ]]>
diff --git a/entries/show.xml b/entries/show.xml
index 0185aed7..5a807d52 100644
--- a/entries/show.xml
+++ b/entries/show.xml
@@ -67,7 +67,7 @@ $( "#clickme)" ).on( "click", function() {
   
     Animates all hidden paragraphs to show slowly, completing the animation within 600 milliseconds.
     
diff --git a/entries/slideToggle.xml b/entries/slideToggle.xml
index 217b9088..f3fc2352 100644
--- a/entries/slideToggle.xml
+++ b/entries/slideToggle.xml
@@ -63,7 +63,7 @@ $( "#clickme)" ).on( "click", function() {
   
     Animates all paragraphs to slide up or down, completing the animation within 600 milliseconds.
     
diff --git a/entries/slideUp.xml b/entries/slideUp.xml
index c6d32eef..d21f3354 100644
--- a/entries/slideUp.xml
+++ b/entries/slideUp.xml
@@ -83,7 +83,7 @@ Click me!
   
     Animates the parent paragraph to slide up, completing the animation within 200 milliseconds. Once the animation is done, it displays an alert.
     
     Animates all paragraphs to be shown if they are hidden and hidden if they are visible, completing the animation within 600 milliseconds.
     
@@ -126,7 +126,7 @@ $( "button)" ).on( "click", function() {
     Shows all paragraphs, then hides them all, back and forth.
     
diff --git a/entries/unwrap.xml b/entries/unwrap.xml
index 1ba959aa..b2dde604 100644
--- a/entries/unwrap.xml
+++ b/entries/unwrap.xml
@@ -18,7 +18,7 @@
     Wrap/unwrap a div around each of the paragraphs.
     
       Set the value of an input box.
       

From 21e195805b73f1457e0fc26e17e9d612d8e5a342 Mon Sep 17 00:00:00 2001
From: Christopher Bonnell 
Date: Thu, 4 May 2023 18:26:33 -0400
Subject: [PATCH 636/699] All: Fix event selectors

Multiple selectors erroneously used `selector)` instead of `selector`.
This has been fixed.

The typos were accidentally introduced during
a mass-replace in gh-1223.

Fixes gh-1228
Closes gh-1229
Ref gh-1223
Ref gh-1226
Ref gh-1227
---
 entries/ajaxComplete.xml       |  4 ++--
 entries/ajaxSend.xml           |  2 +-
 entries/animate.xml            | 22 +++++++++++-----------
 entries/animated-selector.xml  |  2 +-
 entries/clearQueue.xml         |  4 ++--
 entries/css.xml                |  4 ++--
 entries/detach.xml             |  2 +-
 entries/each.xml               |  2 +-
 entries/fadeIn.xml             |  4 ++--
 entries/fadeOut.xml            | 10 +++++-----
 entries/fadeTo.xml             |  4 ++--
 entries/height.xml             |  6 +++---
 entries/hide.xml               |  8 ++++----
 entries/html.xml               |  2 +-
 entries/index.xml              |  2 +-
 entries/is.xml                 |  8 ++++----
 entries/jQuery.fx.interval.xml |  2 +-
 entries/jQuery.fx.off.xml      |  2 +-
 entries/jQuery.getScript.xml   |  2 +-
 entries/jQuery.queue.xml       |  6 +++---
 entries/jQuery.sub.xml         |  2 +-
 entries/jQuery.xml             |  4 ++--
 entries/off.xml                |  4 ++--
 entries/parents.xml            |  2 +-
 entries/queue.xml              |  4 ++--
 entries/replaceWith.xml        |  2 +-
 entries/show.xml               |  6 +++---
 entries/slideDown.xml          |  2 +-
 entries/slideToggle.xml        |  4 ++--
 entries/slideUp.xml            |  2 +-
 entries/stop.xml               |  6 +++---
 entries/toggle.xml             |  2 +-
 entries/toggleClass.xml        |  2 +-
 entries/triggerHandler.xml     |  4 ++--
 entries/unbind.xml             |  4 ++--
 entries/undelegate.xml         |  4 ++--
 entries/width.xml              |  4 ++--
 37 files changed, 78 insertions(+), 78 deletions(-)

diff --git a/entries/ajaxComplete.xml b/entries/ajaxComplete.xml
index 168865e7..0c133516 100644
--- a/entries/ajaxComplete.xml
+++ b/entries/ajaxComplete.xml
@@ -7,7 +7,7 @@
     
       The string "ajaxComplete".
     
-          
+    
       
       
       
@@ -33,7 +33,7 @@ $( document ).on( "ajaxComplete", function() {
     
            
     
            Now, make an Ajax request using any jQuery method:
            
     
            
-$( ".trigger)" ).on( "click", function() {
+$( ".trigger" ).on( "click", function() {
   $( ".result" ).load( "ajax/test.html" );
 } );
     
            
diff --git a/entries/ajaxSend.xml b/entries/ajaxSend.xml
index ad01194e..cbd1641c 100644
--- a/entries/ajaxSend.xml
+++ b/entries/ajaxSend.xml
@@ -33,7 +33,7 @@ $( document ).on( "ajaxSend", function() {
     
            
     
            Now, make an Ajax request using any jQuery method:
            
     
            
-$( ".trigger)" ).on( "click", function() {
+$( ".trigger" ).on( "click", function() {
   $( ".result" ).load( "ajax/test.html" );
 } );
     
            
diff --git a/entries/animate.xml b/entries/animate.xml
index 1ece251c..c4ac9e70 100644
--- a/entries/animate.xml
+++ b/entries/animate.xml
@@ -45,7 +45,7 @@
     
            
     
            To animate the opacity, left offset, and height of the image simultaneously:
            
     
            
-$( "#clickme)" ).on( "click", function() {
+$( "#clickme" ).on( "click", function() {
   $( "#book" ).animate({
     opacity: 0.25,
     left: "+=50",
@@ -101,7 +101,7 @@ $( "li" ).animate({
     
            As of jQuery version 1.4, you can set per-property easing functions within a single .animate() call. In the first version of .animate(), each property can take an array as its value: The first member of the array is the CSS property and the second member is an easing function.  If a per-property easing function is not defined for a particular property, it uses the value of the .animate() method's optional easing argument. If the easing argument is not defined, the default swing function is used.
            
     
            For example, to simultaneously animate the width and height with the swing easing function and the opacity with the linear easing function:
            
     
            
-$( "#clickme)" ).on( "click", function() {
+$( "#clickme" ).on( "click", function() {
   $( "#book" ).animate({
     width: [ "toggle", "swing" ],
     height: [ "toggle", "swing" ],
@@ -113,7 +113,7 @@ $( "#clickme)" ).on( "click", function() {
     
            
     
            In the second version of .animate(), the options object can include the specialEasing property, which is itself an object of CSS properties and their corresponding easing functions.  For example, to simultaneously animate the width using the linear easing function and the height using the easeOutBounce easing function:
            
     
            
-$( "#clickme)" ).on( "click", function() {
+$( "#clickme" ).on( "click", function() {
   $( "#book" ).animate({
     width: "toggle",
     height: "toggle"
@@ -137,7 +137,7 @@ $( "#clickme)" ).on( "click", function() {
     
     Animates a div's left property with a relative value. Click several times on the buttons to see the relative animations queued up.
     
@@ -191,7 +191,7 @@ $( "#left)" ).on( "click", function(){
 
 The second button starts a traditional chained animation, where each animation will start once the previous animation on the element has completed.
     
     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. 
     
     Change the color of any div that is animated.
     
     Empty the queue.
     
       Get the background color of a clicked div.
       " + color + "." );
@@ -54,7 +54,7 @@ $( "div)" ).on( "click", function() {
     
       Get the width, height, text color, and background color of a clicked div.
       
     Detach all paragraphs from the DOM
     
     To access a jQuery object instead of the regular DOM element, use $( this ). For example:
     
     Fades a red block in over the text. Once the animation is done, it quickly fades in more text on top.
     
            
     
            With the element initially shown, we can hide it slowly:
            
     
            
-$( "#clickme)" ).on( "click", function() {
+$( "#clickme" ).on( "click", function() {
   $( "#book" ).fadeOut( "slow", function() {
     // Animation complete.
   });
@@ -56,7 +56,7 @@ $( "#clickme)" ).on( "click", function() {
   
     Animates all paragraphs to fade out, completing the animation within 600 milliseconds.
     
@@ -76,7 +76,7 @@ $( "p)" ).on( "click", function() {
   
     Fades out spans in one section that you click on.
     
     Fades out two divs, one with a "linear" easing and one with the default, "swing," easing.
     " ).text( this.id ).appendTo( "#log" );
   }
@@ -121,7 +121,7 @@ $( "#btn1)" ).on( "click", function() {
   $( "#box2" ).fadeOut( 1600, complete );
 });
 
-$( "#btn2)" ).on( "click", function() {
+$( "#btn2" ).on( "click", function() {
   $( "div" ).show();
   $( "#log" ).empty();
 });
diff --git a/entries/fadeTo.xml b/entries/fadeTo.xml
index b21cda8a..c77da0d6 100644
--- a/entries/fadeTo.xml
+++ b/entries/fadeTo.xml
@@ -44,7 +44,7 @@
 </div>
 <img id="book" src="book.png" alt="" width="100" height="123">
 // With the element initially shown, we can dim it slowly:
-$( "#clickme)" ).on( "click", function() {
+$( "#clickme" ).on( "click", function() {
   $( "#book" ).fadeTo( "slow" , 0.5, function() {
     // Animation complete.
   });
@@ -80,7 +80,7 @@ Compare to this one that won't fade.
   
     Fade div to a random opacity on each click, completing the animation within 200 milliseconds.
     
diff --git a/entries/height.xml b/entries/height.xml
index 604be8fb..3a57f603 100644
--- a/entries/height.xml
+++ b/entries/height.xml
@@ -34,13 +34,13 @@ $( document ).height();
 function showHeight( element, height ) {
   $( "div" ).text( "The height for the " + element + " is " + height + "px." );
 }
-$( "#getp)" ).on( "click", function() {
+$( "#getp" ).on( "click", function() {
   showHeight( "paragraph", $( "p" ).height() );
 });
-$( "#getd)" ).on( "click", function() {
+$( "#getd" ).on( "click", function() {
   showHeight( "document", $( document ).height() );
 });
-$( "#getw)" ).on( "click", function() {
+$( "#getw" ).on( "click", function() {
   showHeight( "window", $( window ).height() );
 });
 ]]>
diff --git a/entries/hide.xml b/entries/hide.xml
index 3db8c718..01f88a15 100644
--- a/entries/hide.xml
+++ b/entries/hide.xml
@@ -49,7 +49,7 @@ $( ".target" ).hide();
     
            
     
            
 // With the element initially shown, we can hide it slowly:
-$( "#clickme)" ).on( "click", function() {
+$( "#clickme" ).on( "click", function() {
   $( "#book" ).hide( "slow", function() {
     alert( "Animation complete." );
   });
@@ -101,13 +101,13 @@ $( "button" ).on( "click", function() {
   
     Animates all spans (words in this case) to hide fastly, completing each animation within 200 milliseconds. Once each animation is done, it starts the next one.
     
@@ -134,7 +134,7 @@ $( "#shower)" ).on( "click", function() {
 for ( var i = 0; i < 5; i++ ) {
   $( "
            " ).appendTo( document.body );
 }
-$( "div)" ).on( "click", function() {
+$( "div" ).on( "click", function() {
   $( this ).hide( 2000, function() {
     $( this ).remove();
   });
diff --git a/entries/html.xml b/entries/html.xml
index 4be065f3..0eae2f74 100644
--- a/entries/html.xml
+++ b/entries/html.xml
@@ -29,7 +29,7 @@ $( "div.demo-container" ).html();
     
       Click a paragraph to convert it from html to text.
       
     On click, returns the index (zero-based) of that div in the page.
     A function used as a test for every element in the set. It accepts two arguments, index, which is the element's index in the jQuery collection, and element, which is the DOM element. Within the function, this refers to the current DOM element.
       
       
-            
+      
     
   
   
@@ -63,7 +63,7 @@ $( "ul" ).on( "click", function( event ) {
     
            
     
            You can attach a click handler to every <li> that evaluates the number of <strong> elements within the clicked <li> at that time like so:
            
     
            
-$( "li)" ).on( "click", function() {
+$( "li" ).on( "click", function() {
   var li = $( this ),
     isWithTwo = li.is(function() {
       return $( "strong", this ).length === 2;
@@ -177,7 +177,7 @@ $( "div" ).text( "isFormParent = " + isFormParent );
     Checks against an existing collection of alternating list elements. Blue, alternating list elements slide up while others turn red.
     An alternate way to achieve the above example using an element rather than a jQuery object. Checks against an existing collection of alternating list elements. Blue, alternating list elements slide up while others turn red.
     Cause all animations to run with less frames.
     
diff --git a/entries/jQuery.fx.off.xml b/entries/jQuery.fx.off.xml
index 3c93466d..8464f69f 100644
--- a/entries/jQuery.fx.off.xml
+++ b/entries/jQuery.fx.off.xml
@@ -21,7 +21,7 @@ var toggleFx = function() {
 };
 toggleFx();
 $( "button" ).on( "click", toggleFx );
-$( "input)" ).on( "click", function() {
+$( "input" ).on( "click", function() {
   $( "div" ).toggle( "slow" );
 } );
 ]]>
diff --git a/entries/jQuery.getScript.xml b/entries/jQuery.getScript.xml
index d6e091ab..d44d1f3a 100644
--- a/entries/jQuery.getScript.xml
+++ b/entries/jQuery.getScript.xml
@@ -94,7 +94,7 @@ $.cachedScript( "ajax/test.js" ).done(function( script, textStatus ) {
     
       Show the length of the queue.
       
       Set a queue array to delete the queue.
       Selector Context
       
            By default, selectors perform their searches within the DOM starting at the document root. However, an alternate context can be given for the search by using the optional second parameter to the $() function. For example, to do a search within an event handler, the search can be restricted like so:
            
       
            
-$( "div.foo)" ).on( "click", function() {
+$( "div.foo" ).on( "click", function() {
   $( "span", this ).addClass( "bar" );
 });
       
            
@@ -62,7 +62,7 @@ $( "div.foo)" ).on( "click", function() {
       
            Please note that although you can pass text nodes and comment nodes into a jQuery collection this way, most operations don't support them. The few that do will have an explicit note on their API documentation page.
            
       
            A common use of single-DOM-element construction is to call jQuery methods on an element that has been passed to a callback function through the keyword this:
            
       
            
-$( "div.foo)" ).on( "click", function() {
+$( "div.foo" ).on( "click", function() {
   $( this ).slideUp();
 });
       
            
diff --git a/entries/off.xml b/entries/off.xml
index c35a537c..fba3925c 100644
--- a/entries/off.xml
+++ b/entries/off.xml
@@ -46,13 +46,13 @@
 function flash() {
   $( "div" ).show().fadeOut( "slow" );
 }
-$( "#bind)" ).on( "click", function() {
+$( "#bind" ).on( "click", function() {
   $( "body" )
     .on( "click", "#theone", flash )
     .find( "#theone" )
       .text( "Can Click!" );
 });
-$( "#unbind)" ).on( "click", function() {
+$( "#unbind" ).on( "click", function() {
   $( "body" )
     .off( "click", "#theone", flash )
     .find( "#theone" )
diff --git a/entries/parents.xml b/entries/parents.xml
index 57b860b4..ab51cde9 100644
--- a/entries/parents.xml
+++ b/entries/parents.xml
@@ -82,7 +82,7 @@ function showParents() {
       .length;
   $( "b" ).text( "Unique div parents: " + len );
 }
-$( "span)" ).on( "click", function() {
+$( "span" ).on( "click", function() {
   $( this ).toggleClass( "selected" );
   showParents();
 });
diff --git a/entries/queue.xml b/entries/queue.xml
index 1a6a38ac..ec66c39f 100644
--- a/entries/queue.xml
+++ b/entries/queue.xml
@@ -156,7 +156,7 @@ Click here...
     
       Set a queue array to delete the queue.
       Paragraph. " );
   
     On click, replace each paragraph with a div that is already in the DOM and selected with the $() function. Notice it doesn't clone the object but rather moves it to replace the paragraph.
     
diff --git a/entries/show.xml b/entries/show.xml
index 5a807d52..2ce1c4a4 100644
--- a/entries/show.xml
+++ b/entries/show.xml
@@ -49,7 +49,7 @@ $( ".target" ).show();
 </div>
 <img id="book" src="book.png" alt="" width="100" height="123">
 With the element initially hidden, we can show it slowly:
-$( "#clickme)" ).on( "click", function() {
+$( "#clickme" ).on( "click", function() {
   $( "#book" ).show( "slow", function() {
     // Animation complete.
   });
@@ -84,13 +84,13 @@ $( "button" ).on( "click", function() {
   
     Show the first div, followed by each next adjacent sibling div in order, with a 200ms animation. Each animation starts when the previous sibling div's animation ends.
     
diff --git a/entries/slideDown.xml b/entries/slideDown.xml
index 749a19a7..e70c81f7 100644
--- a/entries/slideDown.xml
+++ b/entries/slideDown.xml
@@ -30,7 +30,7 @@
     
            
     
            With the element initially hidden, we can show it slowly:
            
     
            
-$( "#clickme)" ).on( "click", function() {
+$( "#clickme" ).on( "click", function() {
   $( "#book" ).slideDown( "slow", function() {
     // Animation complete.
   });
diff --git a/entries/slideToggle.xml b/entries/slideToggle.xml
index f3fc2352..9a91bed8 100644
--- a/entries/slideToggle.xml
+++ b/entries/slideToggle.xml
@@ -30,7 +30,7 @@
     
            
     
            We will cause .slideToggle() to be called when another element is clicked:
            
     
            
-$( "#clickme)" ).on( "click", function() {
+$( "#clickme" ).on( "click", function() {
   $( "#book" ).slideToggle( "slow", function() {
     // Animation complete.
   });
@@ -84,7 +84,7 @@ $( "button" ).on( "click", function() {
   
     Animates divs between dividers with a toggle that makes some appear and some disappear.
     
            
     
            With the element initially shown, we can hide it slowly:
            
     
            
-$( "#clickme)" ).on( "click", function() {
+$( "#clickme" ).on( "click", function() {
   $( "#book" ).slideUp( "slow", function() {
     // Animation complete.
   });
diff --git a/entries/stop.xml b/entries/stop.xml
index ce4d5538..60062614 100644
--- a/entries/stop.xml
+++ b/entries/stop.xml
@@ -53,17 +53,17 @@ $( "#hoverme-stop-2" ).hover(function() {
     Click the Go button once to start the animation, then click the STOP button to stop it where it's currently positioned.  Another option is to click several buttons to queue them up and see that stop just kills the currently playing one.
     
diff --git a/entries/toggle.xml b/entries/toggle.xml
index 199c93f6..7d74577f 100644
--- a/entries/toggle.xml
+++ b/entries/toggle.xml
@@ -51,7 +51,7 @@ $( ".target" ).toggle();
     
            
     
            We will cause .toggle() to be called when another element is clicked:
            
     
            
-$( "#clickme)" ).on( "click", function() {
+$( "#clickme" ).on( "click", function() {
   $( "#book" ).toggle( "slow", function() {
     // Animation complete.
   });
diff --git a/entries/toggleClass.xml b/entries/toggleClass.xml
index fcb8da42..da2c894f 100644
--- a/entries/toggleClass.xml
+++ b/entries/toggleClass.xml
@@ -99,7 +99,7 @@ $( "div.foo" ).toggleClass(function() {
     
       Toggle the class 'highlight' when a paragraph is clicked.
       
diff --git a/entries/triggerHandler.xml b/entries/triggerHandler.xml
index fb2da985..83b2a576 100644
--- a/entries/triggerHandler.xml
+++ b/entries/triggerHandler.xml
@@ -37,10 +37,10 @@
   
     If you called .triggerHandler() on a focus event - the browser's default focus action would not be triggered, only the event handlers bound to the focus event.
     
Date: Sat, 6 May 2023 01:30:46 +0100
Subject: [PATCH 637/699] Build: Add `.` dot as word boundary in Typesense and
 downrank non-API pages

Override the default from
https://github.com/typesense/typesense-docsearch-scraper/blob/0.6.0/scraper/src/typesense_helper.py#L58

> 'token_separators': ['_', '-']

This should make it so that "jQuery.ajax" is tokenised as "jquery ajax"
instead of "jqueryajax".

Ref https://github.com/typesense/typesense-docsearch-scraper/issues/40.
---
 docsearch.config.json | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/docsearch.config.json b/docsearch.config.json
index 5325f6f7..ed567926 100644
--- a/docsearch.config.json
+++ b/docsearch.config.json
@@ -1,8 +1,8 @@
 {
   "index_name": "jquery_com",
   "start_urls": [
-    { "url": "https://jquery.com" },
-    { "url": "https://api.jquery.com", "selectors_key": "api" }
+    { "url": "https://api.jquery.com", "selectors_key": "api", "page_rank": 20 },
+    { "url": "https://jquery.com", "page_rank": 10 }
   ],
   "stop_urls": [
     ".com/category/"
@@ -34,6 +34,9 @@
       "text": ".entry-content p, .entry-content li"
     }
   },
+  "custom_settings": {
+    "token_separators": ["_", "-", "."]
+  },
   "selectors_exclude": [
     "header ~ article",
     ".returns",

From e7c8ccd58f034db300b76be09588e7d14dedb602 Mon Sep 17 00:00:00 2001
From: Timo Tijhof 
Date: Mon, 8 May 2023 02:22:04 +0100
Subject: [PATCH 638/699] Fix non-canonical links to /jQuery.ajax/

Thanks to WordPress, each of these works, but they also end up
indexed in Typesense (and in Algolia) as duplicate entries with
slightly differently cased URLs.

Avoid the duplication by making the links consistent.
---
 entries/jQuery.get.xml  | 2 +-
 entries/jQuery.post.xml | 2 +-
 notes.xsl               | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/entries/jQuery.get.xml b/entries/jQuery.get.xml
index 16b764d4..575a6f83 100644
--- a/entries/jQuery.get.xml
+++ b/entries/jQuery.get.xml
@@ -24,7 +24,7 @@
   
     1.12-and-2.2
     
-      A set of key/value pairs that configure the Ajax request. All properties except for url are optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) for a complete list of all settings. The type option will automatically be set to GET.
+      A set of key/value pairs that configure the Ajax request. All properties except for url are optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) for a complete list of all settings. The type option will automatically be set to GET.
     
   
   Load data from the server using a HTTP GET request.
diff --git a/entries/jQuery.post.xml b/entries/jQuery.post.xml
index 4495cb7c..e5411bed 100644
--- a/entries/jQuery.post.xml
+++ b/entries/jQuery.post.xml
@@ -24,7 +24,7 @@
   
     1.12-and-2.2
     
-      A set of key/value pairs that configure the Ajax request. All properties except for url are optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) for a complete list of all settings. Type will automatically be set to POST.
+      A set of key/value pairs that configure the Ajax request. All properties except for url are optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) for a complete list of all settings. Type will automatically be set to POST.
     
   
   Send data to the server using a HTTP POST request.
diff --git a/notes.xsl b/notes.xsl
index fb74e852..b6c5969f 100644
--- a/notes.xsl
+++ b/notes.xsl
@@ -53,7 +53,7 @@
 			If a request with  returns an error code, it will fail silently unless the script has also called the global ajaxError event. Alternatively, as of jQuery 1.5, the .error() method of the jqXHR object returned by  is also available for error handling.
 		
 		
-			If $.ajax() or $.ajaxSetup() is called with the global option set to false, the  event will not fire.
+			If $.ajax() or $.ajaxSetup() is called with the global option set to false, the  event will not fire.
 		
 		
 			If  is called on an unordered list (<ul>) and its <li> elements have position (relative, absolute, or fixed), the effect may not work properly in IE6 through at least IE9 unless the <ul> has "layout." To remedy the problem, add the position: relative; and zoom: 1; CSS declarations to the ul.

From 1d2d81142c879feaa782ef4f60c9c8d0ce7cafe9 Mon Sep 17 00:00:00 2001
From: Timo Tijhof 
Date: Mon, 8 May 2023 02:25:14 +0100
Subject: [PATCH 639/699] 3.2.2

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 382479f8..3ada399b 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.2.1",
+  "version": "3.2.2",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index c628acd1..1022707a 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.2.1",
+  "version": "3.2.2",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 0acd2c3ae34a847dbfa1ca15bcef274aa6010416 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Wed, 10 May 2023 10:50:39 +0200
Subject: [PATCH 640/699] All: Add missing jQuery versions to categories,
 update entries

jQuery 1.10/2.0 & 1.11/2.1 now have dedicated version categories; the
same applies to 3.6. A few other version descriptions have been tweaked.

The `.add( selection )` signature is now documented to have arrived in
1.1 instead of 1.3.2. Tests for this behavior got added in:
https://github.com/jquery/jquery/commit/a5f9108a2109b2ed5778af860b0928d8e6b0fdd2

A cetegory in one of `before` & `after` signatures was updated from
`1.10` to `1.10-and-2.0`, fixing a broken category link.

Closes gh-1225
---
 categories.xml             | 40 ++++++++++++++++++++++++++++----------
 entries/add.xml            |  2 +-
 entries/after.xml          |  2 +-
 entries/before.xml         |  2 +-
 entries/jQuery.ajax.xml    |  3 ++-
 entries/jQuery.support.xml |  7 ++++++-
 6 files changed, 41 insertions(+), 15 deletions(-)

diff --git a/categories.xml b/categories.xml
index 22dbd59b..513b5459 100644
--- a/categories.xml
+++ b/categories.xml
@@ -439,11 +439,24 @@ var files = event.originalEvent.dataTransfer.files;
         
            
       ]]>
     
+    
+      Aspects of the API that were changed in the corresponding versions of jQuery. Changes in jQuery 1.10 and 2.0 include a new `wrap` module, relaxing HTML parsing, and aligning the 1.x & 2.x lines.
            
+        
            For more information, see the 2.0 Release Notes/Changelog and 1.10.0/2.0.1 Release Notes/Changelog.
            
+        
            
+      ]]>            
+                
+    
+      Aspects of the API that were changed in the corresponding versions of jQuery. Changes in jQuery 1.11 and 2.1 include lower startup overhead & fewer forced layouts; jQuery is now authored via AMD and published to npm & bower under the name jquery.
            
+        
            For more information, see the Release Notes/Changelog.
            
+        
            
+      ]]>            
+                
     
       Aspects of the API that were changed in the corresponding versions of jQuery. Changes in jQuery 1.12 and 2.2 includes performance improvements of the selector engine, manipulation of class names for SVG elements, support for the Symbol type and iterators added in ES2015, and a new hook has been added for filtering HTML. A jQuery Migrate Plugin was offered to help developers with a transitional upgrade path.
-        
            
-        
            For more information, see the Release Notes/Changelog
            
+        
            Aspects of the API that were changed in the corresponding versions of jQuery. Changes in jQuery 1.12 and 2.2 include performance improvements of the selector engine, manipulation of class names for SVG elements, support for the Symbol type and iterators added in ES2015, and a new hook has been added for filtering HTML.
            
+        
            For more information, see the Release Notes/Changelog.
            
         
            
       ]]>            
                 
@@ -451,42 +464,49 @@ var files = event.originalEvent.dataTransfer.files;
       Aspects of the API that were changed in the corresponding version of jQuery. Changes in jQuery 3.0 dealt primarily with deferreds, data, show/hide and removal of some deprecated APIs. A jQuery Migrate Plugin was offered to help developers with a transitional upgrade path.
         
            
-        
            For more information, see the jQuery Core 3.0 Upgrade guide and the Release Notes/Changelog
            
+        
            For more information, see the jQuery Core 3.0 Upgrade guide and the Release Notes/Changelog.
            
         
            
       ]]>            
     
     
       Aspects of the API that were changed in the corresponding version of jQuery. Version 3.1 added the jQuery.readyException API.
            
-        
            For more information, see the Release Notes/Changelog
            
+        
            For more information, see the Release Notes/Changelog.
            
         
            
       ]]>            
                 
     
       Aspects of the API that were changed in the corresponding version of jQuery. Version 3.2 added support for custom CSS properties, made .contents() work on the <template> element & made .width() & .height() ignore CSS transforms. A few APIs were deprecated. The deprecated module was added back to the slim build.
            
-        
            For more information, see the Release Notes/Changelog
            
+        
            For more information, see the Release Notes/Changelog.
            
         
            
       ]]>            
                 
     
       Aspects of the API that were changed in the corresponding version of jQuery. .addClass(), .removeClass() & .toggleClass() now work on arrays of classes; a few APIs were deprecated.
            
-        
            For more information, see the Release Notes/Changelog
            
+        
            For more information, see the Release Notes/Changelog.
            
         
            
       ]]>            
                 
     
       Aspects of the API that were changed in the corresponding version of jQuery. nonce & nomodule attributes are now preserved during script manipulation, layout thrashing was eliminated in some cases in .width() & .height() APIs. Radio elements state is now updated before event handlers run. Passing data now works when triggering all events, including focus. A minor security fix is also included.
            
-        
            For more information, see the Release Notes/Changelog
            
+        
            For more information, see the Release Notes/Changelog.
            
         
            
       ]]>            
                 
     
       Aspects of the API that were changed in the corresponding version of jQuery. Security fixes, new .even() & .odd() methods; jQuery.globalEval now accepts context; unsuccessful HTTP script responses are no longer evaluated; performance improvements. jQuery.trim is now deprecated.
            
-        
            For more information, see the jQuery Core 3.5 Upgrade guide and the Release Notes/Changelog
            
+        
            Aspects of the API that were changed in the corresponding version of jQuery. Security fixes, including a breaking change to jQuery.htmlPrefilter; new .even() & .odd() methods; jQuery.globalEval now accepts context; unsuccessful HTTP script responses are no longer evaluated; performance improvements. jQuery.trim is now deprecated. A jQuery Migrate Plugin was offered to help developers with a transitional upgrade path.
            
+        
            For more information, see the jQuery Core 3.5 Upgrade guide and the Release Notes/Changelog.
            
+        
            
+      ]]>            
+                
+    
+      Aspects of the API that were changed in the corresponding version of jQuery. Returning JSON even for JSONP erroneous responses is working again, a few focus fixes.
            
+        
            For more information, see the Release Notes/Changelog.
            
         
            
       ]]>            
                 
diff --git a/entries/add.xml b/entries/add.xml
index 6f1d7870..bb95b0f0 100644
--- a/entries/add.xml
+++ b/entries/add.xml
@@ -20,7 +20,7 @@
     
   
   
-    1.3.2
+    1.1
     
       An existing jQuery object to add to the set of matched elements.
     
diff --git a/entries/after.xml b/entries/after.xml
index 210ad7c8..2ea48a9c 100644
--- a/entries/after.xml
+++ b/entries/after.xml
@@ -34,7 +34,7 @@
     
   
   
-    1.10
+    1.10-and-2.0
     
       A function that returns an HTML string, DOM element(s), text node(s), or jQuery object to insert after each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, this refers to the current element in the set.
       
diff --git a/entries/before.xml b/entries/before.xml
index 1a1fcdea..577f588b 100644
--- a/entries/before.xml
+++ b/entries/before.xml
@@ -35,7 +35,7 @@
     
   
    
-    1.10
+    1.10-and-2.0
     
       
       
diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml
index b8ee69a7..258ec227 100644
--- a/entries/jQuery.ajax.xml
+++ b/entries/jQuery.ajax.xml
@@ -114,7 +114,7 @@ $.ajax({
         
         
         
-        A function to be called if the request fails. The function receives three arguments: The jqXHR (in jQuery 1.4.x, XMLHttpRequest) object, a string describing the type of error that occurred and an optional exception object, if one occurred. Possible values for the second argument (besides null) are "timeout", "error", "abort", and "parsererror". When an HTTP error occurs, errorThrown receives the textual portion of the HTTP status, such as "Not Found" or "Internal Server Error." (in HTTP/2 it may instead be an empty string) As of jQuery 1.5, the error setting can accept an array of functions. Each function will be called in turn.  Note: This handler is not called for cross-domain script and cross-domain JSONP requests. This is an Ajax Event.
+        A function to be called if the request fails. The function receives three arguments: The jqXHR (in jQuery 1.4.x, XMLHttpRequest) object, a string describing the type of error that occurred and an optional exception object, if one occurred. Possible values for the second argument (besides null) are "timeout", "error", "abort", and "parsererror". When an HTTP error occurs, errorThrown receives the textual portion of the HTTP status, such as "Not Found" or "Internal Server Error." (in HTTP/2 it may instead be an empty string) As of jQuery 1.5, the error setting can accept an array of functions. Each function will be called in turn.  Note: This handler is not called for cross-domain scripts and cross-domain JSONP requests. This is an Ajax Event.
       
       
         Whether to trigger global Ajax event handlers for this request. The default is true. Set to false to prevent the global handlers like ajaxStart or ajaxStop from being triggered. This can be used to control various Ajax Events.
@@ -463,4 +463,5 @@ $.ajax({
   
   
   
+  
 
diff --git a/entries/jQuery.support.xml b/entries/jQuery.support.xml
index 636ec72e..3252fd6e 100644
--- a/entries/jQuery.support.xml
+++ b/entries/jQuery.support.xml
@@ -4,10 +4,15 @@
   
     1.3
   
-  A collection of properties that represent the presence of different browser features or bugs. Intended for jQuery's internal use; specific properties may be removed when they are no longer needed internally to improve page startup performance. For your own project's feature-detection needs, we strongly recommend the use of an external library such as Modernizr instead of dependency on properties in jQuery.support.
+  A collection of properties that represent the presence of different browser features or bugs; intended for jQuery's internal use.
+  
+    
            A collection of properties that represent the presence of different browser features or bugs. Intended for jQuery's internal use; specific properties may be removed when they are no longer needed internally to improve page startup performance. For your own project's feature-detection needs, we strongly recommend the use of an external library such as Modernizr instead of dependency on properties in jQuery.support.
            
+    
            As of jQuery 1.11 or 1.12, jQuery.support is no longer JSON-serializable; some properties point to functions that return the support test result when called. This was necessary to support lazy execution of support tests.
            
+              
   
   
   
   
+  
   
 

From 9b950789e3552616779131603b008e99063a246d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Wed, 10 May 2023 23:49:40 +0200
Subject: [PATCH 641/699] 3.2.3

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 3ada399b..80ce541b 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.2.2",
+  "version": "3.2.3",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 1022707a..13abd64e 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.2.2",
+  "version": "3.2.3",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From 507541789e44a4ca40c76c2e5e8fbb95079a02b0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Thu, 11 May 2023 00:31:13 +0200
Subject: [PATCH 642/699] All: Fix a few MDN links

Replace all MDN links with their canonical versions, fixing one 404 in
the process as well.
---
 entries/contents.xml    | 2 +-
 entries/delay.xml       | 2 +-
 entries/event.which.xml | 2 +-
 pages/Types.html        | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/entries/contents.xml b/entries/contents.xml
index 950411ba..6cfa73ba 100644
--- a/entries/contents.xml
+++ b/entries/contents.xml
@@ -34,7 +34,7 @@ $( ".container" )
     .filter( "br" )
     .remove();
     
            
-    
            This code first retrieves the contents  of <div class="container"> and then filters it for text nodes, which are wrapped in paragraph tags. This is accomplished by testing the .nodeType property of the element. This DOM property holds a numeric code indicating the node's type; text nodes use the code 3. The contents are again filtered, this time for <br /> elements, and these elements are removed.
            
+    
            This code first retrieves the contents  of <div class="container"> and then filters it for text nodes, which are wrapped in paragraph tags. This is accomplished by testing the .nodeType property of the element. This DOM property holds a numeric code indicating the node's type; text nodes use the code 3. The contents are again filtered, this time for <br /> elements, and these elements are removed.
            
   
   
     Find all the text nodes inside a paragraph and wrap them with a bold tag.
diff --git a/entries/delay.xml b/entries/delay.xml
index f611ffff..b2066217 100644
--- a/entries/delay.xml
+++ b/entries/delay.xml
@@ -21,7 +21,7 @@ $( "#foo" ).slideUp( 300 ).delay( 800 ).fadeIn( 400 );
     
            When this statement is executed, the element slides up for 300 milliseconds and then pauses for 800 milliseconds before fading in for 400 milliseconds.
            
     
            
       
            
-        The .delay() method is best for delaying between queued jQuery effects. Because it is limited—it doesn't, for example, offer a way to cancel the delay—.delay() is not a replacement for JavaScript's native setTimeout function, which may be more appropriate for certain use cases.
+        The .delay() method is best for delaying between queued jQuery effects. Because it is limited—it doesn't, for example, offer a way to cancel the delay—.delay() is not a replacement for JavaScript's native setTimeout function, which may be more appropriate for certain use cases.
       
            
     
            
   
diff --git a/entries/event.which.xml b/entries/event.which.xml
index 1d36d527..e8e6aa28 100644
--- a/entries/event.which.xml
+++ b/entries/event.which.xml
@@ -6,7 +6,7 @@
   
   For key or mouse events, this property indicates the specific key or button that was pressed.
   
-    
            The event.which property normalizes event.keyCode and event.charCode. It is recommended to watch event.which for keyboard key input. For more detail, read about event.charCode on the MDN. 
            
+    
            The event.which property normalizes event.keyCode and event.charCode. It is recommended to watch event.which for keyboard key input. For more detail, read about event.charCode on the MDN. 
            
     
            event.which also normalizes button presses (mousedown and mouseupevents), reporting 1 for left button, 2 for middle, and 3 for right. Use event.which instead of event.button.  
            
               
   
diff --git a/pages/Types.html b/pages/Types.html
index 969d154a..6c75695e 100644
--- a/pages/Types.html
+++ b/pages/Types.html
@@ -648,7 +648,7 @@ 
             XMLHttpRequest 
            
 
            Although the XHR object is a standard, there are variations in its behavior on different browsers. Refer to the WHATWG site and Mozilla Developer Network for more information:
 
            
 
 
             jqXHR 
            
 
            As of jQuery 1.5, the $.ajax() method returns the jqXHR object, which is a superset of the XMLHTTPRequest object. For more information, see the jqXHR section of the $.ajax entry

From 66bda2e28f93e98f963486fd5b2eea4b13d6c466 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Thu, 11 May 2023 00:31:41 +0200
Subject: [PATCH 643/699] 3.2.4

---
 package-lock.json | 2 +-
 package.json      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 80ce541b..9fad268c 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.2.3",
+  "version": "3.2.4",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 13abd64e..48632141 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "api.jquery.com",
   "title": "jQuery API Docs",
   "description": "API reference documentation for the jQuery JavaScript Library.",
-  "version": "3.2.3",
+  "version": "3.2.4",
   "homepage": "https://github.com/jquery/api.jquery.com",
   "author": {
     "name": "jQuery Foundation and other contributors"

From e52362a73a7f9be25d05b66ee254669f6ea1142b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Thu, 11 May 2023 21:52:53 +0200
Subject: [PATCH 644/699] prevAll:uniqueAll: Add uniqueAll, use it in reverse
 doc order examples

Also, use it in `.prevAll()` examples instead of the
older `jQuery.uniqueSort()`.

In addition, update jQuery used in examples to `3.7.0`
and add the category for jQuery `3.7`.

Closes gh-1216
Ref gh-1215
Ref jquery/jquery#5149
---
 categories.xml         |   9 ++++
 entries/prevAll.xml    |  19 ++++---
 entries/uniqueSort.xml | 112 +++++++++++++++++++++++++++++++++++++++++
 entries2html.xsl       |   2 +-
 4 files changed, 135 insertions(+), 7 deletions(-)
 create mode 100644 entries/uniqueSort.xml

diff --git a/categories.xml b/categories.xml
index 513b5459..d5c9d917 100644
--- a/categories.xml
+++ b/categories.xml
@@ -510,6 +510,15 @@ var files = event.originalEvent.dataTransfer.files;
         
            
       ]]>
     
+    
+      Aspects of the API that were changed in the corresponding version of jQuery. New .uniqueSort() method performance improvements in manipulation, fixes for .outerWidth( true ) & .outerHeight( true ) with negative margins, focus fixes.
            
+        
            As of this release, jQuery no longer relies on Sizzle.
            
+        
            Native events for focus & blur changed in IE to - respectively - focusin and focusout.
            
+        
            For more information, see the Release Notes/Changelog.
            
+        
            
+      ]]>            
+                
     
   
 
diff --git a/entries/prevAll.xml b/entries/prevAll.xml
index 4b5f6062..d3eeca03 100644
--- a/entries/prevAll.xml
+++ b/entries/prevAll.xml
@@ -50,7 +50,14 @@ $( ".last-item" )
   <div class="last-item">Last</div>
 </div>
     
            
-    
            because "Item 2" gets appended to the wrapper div first. To work around the issue, you may use $.uniqueSort() on the .prevAll() output first:
            
+    
            because "Item 2" gets appended to the wrapper div first. To work around the issue, you may use .uniqueSort() on the .prevAll() output first:
            
+    
            
+$( ".last-item" )
+  .prevAll()
+  .uniqueSort()
+  .wrapAll( "<div class='wrapper'></div>" );
+    
            
+    
            Note that the .uniqueSort() method is only available in jQuery 3.7.0 or newer. In older versions, you will need to use $.uniqueSort() to achieve a similar effect:
            
     
            
 var prevSiblings = $( ".last-item" ).prevAll();
 $.uniqueSort( prevSiblings );
@@ -83,7 +90,7 @@ $( "div" ).last().prevAll().addClass( "before" );
 ]]>
   
   
-    Locate all the divs preceding the last item and wrap them with a div with class wrapper - with or without $.uniqueSort().
+    Locate all the divs preceding the last item and wrap them with a div with class wrapper - with or without .uniqueSort().
     " );
 
-var prevSiblings = $( "#container-2" )
+$( "#container-2" )
   .find( ".item" )
   .last()
-  .prevAll();
-$.uniqueSort( prevSiblings );
-prevSiblings.wrapAll( "
            " );
+  .prevAll()
+  .uniqueSort()
+  .wrapAll( "
            " );
 ]]>            
     
+
+  .uniqueSort()
+  
+    3.7
+  
+  Sorts a jQuery object of DOM elements, in place, with the duplicates removed. Note that this only works on jQuery objects consisting of DOM elements, not strings or numbers.
+  
+    
            The .uniqueSort() function searches through a jQuery object, sorting it in document order, and removing any duplicate nodes. A node is considered a duplicate if it is the exact same node as one already in the jQuery object; two different nodes with identical attributes are not considered to be duplicates. This function only works on jQuery objects consisting of DOM elements.
            
+              
+  
+    Removes any duplicate elements from the jQuery object of divs.
+    
+    
+    There are 6 divs in this document.
+
            
+
            
+
            
+
            
+
            
+]]>
+              
+  
+    Locate all the divs preceding the last item and wrap them with a div with class wrapper - with or without .uniqueSort().
+    " );
+
+$( "#container-2" )
+  .find( ".item" )
+  .last()
+  .prevAll()
+  .uniqueSort()
+  .wrapAll( "
            " );
+]]>            
+    
+    
+  
            1
            
+  
            2
            
+  
            3
            
+
+
+
            
+  
            1
            
+  
            2
            
+  
            3
            
+
            
+]]>
+              
+  
+  
+            
diff --git a/entries2html.xsl b/entries2html.xsl
index 8b06fadf..37bfdb3c 100755
--- a/entries2html.xsl
+++ b/entries2html.xsl
@@ -12,7 +12,7 @@
 	<meta charset="utf-8">
 	<title> demo</title>
 	<style>	</style>
-	<script src="https://code.jquery.com/jquery-3.6.3.js"></script>
+	<script src="https://code.jquery.com/jquery-3.7.0.js"></script>
 	<script>
 	
 	</script>

From 5c72da2c884c6930b7488f568fab59b0ae90079d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Thu, 11 May 2023 21:55:37 +0200
Subject: [PATCH 645/699] blur:focus: document IE-related changes in jQuery 3.7

---
 entries/blur.xml  | 2 ++
 entries/focus.xml | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/entries/blur.xml b/entries/blur.xml
index d99003e9..68636a0c 100644
--- a/entries/blur.xml
+++ b/entries/blur.xml
@@ -51,6 +51,7 @@ $( "#other" ).on( "click", function() {
     
            
     
            After this code executes, clicks on Trigger the handler will also alert the message.
            
     
            The blur event does not bubble. As of version 1.4.2, jQuery works around this limitation by mapping blur to the focusout event in its event delegation methods.
            
+    
            The native blur event is asynchronous in all versions of IE, contrary to other browsers. To avoid issues related to this discrepancy, as of jQuery 3.7.0, jQuery uses focusout as the native backing event for blur in IE.
            
   
   
     To trigger the blur event on all paragraphs:
@@ -62,6 +63,7 @@ $( "p" ).trigger( "blur" );
   
   
   
+  
             
 
 
diff --git a/entries/focus.xml b/entries/focus.xml
index 21d6b2c2..c9736a29 100644
--- a/entries/focus.xml
+++ b/entries/focus.xml
@@ -57,6 +57,7 @@ $( "#other" ).on( "click", function() {

            After this code executes, clicks on Trigger the handler will also alert the message.

            The focus event does not bubble. As of version 1.4.2, jQuery works around this limitation by mapping focus to the focusin event in its event delegation methods.

            +

            The native focus event is asynchronous in all versions of IE, contrary to other browsers. To avoid issues related to this discrepancy, as of jQuery 3.7.0, jQuery uses focusin as the native backing event for focus in IE.

            Fire focus. @@ -95,6 +96,7 @@ $( function() { + From 226f67d0d9325143ed8155e27c609ee12768835a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?= Date: Thu, 11 May 2023 21:56:37 +0200 Subject: [PATCH 646/699] All: Make deprecation warnings more prominent --- entries/deferred.pipe.xml | 4 +++- entries/jQuery.fx.interval.xml | 4 +++- entries/jQuery.parseJSON.xml | 4 +++- entries/jQuery.unique.xml | 4 +++- 4 files changed, 12 insertions(+), 4 deletions(-) diff --git a/entries/deferred.pipe.xml b/entries/deferred.pipe.xml index 66eda149..a74f9dac 100644 --- a/entries/deferred.pipe.xml +++ b/entries/deferred.pipe.xml @@ -34,7 +34,9 @@ Utility method to filter and/or chain Deferreds. -

            Deprecation Notice:As of jQuery 1.8, the deferred.pipe() method is deprecated. The deferred.then() method, which replaces it, should be used instead.

            +
            +

            Deprecation Notice:As of jQuery 1.8, the deferred.pipe() method is deprecated. The deferred.then() method, which replaces it, should be used instead.

            +

            The deferred.pipe() method returns a new promise that filters the status and values of a deferred through a function. The doneFilter and failFilter functions filter the original deferred's resolved / rejected status and values. As of jQuery 1.7, the method also accepts a progressFilter function to filter any calls to the original deferred's notify or notifyWith methods. These filter functions can return a new value to be passed along to the piped promise's done() or fail() callbacks, or they can return another observable object (Deferred, Promise, etc) which will pass its resolved / rejected status and values to the piped promise's callbacks. If the filter function used is null, or not specified, the piped promise will be resolved or rejected with the same values as the original.

             diff --git a/entries/jQuery.fx.interval.xml b/entries/jQuery.fx.interval.xml index dcf5653a..ddcf4296 100644 --- a/entries/jQuery.fx.interval.xml +++ b/entries/jQuery.fx.interval.xml @@ -6,7 +6,9 @@ 1.4.3 -

            This property is deprecated as of version 3.0, and has no effect in browsers that support the requestAnimationFrame method.

            +
            +

            This property is deprecated as of version 3.0, and has no effect in browsers that support the requestAnimationFrame method.

            +

            On browsers that do not support requestAnimationFrame, this property can be changed to adjust the interval at which animations will run. The default is 13 milliseconds.

            Since jQuery uses one global interval, no animation should be running or all animations should stop for the change of this property to take effect.

             diff --git a/entries/jQuery.parseJSON.xml b/entries/jQuery.parseJSON.xml index c09f3c40..a3249174 100644 --- a/entries/jQuery.parseJSON.xml +++ b/entries/jQuery.parseJSON.xml @@ -14,7 +14,9 @@ Takes a well-formed JSON string and returns the resulting JavaScript value. -

            As of jQuery 3.0, $.parseJSON is deprecated. To parse JSON strings use the native JSON.parse method instead.

            +
            +

            As of jQuery 3.0, $.parseJSON is deprecated. To parse JSON strings use the native JSON.parse method instead.

            +

            Passing in a malformed JSON string results in a JavaScript exception being thrown. For example, the following are all invalid JSON strings:

            • "{test: 1}" (test does not have double quotes around it).
              • diff --git a/entries/jQuery.unique.xml b/entries/jQuery.unique.xml index 01b0c980..bac61334 100644 --- a/entries/jQuery.unique.xml +++ b/entries/jQuery.unique.xml @@ -9,7 +9,9 @@ Sorts an array of DOM elements, in place, with the duplicates removed. Note that this only works on arrays of DOM elements, not strings or numbers. -

              As of jQuery 3.0, this method is deprecated and just an alias of jQuery.uniqueSort(). Please use that method instead.

              +
              +

              As of jQuery 3.0, this method is deprecated and just an alias of jQuery.uniqueSort(). Please use that method instead.

              +

              The $.unique() function searches through an array of objects, sorting the array, and removing any duplicate nodes. A node is considered a duplicate if it is the exact same node as one already in the array; two different nodes with identical attributes are not considered to be duplicates. This function only works on plain JavaScript arrays of DOM elements, and is chiefly used internally by jQuery. You probably will never need to use it.

              As of jQuery 1.4 the results will always be returned in document order.

               From 0cb274564b71e3503f620dfae3d0a1e646f28fcc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?= Date: Thu, 11 May 2023 21:59:10 +0200 Subject: [PATCH 647/699] 3.3.0 --- package-lock.json | 2 +- package.json | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/package-lock.json b/package-lock.json index 9fad268c..580ff193 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,6 +1,6 @@ { "name": "api.jquery.com", - "version": "3.2.4", + "version": "3.3.0", "lockfileVersion": 1, "requires": true, "dependencies": { diff --git a/package.json b/package.json index 48632141..b329b4c9 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "api.jquery.com", "title": "jQuery API Docs", "description": "API reference documentation for the jQuery JavaScript Library.", - "version": "3.2.4", + "version": "3.3.0", "homepage": "https://github.com/jquery/api.jquery.com", "author": { "name": "jQuery Foundation and other contributors" From 29cf863ab724734849effbfd6b777d4cdfd0a6ce Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?= Date: Sun, 14 May 2023 23:35:55 +0200 Subject: [PATCH 648/699] Build: Skip checking Twitter links in the hydra crawler (#1231) Twitter pages now do 302-redirects to themselves for users without a specific cookie set which trips the crawler; avoid checking Twitter links by abusing the `exclude_scheme_prefixes` option of the crawler. Since the project only accepts options in a form of a configuration file, we also need to clone the API repo to provide such a file. --- .github/configs/hydra-config.json | 5 +++++ .github/workflows/spider-check.yaml | 13 +++++++++++-- 2 files changed, 16 insertions(+), 2 deletions(-) create mode 100644 .github/configs/hydra-config.json diff --git a/.github/configs/hydra-config.json b/.github/configs/hydra-config.json new file mode 100644 index 00000000..3d367e7b --- /dev/null +++ b/.github/configs/hydra-config.json @@ -0,0 +1,5 @@ +{ + "exclude_scheme_prefixes": [ + "https://twitter.com/" + ] +} diff --git a/.github/workflows/spider-check.yaml b/.github/workflows/spider-check.yaml index daa13e89..eae939e0 100644 --- a/.github/workflows/spider-check.yaml +++ b/.github/workflows/spider-check.yaml @@ -20,9 +20,18 @@ jobs: runs-on: ubuntu-latest if: ${{ github.repository_owner == 'jquery' }} # skip on forks steps: - - uses: actions/checkout@v2 + - name: Checkout hydra-link-checker + uses: actions/checkout@v3 with: repository: jquery/hydra-link-checker ref: v2.0.0 + path: hydra + + # Checkout the API repo as well to provide the config for hydra-link-checker + - name: Checkout API repo + uses: actions/checkout@v3 + with: + path: api + - name: Run hydra-link-checker - run: python3 hydra.py "$MY_SITE" + run: python3 hydra/hydra.py "$MY_SITE" --config api/.github/configs/hydra-config.json From 753b2ee418fc924a70b1a4adbd1171794826e7fd Mon Sep 17 00:00:00 2001 From: Timo Tijhof Date: Sun, 14 May 2023 22:38:02 +0100 Subject: [PATCH 649/699] deferred.isRejected: Fix broken link Found by hydra-link-checker: - code: 404 url: https://api.jquery.com/deferred.isRejected/h/deferred.reject/ parent: https://api.jquery.com/deferred.isRejected/ error: Not Found --- entries/deferred.isRejected.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/entries/deferred.isRejected.xml b/entries/deferred.isRejected.xml index 60ddb77b..a391f779 100644 --- a/entries/deferred.isRejected.xml +++ b/entries/deferred.isRejected.xml @@ -9,7 +9,7 @@

              Note: This API has been removed in jQuery 1.8; please use deferred.state() instead.

              -

              Returns true if the Deferred object is in the rejected state, meaning that either deferred.reject() or deferred.rejectWith() has been called for the object and the failCallbacks have been called (or are in the process of being called).

              +

              Returns true if the Deferred object is in the rejected state, meaning that either deferred.reject() or deferred.rejectWith() has been called for the object and the failCallbacks have been called (or are in the process of being called).

              Note that a Deferred object can be in one of three states: pending, resolved, or rejected; use deferred.isResolved() to determine whether the Deferred object is in the resolved state. These methods are primarily useful for debugging, for example to determine whether a Deferred has already been resolved even though you are inside code that intended to reject it.

              From 8f8f62c1f1231e381344d1d90991dece4b37051f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?= Date: Wed, 17 May 2023 13:56:09 +0200 Subject: [PATCH 650/699] All: Fix links reported by hydra-link-checker Closes gh-1232 --- categories.xml | 6 +++--- entries/context.xml | 4 ++-- entries/innerHeight.xml | 4 ++-- entries/innerWidth.xml | 4 ++-- entries/jQuery.ajax.xml | 4 ++-- entries/jQuery.cssHooks.xml | 2 +- entries/jQuery.globalEval.xml | 4 ++-- entries/outerHeight.xml | 4 ++-- entries/outerWidth.xml | 4 ++-- notes.xsl | 2 +- pages/Types.html | 2 +- 11 files changed, 20 insertions(+), 20 deletions(-) diff --git a/categories.xml b/categories.xml index d5c9d917..06418fb2 100644 --- a/categories.xml +++ b/categories.xml @@ -61,7 +61,7 @@

              For more information, see the Release Notes/Changelog at https://blog.jquery.com/2013/01/15/jquery-1-9-final-jquery-2-0-beta-migrate-final-released/

              ]]>               - + For more information, see the Release Notes/Changelog at https://blog.jquery.com/2013/05/24/jquery-1-10-0-and-2-0-1-released/

              ]]>               @@ -401,8 +401,8 @@ var files = event.originalEvent.dataTransfer.files; All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.

              -

              jQuery 1.5 also includes a large rewrite of the Ajax module, which has a number of extensibility improvements. You can find out more about those improvements in the Extending Ajax documentation.

              -

              Additionally jQuery 1.5 includes a new Deferred callback management system you can learn more about in in the Deferred Object documentation.

              +

              jQuery 1.5 also includes a large rewrite of the Ajax module, which has a number of extensibility improvements. You can find out more about those improvements in the Extending Ajax documentation.

              +

              Additionally, jQuery 1.5 includes a new Deferred callback management system you can learn more about in the Deferred Object documentation.

              ]]>                             diff --git a/entries/context.xml b/entries/context.xml index 496c833a..cd9c3cc4 100644 --- a/entries/context.xml +++ b/entries/context.xml @@ -1,5 +1,5 @@ - + .context 1.3 @@ -24,6 +24,6 @@ $( "ul" ) - + diff --git a/entries/innerHeight.xml b/entries/innerHeight.xml index bf5eab75..72e8327d 100644 --- a/entries/innerHeight.xml +++ b/entries/innerHeight.xml @@ -44,7 +44,7 @@ $( "p" ).last().text( "innerHeight:" + p.innerHeight() ); - 1.8.0 + 1.8 @@ -52,7 +52,7 @@ $( "p" ).last().text( "innerHeight:" + p.innerHeight() ); - 1.8.0 + 1.8 diff --git a/entries/innerWidth.xml b/entries/innerWidth.xml index 2990b7b2..7eb25c9d 100644 --- a/entries/innerWidth.xml +++ b/entries/innerWidth.xml @@ -43,7 +43,7 @@ $( "p" ).last().text( "innerWidth:" + p.innerWidth() ); - 1.8.0 + 1.8 @@ -51,7 +51,7 @@ $( "p" ).last().text( "innerWidth:" + p.innerWidth() ); - 1.8.0 + 1.8 diff --git a/entries/jQuery.ajax.xml b/entries/jQuery.ajax.xml index 258ec227..9074388b 100644 --- a/entries/jQuery.ajax.xml +++ b/entries/jQuery.ajax.xml @@ -138,7 +138,7 @@ $.ajax({ Specify the callback function name for a JSONP request. This value will be used instead of the random name automatically generated by jQuery. It is preferable to let jQuery generate a unique name as it'll make it easier to manage the requests and provide callbacks and error handling. You may want to specify the callback when you want to enable better browser caching of GET requests. As of jQuery 1.5, you can also use a function for this setting, in which case the value of jsonpCallback is set to the return value of that function. - + The HTTP method to use for the request (e.g. "POST", "GET", "PUT"). @@ -150,7 +150,7 @@ $.ajax({ By default, data passed in to the data option as an object (technically, anything other than a string) will be processed and transformed into a query string, fitting to the default content-type "application/x-www-form-urlencoded". If you want to send a DOMDocument, or other non-processed data, set this option to false. - + Defines an object with additional attributes to be used in a "script" or "jsonp" request. The key represents the name of the attribute and the value is the attribute's value. If this object is provided it will force the use of a script-tag transport. For example, this can be used to set nonce, integrity, or crossorigin attributes to satisfy Content Security Policy requirements. diff --git a/entries/jQuery.cssHooks.xml b/entries/jQuery.cssHooks.xml index 19bb9054..ec36ccfe 100644 --- a/entries/jQuery.cssHooks.xml +++ b/entries/jQuery.cssHooks.xml @@ -163,7 +163,7 @@ if ( $.support.someCSSProp && $.support.someCSSProp !== "someCSSProp" ) })( jQuery );

              Special units

              -

              By default, jQuery adds a "px" unit to the values passed to the .css() method. This behavior can be prevented by adding the property to the jQuery.cssNumber object

              +

              By default, jQuery adds a "px" unit to the values passed to the .css() method. This behavior can be prevented by adding the property to the jQuery.cssNumber object

              
 $.cssNumber.someCSSProp = true;
              diff --git a/entries/jQuery.globalEval.xml b/entries/jQuery.globalEval.xml index 19b9f9c9..f6234efe 100644 --- a/entries/jQuery.globalEval.xml +++ b/entries/jQuery.globalEval.xml @@ -8,7 +8,7 @@               - 3.4.0 + 3.4 The JavaScript code to execute. @@ -19,7 +19,7 @@               - 3.5.0 + 3.5 The JavaScript code to execute. diff --git a/entries/outerHeight.xml b/entries/outerHeight.xml index 991a36da..5432ff08 100644 --- a/entries/outerHeight.xml +++ b/entries/outerHeight.xml @@ -47,7 +47,7 @@ $( "p" ).last().text( - 1.8.0 + 1.8 @@ -58,7 +58,7 @@ $( "p" ).last().text( - 1.8.0 + 1.8 diff --git a/entries/outerWidth.xml b/entries/outerWidth.xml index c8e6f87e..93faab40 100644 --- a/entries/outerWidth.xml +++ b/entries/outerWidth.xml @@ -47,7 +47,7 @@ $( "p" ).last().text( - 1.8.0 + 1.8 @@ -58,7 +58,7 @@ $( "p" ).last().text( - 1.8.0 + 1.8 diff --git a/notes.xsl b/notes.xsl index b6c5969f..6963dad2 100644 --- a/notes.xsl +++ b/notes.xsl @@ -17,7 +17,7 @@ Selected elements are in the order of their appearance in the document. - Forms and their child elements should not use input names or ids that conflict with properties of a form, such as submit, length, or method. Name conflicts can cause confusing failures. For a complete list of rules and to check your markup for these problems, see DOMLint. + Forms and their child elements should not use input names or ids that conflict with properties of a form, such as submit, length, or method. Name conflicts can cause confusing failures. For a complete list of rules and to check your markup for these problems, see DOMLint. The value reported by is not guaranteed to be accurate when the element or its parent is hidden. To get an accurate value, ensure the element is visible before using . jQuery will attempt to temporarily show and then re-hide an element in order to measure its dimensions, but this is unreliable and (even when accurate) can significantly impact page performance. This show-and-rehide measurement feature may be removed in a future version of jQuery. diff --git a/pages/Types.html b/pages/Types.html index 6c75695e..5364dd5f 100644 --- a/pages/Types.html +++ b/pages/Types.html @@ -300,7 +300,7 @@

              Iteration

              alert( "key is " + [ key ] + ", value is " + obj[ key ] ); } -

              Note that for-in-loop can be spoiled by extending Object.prototype (see Object.prototype is verboten) so take care when using other libraries. +

              Note that for-in-loop can be spoiled by extending Object.prototype (see Object.prototype is verboten) so take care when using other libraries.

              jQuery provides a generic each function to iterate over properties of objects, as well as elements of arrays:

              From 72e6a9159fde4e40683426ddb9e410d4c3c2742b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?= Date: Wed, 17 May 2023 15:36:13 +0200 Subject: [PATCH 651/699] 3.3.1 --- package-lock.json | 2 +- package.json | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/package-lock.json b/package-lock.json index 580ff193..f90e7656 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,6 +1,6 @@ { "name": "api.jquery.com", - "version": "3.3.0", + "version": "3.3.1", "lockfileVersion": 1, "requires": true, "dependencies": { diff --git a/package.json b/package.json index b329b4c9..040e83a1 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "api.jquery.com", "title": "jQuery API Docs", "description": "API reference documentation for the jQuery JavaScript Library.", - "version": "3.3.0", + "version": "3.3.1", "homepage": "https://github.com/jquery/api.jquery.com", "author": { "name": "jQuery Foundation and other contributors" From 88b9286e689f39ecd3e3e582fe6a8c8ca887ebb9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?= Date: Mon, 12 Jun 2023 22:00:56 +0200 Subject: [PATCH 652/699] jQuery.error: Don't advertise assigning jQuery.error to console.error The original implementation of `jQuery.error` throws an error. When overwritten, it should still finish by throwing an error to avoid observable differences in behavior. Closes gh-1233 --- entries/jQuery.error.xml | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/entries/jQuery.error.xml b/entries/jQuery.error.xml index 3ae5110a..54b64d5d 100644 --- a/entries/jQuery.error.xml +++ b/entries/jQuery.error.xml @@ -10,11 +10,15 @@ Takes a string and throws an exception containing it.

              This method exists primarily for plugin developers who wish to override it and provide a better display (or more information) for the error messages.

              +

              If you do override the method, remember to still throw an error at the end to preserve semantics.

               - Override jQuery.error for display in Firebug. + Override jQuery.error to send it to a logging service, assuming the sendErrorLog method is provided by this service. From 6c2c0e6839aeabbc8f1613666b25a292c74c44d7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?= Date: Mon, 12 Jun 2023 22:01:44 +0200 Subject: [PATCH 653/699] 3.3.2 --- package-lock.json | 2 +- package.json | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/package-lock.json b/package-lock.json index f90e7656..4e749025 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,6 +1,6 @@ { "name": "api.jquery.com", - "version": "3.3.1", + "version": "3.3.2", "lockfileVersion": 1, "requires": true, "dependencies": { diff --git a/package.json b/package.json index 040e83a1..7682059f 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "api.jquery.com", "title": "jQuery API Docs", "description": "API reference documentation for the jQuery JavaScript Library.", - "version": "3.3.1", + "version": "3.3.2", "homepage": "https://github.com/jquery/api.jquery.com", "author": { "name": "jQuery Foundation and other contributors" From 2efc58620b8e451b57780b83ca3fe7b645e00758 Mon Sep 17 00:00:00 2001 From: Timo Tijhof Date: Sat, 8 Jul 2023 20:04:37 +0100 Subject: [PATCH 654/699] Build: Remove redundant grunt-cli dependency This is already providewd by grunt, which actually installs one patch version newer, and so was even installed twice. --- package-lock.json | 28 ---------------------------- package.json | 1 - 2 files changed, 29 deletions(-) diff --git a/package-lock.json b/package-lock.json index 4e749025..29f9ff8c 100644 --- a/package-lock.json +++ b/package-lock.json @@ -422,29 +422,6 @@ "resolved": "https://registry.npmjs.org/grunt-check-modules/-/grunt-check-modules-1.1.0.tgz", "integrity": "sha1-fBZB28ZlSGdqbVl5Ga35C3s11kQ=" }, - "grunt-cli": { - "version": "1.4.2", - "resolved": "https://registry.npmjs.org/grunt-cli/-/grunt-cli-1.4.2.tgz", - "integrity": "sha512-wsu6BZh7KCnfeaSkDrKIAvOlqGKxNRTZjc8xfZlvxCByQIqUfZ31kh5uHpPnhQ4NdVgvaWaVxa1LUbVU80nACw==", - "requires": { - "grunt-known-options": "~1.1.1", - "interpret": "~1.1.0", - "liftup": "~3.0.1", - "nopt": "~4.0.1", - "v8flags": "~3.2.0" - }, - "dependencies": { - "nopt": { - "version": "4.0.3", - "resolved": "https://registry.npmjs.org/nopt/-/nopt-4.0.3.tgz", - "integrity": "sha512-CvaGwVMztSMJLOeXPrez7fyfObdZqNUK1cPAEzLHrTybIua9pMdmmPR5YwtfNftIOMv3DPUhFaxsZMNTQO20Kg==", - "requires": { - "abbrev": "1", - "osenv": "^0.1.4" - } - } - } - }, "grunt-jquery-content": { "version": "3.1.0", "resolved": "https://registry.npmjs.org/grunt-jquery-content/-/grunt-jquery-content-3.1.0.tgz", @@ -473,11 +450,6 @@ } } }, - "grunt-known-options": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/grunt-known-options/-/grunt-known-options-1.1.1.tgz", - "integrity": "sha512-cHwsLqoighpu7TuYj5RonnEuxGVFnztcUqTqp5rXFGYL4OuPFofwC4Ycg7n9fYwvK6F5WbYgeVOwph9Crs2fsQ==" - }, "grunt-legacy-log": { "version": "3.0.0", "resolved": "https://registry.npmjs.org/grunt-legacy-log/-/grunt-legacy-log-3.0.0.tgz", diff --git a/package.json b/package.json index 7682059f..d4e153da 100644 --- a/package.json +++ b/package.json @@ -25,7 +25,6 @@ }, "dependencies": { "grunt": "1.5.3", - "grunt-cli": "1.4.2", "grunt-jquery-content": "3.1.0" } } From 97813056dd1b4a4d98904b1d66ff8baf2bc8d411 Mon Sep 17 00:00:00 2001 From: Timmy Willison Date: Mon, 24 Jul 2023 11:04:49 -0400 Subject: [PATCH 655/699] Build: add node.js workflow to run lint --- .github/workflows/node.js.yml | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 .github/workflows/node.js.yml diff --git a/.github/workflows/node.js.yml b/.github/workflows/node.js.yml new file mode 100644 index 00000000..c5ba2621 --- /dev/null +++ b/.github/workflows/node.js.yml @@ -0,0 +1,29 @@ +# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-nodejs + +name: Node.js CI + +on: + push: + branches: [ "main" ] + pull_request: + branches: [ "main" ] + +jobs: + build: + + runs-on: ubuntu-latest + + strategy: + matrix: + # Old infra requires Node 10 + node-version: [10.x, 18.x] + + steps: + - uses: actions/checkout@v3 + - name: Use Node.js ${{ matrix.node-version }} + uses: actions/setup-node@v3 + with: + node-version: ${{ matrix.node-version }} + cache: 'npm' + - run: npm ci + - run: npm test From bd7a1a0c5cef3c3fc02d9515147aa43c6263c961 Mon Sep 17 00:00:00 2001 From: Timmy Willison Date: Mon, 24 Jul 2023 11:19:42 -0400 Subject: [PATCH 656/699] Build: install libxml2 for lint task (#1237) --- .github/workflows/node.js.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.github/workflows/node.js.yml b/.github/workflows/node.js.yml index c5ba2621..5309c6fa 100644 --- a/.github/workflows/node.js.yml +++ b/.github/workflows/node.js.yml @@ -19,6 +19,8 @@ jobs: node-version: [10.x, 18.x] steps: + - name: Install xmllint + run: sudo apt-get install -y libxml2-utils - uses: actions/checkout@v3 - name: Use Node.js ${{ matrix.node-version }} uses: actions/setup-node@v3 From e0244b03fc2c7fd4475b37c11fb77b919bb9263a Mon Sep 17 00:00:00 2001 From: Timo Tijhof Date: Sat, 23 Jan 2016 17:13:04 +0000 Subject: [PATCH 657/699] Build: Add `.editorconfig` file (#877) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The vast majority of XML files in the repo use two spaces today, and even the files that contain tabs, do so only among many more lines in the same file that are indented with spaces instead. As such, for now, normalize toward two spaces so that only a few files need to edited. The exception is the JS and XSL files, of which the are only two of each. In accordance with jQuery Style Guide, keep those as tabs. ``` $ git grep $'\t' | cut -d':' -f1 | sort | uniq Gruntfile.js entries2html.xsl notes.xsl resources/events.js git grep $' ' | cut -d':' -f1 | sort | uniq … ``` Closes https://github.com/jquery/api.jquery.com/pull/877. Co-authored-by: Aurelio De Rosa --- .editorconfig | 13 +++ categories.xml | 72 ++++++++-------- config-sample.json | 6 +- entries/appendTo.xml | 2 +- entries/innerHeight.xml | 2 +- entries/innerWidth.xml | 8 +- entries/jQuery.parseHTML.xml | 4 +- entries/offset.xml | 6 +- entries/outerHeight.xml | 2 +- entries/outerWidth.xml | 2 +- entries/position.xml | 2 +- entries/width.xml | 2 +- includes/complete-argument.xml | 2 +- includes/duration-argument.xml | 6 +- includes/easing-argument.xml | 2 +- includes/options-argument.xml | 150 ++++++++++++++++----------------- pages/Types.html | 2 +- redirects.json | 2 +- resources/events.js | 52 ++++++------ resources/load.html | 16 ++-- 20 files changed, 183 insertions(+), 170 deletions(-) create mode 100644 .editorconfig diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 00000000..8b808995 --- /dev/null +++ b/.editorconfig @@ -0,0 +1,13 @@ +# editorconfig.org +root = true + +[*] +indent_style = space +indent_size = 2 +end_of_line = lf +charset = utf-8 +trim_trailing_whitespace = true +insert_final_newline = true + +[*.js, *.xsl] +indent_style = tab diff --git a/categories.xml b/categories.xml index 06418fb2..2f408651 100644 --- a/categories.xml +++ b/categories.xml @@ -190,15 +190,15 @@ var files = event.originalEvent.dataTransfer.files;               - + Attributes category), while others set an element's style properties (also listed in the CSS category). Still others modify entire elements (or groups of elements) themselves—inserting, copying, removing, and so on. All of these methods are referred to as "setters," as they change the values of properties. - A few of these methods—such as .attr(), .html(), and .val()—also act as "getters," retrieving information from DOM elements for later use. - ]]> + A few of these methods—such as .attr(), .html(), and .val()—also act as "getters," retrieving information from DOM elements for later use. + ]]> @@ -327,73 +327,73 @@ var files = event.originalEvent.dataTransfer.files; jQuery 1.0 Release Notes. - ]]> + jQuery 1.0 Release Notes. + ]]> 1.0.1, 1.0.2, 1.0.3, 1.0.4. - ]]> + Release Notes: 1.0.1, 1.0.2, 1.0.3, 1.0.4. + ]]> jQuery 1.1 Release Notes. - ]]> + jQuery 1.1 Release Notes. + ]]> jQuery 1.1.2 Release Notes. - ]]> + jQuery 1.1.2 Release Notes. + ]]> jQuery 1.1.3 Release Notes - ]]> + jQuery 1.1.3 Release Notes + ]]> jQuery 1.1.4 Release Notes. - ]]> + jQuery 1.1.4 Release Notes. + ]]> jQuery 1.2 Release Notes - ]]> + jQuery 1.2 Release Notes + ]]> 1.2.1, 1.2.2, 1.2.3. - ]]> + Release Notes: 1.2.1, 1.2.2, 1.2.3. + ]]> jQuery 1.2.6 Release Notes. - ]]> + jQuery 1.2.6 Release Notes. + ]]> 1.3, 1.3.1, 1.3.2 - ]]> + Release Notes: 1.3, 1.3.1, 1.3.2 + ]]> jQuery 1.4 Release Notes. - ]]> + jQuery 1.4 Release Notes. + ]]> jQuery 1.4.1 Release Notes. - ]]> + jQuery 1.4.1 Release Notes. + ]]> jQuery 1.4.2 Release Notes. - ]]> + jQuery 1.4.2 Release Notes. + ]]> jQuery 1.4.3 Release Notes. - ]]> + jQuery 1.4.3 Release Notes. + ]]> jQuery 1.4.4 Release Notes.]]> @@ -414,11 +414,11 @@ var files = event.originalEvent.dataTransfer.files; Aspects of the API that were changed in the corresponding version of jQuery. API changes in jQuery 1.7.0 dealt primarily with the new - Event APIs: .on() and .off() - Better Support for HTML5 in IE6/7/8 - jQuery.Callbacks() - Toggling Animations Work Intuitively -

              + Event APIs: .on() and .off() + Better Support for HTML5 in IE6/7/8 + jQuery.Callbacks() + Toggling Animations Work Intuitively +

              For more information, see the Release Notes/Changelog at https://blog.jquery.com/2011/11/03/jquery-1-7-released/

              ]]>               diff --git a/config-sample.json b/config-sample.json index b26cf9fc..a62b85f2 100644 --- a/config-sample.json +++ b/config-sample.json @@ -1,5 +1,5 @@ { - "url": "vagrant.api.jquery.com", - "username": "admin", - "password": "secret" + "url": "vagrant.api.jquery.com", + "username": "admin", + "password": "secret" } diff --git a/entries/appendTo.xml b/entries/appendTo.xml index 931e70bb..7221b2e0 100644 --- a/entries/appendTo.xml +++ b/entries/appendTo.xml @@ -54,7 +54,7 @@ $( "h2" ).appendTo( $( ".container" ) ); </div>

              If there is more than one target element, however, cloned copies of the inserted element will be created for each target except the last, and that new set (the original element plus clones) is returned.

              -

              Before jQuery 1.9, the append-to-single-element case did not create a new set, but instead returned the original set which made it difficult to use the .end() method reliably when being used with an unknown number of elements.

              +

              Before jQuery 1.9, the append-to-single-element case did not create a new set, but instead returned the original set which made it difficult to use the .end() method reliably when being used with an unknown number of elements.

              diff --git a/entries/innerHeight.xml b/entries/innerHeight.xml index 72e8327d..2f71ae9f 100644 --- a/entries/innerHeight.xml +++ b/entries/innerHeight.xml @@ -16,7 +16,7 @@
              Figure 1 - Illustration of the measured height
              - + Get the innerHeight of a paragraph. diff --git a/entries/innerWidth.xml b/entries/innerWidth.xml index 7eb25c9d..54b6b358 100644 --- a/entries/innerWidth.xml +++ b/entries/innerWidth.xml @@ -15,7 +15,7 @@
              Figure 1 - Illustration of the measured width
              - + Get the innerWidth of a paragraph. @@ -45,9 +45,9 @@ $( "p" ).last().text( "innerWidth:" + p.innerWidth() ); 1.8 - - - A number representing the number of pixels, or a number along with an optional unit of measure appended (as a string). + + + A number representing the number of pixels, or a number along with an optional unit of measure appended (as a string). diff --git a/entries/jQuery.parseHTML.xml b/entries/jQuery.parseHTML.xml index 5354627a..5ff74ce7 100644 --- a/entries/jQuery.parseHTML.xml +++ b/entries/jQuery.parseHTML.xml @@ -18,8 +18,8 @@

              jQuery.parseHTML uses native methods to convert the string to a set of DOM nodes, which can then be inserted into the document. These methods do render all trailing or leading text (even if that's just whitespace). To prevent trailing/leading whitespace from being converted to text nodes you can pass the HTML string through jQuery.trim.

              By default, the context is the current document if not specified or given as null or undefined. If the HTML was to be used in another document such as an iframe, that frame's document could be used.

              As of 3.0 the default behavior is changed. If the context is not specified or given as null or undefined, a new document is used. This can potentially improve security because inline events will not execute when the HTML is parsed. Once the parsed HTML is injected into a document it does execute, but this gives tools a chance to traverse the created DOM and remove anything deemed unsafe. This improvement does not apply to internal uses of jQuery.parseHTML as they usually pass in the current document. Therefore, a statement like $( "#log" ).append( $( htmlString ) ) is still subject to the injection of malicious code.

              -

              Security Considerations

              -

              Most jQuery APIs that accept HTML strings will run scripts that are included in the HTML. jQuery.parseHTML does not run scripts in the parsed HTML unless keepScripts is explicitly true. However, it is still possible in most environments to execute scripts indirectly, for example via the <img onerror> attribute. The caller should be aware of this and guard against it by cleaning or escaping any untrusted inputs from sources such as the URL or cookies. For future compatibility, callers should not depend on the ability to run any script content when keepScripts is unspecified or false.

              +

              Security Considerations

              +

              Most jQuery APIs that accept HTML strings will run scripts that are included in the HTML. jQuery.parseHTML does not run scripts in the parsed HTML unless keepScripts is explicitly true. However, it is still possible in most environments to execute scripts indirectly, for example via the <img onerror> attribute. The caller should be aware of this and guard against it by cleaning or escaping any untrusted inputs from sources such as the URL or cookies. For future compatibility, callers should not depend on the ability to run any script content when keepScripts is unspecified or false.

              Create an array of DOM nodes using an HTML string and insert it into a div. diff --git a/entries/offset.xml b/entries/offset.xml index 5a2f3535..81923287 100644 --- a/entries/offset.xml +++ b/entries/offset.xml @@ -11,11 +11,11 @@

              The .offset() method allows us to retrieve the current position of an element (specifically its border box, which excludes margins) relative to the document. Contrast this with .position(), which retrieves the current position relative to the offset parent. When positioning a new element on top of an existing one for global manipulation (in particular, for implementing drag-and-drop), .offset() is more useful.

              .offset() returns an object containing the properties top and left.

              -

              Note: jQuery does not support getting the offset coordinates of hidden elements or accounting for margins set on the <html> document element.

              +

              Note: jQuery does not support getting the offset coordinates of hidden elements or accounting for margins set on the <html> document element.

              While it is possible to get the coordinates of elements with visibility:hidden set, display:none is excluded from the rendering tree and thus has a position that is undefined.

              - + Access the offset of the second paragraph: - + A function to return the coordinates to set. Receives the index of the element in the collection as the first argument and the current coordinates as the second argument. The function should return an object with the new top and left properties.               diff --git a/entries/outerHeight.xml b/entries/outerHeight.xml index 5432ff08..dc53bcb3 100644 --- a/entries/outerHeight.xml +++ b/entries/outerHeight.xml @@ -18,7 +18,7 @@
              Figure 1 - Illustration of the measured height
              - + Get the outerHeight of a paragraph. diff --git a/entries/outerWidth.xml b/entries/outerWidth.xml index 93faab40..2c5856be 100644 --- a/entries/outerWidth.xml +++ b/entries/outerWidth.xml @@ -18,7 +18,7 @@
              Figure 1 - Illustration of the measured width
              - + Get the outerWidth of a paragraph. diff --git a/entries/position.xml b/entries/position.xml index 60b3e6a2..565f64af 100644 --- a/entries/position.xml +++ b/entries/position.xml @@ -12,7 +12,7 @@

              Note: jQuery does not support getting the position coordinates of hidden elements or accounting for margins set on the <html> document element.

              - + Access the position of the second paragraph: Note: Although style and script tags will report a value for .width() or height() when absolutely positioned and given display:block, it is strongly discouraged to call those methods on these tags. In addition to being a bad practice, the results may also prove unreliable.

              - + Show various widths. Note the values are from the iframe so might be smaller than you expected. The yellow highlight shows the iframe body. diff --git a/includes/complete-argument.xml b/includes/complete-argument.xml index 5d109f39..4ef06fa3 100644 --- a/includes/complete-argument.xml +++ b/includes/complete-argument.xml @@ -1,4 +1,4 @@ - A function to call once the animation is complete, called once per matched element. + A function to call once the animation is complete, called once per matched element. diff --git a/includes/duration-argument.xml b/includes/duration-argument.xml index 1a1c5c5e..8fcfb7f3 100644 --- a/includes/duration-argument.xml +++ b/includes/duration-argument.xml @@ -1,6 +1,6 @@ - A string or number determining how long the animation will run. - - + A string or number determining how long the animation will run. + + diff --git a/includes/easing-argument.xml b/includes/easing-argument.xml index b6483551..127057af 100644 --- a/includes/easing-argument.xml +++ b/includes/easing-argument.xml @@ -1,4 +1,4 @@ - A string indicating which easing function to use for the transition. + A string indicating which easing function to use for the transition. diff --git a/includes/options-argument.xml b/includes/options-argument.xml index 168e8648..cacb3286 100644 --- a/includes/options-argument.xml +++ b/includes/options-argument.xml @@ -1,81 +1,81 @@ - A map of additional options to pass to the method. - - A string or number determining how long the animation will run. - - - - - A string indicating which easing function to use for the transition. - - - A Boolean indicating whether to place the animation in the effects queue. If false, the animation will begin immediately. As of jQuery 1.7, the queue option can also accept a string, in which case the animation is added to the queue represented by that string. When a custom queue name is used the animation does not automatically start; you must call .dequeue("queuename") to start it. - - - - - An object containing one or more of the CSS properties defined by the properties argument and their corresponding easing functions. - + A map of additional options to pass to the method. + + A string or number determining how long the animation will run. + + + + + A string indicating which easing function to use for the transition. + + + A Boolean indicating whether to place the animation in the effects queue. If false, the animation will begin immediately. As of jQuery 1.7, the queue option can also accept a string, in which case the animation is added to the queue represented by that string. When a custom queue name is used the animation does not automatically start; you must call .dequeue("queuename") to start it. + + + + + An object containing one or more of the CSS properties defined by the properties argument and their corresponding easing functions. + - - A function to be called for each animated property of each animated element. This function provides an opportunity to modify the Tween object to change the value of the property before it is set. - - The numeric value of the property being animated at each step - - - An object of properties related to the animation and the element being animated. For information about the tween object and its properties, see jQuery.Tween - - + + A function to be called for each animated property of each animated element. This function provides an opportunity to modify the Tween object to change the value of the property before it is set. + + The numeric value of the property being animated at each step + + + An object of properties related to the animation and the element being animated. For information about the tween object and its properties, see jQuery.Tween + + - - A function to be called after each step of the animation, only once per animated element regardless of the number of animated properties. - - An enhanced Promise object with additional properties for the animation - - - A number from 0 to 1 indicating the progress of the animation - - - A number indicating the remaining number of milliseconds until the scheduled end of the animation - - - - A function that is called once the animation on an element is complete. - - - - A function to call when the animation on an element begins. - - An enhanced Promise object with additional properties for the animation - - - - A function to be called when the animation on an element completes (its Promise object is resolved). - - An enhanced Promise object with additional properties for the animation - - - Indicates whether the animation jumped to the end - - - - A function to be called when the animation on an element fails to complete (its Promise object is rejected). - - An enhanced Promise object with additional properties for the animation - - - Indicates whether the animation jumped to the end - - - - A function to be called when the animation on an element completes or stops without completing (its Promise object is either resolved or rejected). - - An enhanced Promise object with additional properties for the animation - - - Indicates whether the animation jumped to the end - - + + A function to be called after each step of the animation, only once per animated element regardless of the number of animated properties. + + An enhanced Promise object with additional properties for the animation + + + A number from 0 to 1 indicating the progress of the animation + + + A number indicating the remaining number of milliseconds until the scheduled end of the animation + + + + A function that is called once the animation on an element is complete. + + + + A function to call when the animation on an element begins. + + An enhanced Promise object with additional properties for the animation + + + + A function to be called when the animation on an element completes (its Promise object is resolved). + + An enhanced Promise object with additional properties for the animation + + + Indicates whether the animation jumped to the end + + + + A function to be called when the animation on an element fails to complete (its Promise object is rejected). + + An enhanced Promise object with additional properties for the animation + + + Indicates whether the animation jumped to the end + + + + A function to be called when the animation on an element completes or stops without completing (its Promise object is either resolved or rejected). + + An enhanced Promise object with additional properties for the animation + + + Indicates whether the animation jumped to the end + + diff --git a/pages/Types.html b/pages/Types.html index 5364dd5f..a289a497 100644 --- a/pages/Types.html +++ b/pages/Types.html @@ -1,6 +1,6 @@