Bump to v3.3.0.

array/difference.js

@@ -17,7 +17,7 @@ define(['../internal/baseDifference', '../internal/baseFlatten', '../lang/isArgu
    * @returns {Array} Returns the new array of filtered values.
    * @example
    *
-   * _.difference([1, 2, 3], [5, 2, 10]);
+   * _.difference([1, 2, 3], [4, 2]);
    * // => [1, 3]
    */
   function difference() {

array/dropRightWhile.js

@@ -26,7 +26,9 @@ define(['../internal/baseCallback', '../internal/baseSlice'], function(baseCallb
    * @returns {Array} Returns the slice of `array`.
    * @example
    *
-   * _.dropRightWhile([1, 2, 3], function(n) { return n > 1; });
+   * _.dropRightWhile([1, 2, 3], function(n) {
+   *   return n > 1;
+   * });
    * // => [1]
    *
    * var users = [

array/dropWhile.js

@@ -26,7 +26,9 @@ define(['../internal/baseCallback', '../internal/baseSlice'], function(baseCallb
    * @returns {Array} Returns the slice of `array`.
    * @example
    *
-   * _.dropWhile([1, 2, 3], function(n) { return n < 3; });
+   * _.dropWhile([1, 2, 3], function(n) {
+   *   return n < 3;
+   * });
    * // => [3]
    *
    * var users = [

array/findIndex.js

@@ -31,7 +31,9 @@ define(['../internal/baseCallback'], function(baseCallback) {
    *   { 'user': 'pebbles', 'active': true }
    * ];
    *
-   * _.findIndex(users, function(chr) { return chr.user == 'barney'; });
+   * _.findIndex(users, function(chr) {
+   *   return chr.user == 'barney';
+   * });
    * // => 0
    *
    * // using the `_.matches` callback shorthand

array/findLastIndex.js

@@ -31,7 +31,9 @@ define(['../internal/baseCallback'], function(baseCallback) {
    *   { 'user': 'pebbles', 'active': false }
    * ];
    *
-   * _.findLastIndex(users, function(chr) { return chr.user == 'pebbles'; });
+   * _.findLastIndex(users, function(chr) {
+   *   return chr.user == 'pebbles';
+   * });
    * // => 2
    *
    * // using the `_.matches` callback shorthand

array/flatten.js

@@ -13,11 +13,11 @@ define(['../internal/baseFlatten', '../internal/isIterateeCall'], function(baseF
    * @returns {Array} Returns the new flattened array.
    * @example
    *
-   * _.flatten([1, [2], [3, [[4]]]]);
-   * // => [1, 2, 3, [[4]]];
+   * _.flatten([1, [2, 3, [4]]]);
+   * // => [1, 2, 3, [4]];
    *
    * // using `isDeep`
-   * _.flatten([1, [2], [3, [[4]]]], true);
+   * _.flatten([1, [2, 3, [4]]], true);
    * // => [1, 2, 3, 4];
    */
   function flatten(array, isDeep, guard) {

array/flattenDeep.js

@@ -10,7 +10,7 @@ define(['../internal/baseFlatten'], function(baseFlatten) {
    * @returns {Array} Returns the new flattened array.
    * @example
    *
-   * _.flattenDeep([1, [2], [3, [[4]]]]);
+   * _.flattenDeep([1, [2, 3, [4]]]);
    * // => [1, 2, 3, 4];
    */
   function flattenDeep(array) {

array/indexOf.js

@@ -24,15 +24,15 @@ define(['../internal/baseIndexOf', '../internal/binaryIndex'], function(baseInde
    * @returns {number} Returns the index of the matched value, else `-1`.
    * @example
    *
-   * _.indexOf([1, 2, 3, 1, 2, 3], 2);
-   * // => 1
+   * _.indexOf([1, 2, 1, 2], 2);
+   * // => 2
    *
    * // using `fromIndex`
-   * _.indexOf([1, 2, 3, 1, 2, 3], 2, 3);
-   * // => 4
+   * _.indexOf([1, 2, 1, 2], 2, 2);
+   * // => 3
    *
    * // performing a binary search
-   * _.indexOf([4, 4, 5, 5, 6, 6], 5, true);
+   * _.indexOf([1, 1, 2, 2], 2, true);
    * // => 2
    */
   function indexOf(array, value, fromIndex) {

array/intersection.js

@@ -15,9 +15,8 @@ define(['../internal/baseIndexOf', '../internal/cacheIndexOf', '../internal/crea
    * @param {...Array} [arrays] The arrays to inspect.
    * @returns {Array} Returns the new array of shared values.
    * @example
-   *
-   * _.intersection([1, 2, 3], [5, 2, 1, 4], [2, 1]);
-   * // => [1, 2]
+   * _.intersection([1, 2], [4, 2], [2, 1]);
+   * // => [2]
    */
   function intersection() {
     var args = [],

array/lastIndexOf.js

@@ -18,15 +18,15 @@ define(['../internal/binaryIndex', '../internal/indexOfNaN'], function(binaryInd
    * @returns {number} Returns the index of the matched value, else `-1`.
    * @example
    *
-   * _.lastIndexOf([1, 2, 3, 1, 2, 3], 2);
-   * // => 4
+   * _.lastIndexOf([1, 2, 1, 2], 2);
+   * // => 3
    *
    * // using `fromIndex`
-   * _.lastIndexOf([1, 2, 3, 1, 2, 3], 2, 3);
+   * _.lastIndexOf([1, 2, 1, 2], 2, 2);
    * // => 1
    *
    * // performing a binary search
-   * _.lastIndexOf([4, 4, 5, 5, 6, 6], 5, true);
+   * _.lastIndexOf([1, 1, 2, 2], 2, true);
    * // => 3
    */
   function lastIndexOf(array, value, fromIndex) {

array/pull.js

@@ -25,6 +25,7 @@ define(['../internal/baseIndexOf'], function(baseIndexOf) {
    * @example
    *
    * var array = [1, 2, 3, 1, 2, 3];
+   *
    * _.pull(array, 2, 3);
    * console.log(array);
    * // => [1, 1]

array/pullAt.js

@@ -17,7 +17,7 @@ define(['../internal/baseFlatten', '../internal/basePullAt'], function(baseFlatt
    * @example
    *
    * var array = [5, 10, 15, 20];
-   * var evens = _.pullAt(array, [1, 3]);
+   * var evens = _.pullAt(array, 1, 3);
    *
    * console.log(array);
    * // => [5, 15]

array/remove.js

@@ -35,7 +35,9 @@ define(['../internal/baseCallback'], function(baseCallback) {
    * @example
    *
    * var array = [1, 2, 3, 4];
-   * var evens = _.remove(array, function(n) { return n % 2 == 0; });
+   * var evens = _.remove(array, function(n) {
+   *   return n % 2 == 0;
+   * });
    *
    * console.log(array);
    * // => [1, 3]

array/sortedIndex.js

@@ -33,7 +33,7 @@ define(['../internal/baseCallback', '../internal/binaryIndex', '../internal/bina
    * _.sortedIndex([30, 50], 40);
    * // => 1
    *
-   * _.sortedIndex([4, 4, 5, 5, 6, 6], 5);
+   * _.sortedIndex([4, 4, 5, 5], 5);
    * // => 2
    *
    * var dict = { 'data': { 'thirty': 30, 'forty': 40, 'fifty': 50 } };

array/sortedLastIndex.js

@@ -17,7 +17,7 @@ define(['../internal/baseCallback', '../internal/binaryIndex', '../internal/bina
    *  into `array`.
    * @example
    *
-   * _.sortedLastIndex([4, 4, 5, 5, 6, 6], 5);
+   * _.sortedLastIndex([4, 4, 5, 5], 5);
    * // => 4
    */
   function sortedLastIndex(array, value, iteratee, thisArg) {

array/takeRightWhile.js

@@ -26,7 +26,9 @@ define(['../internal/baseCallback', '../internal/baseSlice'], function(baseCallb
    * @returns {Array} Returns the slice of `array`.
    * @example
    *
-   * _.takeRightWhile([1, 2, 3], function(n) { return n > 1; });
+   * _.takeRightWhile([1, 2, 3], function(n) {
+   *   return n > 1;
+   * });
    * // => [2, 3]
    *
    * var users = [

array/takeWhile.js

@@ -26,7 +26,9 @@ define(['../internal/baseCallback', '../internal/baseSlice'], function(baseCallb
    * @returns {Array} Returns the slice of `array`.
    * @example
    *
-   * _.takeWhile([1, 2, 3], function(n) { return n < 3; });
+   * _.takeWhile([1, 2, 3], function(n) {
+   *   return n < 3;
+   * });
    * // => [1, 2]
    *
    * var users = [

array/union.js

@@ -16,8 +16,8 @@ define(['../internal/baseFlatten', '../internal/baseUniq'], function(baseFlatten
    * @returns {Array} Returns the new array of combined values.
    * @example
    *
-   * _.union([1, 2, 3], [5, 2, 1, 4], [2, 1]);
-   * // => [1, 2, 3, 5, 4]
+   * _.union([1, 2], [4, 2], [2, 1]);
+   * // => [1, 2, 4]
    */
   function union() {
     return baseUniq(baseFlatten(arguments, false, true));

array/uniq.js

@@ -43,7 +43,9 @@ define(['../internal/baseCallback', '../internal/baseUniq', '../internal/isItera
    * // => [1, 2]
    *
    * // using an iteratee function
-   * _.uniq([1, 2.5, 1.5, 2], function(n) { return this.floor(n); }, Math);
+   * _.uniq([1, 2.5, 1.5, 2], function(n) {
+   *   return this.floor(n);
+   * }, Math);
    * // => [1, 2.5]
    *
    * // using the `_.property` callback shorthand
@@ -55,8 +57,7 @@ define(['../internal/baseCallback', '../internal/baseUniq', '../internal/isItera
     if (!length) {
       return [];
     }
-    // Juggle arguments.
-    if (typeof isSorted != 'boolean' && isSorted != null) {
+    if (isSorted != null && typeof isSorted != 'boolean') {
       thisArg = iteratee;
       iteratee = isIterateeCall(array, isSorted, thisArg) ? null : isSorted;
       isSorted = false;

array/without.js

@@ -17,8 +17,8 @@ define(['../internal/baseDifference', '../internal/baseSlice'], function(baseDif
    * @returns {Array} Returns the new array of filtered values.
    * @example
    *
-   * _.without([1, 2, 1, 0, 3, 1, 4], 0, 1);
-   * // => [2, 3, 4]
+   * _.without([1, 2, 1, 3], 1, 2);
+   * // => [3]
    */
   function without(array) {
     return baseDifference(array, baseSlice(arguments, 1));

array/xor.js

@@ -12,11 +12,8 @@ define(['../internal/baseDifference', '../internal/baseUniq', '../lang/isArgumen
    * @returns {Array} Returns the new array of values.
    * @example
    *
-   * _.xor([1, 2, 3], [5, 2, 1, 4]);
-   * // => [3, 5, 4]
-   *
-   * _.xor([1, 2, 5], [2, 3, 5], [3, 4, 5]);
-   * // => [1, 4, 5]
+   * _.xor([1, 2], [4, 2]);
+   * // => [1, 4]
    */
   function xor() {
     var index = -1,