diff --git a/docs/ru/designers/language-builtin-functions/language-function-capture.xml b/docs/ru/designers/language-builtin-functions/language-function-capture.xml
index 3aa0afb2..159f1a01 100644
--- a/docs/ru/designers/language-builtin-functions/language-function-capture.xml
+++ b/docs/ru/designers/language-builtin-functions/language-function-capture.xml
@@ -1,17 +1,25 @@
 <?xml version="1.0" encoding="windows-1251"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.10 Maintainer: freespace Status: ready -->
+<!-- EN-Revision: 1.13 Maintainer: freespace Status: ready -->
 <sect1 id="language.function.capture">
  <title>capture</title>
  <para>
-  {capture} используется для того, чтобы собрать результат работы шаблона
+  {capture} используется для того, чтобы собрать результат обработки
+  части шаблона между тэгами
   в какую-то переменную, вместо того, чтобы вывести результат браузеру.
-  Любое содержимое между {capture name="foo"} и {/capture} сохраняется в
-  переменную, указанную в атрибуте name. Затем его можно использовать в
-  шаблоне при помощи специальной переменной $smarty.capture.foo,
+  Любое содержимое между {capture name='foo'} и {/capture} сохраняется в
+  переменную, указанную в атрибуте name.
+ </para>
+ <para>
+  Захваченные данные могут в дальнейшем использоваться в
+  шаблоне при помощи специальной переменной <link
+  linkend="language.variables.smarty.capture">$smarty.capture.foo</link>,
   где "foo" - значение, переданное атрибуту name. Если атрибут name не указан,
-  то используется "default". Каждая комманда {capture} должна иметь пару
-  {/capture}. Команда capture поддерживает вложенность.
+  то используется "default".
+ </para>
+ 
+ <para>
+  Команда capture поддерживает вложенность.
  </para>
 
  <caution>
@@ -28,18 +36,12 @@
    <title>Сохранение вывода шаблона</title>
    <programlisting>
 <![CDATA[
-{* мы не хотим выводить строку таблицы, если содержимое не отображается *}
+{* мы не хотим выводить слой div, если содержимое не отображается *}
 {capture name=banner}
   {include file='get_banner.tpl'}
 {/capture}
 {if $smarty.capture.banner ne ''}
-<table>
-    <tr>
-        <td>
- 			        {$smarty.capture.banner}
-		      </td>
-	   </tr>
-</table>
+<div id="banner">{$smarty.capture.banner}</div>
 {/if}
 ]]>
    </programlisting>
@@ -54,10 +56,11 @@
    <programlisting>
 <![CDATA[
 {capture name=some_content assign=popText}
-    .... some content ....
+The server is {$smarty.server.SERVER_NAME|upper} at {$smarty.server.SERVER_ADDR}<br />
+Your ip is {$smarty.server.REMOTE_ADDR}.
 {/capture}
 
-<a href="#" {popup caption='Help' text=$popText}>help</a>
+<a href="#" {popup caption='Server Info' text=$popText}>help</a>
 ]]>
    </programlisting>
   </example>
@@ -91,4 +94,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
 -->
-
diff --git a/docs/ru/designers/language-builtin-functions/language-function-if.xml b/docs/ru/designers/language-builtin-functions/language-function-if.xml
index a5f521e0..6a1113be 100644
--- a/docs/ru/designers/language-builtin-functions/language-function-if.xml
+++ b/docs/ru/designers/language-builtin-functions/language-function-if.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="windows-1251"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.8 Maintainer: freespace Status: ready -->
+<!-- EN-Revision: 1.9 Maintainer: freespace Status: ready -->
 <sect1 id="language.function.if">
  <title>{if},{elseif},{else}</title>
  <para>
@@ -150,24 +150,24 @@
  </informaltable>
  
  <example>
-  <title>{if} statements</title>
+  <title>примеры использования {if}</title>
   <programlisting>
 <![CDATA[
-{if $name eq "Fred"}
+{if $name eq 'Fred'}
 	Welcome Sir.
-{elseif $name eq "Wilma"}
+{elseif $name eq 'Wilma'}
     Welcome Ma'am.
 {else}
     Welcome, whatever you are.
 {/if}
 
 {* пример с логикой "или" *}
-{if $name eq "Fred" or $name eq "Wilma"}
+{if $name eq 'Fred' or $name eq 'Wilma'}
 	...
 {/if}
 
 {* то же самое, что и выше *}
-{if $name == "Fred" || $name == "Wilma"}
+{if $name == 'Fred' || $name == 'Wilma'}
 	...
 {/if}
 
@@ -222,6 +222,24 @@
 ]]>
   </programlisting>
  </example>
