[DOCUMENTATION] Russian:

- Sync

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@16413 44c647ce-9c0f-0410-b52a-842ac1e357ba

documentation/manual/ru/manual.xml.in

@@ -1285,6 +1285,21 @@
                 <xi:include href="../en/module_specs/Zend_Service_Amazon_Ec2-Instance.xml" />
             </xi:fallback>
         </xi:include>
+        <xi:include href="module_specs/Zend_Service_Amazon_Ec2-WindowsInstance.xml">
+            <xi:fallback>
+                <xi:include href="../en/module_specs/Zend_Service_Amazon_Ec2-WindowsInstance.xml" />
+            </xi:fallback>
+        </xi:include>
+        <xi:include href="module_specs/Zend_Service_Amazon_Ec2-ReservedInstance.xml">
+            <xi:fallback>
+                <xi:include href="../en/module_specs/Zend_Service_Amazon_Ec2-ReservedInstance.xml" />
+            </xi:fallback>
+        </xi:include>
+        <xi:include href="module_specs/Zend_Service_Amazon_Ec2-CloudWatch.xml">
+            <xi:fallback>
+                <xi:include href="../en/module_specs/Zend_Service_Amazon_Ec2-CloudWatch.xml" />
+            </xi:fallback>
+        </xi:include>
         <xi:include href="module_specs/Zend_Service_Amazon_Ec2-Image.xml">
             <xi:fallback>
                 <xi:include href="../en/module_specs/Zend_Service_Amazon_Ec2-Image.xml" />

documentation/manual/ru/module_specs/Zend_Cache-Backends.xml

@@ -30,7 +30,7 @@
                       <row>
                           <entry><emphasis>cache_dir</emphasis></entry>
                           <entry><type>String</type></entry>
-                          <entry><filename>'/tmp/'</filename></entry>
+                          <entry>'<filename>/tmp/</filename>'</entry>
                           <entry>
                               Директория, в которой хранятся файлы кэша
                           </entry>
@@ -43,7 +43,7 @@
                             Включает/отключает блокировку файлов. Позволяет
                             избежать искажения данных кэша в плохих условиях, но
                             это не поможет при многопоточном веб-сервере или
-                            файловой системе NFS...
+                            файловой системе <acronym>NFS</acronym>...
                           </entry>
                       </row>
                       <row>
@@ -105,7 +105,8 @@
                           <entry>
                               Префикс для файлов кэша. Будьте осторожны с этой
                               опцией, поскольку слишком общее значение в
-                              системной директории для кэша (например '/tmp')
+                              системной директории для кэша (например,
+                              <filename>/tmp</filename>)
                               может привести к катастрофическим последствиям при
                               очищении кэша.
                         </entry>
@@ -168,13 +169,16 @@
                               Отклочение/настройка процесса автоматической
                               чистки. Автоматическая чистка дефрагментирует
                               файл данных (и делает его меньше) при вызове
-                              методов clean() и delete():
+                              методов <methodname>clean()</methodname>
+                              и <methodname>delete()</methodname>:
                               0 - автоматическая чистка отключена;
                               1 - систематическая чистка (при каждом вызове
-                              методов delete() или clean());
+                              методов <methodname>delete()</methodname> или
+                              <methodname>clean()</methodname>);
                               x (целое число больше 1) - автоматическая чистка
                               производится случайным образом 1 раз на x вызовов
-                              методов clean() и delete().
+                              методов <methodname>clean()</methodname>
+                              и <methodname>delete()</methodname>.
                           </entry>
                       </row>
                   </tbody>
@@ -260,8 +264,9 @@
             Этот расширенный бэкэнд хранит записи кэша в совместно используемой
             памяти через расширение
             <ulink url="http://pecl.php.net/package/APC">APC</ulink>
-            (Alternative PHP Cache — альтернативный кэш PHP), которое,
-            разумеется, необходимо установить для использования этого бэкэнда.
+            (Alternative <acronym>PHP</acronym> Cache — альтернативный
+            кэш <acronym>PHP</acronym>), которое, разумеется, необходимо
+            установить для использования этого бэкэнда.
         </para>
         <para>
             Будьте осторожны: на данный момент теги для этого бэкэнда
@@ -305,7 +310,9 @@
                           <entry><type>String</type></entry>
                           <entry><constant>NULL</constant></entry>
                           <entry>
-                              xcache.admin.user, необходима для метода clean()
+                              <filename>xcache.admin.user</filename>,
+                              необходима для метода
+                              <methodname>clean()</methodname>
                           </entry>
                       </row>
                       <row>
@@ -313,8 +320,10 @@
                           <entry><type>String</type></entry>
                           <entry><constant>NULL</constant></entry>
                           <entry>
-                              xcache.admin.pass - пароль в незашифрованном виде,
-                              необходим для метода clean()
+                              <filename>xcache.admin.pass</filename> - пароль
+                              в незашифрованном виде,
+                              необходим для метода
+                              <methodname>clean()</methodname>
                           </entry>
                       </row>
                   </tbody>
