svn: /phpdoc/ru/trunk/ appendices/filters.xml reference/exec/functions/proc-open.xml reference/filesystem/functions/fgetss.xml reference/spl/splfileobject/fgetss.xml

Modified: phpdoc/ru/trunk/appendices/filters.xml
===================================================================
--- phpdoc/ru/trunk/appendices/filters.xml	2019-12-02 04:01:14 UTC (rev 348394)
+++ phpdoc/ru/trunk/appendices/filters.xml	2019-12-02 04:41:40 UTC (rev 348395)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 346281 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 348383 Maintainer: shein Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <appendix xml:id="filters" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -47,14 +47,15 @@
    обратитесь к странице руководства соответствующей функции.
   </simpara>

-  <simpara>
-   <literal>string.rot13</literal>
-   Использование этого фильтра эквивалентно обработке всех данных потока
-   функцией <function>str_rot13</function>.
-  </simpara>
-  <example>
+  <section xml:id="filters.string.rot13">
    <title>string.rot13</title>
-   <programlisting role="php">
+   <simpara>
+    Использование этого фильтра эквивалентно обработке всех данных потока
+    функцией <function>str_rot13</function>.
+   </simpara>
+   <example>
+    <title>string.rot13</title>
+    <programlisting role="php">
 <![CDATA[
 <?php
 $fp = fopen('php://output', 'w');
@@ -63,17 +64,19 @@
 /* Выведет:  Guvf vf n grfg.   */
 ?>
 ]]>
-   </programlisting>
-  </example>
+    </programlisting>
+   </example>
+  </section>

-  <simpara>
-   <literal>string.toupper</literal>
-   Использование этого фильтра эквивалентно обработке всех данных потока
-   функцией <function>strtoupper</function>.
-  </simpara>
-  <example>
+  <section xml:id="filters.string.toupper">
    <title>string.toupper</title>
-   <programlisting role="php">
+   <simpara>
+    Использование этого фильтра эквивалентно обработке всех данных потока
+    функцией <function>strtoupper</function>.
+   </simpara>
+   <example>
+    <title>string.toupper</title>
+    <programlisting role="php">
 <![CDATA[
 <?php
 $fp = fopen('php://output', 'w');
@@ -82,17 +85,19 @@
 /* Выведет:  THIS IS A TEST.   */
 ?>
 ]]>
-   </programlisting>
-  </example>
+    </programlisting>
+   </example>
+  </section>

-  <simpara>
-   <literal>string.tolower</literal>
-   Использование этого фильтра эквивалентно обработке всех данных потока
-   функцией <function>strtolower</function>.
-  </simpara>
-  <example>
+  <section xml:id="filters.string.tolower">
    <title>string.tolower</title>
-   <programlisting role="php">
+   <simpara>
+    Использование этого фильтра эквивалентно обработке всех данных потока
+    функцией <function>strtolower</function>.
+   </simpara>
+   <example>
+    <title>string.tolower</title>
+    <programlisting role="php">
 <![CDATA[
 <?php
 $fp = fopen('php://output', 'w');
@@ -101,23 +106,25 @@
 /* Выведет:  this is a test.   */
 ?>
 ]]>
-   </programlisting>
-  </example>
+    </programlisting>
+   </example>
+  </section>

-  <simpara>
-   <literal>string.strip_tags</literal>
-   Использование этого фильтра эквивалентно обработке всех данных потока
-   функцией <function>strip_tags</function>.
-   Он принимает аргументы в одной из двух форм:
-   Либо в виде строки со списком тегов, как и второй аргумент функции
-   <function>strip_tags</function>, либо массив названий тегов.
-  </simpara>
-  <para>
-   &warn.deprecated.feature-7-3-0;
-  </para>
-  <example>
+  <section xml:id="filters.string.strip_tags">
    <title>string.strip_tags</title>
