@@ -396,8 +396,8 @@ function extend(dst) {
396
396
* sinceVersion="1.6.5"
397
397
* This function is deprecated, but will not be removed in the 1.x lifecycle.
398
398
* There are edge cases (see {@link angular.merge#known-issues known issues}) that are not
399
- * supported by this function. We suggest
400
- * using [lodash's merge()](https://lodash.com/docs/4.17.4#merge) instead .
399
+ * supported by this function. We suggest using another, similar library for all-purpose merging,
400
+ * such as [lodash's merge()](https://lodash.com/docs/4.17.4#merge).
401
401
*
402
402
* @knownIssue
403
403
* This is a list of (known) object types that are not handled correctly by this function:
@@ -406,6 +406,8 @@ function extend(dst) {
406
406
* - [`CanvasGradient`](https://developer.mozilla.org/docs/Web/API/CanvasGradient)
407
407
* - AngularJS {@link $rootScope.Scope scopes};
408
408
*
409
+ * `angular.merge` also does not support merging objects with circular references.
410
+ *
409
411
* @param {Object } dst Destination object.
410
412
* @param {...Object } src Source object(s).
411
413
* @returns {Object } Reference to `dst`.
@@ -806,8 +808,10 @@ function arrayRemove(array, value) {
806
808
* </div>
807
809
*
808
810
* @knownIssue
809
- * This is a non-exhaustive list of object types / features that are not handled correctly by this
810
- * function:
811
+ * This is a non-exhaustive list of object types / features that are not handled correctly by
812
+ * `angular.copy`. Note that since this functions is used by the change detection code, this
813
+ * means binding or watching objects of these types (or that include these types) might not work
814
+ * correctly.
811
815
* - [`ImageData`](https://developer.mozilla.org/docs/Web/API/File)
812
816
* - [`Map`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Map)
813
817
* - [`ImageData`](https://developer.mozilla.org/docs/Web/API/ImageData)
0 commit comments