@@ -324,7 +333,7 @@
     <sect2 id="zend.cache.backends.platform">
         <title>Zend_Cache_Backend_ZendPlatform</title>
         <para>
-            Этот бэкэнд использует API
+            Этот бэкэнд использует <acronym>API</acronym>
             <ulink url="http://www.zend.com/products/platform">Zend
             Platform</ulink> для кэширования контента. Естетственно,
             использование этого бэкэнда требует наличия установленного Zend
@@ -411,10 +420,11 @@ $cache = Zend_Cache::factory('Core', 'Zend Platform');
                           <entry><type>Boolean</type></entry>
                           <entry><constant>FALSE</constant></entry>
                           <entry>
-                              Если равна true, то аргумент slow_backend
+                              Если <constant>TRUE</constant>, то аргумент slow_backend
                               используется как полное имя класса, иначе
                               значение этого аргумента используется в конце
-                              имени класса "Zend_Cache_Backend_[...]".
+                              имени класса
+                              "<classname>Zend_Cache_Backend_</classname>[...]".
                           </entry>
                       </row>
                       <row>
@@ -422,10 +432,12 @@ $cache = Zend_Cache::factory('Core', 'Zend Platform');
                           <entry><type>Boolean</type></entry>
                           <entry><constant>FALSE</constant></entry>
                           <entry>
-                              Если равна true, то аргумент fast_backend
-                              используется как полное имя класса, иначе
+                              Если <constant>TRUE</constant>, то аргумент fast_backend
+                              используется как полное имя класса.
+                              Если <constant>FALSE</constant>, то
                               значение этого аргумента используется в конце
-                              имени класса "Zend_Cache_Backend_[...]".
+                              имени класса
+                              "<classname>Zend_Cache_Backend_</classname>[...]".
                           </entry>
                       </row>
                       <row>
@@ -433,7 +445,7 @@ $cache = Zend_Cache::factory('Core', 'Zend Platform');
                           <entry><type>Boolean</type></entry>
                           <entry><constant>FALSE</constant></entry>
                           <entry>
-                              Если равна true, то для медленного бэкэнда не
+                              Если <constant>TRUE</constant>, то для медленного бэкэнда не
                               будет производиться включение require_once
                               (полезно только при использовании собственных
                               бэкэндов).
@@ -444,7 +456,7 @@ $cache = Zend_Cache::factory('Core', 'Zend Platform');
                           <entry><type>Boolean</type></entry>
                           <entry><constant>FALSE</constant></entry>
                           <entry>
-                              Если равна true, то для быстрого бэкэнда не
+                              Если <constant>TRUE</constant>, то для быстрого бэкэнда не
                               будет производиться включение require_once
                               (полезно только при использовании собственных
                               бэкэндов).
@@ -455,7 +467,7 @@ $cache = Zend_Cache::factory('Core', 'Zend Platform');
                           <entry><type>Boolean</type></entry>
                           <entry><constant>TRUE</constant></entry>
                           <entry>
-                              Если равна true, то будет производиться
+                              Если <constant>TRUE</constant>, то будет производиться
                               автоматическое обновление "быстрого" кэша при
                               попадании в кэш.
                           </entry>
@@ -489,7 +501,8 @@ $cache = Zend_Cache::factory('Core', 'Zend Platform');
         </para>
         <para>
             Этот бэкэнд работает только в среде Zend Server с запросами,
-            производимыми через HTTP(S), и не работает в случае скриптов,
+            производимыми через <acronym>HTTP</acronym> и
+            <acronym>HTTPS</acronym>, и не работает в случае скриптов,
             запускаемых через командную строку.
         </para>
         <para>

documentation/manual/ru/module_specs/Zend_Cache-Frontends.xml

@@ -133,7 +133,8 @@
                               <entry><constant>FALSE</constant></entry>
                               <entry>
                                   Если установлен в true, то ядро будет
-                                  устанавливать флаг ignore_user_abort в методе
+                                  устанавливать <acronym>PHP</acronym>-флаг
+                                  ignore_user_abort в методе
                                   save() во избежание порчи кэша в некоторых
                                   случаях.
                               </entry>