-   <programlisting role="php">
+   <simpara>
+    Использование этого фильтра эквивалентно обработке всех данных потока
+    функцией <function>strip_tags</function>.
+    Он принимает аргументы в одной из двух форм:
+    Либо в виде строки со списком тегов, как и второй аргумент функции
+    <function>strip_tags</function>, либо массив названий тегов.
+   </simpara>
+   <para>
+    &warn.deprecated.feature-7-3-0;
+   </para>
+   <example>
+    <title>string.strip_tags</title>
+    <programlisting role="php">
 <![CDATA[
 <?php
 $fp = fopen('php://output', 'w');
@@ -133,9 +140,9 @@
 /* Выведет:  <b>bolded text</b> enlarged to a level 1 heading   */
 ?>
 ]]>
-   </programlisting>
-  </example>
-
+    </programlisting>
+   </example>
+  </section>
  </section>

  <section xml:id="filters.convert">
@@ -143,33 +150,32 @@

   <simpara>
    Как и фильтры string.*, фильтры convert.* совершают действия,
-   соответствующие их именам. Преобразовывающие фильтры были добавлены
-   в PHP 5.0.0.
+   соответствующие их именам.
    Для получения дополнительной информации о конкретном фильтре,
    обратитесь к странице руководства соответствующей функции.
   </simpara>

-  <simpara>
-   <literal>convert.base64-encode</literal> и
-   <literal>convert.base64-decode</literal>
-   Использование этих фильтров эквивалентно обработке всех данных потока
-   функциями <function>base64_encode</function> и
-   <function>base64_decode</function> соответственно.
-   <literal>convert.base64-encode</literal> поддерживает аргументы, переданные
-   в виде ассоциативного массива. Если указан аргумент
-   <parameter>line-length</parameter>, результат base64 будет разделен на
-   куски длинной <parameter>line-length</parameter> символов каждый.
-   Если указан аргумент <parameter>line-break-chars</parameter>,
-   каждый кусок будет разделен указанными символами. Эти параметры дают
-   такой же эффект, как и использование <function>base64_encode</function>
-   в паре с <function>chunk_split</function>.
-  </simpara>
-  <example>
-   <title>
-    convert.base64-encode и
-    convert.base64-decode
-   </title>
-   <programlisting role="php">
+  <section xml:id="filters.convert.base64">
+   <title>convert.base64-encode и convert.base64-decode</title>
+   <simpara>
+    Использование этих фильтров эквивалентно обработке всех данных потока
+    функциями <function>base64_encode</function> и
+    <function>base64_decode</function> соответственно.
+    <literal>convert.base64-encode</literal> поддерживает аргументы, переданные
+    в виде ассоциативного массива. Если указан аргумент
+    <parameter>line-length</parameter>, результат base64 будет разделен на
+    куски длинной <parameter>line-length</parameter> символов каждый.
+    Если указан аргумент <parameter>line-break-chars</parameter>,
+    каждый кусок будет разделен указанными символами. Эти параметры дают
+    такой же эффект, как и использование <function>base64_encode</function>
+    в паре с <function>chunk_split</function>.
+   </simpara>
+   <example>
+    <title>
+     convert.base64-encode и
+     convert.base64-decode
+    </title>
+    <programlisting role="php">
 <![CDATA[
 <?php
 $fp = fopen('php://output', 'w');
@@ -194,32 +200,33 @@
 /* Выведет:  This is a test.  */
 ?>
 ]]>
-   </programlisting>
-  </example>
+    </programlisting>
+   </example>
+  </section>

