svn: /phpdoc/ru/trunk/ language/control-structures.xml language-snippets.ent reference/bc/book.xml reference/dom/domxpath/query.xml reference/filesystem/functions/chgrp.xml reference/filesystem/functions/chown.xml reference/image/functions/imagecreatefromgd.xml reference/image/functions/imagecreatefromgd2.xml reference/image/functions/imagecreatefromgd2part.xml reference/image/functions/imagegd.xml reference/image/functions/imagegd2.xml reference/spl/spldoublylinkedlist.xml reference/strings/fun

[email protected] (Sergey Panteleev)
Newsgroups php.doc.ru
Message-ID <[email protected]>
sergey                                   Fri, 06 Mar 2020 04:30:20 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=349335

Log:
docs(ru): Updated to English revision

Changed paths:
    U   phpdoc/ru/trunk/language/control-structures.xml
    U   phpdoc/ru/trunk/language-snippets.ent
    U   phpdoc/ru/trunk/reference/bc/book.xml
    U   phpdoc/ru/trunk/reference/dom/domxpath/query.xml
    U   phpdoc/ru/trunk/reference/filesystem/functions/chgrp.xml
    U   phpdoc/ru/trunk/reference/filesystem/functions/chown.xml
    U   phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd.xml
    U   phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd2.xml
    U   phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd2part.xml
    U   phpdoc/ru/trunk/reference/image/functions/imagegd.xml
    U   phpdoc/ru/trunk/reference/image/functions/imagegd2.xml
    U   phpdoc/ru/trunk/reference/spl/spldoublylinkedlist.xml
    U   phpdoc/ru/trunk/reference/strings/functions/strip-tags.xml
    U   phpdoc/ru/trunk/reference/zip/ziparchive/getstatusstring.xml
    U   phpdoc/ru/trunk/reference/zip/ziparchive.xml
svn-diffs-349335.txt (text/x-diff, 17.6 KB)
Modified: phpdoc/ru/trunk/language/control-structures.xml
===================================================================
--- phpdoc/ru/trunk/language/control-structures.xml	2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/language/control-structures.xml	2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 288721 Maintainer: shafff Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 349319 Maintainer: shafff Status: ready -->
+<!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->

 <chapter xml:id="language.control-structures" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -17,6 +17,23 @@
     Блок инструкций также сам по себе является инструкцией.
     В этом разделе описываются различные типы инструкций.
   </simpara>
+
+    <sect2 role="seealso">
+   &reftitle.seealso;
+   <para>
+    Ниже также рассматриваются языковые конструкции, даже если они
+    упоминаются в функциях руководства.
+   </para>
+   <para>
+    <simplelist>
+     <member><function>list</function></member>
+     <member><function>array</function></member>
+     <member><function>echo</function></member>
+     <member><function>eval</function></member>
+    </simplelist>
+   </para>
+  </sect2>
+
  </sect1>

  &language.control-structures.if;

Modified: phpdoc/ru/trunk/language-snippets.ent
===================================================================
--- phpdoc/ru/trunk/language-snippets.ent	2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/language-snippets.ent	2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 349148 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 349322 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->

@@ -562,6 +562,8 @@
 <entry>7.0.0</entry><entry>Поддержка T1Lib удалена из PHP и эта функция, соответственно, тоже.</entry>
 </row>'>

+<!ENTITY gd.deprecated.gd-formats '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Форматы изображений GD и GD2 являются проприетарными форматами изображений libgd. Они должны рассматриваться как <emphasis>устаревшие</emphasis> и должны использоваться только для целей разработки и тестирования.</simpara></warning>'>
+
 <!-- DBM notes -->

 <!ENTITY dbm.dbm-identifier.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>

Modified: phpdoc/ru/trunk/reference/bc/book.xml
===================================================================
--- phpdoc/ru/trunk/reference/bc/book.xml	2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/bc/book.xml	2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 347753 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 349317 Maintainer: tmn Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->
 <!-- $Revision$ -->

@@ -12,8 +12,7 @@
  <preface xml:id="intro.bc">
   &reftitle.intro;
   <para>
-   Для вычислений с произвольной точностью PHP предоставляет двоичный
-   калькулятор, который поддерживает числа любого размера и точности, вплоть до
+   Для вычислений с произвольной точностью PHP предоставляет BCMath, который поддерживает числа любого размера и точности, вплоть до
    <literal>2147483647</literal> (или <literal>0x7FFFFFFF</literal>) десятичных знаков,
    если хватит памяти, представленных в виде строк.
   </para>