+ 
+ <example>
+   <title>ещё несколько примеров использования {if}</title>
+   <programlisting>
+<![CDATA[
+{if isset($name) && $name = 'Blog'}
+    {* сделать что-нибудь *}
+{elseif $name == $foo}
+    {* сделать что-нибудь другое *}
+{/if}
+
+{if is_array($foo) && count($foo) > 0)
+    {* выполнить цикл foreach *}
+{/if}
+]]>
+  </programlisting>
+ </example>
+
 </sect1>
 <!-- Keep this comment at the end of the file
 Local variables:
diff --git a/docs/ru/designers/language-builtin-functions/language-function-include-php.xml b/docs/ru/designers/language-builtin-functions/language-function-include-php.xml
index 8cd9dda7..7fb78678 100644
--- a/docs/ru/designers/language-builtin-functions/language-function-include-php.xml
+++ b/docs/ru/designers/language-builtin-functions/language-function-include-php.xml
@@ -63,7 +63,7 @@
 
  <para>
   Тэги {include_php} используются для подключения PHP-скрипта в шаблон.
-  Если режим <link linkend="variable.security">security</link> включен,
+  Если режим <link linkend="variable.security">$security</link> включен,
   то PHP-скрипт должен быть расположен в директории
   <link linkend="variable.trusted.dir">$trusted_dir</link>.
   Тэг {include_php} должен иметь атрибут "file", который
@@ -94,9 +94,9 @@
 <?php
 
 // загружает переменные из БД MySQL и присваивает их шаблону
-require_once("MySQL.class.php");
+require_once('MySQL.class.php');
 $sql = new MySQL;
-$sql->query("select * from site_nav_sections order by name",SQL_ALL);
+$sql->query('select * from site_nav_sections order by name',SQL_ALL);
 $this->assign('sections',$sql->record);
 
 ?>
