updated README with iterative processing docs

Author: thunderer

README.md

@@ -86,7 +86,7 @@ assert('sth {"name":"spl","parameters":{"arg":"val"},"content":"cnt"} end'
     === $processor->process('sth [spl arg=val]cnt[/spl] end');
 ```
 
-Recursive shortcode processing is enabled by default, use `Processor::setRecursion($status)` to control that behavior:
+Recursive shortcode processing is enabled by default, use `Processor::setRecursion($status)` and `Processor::setRecursionDepth($depth)` to control that behavior:
 
 ```
 $processor->addHandler('c', function(Shortcode $s) { return $s->getContent() })
@@ -96,6 +96,24 @@ $processor->setRecursion(false);
 assert('x[d]y[/d]z' === $processor->process('[c]x[d]y[/d]z[/c]'))
 ```
 
+Default number of iterations is `1`, but this can be controlled using `Processor::setMaxIterations()`:
+
+```
+$processor->addHandler('c', function(Shortcode $s) { return $s->getContent() })
+$processor->addHandlerAlias('d', 'c');
+$processor->addHandlerAlias('e', 'c');
+$processor->setRecursionDepth(0);
+
+$processor->setMaxIterations(1);
+assert("ab[d]cd[/d]e" === $processor->process('a[c]b[d]c[/c]d[/d]e'));
+
+$processor->setMaxIterations(2);
+assert("ab[e]c[/e]de" === $processor->process('[c]a[d]b[e]c[/e]d[/d]e[/c]'));
+
+$processor->setMaxIterations(null);
+assert('abcde' === $processor->process('[c]a[d]b[e]c[/e]d[/d]e[/c]'));
+```
+
 **Extraction**
 
 Create instance of class `Extractor` and use its `extract()` method to get array of shortcode matches:
@@ -173,7 +191,6 @@ Looking for contribution ideas? Here you are:
 * specialized parameter values (`array=value,value`, `map=key:value,key:value`),
 * shortcode validators and strict mode,
 * forced self-closing tags (`[code /][code]x[/code]` parsed as two matches),
-* iterative processing (`[c]x[c]y[/c]z[/c]` > `x[c]yz[/c]` > `xyz`),
 * ...your idea?
 
 ## License

tests/ProcessorTest.php

@@ -109,13 +109,20 @@ public function testExceptionOnInvalidRecursionDepth()
         $processor->setRecursionDepth(new \stdClass());
         }
 
+    public function testExceptionOnInvalidMaxIterations()
+        {
+        $processor = $this->getProcessor();
+        $this->setExpectedException('InvalidArgumentException');
+        $processor->setMaxIterations(new \stdClass());
+        }
+
     public function testPreventInfiniteLoop()
         {
         $processor = $this
             ->getProcessor()
-            ->addHandler('self', function(Shortcode $s) { return '[self]'; })
-            ->addHandler('other', function(Shortcode $s) { return '[self]'; })
-            ->addHandler('random', function(Shortcode $s) { return '[various]'; })
+            ->addHandler('self', function() { return '[self]'; })
+            ->addHandler('other', function() { return '[self]'; })
+            ->addHandler('random', function() { return '[various]'; })
             ->setMaxIterations(null);
 
         $processor->process('[self]');