Modified: phpdoc/ru/trunk/reference/dom/domxpath/query.xml
===================================================================
--- phpdoc/ru/trunk/reference/dom/domxpath/query.xml	2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/dom/domxpath/query.xml	2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 344109 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 349324 Maintainer: tmn Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->
 <!-- $Revision$ -->
 <refentry xml:id="domxpath.query" xmlns="http://docbook.org/ns/docbook">

Modified: phpdoc/ru/trunk/reference/filesystem/functions/chgrp.xml
===================================================================
--- phpdoc/ru/trunk/reference/filesystem/functions/chgrp.xml	2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/filesystem/functions/chgrp.xml	2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 308663 Maintainer: shein Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 349320 Maintainer: shein Status: ready -->
+<!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.chgrp">
  <refnamediv>
@@ -82,6 +82,11 @@
   &reftitle.notes;
   &note.no-remote;
   &note.sm.uidcheck;
+  <note>
+   <simpara>
+    В Windows функция молча завершается ошибкой при применении к обычному файлу.
+   </simpara>
+  </note>
  </refsect1>

  <refsect1 role="seealso">

Modified: phpdoc/ru/trunk/reference/filesystem/functions/chown.xml
===================================================================
--- phpdoc/ru/trunk/reference/filesystem/functions/chown.xml	2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/filesystem/functions/chown.xml	2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 336238 Maintainer: shein Status: ready -->
-<!-- Reviewed: yes -->
+<!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.chown">
  <refnamediv>
@@ -101,6 +101,11 @@
   &reftitle.notes;
   &note.no-remote;
   &note.sm.uidcheck;
+  <note>
+   <simpara>
+    В Windows функция молча завершается ошибкой при применении к обычному файлу.
+   </simpara>
+  </note>
  </refsect1>

  <refsect1 role="seealso">

Modified: phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd.xml
===================================================================
--- phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd.xml	2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd.xml	2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 336340 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 349322 Maintainer: tmn Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xml:id='function.imagecreatefromgd' xmlns="http://docbook.org/ns/docbook">
@@ -67,6 +67,12 @@
    </example>
   </para>
  </refsect1>
+
+ <refsect1 role="notes">
+  &reftitle.notes;
+  &gd.deprecated.gd-formats;
+ </refsect1>
+
 </refentry>

 <!-- Keep this comment at the end of the file

Modified: phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd2.xml
===================================================================
--- phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd2.xml	2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd2.xml	2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 339875 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 349322 Maintainer: tmn Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xml:id='function.imagecreatefromgd2' xmlns="http://docbook.org/ns/docbook">
@@ -66,6 +66,11 @@
    </example>
   </para>
  </refsect1>
+
+ <refsect1 role="notes">
+  &reftitle.notes;
+  &gd.deprecated.gd-formats;
+ </refsect1>
 </refentry>

 <!-- Keep this comment at the end of the file

Modified: phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd2part.xml
===================================================================
--- phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd2part.xml	2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd2part.xml	2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 339875 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 349322 Maintainer: tmn Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xml:id='function.imagecreatefromgd2part' xmlns="http://docbook.org/ns/docbook">
@@ -101,6 +101,11 @@
    </example>
   </para>
  </refsect1>
+
+ <refsect1 role="notes">
+  &reftitle.notes;
+  &gd.deprecated.gd-formats;
+ </refsect1>
 </refentry>

 <!-- Keep this comment at the end of the file

Modified: phpdoc/ru/trunk/reference/image/functions/imagegd.xml
===================================================================
--- phpdoc/ru/trunk/reference/image/functions/imagegd.xml	2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/image/functions/imagegd.xml	2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 344720 Maintainer: aur Status: ready -->
+<!-- EN-Revision: 349322 Maintainer: aur Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <refentry xml:id='function.imagegd' xmlns="http://docbook.org/ns/docbook">
@@ -126,6 +126,7 @@
     Заметим, что формат GD используется только в GD-совместимых приложениях.
    </para>
   </note>
+  &gd.deprecated.gd-formats;
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;

Modified: phpdoc/ru/trunk/reference/image/functions/imagegd2.xml
===================================================================
--- phpdoc/ru/trunk/reference/image/functions/imagegd2.xml	2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/image/functions/imagegd2.xml	2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 344720 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 349322 Maintainer: tmn Status: ready -->
 <!-- Reviewed: no -->
 <!-- $Revision$ -->
 <refentry xml:id='function.imagegd2' xmlns="http://docbook.org/ns/docbook">
@@ -140,6 +140,7 @@
     GD2-совместимых приложениях.
    </para>
   </note>
+  &gd.deprecated.gd-formats;
  </refsect1>

  <refsect1 role="seealso">

