From f102fb75b6d83085bd4832d9c8bb02475cc22875 Mon Sep 17 00:00:00 2001
From: jakub-bochenski
Date: Tue, 10 Sep 2013 13:37:51 +0200
Subject: docs(angular.copy): clarify corner cases

The behaviour when null or undefined was passed was not clear.
The exception thrown when source == destination was not documented.

Closes #3946
---
 src/Angular.js | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

(limited to 'src')

diff --git a/src/Angular.js b/src/Angular.js
index 298d6406..9ef10410 100644
--- 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.
-- 
cgit v1.2.3