diff --git a/lodash.js b/lodash.js index ced1c9483..81573b54d 100644 --- a/lodash.js +++ b/lodash.js @@ -7059,10 +7059,9 @@ } /** - * This method invokes `interceptor` and returns `value`. The interceptor is - * invoked with one argument; (value). The purpose of this method is to "tap into" - * a method chain in order to perform operations on intermediate results within - * the chain. + * This method invokes `interceptor` and returns `value`. The interceptor + * is invoked with one argument; (value). The purpose of this method is to + * "tap into" a method chain in order to modify intermediate results. * * @static * @memberOf _ @@ -7074,6 +7073,7 @@ * * _([1, 2, 3]) * .tap(function(array) { + * // Mutate input array. * array.pop(); * }) * .reverse() @@ -7087,6 +7087,8 @@ /** * This method is like `_.tap` except that it returns the result of `interceptor`. + * The purpose of this method is to "pass thru" values replacing intermediate + * results in a method chain. * * @static * @memberOf _