docs(angular.extend): explanation of deep copy.

wedneyyuri · petebacondarwin · commit 7fa66348cb6b · 2014-10-19T10:54:32.000+01:00
It is very common to see many developers confused about it. Closes angular#9672
diff --git a/src/Angular.js b/src/Angular.js
@@ -340,6 +340,7 @@ function setHashKey(obj, h) {
  * Extends the destination object `dst` by copying own enumerable properties from the `src` object(s)
  * to `dst`. You can specify multiple `src` objects. If you want to preserve original objects, you can do so
  * by passing an empty object as the target: `var object = angular.extend({}, object1, object2)`.
+ * Note: Keep in mind that `angular.extend` does not support recursive merge (deep copy).
  *
  * @param {Object} dst Destination object.
  * @param {...Object} src Source object(s).

Original file line number	Diff line number	Diff line change
`@@ -340,6 +340,7 @@ function setHashKey(obj, h) {`
`340`	`340`	* Extends the destination object `dst` by copying own enumerable properties from the `src` object(s)
`341`	`341`	* to `dst`. You can specify multiple `src` objects. If you want to preserve original objects, you can do so
`342`	`342`	* by passing an empty object as the target: `var object = angular.extend({}, object1, object2)`.
	`343`	+ * Note: Keep in mind that `angular.extend` does not support recursive merge (deep copy).
`343`	`344`	`*`
`344`	`345`	`* @param {Object} dst Destination object.`
`345`	`346`	`* @param {...Object} src Source object(s).`