Modified: phpdoc/ru/trunk/reference/spl/spldoublylinkedlist.xml
===================================================================
--- phpdoc/ru/trunk/reference/spl/spldoublylinkedlist.xml	2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/spl/spldoublylinkedlist.xml	2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 347439 Maintainer: northcat Status: ready -->
+<!-- EN-Revision: 349321 Maintainer: northcat Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->
 <phpdoc:classref xmlns:phpdoc="http://php.net/ns/phpdoc" xml:id="class.spldoublylinkedlist" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>Класс SplDoublyLinkedList</title>
@@ -43,6 +43,10 @@
       <interfacename>Countable</interfacename>
      </oointerface>

+     <oointerface>
+      <interfacename>Serializable</interfacename>
+     </oointerface>
+
     </classsynopsisinfo>
     <!-- }}} -->


Modified: phpdoc/ru/trunk/reference/strings/functions/strip-tags.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/strip-tags.xml	2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/strings/functions/strip-tags.xml	2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 348925 Maintainer: shein Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 349323 Maintainer: shein Status: ready -->
+<!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strip-tags">
  <refnamediv>
@@ -13,10 +13,10 @@
   <methodsynopsis>
    <type>string</type><methodname>strip_tags</methodname>
    <methodparam><type>string</type><parameter>str</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>allowable_tags</parameter></methodparam>
+   <methodparam choice="opt"><type>mixed</type><parameter>allowable_tags</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Эта функция пытается возвратить строку, из которой
+   функция пытается возвратить строку, из которой
    удалены все NULL-байты, HTML- и PHP-теги. Для удаления тегов используется тот же механизм,
    что и в функции <function>fgetss</function>.
   </para>
@@ -40,6 +40,8 @@
       <para>
        Второй необязательный параметр может быть использован для
        указания тегов, которые не нужно удалять.
+       Они указываются как строка (&string;) или как массив (&array;) с PHP 7.4.0.
+       Смотрите пример ниже относительно формата этого параметра.
       </para>
       <note>
        <para>
@@ -92,6 +94,12 @@
      </thead>
      <tbody>
       <row>
+       <entry>7.4.0</entry>
+       <entry>
+        <parameter>allowable_tags</parameter> теперь альтернативно принимает массив (&array;).
+       </entry>
+      </row>
+      <row>
        <entry>5.3.4</entry>
        <entry>
         <function>strip_tags</function> игнорирует самозакрывающиеся теги XHTML
@@ -118,6 +126,9 @@

 // Разрешаем <p> и <a>
 echo strip_tags($text, '<p><a>');
+
+// Начиная с PHP 7.4.0, строка выше может быть записана как:
+// echo strip_tags($text, ['p', 'a']);
 ?>
 ]]>
     </programlisting>

Modified: phpdoc/ru/trunk/reference/zip/ziparchive/getstatusstring.xml
===================================================================
--- phpdoc/ru/trunk/reference/zip/ziparchive/getstatusstring.xml	2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/zip/ziparchive/getstatusstring.xml	2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 322115 Maintainer: aur Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 349314 Maintainer: aur Status: ready -->
+<!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xml:id="ziparchive.getstatusstring" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -29,6 +29,30 @@
    Возвращает строку (<type>string</type>) с сообщением о статусе при успехе&return.falseforfailure;.
   </para>
  </refsect1>
+
+  <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>8.0.0 / 1.18.0</entry>
+       <entry>
+        Метод можно вызвать в закрытом архиве.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
 </refentry>

 <!-- Keep this comment at the end of the file

Modified: phpdoc/ru/trunk/reference/zip/ziparchive.xml
===================================================================
--- phpdoc/ru/trunk/reference/zip/ziparchive.xml	2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/zip/ziparchive.xml	2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 349304 Maintainer: daniil Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 349311 Maintainer: daniil Status: ready -->
+<!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <phpdoc:classref xmlns:phpdoc="http://php.net/ns/phpdoc" xml:id="class.ziparchive" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>Класс <classname>ZipArchive</classname></title>
@@ -65,13 +65,15 @@
     <varlistentry xml:id="ziparchive.props.status">
      <term><varname>status</varname></term>
      <listitem>
-      <para>Статус Zip-архива</para>
+      <para>Статус Zip-архива.
+      Доступно для закрытого архива, начиная с PHP 8.0.0 и PECL zip 1.18.0.</para>
      </listitem>
     </varlistentry>
     <varlistentry xml:id="ziparchive.props.statussys">
      <term><varname>statusSys</varname></term>
      <listitem>
-      <para>Системный статус Zip-архива</para>
+      <para>Системный статус Zip-архива.
+      Доступно для закрытого архива, начиная с PHP 8.0.0 и PECL zip 1.18.0.</para>
      </listitem>
     </varlistentry>
     <varlistentry xml:id="ziparchive.props.numfiles">
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.