Bump to v3.3.0.

collection/at.js

@@ -17,8 +17,8 @@ var baseAt = require('../internal/baseAt'),
  * @returns {Array} Returns the new array of picked elements.
  * @example
  *
- * _.at(['a', 'b', 'c', 'd', 'e'], [0, 2, 4]);
- * // => ['a', 'c', 'e']
+ * _.at(['a', 'b', 'c'], [0, 2]);
+ * // => ['a', 'c']
  *
  * _.at(['fred', 'barney', 'pebbles'], 0, 2);
  * // => ['fred', 'pebbles']

collection/countBy.js

@@ -34,10 +34,14 @@ var hasOwnProperty = objectProto.hasOwnProperty;
  * @returns {Object} Returns the composed aggregate object.
  * @example
  *
- * _.countBy([4.3, 6.1, 6.4], function(n) { return Math.floor(n); });
+ * _.countBy([4.3, 6.1, 6.4], function(n) {
+ *   return Math.floor(n);
+ * });
  * // => { '4': 1, '6': 2 }
  *
- * _.countBy([4.3, 6.1, 6.4], function(n) { return this.floor(n); }, Math);
+ * _.countBy([4.3, 6.1, 6.4], function(n) {
+ *   return this.floor(n);
+ * }, Math);
  * // => { '4': 1, '6': 2 }
  *
  * _.countBy(['one', 'two', 'three'], 'length');

collection/filter.js

@@ -30,8 +30,10 @@ var arrayFilter = require('../internal/arrayFilter'),
  * @returns {Array} Returns the new filtered array.
  * @example
  *
- * var evens = _.filter([1, 2, 3, 4], function(n) { return n % 2 == 0; });
- * // => [2, 4]
+ * _.filter([4, 5, 6], function(n) {
+ *   return n % 2 == 0;
+ * });
+ * // => [4, 6]
  *
  * var users = [
  *   { 'user': 'barney', 'age': 36, 'active': true },

collection/find.js

@@ -37,7 +37,9 @@ var baseCallback = require('../internal/baseCallback'),
  *   { 'user': 'pebbles', 'age': 1,  'active': true }
  * ];
  *
- * _.result(_.find(users, function(chr) { return chr.age < 40; }), 'user');
+ * _.result(_.find(users, function(chr) {
+ *   return chr.age < 40;
+ * }), 'user');
  * // => 'barney'
  *
  * // using the `_.matches` callback shorthand

collection/findLast.js

@@ -16,7 +16,9 @@ var baseCallback = require('../internal/baseCallback'),
  * @returns {*} Returns the matched element, else `undefined`.
  * @example
  *
