From e4aee13e9ea5a4dce4cd6b3f21668ecd8b71da21 Mon Sep 17 00:00:00 2001 From: John-David Dalton Date: Fri, 10 Jan 2014 22:22:45 -0800 Subject: [PATCH] Merge branch 'master' of github.com:lodash/lodash --- README.md | 8 ++++---- lodash.js | 29 ++++++++++++++--------------- 2 files changed, 18 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index 92894de67..e36e8f6fa 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ Check out our [wiki](https://github.com/lodash/lodash/wiki/build-differences) fo * [Modern build](https://raw.github.com/lodash/lodash/2.4.1/dist/lodash.js) ([minified](https://raw.github.com/lodash/lodash/2.4.1/dist/lodash.min.js)) perfect for new environments * [Compatibility build](https://raw.github.com/lodash/lodash/2.4.1/dist/lodash.compat.js) ([minified](https://raw.github.com/lodash/lodash/2.4.1/dist/lodash.compat.min.js)) for old environments too -* [Underscore build](https://raw.github.com/lodash/lodash/2.4.1/dist/lodash.underscore.js) ([minified](https://raw.github.com/lodash/lodash/2.4.1/dist/lodash.underscore.min.js)) as a drop-in replacement +* [Underscore build](https://raw.github.com/lodash/lodash/2.4.1/dist/lodash.underscore.js) ([minified](https://raw.github.com/lodash/lodash/2.4.1/dist/lodash.underscore.min.js)) as a drop-in replacement for [Underscore.js](http://underscorejs.org/) CDN copies are available on [cdnjs](http://cdnjs.com/libraries/lodash.js/) & [jsDelivr](http://www.jsdelivr.com/#!lodash). For smaller file sizes, create [custom builds](http://lodash.com/custom-builds) with only the features needed. @@ -16,7 +16,7 @@ Love modules? We’ve got you covered with [lodash-amd](https://github.com/lodas ## Dive in There’s plenty of **[API documentation](http://lodash.com/docs)**, [unit tests](http://lodash.com/tests), & [benchmarks](http://lodash.com/benchmarks).
-Check out DevDocs as a fast, organized, & searchable interface for our documentation. +Check out DevDocs; a fast, organized, & searchable interface for our documentation. The full changelog for this release is available on our [wiki](https://github.com/lodash/lodash/wiki/Changelog).
A list of upcoming features is available on our [roadmap](https://github.com/lodash/lodash/wiki/Roadmap). @@ -25,8 +25,8 @@ A list of upcoming features is available on our [roadmap](https://github.com/lod * 100% [code coverage](https://coveralls.io/r/lodash) * AMD loader support ([curl](https://github.com/cujojs/curl), [dojo](http://dojotoolkit.org/), [requirejs](http://requirejs.org/), etc.) - * Collections of modules for [AMD](https://github.com/lodash/lodash-amd/tree/2.4.1), [Node.js](https://npmjs.org/package/lodash-node), & [npm packages](https://npmjs.org/browse/keyword/lodash-modularized) - * Follows [semantic versioning](http://semver.org/) for releases + * Module collections for [AMD](https://github.com/lodash/lodash-amd/tree/2.4.1), [Node.js](https://npmjs.org/package/lodash-node), & as [npm packages](https://npmjs.org/browse/keyword/lodash-modularized) + * [Semantic versioning](http://semver.org/) support for releases * [_(…)](http://lodash.com/docs#_) supports intuitive chaining * [_.at](http://lodash.com/docs#at) for cherry-picking collection values * [_.bindKey](http://lodash.com/docs#bindKey) for binding [*“lazy”*](http://michaux.ca/articles/lazy-function-definition-pattern) defined methods diff --git a/lodash.js b/lodash.js index 346cf3e89..c0e368f5b 100644 --- a/lodash.js +++ b/lodash.js @@ -229,8 +229,7 @@ } /** - * The base implementation of `_.indexOf` without support for binary searches - * or `fromIndex` constraints. + * The base implementation of `_.indexOf` without support for binary searches. * * @private * @param {Array} array The array to search. @@ -326,7 +325,7 @@ * * @private * @param {string} string The string to inspect. - * @returns {number} Returns the index of the first non-whitespace character. + * @returns {number} Returns the index of the first character not found in `chars`. */ function charsLeftIndex(string, chars) { var index = -1, @@ -345,7 +344,7 @@ * * @private * @param {string} string The string to inspect. - * @returns {number} Returns the index of the last non-whitespace character. + * @returns {number} Returns the index of the last character not found in `chars`. */ function charsRightIndex(string, chars) { var index = string.length; @@ -506,7 +505,7 @@ * Releases `array` back to the array pool. * * @private - * @param {Array} [array] The array to release. + * @param {Array} array The array to release. */ function releaseArray(array) { array.length = 0; @@ -519,7 +518,7 @@ * Releases `object` back to the object pool. * * @private - * @param {Object} [object] The object to release. + * @param {Object} object The object to release. */ function releaseObject(object) { var cache = object.cache; @@ -849,7 +848,7 @@ * * @private * @param {*} value The value to wrap in a `lodash` instance. - * @param {boolean} chainAll A flag to enable chaining for all methods + * @param {boolean} [chainAll=false] A flag to enable chaining for all methods * @returns {Object} Returns a `lodash` instance. */ function lodashWrapper(value, chainAll) { @@ -1295,7 +1294,7 @@ * @param {Object} prototype The object to inherit from. * @returns {Object} Returns the new object. */ - function baseCreate(prototype, properties) { + function baseCreate(prototype) { return isObject(prototype) ? nativeCreate(prototype) : {}; } // fallback for environments without `Object.create` @@ -3848,7 +3847,7 @@ * @param {Array|Object|string} collection The collection to iterate over. * @param {Function|string} methodName The name of the method to invoke or * the function invoked per iteration. - * @param {...*} [arg] Arguments to invoke the method with. + * @param {...*} [args] Arguments to invoke the method with. * @returns {Array} Returns a new array of the results of each invoked method. * @example * @@ -4554,7 +4553,7 @@ * @category Functions * @param {Function} func The function to bind. * @param {*} [thisArg] The `this` binding of `func`. - * @param {...*} [arg] Arguments to be partially applied. + * @param {...*} [args] Arguments to be partially applied. * @returns {Function} Returns the new bound function. * @example * @@ -4623,7 +4622,7 @@ * @category Functions * @param {Object} object The object the method belongs to. * @param {string} key The key of the method. - * @param {...*} [arg] Arguments to be partially applied. + * @param {...*} [args] Arguments to be partially applied. * @returns {Function} Returns the new bound function. * @example * @@ -4884,7 +4883,7 @@ * @memberOf _ * @category Functions * @param {Function} func The function to defer. - * @param {...*} [arg] Arguments to invoke the function with. + * @param {...*} [args] Arguments to invoke the function with. * @returns {number} Returns the timer id. * @example * @@ -4908,7 +4907,7 @@ * @category Functions * @param {Function} func The function to delay. * @param {number} wait The number of milliseconds to delay execution. - * @param {...*} [arg] Arguments to invoke the function with. + * @param {...*} [args] Arguments to invoke the function with. * @returns {number} Returns the timer id. * @example * @@ -5025,7 +5024,7 @@ * @memberOf _ * @category Functions * @param {Function} func The function to partially apply arguments to. - * @param {...*} [arg] Arguments to be partially applied. + * @param {...*} [args] Arguments to be partially applied. * @returns {Function} Returns the new partially applied function. * @example * @@ -5049,7 +5048,7 @@ * @memberOf _ * @category Functions * @param {Function} func The function to partially apply arguments to. - * @param {...*} [arg] Arguments to be partially applied. + * @param {...*} [args] Arguments to be partially applied. * @returns {Function} Returns the new partially applied function. * @example *