-  <simpara>
-   <literal>convert.quoted-printable-encode</literal> и
-   <literal>convert.quoted-printable-decode</literal>
-   Использование decode-версии этого фильтра эквивалентно обработке всех
-   данных потока функцией <function>quoted_printable_decode</function>.
-   У фильтра <literal>convert.quoted-printable-encode</literal> нет
-   эквивалентной функции.
-   <literal>convert.quoted-printable-encode</literal> поддерживает аргументы,
-   переданные в виде ассоциативного массива. В дополнение к аргументам,
-   поддерживаемыми <literal>convert.base64-encode</literal>,
-   <literal>convert.quoted-printable-encode</literal> также поддерживает
-   boolean-аргументы <parameter>binary</parameter> и
-   <parameter>force-encode-first</parameter>.
-   <literal>convert.base64-decode</literal> поддерживает лишь аргумент
-   <parameter>line-break-chars</parameter> в качестве подсказки для
-   чистки закодированных данных.
-  </simpara>
-  <example>
-   <title>
-    convert.quoted-printable-encode &amp;
-    convert.quoted-printable-decode
-   </title>
-   <programlisting role="php">
+  <section xml:id="filters.covert.quoted-printable">
+   <title>convert.quoted-printable-encode и convert.quoted-printable-decode</title>
+   <simpara>
+    Использование decode-версии этого фильтра эквивалентно обработке всех
+    данных потока функцией <function>quoted_printable_decode</function>.
+    У фильтра <literal>convert.quoted-printable-encode</literal> нет
+    эквивалентной функции.
+    <literal>convert.quoted-printable-encode</literal> поддерживает аргументы,
+    переданные в виде ассоциативного массива. В дополнение к аргументам,
+    поддерживаемыми <literal>convert.base64-encode</literal>,
+    <literal>convert.quoted-printable-encode</literal> также поддерживает
+    boolean-аргументы <parameter>binary</parameter> и
+    <parameter>force-encode-first</parameter>.
+    <literal>convert.base64-decode</literal> поддерживает лишь аргумент
+    <parameter>line-break-chars</parameter> в качестве подсказки для
+    чистки закодированных данных.
+   </simpara>
+   <example>
+    <title>
+     convert.quoted-printable-encode &amp;
+     convert.quoted-printable-decode
+    </title>
+    <programlisting role="php">
 <![CDATA[
 <?php
 $fp = fopen('php://output', 'w');
@@ -228,23 +235,26 @@
 /* Выведет:  =This is a test.=0A  */
 ?>
 ]]>
-   </programlisting>
-  </example>
+    </programlisting>
+   </example>
+  </section>

-  <simpara>
-   Фильтры <literal>convert.iconv.*</literal> доступны в том случае, если
-   включена поддержка <link linkend="book.iconv">iconv</link> и их использование
-   аналогично обработке потоковых данных с помощью <function>iconv</function>.
-   Эти фильтры не поддерживают параметров. Вместо этого ожидается, что
-   исходная и целевая кодировки были заданы в имени фильтра таким образом:
-   <literal>convert.iconv.&lt;input-encoding&gt;.&lt;output-encoding&gt;</literal> или
-   <literal>convert.iconv.&lt;input-encoding&gt;/&lt;output-encoding&gt;</literal>
-   (оба варианта семантически эквивалентны).
-  </simpara>
-
-  <example>
+  <section xml:id="filters.convert.iconv">
    <title>convert.iconv.*</title>
-   <programlisting role="php">
+   <simpara>
+    Фильтры <literal>convert.iconv.*</literal> доступны в том случае, если
+    включена поддержка <link linkend="book.iconv">iconv</link> и их использование
+    аналогично обработке потоковых данных с помощью <function>iconv</function>.
+    Эти фильтры не поддерживают параметров. Вместо этого ожидается, что
+    исходная и целевая кодировки были заданы в имени фильтра таким образом:
+    <literal>convert.iconv.&lt;input-encoding&gt;.&lt;output-encoding&gt;</literal> или
+    <literal>convert.iconv.&lt;input-encoding&gt;/&lt;output-encoding&gt;</literal>
+    (оба варианта семантически эквивалентны).
+   </simpara>
+
+   <example>
+    <title>convert.iconv.*</title>
+    <programlisting role="php">
 <![CDATA[
 <?php
 $fp = fopen('php://output', 'w');
@@ -254,8 +264,9 @@
 /* Выведет: This is a test. */
 ?>
 ]]>
-   </programlisting>
-  </example>
+    </programlisting>
+   </example>
+  </section>
  </section>

  <section xml:id="filters.compression">
@@ -281,58 +292,57 @@
    </simpara>
   </note>