@@ -106,7 +106,7 @@ $this->assign('sections',$sql->record);
   <programlisting>
 <![CDATA[
 {* абсолютный путь, либо относительный к $trusted_dir *}
-{include_php file="/path/to/load_nav.php"}
+{include_php file='/path/to/load_nav.php'}
 {foreach item="curr_section" from=$sections}
     <a href="{$curr_section.url}">{$curr_section.name}</a><br />
 {/foreach}
diff --git a/docs/ru/designers/language-builtin-functions/language-function-include.xml b/docs/ru/designers/language-builtin-functions/language-function-include.xml
index 83e4cdb4..bbf96a51 100644
--- a/docs/ru/designers/language-builtin-functions/language-function-include.xml
+++ b/docs/ru/designers/language-builtin-functions/language-function-include.xml
@@ -1,13 +1,13 @@
 <?xml version="1.0" encoding="windows-1251"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.10 Maintainer: freespace Status: ready -->
+<!-- EN-Revision: 1.13 Maintainer: freespace Status: ready -->
 <sect1 id="language.function.include">
  <title>{include}</title>
  <para>
   Тэги {include} используются для включения других шаблонов в текущий.
   Любые переменные, доступные в текущем шаблоне, доступны и во
-  включаемом. Тэг {include} должен иметь атрибут "file", который
-  указывает путь к ресурсу шаблона.
+  включаемом. Тэг {include} должен иметь атрибут <emphasis>'file'</emphasis>,
+  который указывает путь к ресурсу шаблона.
  </para>
  <para>
   Опциональный атрибут <emphasis>assign</emphasis> указывает, что
@@ -85,7 +85,8 @@
 
  <para>
   Вы также можете передать переменные в подключаемый шаблон в
-  виде атрибутов. Любая переменная, переданная в подключаемый
+  виде <link linkend="language.syntax.attributes">атрибутов</link>.
+  Любая переменная, переданная в подключаемый
   шаблон, доступны только в области видимости подключаемого
   файла. Переданные переменные имеют преимущество перед
   существующими переменными с аналогичными именами.
@@ -170,6 +171,7 @@
  <para>
   См. также
   <link linkend="language.function.include.php">{include_php}</link>,
+  <link linkend="language.function.insert">{insert}</link>,
   <link linkend="language.function.php">{php}</link>,
   <link linkend="template.resources">Ресурсы</link> and
   <link linkend="tips.componentized.templates">Составные шаблоны</link>.
diff --git a/docs/ru/designers/language-builtin-functions/language-function-insert.xml b/docs/ru/designers/language-builtin-functions/language-function-insert.xml
index 5b6968f8..e2d76df8 100644
--- a/docs/ru/designers/language-builtin-functions/language-function-insert.xml
+++ b/docs/ru/designers/language-builtin-functions/language-function-insert.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="windows-1251"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.6 Maintainer: freespace Status: ready -->
+<!-- EN-Revision: 1.9 Maintainer: freespace Status: ready -->
 <sect1 id="language.function.insert">
  <title>{insert}</title>
  <para>
@@ -105,8 +105,9 @@
   Это удобно, когда функция может не сущетсвовать, и должен быть
   подключен PHP-файл, чтобы определить функцию. Путь к файлу
   должен быть либо абсолтным, либо относительным относительно
-  $trusted_dir. Когда security активирована, то PHP-файл должен
-  быть в папке $trusted_dir.
+  $trusted_dir. Когда включен режим <link
+  linkend="variable.security">$security</link>, PHP-файл должен
+  быть в папке <link linkend="variable.trusted.dir">$trusted_dir</link>.
 	</para>
 	<para>
   Обьект Smarty передается в функцию как второй параметр.
@@ -125,6 +126,11 @@
    и т.д.
 		</para>
 	</note>
+	
+ <para>
+  См. также
+  <link linkend="language.function.include">{include}</link>
+ </para>
 </sect1>
 <!-- Keep this comment at the end of the file
 Local variables:
diff --git a/docs/ru/designers/language-builtin-functions/language-function-ldelim.xml b/docs/ru/designers/language-builtin-functions/language-function-ldelim.xml
index d4347281..8edb691b 100644
--- a/docs/ru/designers/language-builtin-functions/language-function-ldelim.xml
+++ b/docs/ru/designers/language-builtin-functions/language-function-ldelim.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="windows-1251"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.9 Maintainer: freespace Status: ready -->
+<!-- EN-Revision: 1.11 Maintainer: freespace Status: ready -->
 <sect1 id="language.function.ldelim">
  <title>{ldelim},{rdelim}</title>
  <para>
@@ -8,7 +8,7 @@
   <link linkend="language.escaping">предотвращения обработки</link> разделителей,
   по-умолчанию "{" и "}". Вы также можете использовать блок
   <link linkend="language.function.literal">{literal}{/literal}</link> для
-  предотвращения обработки блоков текста.
+  предотвращения обработки блоков текста, например кода Javascript или CSS.
   См. также
   <link linkend="language.variables.smarty.ldelim">{$smarty.ldelim}</link>
  </para>
@@ -51,10 +51,26 @@ function foo() {
   </screen>
 
  </example>
+
+ <example>
+  <title>another Javascript example</title>
+  <programlisting>
+<![CDATA[
+<script language="JavaScript" type="text/javascript">
+    function myJsFunction(){ldelim}
+        alert("The server name\n{$smarty.server.SERVER_NAME}\n{$smarty.server.SERVER_ADDR}");
+    {rdelim}
+</script>
+<a href="javascript:myJsFunction()">Click here for Server Info</a>
+]]>
+  </programlisting>
+ </example>
  <para>
   См. также
-  <link linkend="language.escaping">Предотвращение обработки Smarty</link>
- </para>
+  <link linkend="language.function.literal">{literal}</link>
+  и
+  <link linkend="language.escaping">Предотвращение обработки Smarty</link> 
+  </para>
 </sect1>
 
 <!-- Keep this comment at the end of the file
diff --git a/docs/ru/designers/language-builtin-functions/language-function-literal.xml b/docs/ru/designers/language-builtin-functions/language-function-literal.xml
index 0df0d976..9a8dab54 100644
--- a/docs/ru/designers/language-builtin-functions/language-function-literal.xml
+++ b/docs/ru/designers/language-builtin-functions/language-function-literal.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="windows-1251"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.9 Maintainer: freespace Status: ready -->
+<!-- EN-Revision: 1.11 Maintainer: freespace Status: ready -->
 <sect1 id="language.function.literal">
  <title>{literal}</title>
  <para>
@@ -13,8 +13,9 @@
   linkend="language.function.ldelim">{ldelim}{rdelim}</link> для экранирования
   отдельных разделителей.
  </para>
+ 
  <example>
-  <title>тэги literal</title>
+  <title>Тэги {literal}</title>
   <programlisting>
 <![CDATA[
 {literal}
@@ -35,8 +36,47 @@
 ]]>
   </programlisting>
  </example>
+ 
+ <example>
+  <title>Пример функции Javascript</title>
+  <programlisting>
+<![CDATA[
+<script language="JavaScript" type="text/javascript">
+{literal}
+function myJsFunction(name, ip){
+   alert("The server name\n" + name + "\n" + ip);
+}
+{/literal}
+</script>
+<a href="javascript:myJsFunction('{$smarty.server.SERVER_NAME}','{$smarty.server.SERVER_ADDR}')">Click here for the Server Info</a>
+ ]]>
+  </programlisting>
+ </example>
+
+ <example>
+  <title>Немного CSS в шаблоне</title>
+  <programlisting>
+<![CDATA[
+{* включаем этот стиль... в качестве эксперимента *}
+<style type="text/css">
+{literal}
+/* это интересная идея для этого раздела */
+.madIdea{
+    border: 3px outset #ffffff;
+    margin: 2 3 4 5px;
+    background-color: #001122;
+}
+{/literal}
+</style>
+<div class="madIdea">With smarty you can embed css in the template</div>
+]]>
+  </programlisting>
+ </example>
+ 
  <para>
   См. также
+  <link linkend="language.function.ldelim">{ldelim} {rdelim}</link>
+  и
   <link linkend="language.escaping">Предотвращение обработки Smarty</link>
  </para>
 </sect1>
diff --git a/docs/ru/designers/language-builtin-functions/language-function-php.xml b/docs/ru/designers/language-builtin-functions/language-function-php.xml
index c25635c9..b97ed52b 100644
--- a/docs/ru/designers/language-builtin-functions/language-function-php.xml
+++ b/docs/ru/designers/language-builtin-functions/language-function-php.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="windows-1251"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.7 Maintainer: freespace Status: ready -->
+<!-- EN-Revision: 1.11 Maintainer: freespace Status: ready -->
 <sect1 id="language.function.php">
  <title>{php}</title>
  <para>
@@ -8,7 +8,7 @@
   будет как-либо изменен, независимо от <link
   linkend="variable.php.handling">$php_handling</link> настроек.
   Этот тэг только для продвинутых пользователей, так как обычно
-  не требуется.
+  не требуется и не рекоммендуется.
  </para>
  <example>
  <title>тэги {php}</title>
@@ -33,24 +33,39 @@
  </note>
 
  <example>
-  <title>Тэги {php} с глобальными переменными</title>
+  <title>Тэги {php} с глобальными переменными и назначение переменных</title>
   <programlisting role="php">
 <![CDATA[
 {php}
    global $foo, $bar;
    if($foo == $bar){
-     // что-нить делаем
+        echo 'This will come out in the template';
    }
+   
+   $this->assign('varX','Strawberry');
 {/php}
+<strong>{$varX}</strong> is my fav ice cream
 ]]>
   </programlisting>
- </example>
+  <para>
+   Следующее действие действительно НЕ рекоммендуется,
+   так как оно происходит в области видимости шаблона
+ </para>
+<programlisting> 
+<![CDATA[
+{php}
+print_r($some_array);
+{/php}
+]]>
+</programlisting>
+</example>
 
  <para>
   См. также
   <link linkend="variable.php.handling">$php_handling</link>,
   <link linkend="language.function.include.php">{include_php}</link>,
-  <link linkend="language.function.include">{include}</link>
+  <link linkend="language.function.include">{include}</link>,
+  <link linkend="language.function.insert">{insert}</link>
   и
   <link linkend="tips.componentized.templates">Компонентные шаблоны</link>.
  </para>
diff --git a/docs/ru/designers/language-builtin-functions/language-function-strip.xml b/docs/ru/designers/language-builtin-functions/language-function-strip.xml
index bf933f18..d9bd0e62 100644
--- a/docs/ru/designers/language-builtin-functions/language-function-strip.xml
+++ b/docs/ru/designers/language-builtin-functions/language-function-strip.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="windows-1251"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.8 Maintainer: freespace Status: ready -->
+<!-- EN-Revision: 1.9 Maintainer: freespace Status: ready -->
 <sect1 id="language.function.strip">
  <title>{strip}</title>
  <para>
@@ -20,7 +20,7 @@
   <title>Техническое Замечание</title>
   <para>
    {strip}{/strip} не влияет на содержимое переменных шаблона.
-   См. <link linkend="language.modifier.strip">модификатор strip</link>.
+   Для этих целей используйте <link linkend="language.modifier.strip">модификатор strip</link>.
   </para>
  </note>
  <example>