From dba566a96d3c660e12249dcb6445dad19854da97 Mon Sep 17 00:00:00 2001
From: Igor Minar
Date: Tue, 15 Oct 2013 11:28:47 -0700
Subject: docs($rootScope): better document infinite digest and ttl

---
 src/ng/rootScope.js | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

(limited to 'src')

diff --git a/src/ng/rootScope.js b/src/ng/rootScope.js
index 48f8a07b..aa3a6f13 100644
--- a/src/ng/rootScope.js
+++ b/src/ng/rootScope.js
@@ -40,11 +40,15 @@
  * @methodOf ng.$rootScopeProvider
  * @description
  *
- * Sets the number of digest iterations the scope should attempt to execute before giving up and
- * assuming that the model is unstable.
+ * Sets the number of `$digest` iterations the scope should attempt to execute before giving up and assuming that the model is unstable.
  *
  * The current default is 10 iterations.
  *
+ * In complex applications it's possible that the dependencies between `$watch`s will result in several digest iterations.
+ * However if an application needs more than the default 10 digest iterations for its model to stabilize then you should investigate what is causing the model to continuously change during the digest.
+ *
+ * Increasing the TTL could have performance implications, so you should not change it without proper justification.
+ *
  * @param {number} limit The number of digest iterations.
  */
 
-- 
cgit v1.2.3