docs(angular.copy): clarify corner cases

jakub-bochenski · petebacondarwin · commit f102fb75b6d8 · 2013-09-10T22:07:22.000+01:00
The behaviour when null or undefined was passed was not clear. The exception thrown when source == destination was not documented. Closes angular#3946
diff --git a/src/Angular.js b/src/Angular.js
@@ -578,7 +578,8 @@ function isLeafNode (node) {
  * * If no destination is supplied, a copy of the object or array is created.
  * * If a destination is provided, all of its elements (for array) or properties (for objects)
  *   are deleted and then all elements/properties from the source are copied to it.
- * * If  `source` is not an object or array, `source` is returned.
+ * * If `source` is not an object or array (inc. `null` and `undefined`), `source` is returned.
+ * * If `source` is identical to 'destination' an exception will be thrown. 
  *
  * Note: this function is used to augment the Object type in Angular expressions. See
  * {@link ng.$filter} for more information about Angular arrays.
