From 4fb4ec5328c2e1e54f58c00bc825e6c1ec3b1878 Mon Sep 17 00:00:00 2001
From: Y-Less <git@y-less.com>
Date: Sat, 2 Jul 2016 17:36:50 +0100
Subject: [PATCH] Links to creation equivalents for in-place modification
 functions. (#2468)

See issue #2467
---
 lodash.js | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/lodash.js b/lodash.js
index bf1cf81be..df54e5df5 100644
--- a/lodash.js
+++ b/lodash.js
@@ -6392,6 +6392,8 @@
      * for equality comparisons. The order of result values is determined by the
      * order they occur in the first array.
      *
+     * **Note:** Unlike `_.pullAll`, this method returns a new array.
+     *
      * @static
      * @memberOf _
      * @since 0.1.0
@@ -6417,6 +6419,8 @@
      * by which they're compared. Result values are chosen from the first array.
      * The iteratee is invoked with one argument: (value).
      *
+     * **Note:** Unlike `_.pullAllBy`, this method returns a new array.
+     *
      * @static
      * @memberOf _
      * @since 4.0.0
@@ -6450,6 +6454,8 @@
      * are chosen from the first array. The comparator is invoked with two arguments:
      * (arrVal, othVal).
      *
+     * **Note:** Unlike `_.pullAllWith`, this method returns a new array.
+     *
      * @static
      * @memberOf _
      * @since 4.0.0
@@ -7996,6 +8002,8 @@
      * Creates an array excluding all given values using
      * [`SameValueZero`](http://ecma-international.org/ecma-262/6.0/#sec-samevaluezero)
      * for equality comparisons.
+	 *
+     * **Note:** Unlike `_.pull`, this method returns a new array.
      *
      * @static
      * @memberOf _
@@ -8608,6 +8616,8 @@
      * `predicate` returns truthy for. The predicate is invoked with three
      * arguments: (value, index|key, collection).
      *
+     * **Note:** Unlike `_.remove`, this method returns a new collection.
+     *
      * @static
      * @memberOf _
      * @since 0.1.0
@@ -12215,6 +12225,8 @@
     /**
      * Creates an array of values corresponding to `paths` of `object`.
      *
+     * **Note:** Unlike `_.pullAt`, this method returns a new object.
+     *
      * @static
      * @memberOf _
      * @since 1.0.0