-  <simpara>
-   <literal>zlib.deflate</literal> (компрессия) и
-   <literal>zlib.inflate</literal> (декомпрессия) являются реализациями
-   методов сжатия, описанных в
-   <link xlink:href="&url.rfc;1951">RFC 1951</link>.
-   Фильтр <literal>deflate</literal> принимает три аргумента, переданных в
-   виде ассоциативного массива.
-
-   <parameter>level</parameter> определяет, какой уровень компрессии
-   использовать (1-9). Повышение этого значения приведет к уменьшению
-   объемов данных за счет увеличения времени обработки. Существуют также два
-   специальных уровня компрессии:
-   0 (для отключения компрессии) и -1 (внутреннее значение по умолчанию
-   библиотеки zlib -- на текущий момент равно 6).
-
-   <parameter>window</parameter> - это логарифм с основанием 2 от размера окна диапазона сжатия.
-   Высокие значения (вплоть до 15 -- 32768 байт) приводят к улучшению
-   компрессии за счет роста необходимой памяти, в то время как низкие значения
-   (вплоть до 9 -- 512 байт) приводят к ухудшению компрессии за счет
-   уменьшения необходимой памяти.
-   Значением аргумента <parameter>window</parameter> по умолчанию на текущий
-   момент является <constant>15</constant>.
-
-   <parameter>memory</parameter> определяет масштаб резервируемой памяти.
-   Допустимые значения находятся в диапазоне от 1 (минимальное резервирование)
-   до 9 (максимальное резервирование). Такое резервирование памяти влияет
-   только на скорость и не влияет на размер генерируемых данных.
-  </simpara>
-
-  <note>
+  <section xml:id="filters.compression.zlib">
+   <title>zlib.deflate и zlib.inflate</title>
    <simpara>
-    Так как уровень компрессии является наиболее часто используемым
-    аргументом, вы можете передать только его в качестве обычного целого
-    числа (integer), вместо того чтобы передавать массив из одного элемента.
+    <literal>zlib.deflate</literal> (компрессия) и
+    <literal>zlib.inflate</literal> (декомпрессия) являются реализациями
+    методов сжатия, описанных в
+    <link xlink:href="&url.rfc;1951">RFC 1951</link>.
+    Фильтр <literal>deflate</literal> принимает три аргумента, переданных в
+    виде ассоциативного массива.
+
+    <parameter>level</parameter> определяет, какой уровень компрессии
+    использовать (1-9). Повышение этого значения приведет к уменьшению
+    объемов данных за счет увеличения времени обработки. Существуют также два
+    специальных уровня компрессии:
+    0 (для отключения компрессии) и -1 (внутреннее значение по умолчанию
+    библиотеки zlib -- на текущий момент равно 6).
+
+    <parameter>window</parameter> - это логарифм с основанием 2 от размера окна диапазона сжатия.
+    Высокие значения (вплоть до 15 -- 32768 байт) приводят к улучшению
+    компрессии за счет роста необходимой памяти, в то время как низкие значения
+    (вплоть до 9 -- 512 байт) приводят к ухудшению компрессии за счет
+    уменьшения необходимой памяти.
+    Значением аргумента <parameter>window</parameter> по умолчанию на текущий
+    момент является <constant>15</constant>.
+
+    <parameter>memory</parameter> определяет масштаб резервируемой памяти.
+    Допустимые значения находятся в диапазоне от 1 (минимальное резервирование)
+    до 9 (максимальное резервирование). Такое резервирование памяти влияет
+    только на скорость и не влияет на размер генерируемых данных.
    </simpara>
-  </note>
-
-  <simpara>
-   Компрессионные фильтры zlib.* доступны с версии PHP
-   <literal>5.1.0</literal>, если включена поддержка
-   <link linkend="ref.zlib">zlib</link>. Они так же доступны в качестве
-   обратного порта для версий <literal>5.0.x</literal> путем установки
-   пакета <link xlink:href="&url.pecl.package;zlib_filter">zlib_filter</link>
-   из <link xlink:href="&url.pecl;">PECL</link>.
-  </simpara>
-
-  <example>
-   <title>
-    <literal>zlib.deflate</literal> и
-    <literal>zlib.inflate</literal>
-   </title>
-   <programlisting role="php">
+   <note>
+    <simpara>
+     Так как уровень компрессии является наиболее часто используемым
+     аргументом, вы можете передать только его в качестве обычного целого
+     числа (integer), вместо того чтобы передавать массив из одного элемента.
+    </simpara>
+   </note>
+   <simpara>
+    Компрессионные фильтры zlib.* доступны с версии PHP
+    <literal>5.1.0</literal>, если включена поддержка
+    <link linkend="ref.zlib">zlib</link>. Они так же доступны в качестве
+    обратного порта для версий <literal>5.0.x</literal> путем установки
+    пакета <link xlink:href="&url.pecl.package;zlib_filter">zlib_filter</link>
+    из <link xlink:href="&url.pecl;">PECL</link>.
+   </simpara>
+   <example>
+    <title>
+     <literal>zlib.deflate</literal> и
+     <literal>zlib.inflate</literal>
+    </title>
+    <programlisting role="php">
 <![CDATA[
 <?php
 $params = array('level' => 6, 'window' => 15, 'memory' => 9);
@@ -362,14 +372,14 @@
  */
 ?>
 ]]>
