diff --git a/docs/ru/appendixes/tips.xml b/docs/ru/appendixes/tips.xml
index 9f041cb8..bac54697 100644
--- a/docs/ru/appendixes/tips.xml
+++ b/docs/ru/appendixes/tips.xml
@@ -115,6 +115,7 @@ footer.tpl
 <example>
 <title>использование date_format</title>
 <programlisting>
+<![CDATA[
 {$startDate|date_format}
 
 ВЫВОД:
@@ -131,7 +132,8 @@ Jan 4, 2001
 
 {if $date1 < $date2}
 	...
-{/if}</programlisting>
+{/if}
+]]></programlisting>
 </example>
 		<para>
 		Когда {html_select_date} используется в шаблоне, программисты обычно 
diff --git a/docs/ru/designers/language-builtin-functions.xml b/docs/ru/designers/language-builtin-functions.xml
index 0c29b93b..6a999ed6 100644
--- a/docs/ru/designers/language-builtin-functions.xml
+++ b/docs/ru/designers/language-builtin-functions.xml
@@ -676,7 +676,7 @@ index.tpl
 			<emphasis>elseif</emphasis> так же допустимы. "eq", "ne",
 			"neq", "gt", "lt", "lte", "le", "gte" "ge", "is even", 
 			"is odd", "is not even", "is not odd", "not", "mod", 
-			"div by", "even by", "odd by", "==", "!=", ">", "<", "<=",
+			"div by", "even by", "odd by", "==", "!=", "&gt;", "&lt;", "&lt;=",
 			">=" -- допустимые квалификаторы условий. Они должны быть 
 			отделены от окружающих елементов пробелами.
 			</para>
diff --git a/docs/ru/programmers/advanced-features.xml b/docs/ru/programmers/advanced-features.xml
index b09f52cb..bda6f7b2 100644
--- a/docs/ru/programmers/advanced-features.xml
+++ b/docs/ru/programmers/advanced-features.xml
@@ -34,8 +34,9 @@
 	</para>
     <example>
      <title>using a registered or assigned object</title>
-     <programlisting>
-&lt;?php
+     <programlisting role="php">
+<![CDATA[
+<?php
 // the object
 
 class My_Object() {
@@ -56,7 +57,7 @@ $smarty->register_object("foobar",$myobj,null,false);
 $smarty->assign_by_ref("myobj", $myobj);
 
 $smarty->display("index.tpl");
-?&gt;
+?>
 
 TEMPLATE:
 
@@ -68,7 +69,8 @@ TEMPLATE:
 the output was {$output)
 
 {* access our assigned object *}
-{$myobj->meth1("foo",$bar)}</programlisting>
+{$myobj->meth1("foo",$bar)}
+]]></programlisting>
     </example>
   </sect1>
    <sect1 id="advanced.features.prefilters">
diff --git a/docs/ru/programmers/api-functions.xml b/docs/ru/programmers/api-functions.xml
index ee212ea9..28e870dc 100644
--- a/docs/ru/programmers/api-functions.xml
+++ b/docs/ru/programmers/api-functions.xml
@@ -608,7 +608,10 @@ $smarty->load_filter('output', 'compress'); // load output filter named 'compres
 			</para>
 <example>
 <title>register_block</title>
-<programlisting>
+<programlisting role="php">
+<![CDATA[
+<?php
+
 /* PHP */
 $smarty->register_block("translate", "do_translation");
 
@@ -619,11 +622,14 @@ function do_translation ($params, $content, &$smarty) {
         echo $translation;
     }
 }
+?>
 
 {* template *}
 {translate lang="br"}
    Hello, world!
-{/translate}</programlisting>
+{/translate}
+]]>
+</programlisting>
 </example>
 		</sect1>
 		<sect1 id="api.register.compiler.function">
diff --git a/docs/ru/programmers/plugins.xml b/docs/ru/programmers/plugins.xml
index 7e9fbd0e..a36870f9 100644
--- a/docs/ru/programmers/plugins.xml
+++ b/docs/ru/programmers/plugins.xml
@@ -134,7 +134,7 @@ require_once SMARTY_DIR . 'plugins/function.html_options.php';</programlisting>
      <funcprototype>
       <funcdef>void <function>smarty_function_<replaceable>name</replaceable></function></funcdef>
       <paramdef>array <parameter>$params</parameter></paramdef>
-      <paramdef>object <parameter>&$smarty</parameter></paramdef>
+      <paramdef>object <parameter>&amp;$smarty</parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>