From de4fcad6028350e789964f1a25e241ced13e9d24 Mon Sep 17 00:00:00 2001
From: bzick <aco.best@gmail.com>
Date: Fri, 30 Aug 2013 10:26:17 +0400
Subject: [PATCH] Add doc for {insert} and {switch}

---
 docs/readme.md       |  4 ++--
 docs/tags/include.md | 31 ++++++++++++++++++++++++++++++-
 docs/tags/switch.md  | 29 ++++++++++++++++++++++++++++-
 3 files changed, 60 insertions(+), 4 deletions(-)

diff --git a/docs/readme.md b/docs/readme.md
index d697f00..695ab06 100644
--- a/docs/readme.md
+++ b/docs/readme.md
@@ -42,9 +42,9 @@ Documentation
 * [if](./tags/if.md), `elseif` and `else`
 * [foreach](./tags/foreach.md), `foreaelse`, `break` and `continue`
 * [for](./tags/for.md), `forelse`, `break` and `continue`
-* [switch](./tags/switch.md), `case`, `default` and `break`
+* [switch](./tags/switch.md), `case`, `default`
 * [cycle](./tags/cycle.md)
-* [include](./tags/include.md)
+* [include](./tags/include.md), `insert`
 * [extends](./tags/extends.md), `use`, `block` and `parent`
 * [filter](./tags/filter.md)
 * [ignore](./tags/ignore.md)
diff --git a/docs/tags/include.md b/docs/tags/include.md
index 7f3f176..08b59c2 100644
--- a/docs/tags/include.md
+++ b/docs/tags/include.md
@@ -13,4 +13,33 @@ Tag {include} [RU]
 {include "about.tpl" page=$item limit=50}
 ```
 
-Все изменения переменных в подключаемом шаблоне не будут воздействовать на родительский шаблон.
\ No newline at end of file
+Все изменения переменных в подключаемом шаблоне не будут воздействовать на родительский шаблон.
+
+### {insert}
+
+The tag insert template template code instead self.
+
+* No dynamic name allowed
+* No variables as attribute allowed
+
+For example,
+
+```smarty
+a: {$a}
+{insert 'b.tpl'}
+c: {$c}
+```
+
+b.tpl:
+
+```
+b: {$b}
+```
+
+Во время разбора шаблона код шаблона `b.tpl` будет вставлен в код шаблона `main.tpl` как есть:
+
+```smarty
+a: {$a}
+b: {$b}
+c: {$c}
+```
diff --git a/docs/tags/switch.md b/docs/tags/switch.md
index 5891e55..0bb66eb 100644
--- a/docs/tags/switch.md
+++ b/docs/tags/switch.md
@@ -5,9 +5,36 @@ Tag {switch}
 {switch <condition>}
 {case <value1>}
     ...
-{case <value2>}
+{case <value2>, <value3>, ...}
+    ...
+{case <value3>}
     ...
 {default}
     ...
 {/switch}
+```
+
+For example,
+
+```smarty
+{switch $type}
+{case 'new'}
+    It is new item
+{case 'current', 'new'}
+    It is new or current item
+{case 'current'}
+    It is current item
+{case 'new'}
+    It is new item, again
+{default}
+    I don't know the type {$type}
+{/switch}
+```
+
+If `$type = 'new'` template outputs
+
+```
+It is new item
+It is new or current item
+It is new item, again
 ```
\ No newline at end of file