-   </programlisting>
-  </example>
-
-  <example>
-   <title>
-    Упрощенное использование <literal>zlib.deflate</literal>
-   </title>
-   <programlisting role="php">
+    </programlisting>
+   </example>
+
+   <example>
+    <title>
+     Упрощенное использование <literal>zlib.deflate</literal>
+    </title>
+    <programlisting role="php">
 <![CDATA[
 <?php
 $original_text = "This is a test.\nThis is only a test.\nThis is not an important string.\n";
@@ -391,53 +401,56 @@
  */
 ?>
 ]]>
-   </programlisting>
-  </example>
+    </programlisting>
+   </example>
+  </section>

-  <simpara>
-   <literal>bzip2.compress</literal> и
-   <literal>bzip2.decompress</literal>
-   работают точно так же, как и фильтры zlib, описанные выше.
+  <section xml:id="filters.compression.bzip2">
+   <title>bzip2.compress и bzip2.decompress</title>
+   <simpara>
+    <literal>bzip2.compress</literal> и
+    <literal>bzip2.decompress</literal>
+    работают точно так же, как и фильтры zlib, описанные выше.
+
+    Фильтр <literal>bzip2.compress</literal> принимает два аргумента в виде
+    элементов ассоциативного массива:
+
+    <parameter>blocks</parameter> является целочисленным (integer) значением
+    в диапазоне от 1 до 9 и указывает на количество 100-килобайтовых блоков
+    памяти для резервирования в качестве рабочего пространства.
+
+    <parameter>work</parameter> - это так же целочисленное (integer) значение
+    в диапазоне от 0 до 250, определяющее сколько усилий нужно потратить на
+    обычный метод компрессии перед переключением на медленный, но более
+    надежный метод. Изменение этого параметра влияет только на скорость
+    компрессии. Ни размер сжатого результата, ни используемый объем памяти не
+    изменяются при помощи этой настройки. Значение 0 указывает библиотеке bzip
+    использовать собственное внутреннее значение по умолчанию.
+
+    Фильтр <literal>bzip2.decompress</literal> принимает всего один аргумент,
+    который может быть передан либо как обычное boolean-значение, либо как
+    элемент <parameter>small</parameter> ассоциативного массива.
+
+    Когда <parameter>small</parameter> установлен в &true;, библиотека bzip
+    совершит декомпрессию с минимальным расходом памяти за счет понижения
+    скорости.
+   </simpara>

-   Фильтр <literal>bzip2.compress</literal> принимает два аргумента в виде
-   элементов ассоциативного массива:
+   <simpara>
+    Компрессионные фильтры bzip2.* доступны с версии PHP
+    <literal>5.1.0</literal>, если включена поддержка
+    <link linkend="ref.bzip2">bz2</link>. Они так же доступны в качестве
+    обратного порта для версий <literal>5.0.x</literal> путем установки
+    пакета <link xlink:href="&url.pecl.package;bz2_filter">bz2_filter</link>
+    из <link xlink:href="&url.pecl;">PECL</link>.
+   </simpara>

