From 8cbb8befd4220a4de50237b3827001adde2d417f Mon Sep 17 00:00:00 2001 From: Rhys van der Waerden Date: Sat, 12 Sep 2015 12:45:28 +1000 Subject: [PATCH] Clarify `_.merge` description. [ci skip] Mention behaviour difference between merging plain objects and objects with non-Object prototypes. As discussed in #1455. --- lodash.js | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/lodash.js b/lodash.js index 086ef3e1f..4f07d8711 100644 --- a/lodash.js +++ b/lodash.js @@ -9708,9 +9708,13 @@ } /** - * Recursively merges own enumerable properties of the source object(s) into the - * destination object, for source properties which don't resolve to `undefined`. - * Subsequent sources overwrite property assignments of previous sources. + * Recursively merges own and inherited enumerable properties of source + * objects into the destination object, skipping source properties that resolve + * to `undefined`. Array and plain object properties are merged recursively. + * Other objects and value types are overriden by assignment. Subsequent + * sources overwrite property assignments of previous sources. + * + * **Note:** This method mutates `object`. * * @static * @memberOf _