Merge branch 'master' of github.com:lodash/lodash

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).<br>
-Check out <a href="http://devdocs.io/lodash/">DevDocs</a> as a fast, organized, & searchable interface for our documentation.
+Check out <a href="http://devdocs.io/lodash/">DevDocs</a>; 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).<br>
 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

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
      *