-   <parameter>blocks</parameter> является целочисленным (integer) значением
-   в диапазоне от 1 до 9 и указывает на количество 100-килобайтовых блоков
-   памяти для резервирования в качестве рабочего пространства.
-
-   <parameter>work</parameter> - это так же целочисленное (integer) значение
-   в диапазоне от 0 до 250, определяющее сколько усилий нужно потратить на
-   обычный метод компрессии перед переключением на медленный, но более
-   надежный метод. Изменение этого параметра влияет только на скорость
-   компрессии. Ни размер сжатого результата, ни используемый объем памяти не
-   изменяются при помощи этой настройки. Значение 0 указывает библиотеке bzip
-   использовать собственное внутреннее значение по умолчанию.
-
-   Фильтр <literal>bzip2.decompress</literal> принимает всего один аргумент,
-   который может быть передан либо как обычное boolean-значение, либо как
-   элемент <parameter>small</parameter> ассоциативного массива.
-
-   Когда <parameter>small</parameter> установлен в &true;, библиотека bzip
-   совершит декомпрессию с минимальным расходом памяти за счет понижения
-   скорости.
-  </simpara>
-
-  <simpara>
-   Компрессионные фильтры bzip2.* доступны с версии PHP
-   <literal>5.1.0</literal>, если включена поддержка
-   <link linkend="ref.bzip2">bz2</link>. Они так же доступны в качестве
-   обратного порта для версий <literal>5.0.x</literal> путем установки
-   пакета <link xlink:href="&url.pecl.package;bz2_filter">bz2_filter</link>
-   из <link xlink:href="&url.pecl;">PECL</link>.
-  </simpara>
-
-  <example>
-   <title>
-    <literal>bzip2.compress</literal> и
-    <literal>bzip2.decompress</literal>
-   </title>
-   <programlisting role="php">
+   <example>
+    <title>
+     <literal>bzip2.compress</literal> и
+     <literal>bzip2.decompress</literal>
+    </title>
+    <programlisting role="php">
 <![CDATA[
 <?php
 $param = array('blocks' => 9, 'work' => 0);
@@ -459,8 +472,9 @@
  */
 ?>
 ]]>
-   </programlisting>
-  </example>
+    </programlisting>
+   </example>
+  </section>
  </section>

  <section xml:id="filters.encryption">
@@ -467,74 +481,75 @@
   <title>Шифрующие фильтры</title>

   <para>
-   &warn.deprecated.feature-7-1-0;
-  </para>
-
-  <para>
    Шифрующие фильтры очень хорошо подходят для шифрования файлов и потоков.
   </para>
-  <simpara>
-   <literal>mcrypt.*</literal> и <literal>mdecrypt.*</literal>
-   обеспечивают симметричное шифрование и дешифрование при помощи
-   libmcrypt. Оба набора фильтров поддерживают те же алгоритмы, что и
-   <link linkend="ref.mcrypt">расширение mcrypt</link> в виде
-   <literal>mcrypt.ciphername</literal>, где
-   <parameter>ciphername</parameter> - это название шифра, как если
-   бы оно передавалось функции <function>mcrypt_module_open</function>.
-   Также доступны следующие пять параметров:
-  </simpara>

