From b2f50b532777751a5912576e80e8415f81d79464 Mon Sep 17 00:00:00 2001
From: John-David Dalton <john.david.dalton@gmail.com>
Date: Sat, 12 Apr 2014 00:21:48 -0700
Subject: [PATCH] Add mutation notes to `_.pull` and `_.remove`. [ci skip]

---
 lodash.js | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/lodash.js b/lodash.js
index 2e97688f9..ecfd950da 100644
--- a/lodash.js
+++ b/lodash.js
@@ -2956,6 +2956,8 @@
      * Removes all provided values from `array` using strict equality for
      * comparisons, i.e. `===`.
      *
+     * Note: Unlike `_.without`, this method mutates `array`.
+     *
      * @static
      * @memberOf _
      * @category Arrays
@@ -2989,7 +2991,7 @@
     }
 
     /**
-     * Removes all elements from an array that the predicate returns truthy for
+     * Removes all elements from `array` that the predicate returns truthy for
      * and returns an array of removed elements. The predicate is bound to `thisArg`
      * and invoked with three arguments; (value, index, array).
      *
@@ -3000,6 +3002,8 @@
      * will return `true` for elements that have the properties of the given object,
      * else `false`.
      *
+     * Note: Unlike `_.filter`, this method mutates `array`.
+     *
      * @static
      * @memberOf _
      * @category Arrays