added a note in the documentation about using Twig with Xdebug

diff --git a/doc/02-Twig-for-Template-Designers.markdown b/doc/02-Twig-for-Template-Designers.markdown
index 4cf967e..8f5a521 100644 (file)
--- a/doc/02-Twig-for-Template-Designers.markdown
+++ b/doc/02-Twig-for-Template-Designers.markdown
@@ -713,6 +713,12 @@ The operator precedence is as follows, with the lowest-precedence operators
 listed first: `or`, `and`, `==`, `!=`, `<`, `>`, `>=`, `<=`, `in`, `+`, `-`,
 `~`, `*`, `/`, `%`, `//`, `not`, and `[`.
 
+>**CAUTION**
+>When compiling deep-nested arrays or math expressions with Xdebug enabled,
+>Twig can easily reach the default maximum nesting level set by Xdebug via the
+>`xdebug.max_nesting_level` setting; changing the default (100) to a bigger
+>value solves the issue.
+
 ### Literals
 
 The simplest form of expressions are literals. Literals are representations