-  <para>
-   <table>
-    <title>Параметры фильтра mcrypt</title>
-    <tgroup cols="4">
-     <thead>
-      <row>
-       <entry>Параметр</entry>
-       <entry>Обязателен?</entry>
-       <entry>По умолчанию</entry>
-       <entry>Пример значения</entry>
-      </row>
-     </thead>
-     <tbody>
-      <row>
-       <entry>mode</entry>
-       <entry>Нет</entry>
-       <entry>cbc</entry>
-       <entry>cbc, cfb, ecb, nofb, ofb, stream</entry>
-      </row>
-      <row>
-       <entry>algorithms_dir</entry>
-       <entry>Нет</entry>
-       <entry>ini_get('mcrypt.algorithms_dir')</entry>
-       <entry>Путь к модулям алгоритмов</entry>
-      </row>
-      <row>
-       <entry>modes_dir</entry>
-       <entry>Нет</entry>
-       <entry>ini_get('mcrypt.modes_dir')</entry>
-       <entry>Путь к модулям режимов</entry>
-      </row>
-      <row>
-       <entry>iv</entry>
-       <entry>Да</entry>
-       <entry>N/A</entry>
-       <entry>Обычно 8, 16 или 32 байта бинарных данных. Зависит от шифра</entry>
-      </row>
-      <row>
-       <entry>key</entry>
-       <entry>Да</entry>
-       <entry>N/A</entry>
-       <entry>Обычно 8, 16 или 32 байта бинарных данных. Зависит от шифра</entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </table>
-  </para>
-
-  <example>
-   <title>Шифрование/расшифровка используя Blowfish</title>
-   <programlisting role="php">
+  <section xml:id="filters.encryption.mcrypt">
+   <title>mcrypt.* и mdecrypt.*</title>
+   <para>
+    &warn.deprecated.feature-7-1-0;
+   </para>
+   <simpara>
+    <literal>mcrypt.*</literal> и <literal>mdecrypt.*</literal>
+    обеспечивают симметричное шифрование и дешифрование при помощи
+    libmcrypt. Оба набора фильтров поддерживают те же алгоритмы, что и
+    <link linkend="ref.mcrypt">расширение mcrypt</link> в виде
+    <literal>mcrypt.ciphername</literal>, где
+    <parameter>ciphername</parameter> - это название шифра, как если
+    бы оно передавалось функции <function>mcrypt_module_open</function>.
+    Также доступны следующие пять параметров:
+   </simpara>
+   <para>
+    <table>
+     <title>Параметры фильтра mcrypt</title>
+     <tgroup cols="4">
+      <thead>
+       <row>
+        <entry>Параметр</entry>
+        <entry>Обязателен?</entry>
+        <entry>По умолчанию</entry>
+        <entry>Пример значения</entry>
+       </row>
+      </thead>
+      <tbody>
+       <row>
+        <entry>mode</entry>
+        <entry>Нет</entry>
+        <entry>cbc</entry>
+        <entry>cbc, cfb, ecb, nofb, ofb, stream</entry>
+       </row>
+       <row>
+        <entry>algorithms_dir</entry>
+        <entry>Нет</entry>
+        <entry>ini_get('mcrypt.algorithms_dir')</entry>
+        <entry>Путь к модулям алгоритмов</entry>
+       </row>
+       <row>
+        <entry>modes_dir</entry>
+        <entry>Нет</entry>
+        <entry>ini_get('mcrypt.modes_dir')</entry>
+        <entry>Путь к модулям режимов</entry>
+       </row>
+       <row>
+        <entry>iv</entry>
+        <entry>Да</entry>
+        <entry>N/A</entry>
+        <entry>Обычно 8, 16 или 32 байта бинарных данных. Зависит от шифра</entry>
+       </row>
+       <row>
+        <entry>key</entry>
+        <entry>Да</entry>
+        <entry>N/A</entry>
+        <entry>Обычно 8, 16 или 32 байта бинарных данных. Зависит от шифра</entry>
+       </row>
+      </tbody>
+     </tgroup>
+    </table>
+   </para>
+
+   <example>
+    <title>Шифрование/расшифровка используя Blowfish</title>
+    <programlisting role="php">
 <![CDATA[
 <?php
 // примем, что $key  уже сформирован
@@ -557,12 +572,12 @@
 echo $data;
 ?>
 ]]>
-   </programlisting>
-  </example>
-
-  <example>
-   <title>Шифрование файла с помощью AES-128 CBC с SHA256 HMAC в PHP 5.5+</title>
-   <programlisting role="php">
+    </programlisting>
+   </example>
+
+   <example>
+    <title>Шифрование файла с помощью AES-128 CBC с SHA256 HMAC в PHP 5.5+</title>
+    <programlisting role="php">
 <![CDATA[
 <?php
 AES_CBC::encryptFile($password, "plaintext.txt", "encrypted.enc");
@@ -671,9 +686,9 @@
    protected static function key_size() { return self::$KEY_SIZES['AES-256']; }
 }
 ]]>
-   </programlisting>
-  </example>
-
+    </programlisting>
+   </example>
+  </section>
  </section>

 </appendix>

Modified: phpdoc/ru/trunk/reference/exec/functions/proc-open.xml
===================================================================
--- phpdoc/ru/trunk/reference/exec/functions/proc-open.xml	2019-12-02 04:01:14 UTC (rev 348394)
+++ phpdoc/ru/trunk/reference/exec/functions/proc-open.xml	2019-12-02 04:41:40 UTC (rev 348395)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 346994 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 348389 Maintainer: tmn Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->
 <!-- $Revision$ -->
 <!-- splitted from ./en/functions/exec.xml, last change in rev 1.28 -->