@@ -265,8 +266,9 @@ if (!($cache->test($id))) {
             <para>
                 <classname>Zend_Cache_Frontend_Output</classname> является фронтэндом,
                 собирающим выходные данные. Он использует буферизацию вывода
-                (output buffering) в PHP для сохранения всего, что выводится
-                между его методами <methodname>start()</methodname> и <methodname>end()</methodname>.
+                (output buffering) в <acronym>PHP</acronym> для сохранения
+                всего, что выводится между его методами
+                <methodname>start()</methodname> и <methodname>end()</methodname>.
             </para>
         </sect3>
         <sect3 id="zend.cache.frontends.output.options">
@@ -366,7 +368,8 @@ echo 'This is never cached ('.time().').';
             <title>Примеры</title>
             <para>
                 Функция <methodname>call()</methodname> используется так же, как и
-                <methodname>call_user_func_array()</methodname> в PHP:
+                <methodname>call_user_func_array()</methodname> в
+                <acronym>PHP</acronym>:
             </para>
             <programlisting language="php"><![CDATA[
 $cache->call('veryExpensiveFunc', $params);
@@ -528,14 +531,16 @@ $result = $cache->foobar2('1', '2');
                 Можно использовать несколько ведущих файлов.
             </para>
             <para>
-                Например, у вас есть конфигурационный файл XML. Он парсится
+                Например, у вас есть конфигурационный файл
+                <acronym>XML</acronym>. Он парсится
                 функцией, которая возвращает объект конфигурации
                 (наподобие <classname>Zend_Config</classname>). С помощью
                 <classname>Zend_Cache_Frontend_File</classname> вы можете сохранять объект
                 конфигурации в кэш, чтобы избежать повторного парсинга
-                конфигурационного файла XML. Время жизни кэша будет зависеть
-                от ведущего файла - если конфигурационный
-                файл XML изменится, то кэш сразу становится недействительным.
+                конфигурационного файла <acronym>XML</acronym>. Время жизни
+                кэша будет зависеть от ведущего файла - если конфигурационный
+                файл <acronym>XML</acronym> изменится, то кэш сразу становится
+                недействительным.
             </para>
         </sect3>
         <sect3 id="zend.cache.frontends.file.options">
@@ -622,14 +627,16 @@ $result = $cache->foobar2('1', '2');
                 <varname>$_POST</varname>, <varname>$_SESSION</varname>,
                 <varname>$_COOKIE</varname>, <varname>$_FILES</varname>.
                 Кроме этого, вы используете только один метод для вызова
-                (<methodname>start()</methodname>), потому что <methodname>end()</methodname> вызывается
+                (<methodname>start()</methodname>), потому что
+                <methodname>end()</methodname> вызывается
                 автоматически, когда страница заканчивается.
             </para>
             <para>
-                На данный момент мы планируем добавить условную систему HTTP для
+                На данный момент мы планируем добавить условную систему
+                <acronym>HTTP</acronym> для
                 сохранения пропускной способности (система будет отправлять
-                HTTP 304 Not Modified, если есть попадание в кэш и броузер уже
-                имеет правильную версию страницы).
+                <acronym>HTTP</acronym> 304 Not Modified, если есть попадание
+                в кэш и броузер уже имеет правильную версию страницы).
             </para>
         </sect3>
         <sect3 id="zend.cache.frontends.page.options">
@@ -827,9 +834,11 @@ $result = $cache->foobar2('1', '2');
                               <entry><methodname>array()</methodname></entry>
                               <entry>
                                   Ассоциативный массив для установки опций
-                                  только для некоторых REQUEST_URI. Ключами
+                                  только для некоторых
+                                  <acronym>REQUEST_URI</acronym>. Ключами
                                   этого массива являются регулярные выражения
-                                  (PCRE), значениями — ассоциативные массивы со
+                                  (<acronym>PCRE</acronym>), значениями —
+                                  ассоциативные массивы со
                                   специальными опциями, которые устанавливаются,
                                   если <varname>$_SERVER['REQUEST_URI']</varname>
                                   соответствует регулярному выражению
@@ -845,7 +854,8 @@ $result = $cache->foobar2('1', '2');
                               <entry><type>Array</type></entry>
                               <entry><methodname>array()</methodname></entry>
                               <entry>
-                                   Массив строк с именами HTTP-заголовков.
+                                   Массив строк с именами
+                                   <acronym>HTTP</acronym>-заголовков.
                                    Перечисленные заголовки будут сохранены в
                                    кэше и будут замещены при попадании в кэш.
                               </entry>
@@ -930,8 +940,8 @@ $cache->start();
             <para>
                 В некоторых случаях может потребоваться отменить текущий
                 процесс кэширования - например, если используется код
-                возврата, отличный от HTTP/200. Поэтому мы добавили метод
-                <methodname>cancel()</methodname>:
+                возврата, отличный от <acronym>HTTP</acronym> 200. Поэтому
+                мы добавили метод <methodname>cancel()</methodname>:
             </para>
             <programlisting language="php"><![CDATA[
 // [...]

documentation/manual/ru/module_specs/Zend_Cache-Introduction.xml

@@ -8,9 +8,10 @@
     <para>
         Управление кэшированием в Zend Framework производится через фронтэнды
         (интерфейсные части), записи кэша сохраняются через бэкэнды
-        (адаптеры <emphasis>File</emphasis>, <emphasis>Sqlite</emphasis>, <emphasis>Memcache</emphasis>
-        и др.), с использованием гибкой системы идентификаторов и тегов,
-        благодаря которым можно потом легко удалять определенные типы записей
+        (адаптеры <emphasis>File</emphasis>, <emphasis>Sqlite</emphasis>,
+        <emphasis>Memcache</emphasis> и др.), с использованием гибкой системы
+        идентификаторов и тегов, благодаря которым можно потом легко удалять
+        определенные типы записей
         (например: "удалить все записи кэша, помеченные данным тегом").
     </para>
     <para>

documentation/manual/ru/module_specs/Zend_Config-Introduction.xml

@@ -20,7 +20,8 @@
             Обычно предполагается, что используется один из классов адаптеров, например,
             <link linkend="zend.config.adapters.ini"><classname>Zend_Config_Ini</classname></link>
             или <link linkend="zend.config.adapters.xml"><classname>Zend_Config_Xml</classname></link>.
-            Но если конфигурационные данные доступны в виде массива PHP,
+            Но если конфигурационные данные доступны в виде массива
+            <acronym>PHP</acronym>,
             то можно передавать эти данные конструктору <classname>Zend_Config</classname>,
             чтобы использовать преимущества простого объектно-ориентированного
             интерфейса.
@@ -63,7 +64,8 @@ $db = Zend_Db::factory($config->database);
     </para>
     <para>
         Кроме объектно-ориентированного доступа к значениям данных,
-        <classname>Zend_Config</classname> также предоставляет метод <code>get()</code>,
+        <classname>Zend_Config</classname> также предоставляет метод
+        <methodname>get()</methodname>,
         который будет возвращать значение по умолчанию, если элемент
         данных не существует. Например:
     </para>
@@ -74,8 +76,8 @@ $host = $config->database->get('host', 'localhost');
         <title>Использование Zend_Config с конфигурационным файлом PHP</title>
         <para>
             Часто требуется использовать конфигурационный файл,
-            основанный на "чистом" PHP. Следующий код показывает, как просто
-            этого достичь:
+            основанный на "чистом" <acronym>PHP</acronym>. Следующий код
+            показывает, как просто этого достичь:
         </para>
         <programlisting language="php"><![CDATA[
 // config.php

documentation/manual/ru/module_specs/Zend_Config-TheoryOfOperation.xml

@@ -2,6 +2,7 @@
 <!-- Reviewed: no -->
 <sect1 id="zend.config.theory_of_operation">
     <title>Теоретические основы работы с Zend_Config</title>
+
     <para>
         Конфигурационные данные передаются конструктору <classname>Zend_Config</classname>
         в виде ассоциативного массива, который может быть многомерным, что
@@ -13,6 +14,7 @@
         без использования класса адаптера, т.к. это может быть наиболее
         подходящим решением в некоторых ситуациях.
     </para>
+
     <para>
         Каждое значение массива конфигурационных значений становится свойством
         объекта <classname>Zend_Config</classname>. Ключ массива используется как имя
@@ -21,46 +23,51 @@
         заполняется данными этого массива. Это производится рекурсивно, т.о.,
         иерархия конфигурационных данных может иметь любой уровень вложенности.
     </para>
+
     <para>
-        <classname>Zend_Config</classname> реализует интерфейсы <code>Countable</code>
-        и <code>Iterator</code> для того, чтобы обеспечить простой доступ
+        <classname>Zend_Config</classname> реализует интерфейсы <emphasis>Countable</emphasis>
+        и <emphasis>Iterator</emphasis> для того, чтобы обеспечить простой доступ
         к конфигурационным данным. Поэтому с объектами
         <classname>Zend_Config</classname> можно использовать функцию
-        <ulink url="http://php.net/count"><code>count()</code></ulink> и
-        такие конструкции языка PHP, как
-        <ulink url="http://php.net/foreach"><code>foreach</code></ulink>.
+        <ulink url="http://php.net/count"><methodname>count()</methodname></ulink> и
+        такие конструкции языка <acronym>PHP</acronym>, как
+        <ulink url="http://php.net/foreach"><emphasis>foreach</emphasis></ulink>.
     </para>
+
     <para>
         По умолчанию через <classname>Zend_Config</classname> конфигурационные данные
         доступны только для чтения, и операция присваивания (например,
-        <varname>$config->database->host = 'example.com'</varname>)
+        <command>$config->database->host = 'example.com'</command>)
         вызовет исключение. Тем не менее, это поведение
         может быть отменено при вызове конструктора, и тогда
         можно будет изменять конфигурационные данные.
         Если модификации разрешены, то <classname>Zend_Config</classname> также
         поддерживает уничтожение значений
-        (т.е. <code>unset($config->database->host);</code>).
-        Метод <code>readOnly()</code> может использоваться для определения того,
+        (т.е. <methodname>unset($config->database->host)</methodname>).
+        Метод <methodname>readOnly()</methodname> может использоваться для определения того,
         был ли разрешены модификации в данном объекте <classname>Zend_Config</classname>.
-        Метод <code>setReadOnly()</code> запрещает все дальнейшие изменения в
+        Метод <methodname>setReadOnly()</methodname> запрещает все дальнейшие изменения в
         объекте <classname>Zend_Config</classname>, который был создан с разрешением
         изменений.
-        <note>
-            <para>
-                Важно не путать изменение данных в памяти с сохранением
-                конфигурационных данных на физическом носителе данных. Создание
-                и изменение конфигурационных данных на различных
-                носителях данных не входит в сферу назначений <classname>Zend_Config</classname>.
-                Для создания и изменения конфигурационных данных на различных
-                носителях информации можно использовать
-                сторонние разработки с открытым исходным кодом.
-            </para>
-        </note>
     </para>
+
+    <note>
+        <para>
+            Важно не путать изменение данных в памяти с сохранением
+            конфигурационных данных на физическом носителе данных. Создание
+            и изменение конфигурационных данных на различных
+            носителях данных не входит в сферу назначений <classname>Zend_Config</classname>.
+            Для создания и изменения конфигурационных данных на различных
+            носителях информации можно использовать
+            сторонние разработки с открытым исходным кодом.
+        </para>
+    </note>
+
     <para>
         Классы адаптеров наследуют от класса <classname>Zend_Config</classname>,
         и, следовательно, имеют тот же функционал.
     </para>
+
     <para>
         Семейство классов <classname>Zend_Config</classname> позволяет
         организовывать конфигурационные данные, разбивая их на разделы.
@@ -68,6 +75,7 @@
         один определенный раздел, несколько разделов или все разделы
         данных (если не указан раздел).
     </para>
+
     <para>
         Классы адаптеров <classname>Zend_Config</classname> поддерживают единую модель
         наследования, которая позволяет одному разделу наследовать
@@ -79,25 +87,27 @@
         наследует от другого и т.д., но множественное наследование (т.е. раздел
         C наследует напрямую от разделов A и B) не поддерживается.
     </para>
+
     <para>
         Если вы имеете два объекта <classname>Zend_Config</classname>, то можете объединить
-        их в один, используя функцию <code>merge()</code>. Например, имея
+        их в один, используя функцию <methodname>merge()</methodname>. Например, имея
         <varname>$config</varname> и <varname>$localConfig</varname> вы можете объединить
         данные из <varname>$localConfig</varname> с данными из <varname>$config</varname>,
-        используя <varname>$config->merge($localConfig);</varname>. Элементы
+        используя <methodname>$config->merge($localConfig)</methodname>. Элементы
         из <varname>$localConfig</varname> при совпадении имен заменят собой элементы
         <varname>$config</varname>.
-        <note>
-            <para>
-                Объект <classname>Zend_Config</classname>, который выполняет объединение,
-                должен быть создан с разрешением модификаций путем передачи
-                <constant>TRUE</constant> в качестве второго параметра конструктора.
-                После того, как объединение будет завершено, можно использовать
-                метод <code>setReadOnly()</code> для предотвращения всех
-                дальнейших изменений.
-            </para>
-        </note>
     </para>
+
+    <note>
+        <para>
+            Объект <classname>Zend_Config</classname>, который выполняет объединение,
+            должен быть создан с разрешением модификаций путем передачи
+            <constant>TRUE</constant> в качестве второго параметра конструктора.
+            После того, как объединение будет завершено, можно использовать
+            метод <methodname>setReadOnly()</methodname> для предотвращения всех
+            дальнейших изменений.
+        </para>
+    </note>
 </sect1>
 <!--
 vim:se ts=4 sw=4 et:

documentation/manual/ru/module_specs/Zend_Config_Ini.xml

@@ -2,51 +2,65 @@
 <!-- Reviewed: no -->
 <sect1 id="zend.config.adapters.ini">
     <title>Zend_Config_Ini</title>
+
     <para>
-        <classname>Zend_Config_Ini</classname> дает разработчикам возможность хранить
-        конфигурационные данные в знакомом большинству формате INI и считывать
-        их в приложении с использованием синтаксиса вложенных свойств объекта.
-        Формат INI специализируется на обеспечении иерархии конфигурационных
-        данных и наследования между разделами конфигурационных данных.
+        <classname>Zend_Config_Ini</classname> дает разработчикам возможность
+        хранить конфигурационные данные в знакомом большинству
+        формате <acronym>INI</acronym> и считывать их в приложении с
+        использованием синтаксиса вложенных свойств объекта.
+        Формат <acronym>INI</acronym> специализируется на обеспечении иерархии
+        конфигурационных данных и наследования между разделами
+        конфигурационных данных.
         Иерархии конфигурационных данных поддерживаются посредством
-        разделения ключей точкой (<code>.</code>). Раздел можно расширять
-        или наследовать от другого раздела посредством указания имени раздела
-        с двоеточием (<code>:</code>) и именем раздела, от которого
-        наследуются данные, после него.
+        разделения ключей точкой ("<emphasis>.</emphasis>"). Раздел можно
+        расширять или наследовать от другого раздела посредством указания
+        имени раздела с двоеточием ("<emphasis>:</emphasis>") и именем
+        раздела, от которого наследуются данные, после него.
     </para>
+
     <note>
         <title>Синтаксический разбор INI-файла</title>
+
         <para>
-            <classname>Zend_Config_Ini</classname> использует функцию PHP
-            <ulink url="http://php.net/parse_ini_file"><code>parse_ini_file()</code></ulink>.
-            Пожалуйста, почитайте документацию, чтобы получить представление об
+            <classname>Zend_Config_Ini</classname> использует функцию
+            <acronym>PHP</acronym> <ulink
+                url="http://php.net/parse_ini_file"><methodname>parse_ini_file()</methodname></ulink>.
+            Пожалуйста, прочитайте документацию, чтобы получить представление об
             особенностях ее поведения, которые распространяются и на
             <classname>Zend_Config_Ini</classname> — например, о том, как обрабатываются
-            специальные значения <constant>TRUE</constant>, <constant>FALSE</constant>, <code>yes</code>,
-            <code>no</code> и <constant>NULL</constant>.
+            специальные значения "<constant>TRUE</constant>",
+            "<constant>FALSE</constant>", "yes",
+            "no" и "<constant>NULL</constant>".
         </para>
     </note>
-        <note>
+
+    <note>
         <title>Разделитель ключей</title>
+
         <para>
             По умолчанию разделителем ключей является символ точки
-            (<code>.</code>). Он может быть заменен на любой другой путем
-            изменения ключа <code>'nestSeparator'</code> в массиве
-            <varname>$options</varname> при создании объекта <classname>Zend_Config_Ini</classname>.
-            Например:
-            <programlisting language="php"><![CDATA[
+            ("<emphasis>.</emphasis>"). Он может быть заменен на любой другой
+            путем изменения ключа <emphasis>'nestSeparator'</emphasis> в
+            массиве <varname>$options</varname> при создании объекта
+            <classname>Zend_Config_Ini</classname>. Например:
+        </para>
+
+        <programlisting language="php"><![CDATA[
 $options['nestSeparator'] = ':';
 $config = new Zend_Config_Ini('/path/to/config.ini',
                               'staging',
                               $options);
 ]]></programlisting>
-        </para>
+
     </note>
+
     <example id="zend.config.adapters.ini.example.using">
         <title>Использование Zend_Config_Ini</title>
+
         <para>
             Данный пример демонстрирует использование <classname>Zend_Config_Ini</classname>
-            для загрузки конфигурационных данных из файла INI. В этом примере
+            для загрузки конфигурационных данных из файла
+            <acronym>INI</acronym>. В этом примере
             используются конфигурационные данные для производственной и
             промежуточной систем. Поскольку конфигурационные данные для
             промежуточной и производственной систем в основном одни и те же,
@@ -55,8 +69,9 @@ $config = new Zend_Config_Ini('/path/to/config.ini',
             произвольный, т.е. может быть и наоборот — "производственный"
             раздел наследует от "промежуточного", хотя это может не подходить в
             более сложных случаях. Допустим, конфигурационные данные
-            находятся в файле <code>/path/to/config.ini</code>:
+            находятся в файле <filename>/path/to/config.ini</filename>:
         </para>
+
         <programlisting language="ini"><![CDATA[
 ; Конфигурационные данные производственного сайта
 [production]
@@ -74,11 +89,14 @@ database.params.host     = dev.example.com
 database.params.username = devuser
 database.params.password = devsecret
 ]]></programlisting>
+
         <para>
             Далее предположим, что разработчику приложения нужны "промежуточные"
-            конфигурационные данные из файла INI. Загрузить эти данные,
-            указав файл INI и нужный раздел, довольно просто:
+            конфигурационные данные из файла <acronym>INI</acronym>. Загрузить
+            эти данные, указав файл <acronym>INI</acronym> и нужный раздел,
+            довольно просто:
         </para>
+
         <programlisting language="php"><![CDATA[
 $config = new Zend_Config_Ini('/path/to/config.ini', 'staging');
 
@@ -86,6 +104,7 @@ echo $config->database->params->host;   // выведет "dev.example.com"
 echo $config->database->params->dbname; // выведет "dbname"
 ]]></programlisting>
     </example>
+
     <note>
     <table id="zend.config.adapters.ini.table">
         <title>Параметры конструктора Zend_Config_Ini</title>
@@ -99,14 +118,16 @@ echo $config->database->params->dbname; // выведет "dbname"
             <tbody>
                 <row>
                     <entry><varname>$filename</varname></entry>
-                    <entry>INI-файл для загрузки</entry>
+                    <entry><acronym>INI</acronym>-файл для загрузки</entry>
                 </row>
                 <row>
                     <entry><varname>$section</varname></entry>
                     <entry>
-                        Раздел в INI-файле, который должен быть загружен.
-                        Установка этого параметра в null вызовет загрузку всех
-                        разделов. Также может быть передан массив имен разделов
+                        Раздел в <acronym>INI</acronym>-файле, который должен
+                        быть загружен.
+                        Установка этого параметра в <constant>NULL</constant>
+                        вызовет загрузку всех разделов.
+                        Также может быть передан массив имен разделов
                         для загрузки нескольких разделов.
                     </entry>
                 </row>
@@ -118,9 +139,11 @@ echo $config->database->params->dbname; // выведет "dbname"
                             <listitem>
                                 <para>
                                     <emphasis>allowModifications</emphasis>:
-                                    Устанавливается в true, чтобы разрешить
+                                    Устанавливается в
+                                    <constant>TRUE</constant>, чтобы разрешить
                                     последующую модификацию загруженного файла.
-                                    По умолчанию установлен в false
+                                    По умолчанию установлен в
+                                    <constant>FALSE</constant>
                                 </para>
                             </listitem>
                             <listitem>

documentation/manual/ru/module_specs/Zend_Config_Writer.xml

@@ -9,12 +9,12 @@
         в использовании.
         По умолчанию <classname>Zend_Config_Writer</classname> поставляется с тремя
         адаптерами, которые используются одинаково. Вы инстанцируете класс для
-        записи с опциями, которыми могут быть <code>filename</code>
-        (имя файла) и <code>config</code> (конфигурационные данные).
-        Затем вы вызываете метод <code>write()</code> объекта, и он
+        записи с опциями, которыми могут быть <emphasis>filename</emphasis>
+        (имя файла) и <emphasis>config</emphasis> (конфигурационные данные).
+        Затем вы вызываете метод <methodname>write()</methodname> объекта, и он
         создает конфигурационный файл. Вы можете также передавать
         <varname>$filename</varname> и <varname>$config</varname> непосредственно
-        методу <code>write()</code>. В настоящее время вместе с
+        методу <methodname>write()</methodname>. В настоящее время вместе с
         <classname>Zend_Config_Writer</classname> поставляются следующие адаптеры:
     </para>
 
@@ -38,7 +38,7 @@
 
     <para>
         В качестве исключения <classname>Zend_Config_Writer_Ini</classname> имеет
-        еще один опциональный параметр <code>nestSeparator</code>, через
+        еще один опциональный параметр <emphasis>nestSeparator</emphasis>, через
         который указывается символ-разделитель для узлов.
         По умолчанию это точка, как и в <classname>Zend_Config_Ini</classname>.
     </para>
@@ -48,18 +48,19 @@
         следует знать следующее.
         Для того, чтобы создать или изменить значение, устанавливайте
         параметр объекта <classname>Zend_Config</classname> через аксессор
-        <code>-&gt;</code>. Для того, чтобы создать раздел в корне или
+        (<emphasis>-&gt;</emphasis>). Для того, чтобы создать раздел в корне или
         ветку, создавайте новый массив
-        (<varname>$config-&gt;branch = array();</varname>). Для того, чтобы
-        указать, от какого раздела наследует другой, вызывайте метод в корне
-        объекта <classname>Zend_Config</classname>.
+        ("<command>$config-&gt;branch = array()</command>"). Для того, чтобы
+        указать, от какого раздела наследует другой, вызывайте метод
+        <methodname>setExtend()</methodname> в корне объекта
+        <classname>Zend_Config</classname>.
     </para>
 
     <example id="zend.config.writer.example.using">
         <title>Использование Zend_Config_Writer</title>
         <para>
             Этот пример демонстрирует использование
-            <code>Zend_Config_Writer_Xml</code> для создания нового
+            <classname>Zend_Config_Writer_Xml</classname> для создания нового
             конфигурационного файла:
         </para>
         <programlisting language="php"><![CDATA[
@@ -95,9 +96,9 @@ $writer->write('config.xml', $config);
 ]]></programlisting>
         <para>
             В этом примере создается конфигурационный
-            XML-файл с "промежуточным" (staging) и "производственным"
-            (production) разделами, в котором первый раздел наследует от
-            второго.
+            <acronym>XML</acronym>-файл с "промежуточным" (staging) и
+            "производственным" (production) разделами, в котором первый
+            раздел наследует от второго.
         </para>
     </example>
 
@@ -132,7 +133,7 @@ $writer->write();
             важно загрузить все
             разделы с пропуском расширений с тем, чтобы значения не
             объединялись. Это достигается путем передачи опции
-            <code>skipExtends</code> конструктору.
+            <emphasis>skipExtends</emphasis> конструктору.
         </para>
     </note>
 </sect1>

documentation/manual/ru/module_specs/Zend_Config_Xml.xml

@@ -4,15 +4,15 @@
     <title>Zend_Config_Xml</title>
     <para>
         <classname>Zend_Config_Xml</classname> дает разработчикам возможность
-        хранить конфигурационные данные в простом формате XML и читать их
+        хранить конфигурационные данные в простом формате <acronym>XML</acronym> и читать их
         посредством синтаксиса вложенных свойств объектов.
-        Корневой элемент в файле или строке с XML не имеет значения и ему
+        Корневой элемент в файле или строке с <acronym>XML</acronym> не имеет значения и ему
         может быть дано любое имя. Первый уровень
-        элементов XML соответствует разделам конфигурационных данных. Формат
-        XML поддерживает иерархическую организацию данных через вложенность
+        элементов <acronym>XML</acronym> соответствует разделам конфигурационных данных. Формат
+        <acronym>XML</acronym> поддерживает иерархическую организацию данных через вложенность
         элементов ниже элементов уровня разделов. Содержимое конечного элемента
         соответствует значению элемента конфигурационных данных. Наследование
-        разделов поддерживается через специальный атрибут <code>extends</code>,
+        разделов поддерживается через специальный атрибут <emphasis>extends</emphasis>,
         значение атрибута соответствует разделу, данные которого наследуются в
         раздел с этим атрибутом.
     </para>
@@ -28,7 +28,7 @@
         <title>Использование Zend_Config_Xml</title>
         <para>
             Данный пример демонстрирует основы использования <classname>Zend_Config_Xml</classname>
-            для загрузки конфигурационных данных из файла XML. В этом примере
+            для загрузки конфигурационных данных из файла <acronym>XML</acronym>. В этом примере
             используются конфигурационные данные для производственной и
             промежуточной систем. Поскольку конфигурационные данные
             промежуточной системы очень похожи на конфигурационные данные для
@@ -37,7 +37,7 @@
             произвольный, т.е. может быть и наоборот — "производственный"
             раздел наследует от "промежуточного", хотя это может не подходить в
             более сложных случаях. Допустим, конфигурационные данные
-            находятся в файле <code>/path/to/config.xml</code>:
+            находятся в файле <filename>/path/to/config.xml</filename>:
         </para>
         <programlisting language="xml"><![CDATA[
 <?xml version="1.0"?>
@@ -66,8 +66,8 @@
 ]]></programlisting>
         <para>
             Далее предположим, что разработчику приложения нужны "промежуточные"
-            конфигурационные данные из файла XML. Загрузить эти данные, указав
-            файл XML и нужный раздел, довольно просто:
+            конфигурационные данные из файла <acronym>XML</acronym>. Загрузить эти данные, указав
+            файл <acronym>XML</acronym> и нужный раздел, довольно просто:
         </para>
         <programlisting language="php"><![CDATA[
 $config = new Zend_Config_Xml('/path/to/config.xml', 'staging');
@@ -79,11 +79,11 @@ echo $config->database->params->dbname; // выведет "dbname"
     <example id="zend.config.adapters.xml.example.attributes">
         <title>Использование тегов в <classname>Zend_Config_Xml</classname></title>
         <para>
-            Zend_Config_Xml также поддерживает два дополнительных способа
+            <classname>Zend_Config_Xml</classname> также поддерживает два дополнительных способа
             определения узлов в конфигурации. В обоих способах используются
-            атрибуты. Поскольку атрибуты <code>extends</code> и
-            <code>value</code> являются зарезервированными ключевыми словами
-            (<code>value</code> используется во втором способе
+            атрибуты. Поскольку атрибуты <emphasis>extends</emphasis> и
+            <emphasis>value</emphasis> являются зарезервированными ключевыми словами
+            (<emphasis>value</emphasis> используется во втором способе
             с применением атрибутов), то они не должны использоваться здесь.
             Первый способ с использованием атрибутов состоит в добавлении
             атрибутов в родительский узел, они потом будут преобразованы в
@@ -94,12 +94,14 @@ echo $config->database->params->dbname; // выведет "dbname"
 <configdata>
     <production webhost="www.example.com">
         <database adapter="pdo_mysql">
-            <params host="db.example.com" username="dbuser" password="secret" dbname="dbname"/>
+            <params host="db.example.com" username="dbuser" password="secret"
+                    dbname="dbname"/>
         </database>
     </production>
     <staging extends="production">
         <database>
-            <params host="dev.example.com" username="devuser" password="devsecret"/>
+            <params host="dev.example.com" username="devuser"
+                    password="devsecret"/>
         </database>
     </staging>
 </configdata>
@@ -108,7 +110,7 @@ echo $config->database->params->dbname; // выведет "dbname"
             Другой способ не делает конфигурацию заметно короче, но
             облегчает ее поддержку благодаря тому, что не нужно писать имена
             тегов дважды. Вы просто создаете пустой тег, значение которого
-            содержится в атрибуте <code>value</code>:
+            содержится в атрибуте <emphasis>value</emphasis>:
         </para>
         <programlisting language="xml"><![CDATA[
 <?xml version="1.0"?>
@@ -141,10 +143,10 @@ echo $config->database->params->dbname; // выведет "dbname"
         <title>Передача строки с XML</title>
         <para>
             <classname>Zend_Config_Xml</classname> также может загружать
-            XML непосредственно из строки, которая может быть получена,
+            <acronym>XML</acronym> непосредственно из строки, которая может быть получена,
             например, из базы данных. Строка передается конструктору в качестве
             первого параметра и должна начинаться с символов
-            <code>'&lt;?xml'</code>:
+            <emphasis>'&lt;?xml'</emphasis>:
         </para>
         <programlisting language="xml"><![CDATA[
 $string = <<<EOT