- * _.findLast([1, 2, 3, 4], function(n) { return n % 2 == 1; });
+ * _.findLast([1, 2, 3, 4], function(n) {
+ *   return n % 2 == 1;
+ * });
  * // => 3
  */
 function findLast(collection, predicate, thisArg) {

collection/forEach.js

@@ -23,10 +23,14 @@ var arrayEach = require('../internal/arrayEach'),
  * @returns {Array|Object|string} Returns `collection`.
  * @example
  *
- * _([1, 2, 3]).forEach(function(n) { console.log(n); }).value();
+ * _([1, 2]).forEach(function(n) {
+ *   console.log(n);
+ * }).value();
  * // => logs each value from left to right and returns the array
  *
- * _.forEach({ 'one': 1, 'two': 2, 'three': 3 }, function(n, key) { console.log(n, key); });
+ * _.forEach({ 'a': 1, 'b': 2 }, function(n, key) {
+ *   console.log(n, key);
+ * });
  * // => logs each value-key pair and returns the object (iteration order is not guaranteed)
  */
 function forEach(collection, iteratee, thisArg) {

collection/forEachRight.js

@@ -17,7 +17,9 @@ var arrayEachRight = require('../internal/arrayEachRight'),
  * @returns {Array|Object|string} Returns `collection`.
  * @example
  *
- * _([1, 2, 3]).forEachRight(function(n) { console.log(n); }).join(',');
+ * _([1, 2]).forEachRight(function(n) {
+ *   console.log(n);
+ * }).join(',');
  * // => logs each value from right to left and returns the array
  */
 function forEachRight(collection, iteratee, thisArg) {

collection/groupBy.js

@@ -34,10 +34,14 @@ var hasOwnProperty = objectProto.hasOwnProperty;
  * @returns {Object} Returns the composed aggregate object.
  * @example
  *
- * _.groupBy([4.2, 6.1, 6.4], function(n) { return Math.floor(n); });
+ * _.groupBy([4.2, 6.1, 6.4], function(n) {
+ *   return Math.floor(n);
+ * });
  * // => { '4': [4.2], '6': [6.1, 6.4] }
  *
- * _.groupBy([4.2, 6.1, 6.4], function(n) { return this.floor(n); }, Math);
+ * _.groupBy([4.2, 6.1, 6.4], function(n) {
+ *   return this.floor(n);
+ * }, Math);
  * // => { '4': [4.2], '6': [6.1, 6.4] }
  *
  * // using the `_.property` callback shorthand

collection/indexBy.js

@@ -36,10 +36,14 @@ var createAggregator = require('../internal/createAggregator');
  * _.indexBy(keyData, 'dir');
  * // => { 'left': { 'dir': 'left', 'code': 97 }, 'right': { 'dir': 'right', 'code': 100 } }
  *
- * _.indexBy(keyData, function(object) { return String.fromCharCode(object.code); });
+ * _.indexBy(keyData, function(object) {
+ *   return String.fromCharCode(object.code);
+ * });
  * // => { 'a': { 'dir': 'left', 'code': 97 }, 'd': { 'dir': 'right', 'code': 100 } }
  *
- * _.indexBy(keyData, function(object) { return this.fromCharCode(object.code); }, String);
+ * _.indexBy(keyData, function(object) {
+ *   return this.fromCharCode(object.code);
+ * }, String);
  * // => { 'a': { 'dir': 'left', 'code': 97 }, 'd': { 'dir': 'right', 'code': 100 } }
  */
 var indexBy = createAggregator(function(result, value, key) {

collection/map.js

@@ -40,11 +40,15 @@ var arrayMap = require('../internal/arrayMap'),
  * @returns {Array} Returns the new mapped array.
  * @example
  *
- * _.map([1, 2, 3], function(n) { return n * 3; });
- * // => [3, 6, 9]
+ * function timesThree(n) {
+ *   return n * 3;
+ * }
  *
- * _.map({ 'one': 1, 'two': 2, 'three': 3 }, function(n) { return n * 3; });
- * // => [3, 6, 9] (iteration order is not guaranteed)
+ * _.map([1, 2], timesThree);
+ * // => [3, 6]
+ *
+ * _.map({ 'a': 1, 'b': 2 }, timesThree);
+ * // => [3, 6] (iteration order is not guaranteed)
  *
  * var users = [
  *   { 'user': 'barney' },

collection/max.js

@@ -39,7 +39,9 @@ var arrayMax = require('../internal/arrayMax'),
  *   { 'user': 'fred',   'age': 40 }
  * ];
  *
- * _.max(users, function(chr) { return chr.age; });
+ * _.max(users, function(chr) {
+ *   return chr.age;
+ * });
  * // => { 'user': 'fred', 'age': 40 };
  *
  * // using the `_.property` callback shorthand

collection/min.js

@@ -39,7 +39,9 @@ var arrayMin = require('../internal/arrayMin'),
  *   { 'user': 'fred',   'age': 40 }
  * ];
  *
- * _.min(users, function(chr) { return chr.age; });
+ * _.min(users, function(chr) {
+ *   return chr.age;
+ * });
  * // => { 'user': 'barney', 'age': 36 };
  *
  * // using the `_.property` callback shorthand

collection/partition.js

@@ -27,10 +27,14 @@ var createAggregator = require('../internal/createAggregator');
  * @returns {Array} Returns the array of grouped elements.
  * @example
  *
- * _.partition([1, 2, 3], function(n) { return n % 2; });
+ * _.partition([1, 2, 3], function(n) {
+ *   return n % 2;
+ * });
  * // => [[1, 3], [2]]
  *
- * _.partition([1.2, 2.3, 3.4], function(n) { return this.floor(n) % 2; }, Math);
+ * _.partition([1.2, 2.3, 3.4], function(n) {
+ *   return this.floor(n) % 2;
+ * }, Math);
  * // => [[1, 3], [2]]
  *
  * var users = [
@@ -39,7 +43,9 @@ var createAggregator = require('../internal/createAggregator');
  *   { 'user': 'pebbles', 'age': 1,  'active': false }
  * ];
  *
- * var mapper = function(array) { return _.pluck(array, 'user'); };
+ * var mapper = function(array) {
+ *   return _.pluck(array, 'user');
+ * };
  *
  * // using the `_.matches` callback shorthand
  * _.map(_.partition(users, { 'age': 1, 'active': false }), mapper);

collection/reduce.js

@@ -29,14 +29,16 @@ var arrayReduce = require('../internal/arrayReduce'),
  * @returns {*} Returns the accumulated value.
  * @example
  *
- * var sum = _.reduce([1, 2, 3], function(sum, n) { return sum + n; });
- * // => 6
+ * _.reduce([1, 2], function(sum, n) {
+ *   return sum + n;
+ * });
+ * // => 3
  *
- * var mapped = _.reduce({ 'a': 1, 'b': 2, 'c': 3 }, function(result, n, key) {
+ * _.reduce({ 'a': 1, 'b': 2 }, function(result, n, key) {
  *   result[key] = n * 3;
  *   return result;
  * }, {});
- * // => { 'a': 3, 'b': 6, 'c': 9 } (iteration order is not guaranteed)
+ * // => { 'a': 3, 'b': 6 } (iteration order is not guaranteed)
  */
 function reduce(collection, iteratee, accumulator, thisArg) {
   var func = isArray(collection) ? arrayReduce : baseReduce;

collection/reduceRight.js

@@ -20,7 +20,10 @@ var arrayReduceRight = require('../internal/arrayReduceRight'),
  * @example
  *
  * var array = [[0, 1], [2, 3], [4, 5]];
- * _.reduceRight(array, function(flattened, other) { return flattened.concat(other); }, []);
+ *
+ * _.reduceRight(array, function(flattened, other) {
+ *   return flattened.concat(other);
+ * }, []);
  * // => [4, 5, 2, 3, 0, 1]
  */
 function reduceRight(collection, iteratee, accumulator, thisArg) {

collection/reject.js

@@ -28,7 +28,9 @@ var arrayFilter = require('../internal/arrayFilter'),
  * @returns {Array} Returns the new filtered array.
  * @example
  *
- * var odds = _.reject([1, 2, 3, 4], function(n) { return n % 2 == 0; });
+ * _.reject([1, 2, 3, 4], function(n) {
+ *   return n % 2 == 0;
+ * });
  * // => [1, 3]
  *
  * var users = [

collection/size.js

@@ -12,12 +12,12 @@ var isLength = require('../internal/isLength'),
  * @returns {number} Returns the size of `collection`.
  * @example
  *
- * _.size([1, 2]);
- * // => 2
- *
- * _.size({ 'one': 1, 'two': 2, 'three': 3 });
+ * _.size([1, 2, 3]);
  * // => 3
  *
+ * _.size({ 'a': 1, 'b': 2 });
+ * // => 2
+ *
  * _.size('pebbles');
  * // => 7
  */

collection/sortBy.js

@@ -34,10 +34,14 @@ var baseCallback = require('../internal/baseCallback'),
  * @returns {Array} Returns the new sorted array.
  * @example
  *
- * _.sortBy([1, 2, 3], function(n) { return Math.sin(n); });
+ * _.sortBy([1, 2, 3], function(n) {
+ *   return Math.sin(n);
+ * });
  * // => [3, 1, 2]
  *
- * _.sortBy([1, 2, 3], function(n) { return this.sin(n); }, Math);
+ * _.sortBy([1, 2, 3], function(n) {
+ *   return this.sin(n);
+ * }, Math);
  * // => [3, 1, 2]
  *
  * var users = [