@@ -136,6 +136,10 @@
          &true; процесс будет запущен в обход оболочки
          <literal>cmd.exe</literal>
         </member>
+        <member>
+         <literal>blocking_pipes</literal> (только для Windows): принудительно
+         блокировать поток при значении &true;
+        </member>
        </simplelist>
       </para>
      </listitem>
@@ -166,6 +170,13 @@
      </thead>
      <tbody>
       <row>
+       <entry>7.0.0</entry>
+       <entry>
+        Добавлена опция <literal>blocking_pipes</literal> в
+        параметр <parameter>other_options</parameter>.
+       </entry>
+      </row>
+      <row>
        <entry>5.2.1</entry>
        <entry>
         Настройка <literal>bypass_shell</literal> добавлена в аргумент

Modified: phpdoc/ru/trunk/reference/filesystem/functions/fgetss.xml
===================================================================
--- phpdoc/ru/trunk/reference/filesystem/functions/fgetss.xml	2019-12-02 04:01:14 UTC (rev 348394)
+++ phpdoc/ru/trunk/reference/filesystem/functions/fgetss.xml	2019-12-02 04:41:40 UTC (rev 348395)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 346281 Maintainer: shein Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 348386 Maintainer: shein Status: ready -->
+<!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fgetss">
  <refnamediv>
@@ -21,9 +21,12 @@
    <methodparam choice="opt"><type>string</type><parameter>allowable_tags</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Данная функция идентична функции <function>fgets</function>, за исключением того,
+   Функция идентична функции <function>fgets</function>, за исключением того,
    что <function>fgetss</function> удаляет любые NULL-байты,
    HTML- и PHP-теги из прочитанной строки.
+   Функция сохраняет состояние синтаксического анализа от вызова к вызову и поэтому не
+   эквивалентна вызову <function>strip_tags</function> для возвращаемого значения
+   <function>fgets</function>.
   </para>
  </refsect1>

@@ -74,6 +77,7 @@
  </refsect1>

  <refsect1 role="examples">
+  &reftitle.examples;
   <para>
    <example>
     <title>Построчное чтение PHP-файла</title>
@@ -125,6 +129,8 @@
     <member><function>popen</function></member>
     <member><function>fsockopen</function></member>
     <member><function>strip_tags</function></member>
+    <member><methodname>SplFileObject::fgetss</methodname></member>
+    <member>Фильтр <link linkend="filters.string.strip_tags">string.strip_tags</link></member>
    </simplelist>
   </para>
  </refsect1>

Modified: phpdoc/ru/trunk/reference/spl/splfileobject/fgetss.xml
===================================================================
--- phpdoc/ru/trunk/reference/spl/splfileobject/fgetss.xml	2019-12-02 04:01:14 UTC (rev 348394)
+++ phpdoc/ru/trunk/reference/spl/splfileobject/fgetss.xml	2019-12-02 04:41:40 UTC (rev 348395)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 346281 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 348386 Maintainer: tmn Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->
 <!-- $Revision$ -->

@@ -25,6 +25,12 @@
    Работа функции идентична <methodname>SplFileObject::fgets</methodname> за
    исключением того, что <methodname>SplFileObject::fgetss</methodname> пытается
    очистить строку от любых тегов HTML и PHP.
+   The function retains the parsing state from call to call, and as such is not
+   equivalent to calling <function>strip_tags</function> on the return value of
+   <methodname>SplFileObject::fgets</methodname>.
+   Функция сохраняет состояние синтаксического анализа от вызова к вызову и поэтому не
+   эквивалентна вызову <function>strip_tags</function> для возвращаемого значения
+   <methodname>SplFileObject::fgets</methodname>.
   </para>
  </refsect1>

@@ -96,6 +102,7 @@
     <member><methodname>SplFileObject::fgets</methodname></member>
     <member><methodname>SplFileObject::fgetc</methodname></member>
     <member><methodname>SplFileObject::current</methodname></member>
+    <member>Фильтр <link linkend="filters.string.strip_tags">string.strip_tags</link></member>
    </simplelist>
   </para>
  </refsect1>