svn: /phpdoc/ru/trunk/reference/ exif/functions/exif-imagetype.xml exif/functions/exif-read-data.xml exif/functions/exif-tagname.xml exif/functions/exif-thumbnail.xml filesystem/functions/realpath.xml

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

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

Log:
docs(ru): Updated to English revision

Changed paths:
    U   phpdoc/ru/trunk/reference/exif/functions/exif-imagetype.xml
    U   phpdoc/ru/trunk/reference/exif/functions/exif-read-data.xml
    U   phpdoc/ru/trunk/reference/exif/functions/exif-tagname.xml
    U   phpdoc/ru/trunk/reference/exif/functions/exif-thumbnail.xml
    U   phpdoc/ru/trunk/reference/filesystem/functions/realpath.xml
svn-diffs-351453.txt (text/x-diff, 12.2 KB)
Modified: phpdoc/ru/trunk/reference/exif/functions/exif-imagetype.xml
===================================================================
--- phpdoc/ru/trunk/reference/exif/functions/exif-imagetype.xml	2020-11-19 23:05:04 UTC (rev 351452)
+++ phpdoc/ru/trunk/reference/exif/functions/exif-imagetype.xml	2020-11-20 06:38:52 UTC (rev 351453)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 350655 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 351452 Maintainer: tmn Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <!-- splitted from ./en/functions/image.xml, last change in rev 1.81 -->
@@ -10,10 +10,10 @@
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
-  <methodsynopsis>
-   <type>int</type><methodname>exif_imagetype</methodname>
-   <methodparam><type>string</type><parameter>filename</parameter></methodparam>
-  </methodsynopsis>
+   <methodsynopsis>
+    <type class="union"><type>int</type><type>false</type></type><methodname>exif_imagetype</methodname>
+    <methodparam><type>string</type><parameter>filename</parameter></methodparam>
+   </methodsynopsis>
   <para>
    <function>exif_imagetype</function> считывает начальные байты изображения и
    проверяет их сигнатуру.
@@ -206,7 +206,6 @@
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/ru/trunk/reference/exif/functions/exif-read-data.xml
===================================================================
--- phpdoc/ru/trunk/reference/exif/functions/exif-read-data.xml	2020-11-19 23:05:04 UTC (rev 351452)
+++ phpdoc/ru/trunk/reference/exif/functions/exif-read-data.xml	2020-11-20 06:38:52 UTC (rev 351453)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 347589 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 351452 Maintainer: tmn Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <!-- splitted from ./en/functions/image.xml, last change in rev 1.78 -->
@@ -13,11 +13,11 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>array</type><methodname>exif_read_data</methodname>
-   <methodparam><type>mixed</type><parameter>stream</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>sections</parameter><initializer>&null;</initializer></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>arrays</parameter><initializer>&false;</initializer></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>thumbnail</parameter><initializer>&false;</initializer></methodparam>
+   <type class="union"><type>array</type><type>false</type></type><methodname>exif_read_data</methodname>
+   <methodparam><type class="union"><type>resource</type><type>string</type></type><parameter>file</parameter></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>required_sections</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>as_arrays</parameter><initializer>&false;</initializer></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>read_thumbnail</parameter><initializer>&false;</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>exif_read_data</function> читает заголовки <acronym>EXIF</acronym>
@@ -75,7 +75,7 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>stream</parameter></term>
+     <term><parameter>file</parameter></term>
      <listitem>
       <para>
        Местоположение файла с изображением. Может быть как путем к файлу,
@@ -84,7 +84,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>sections</parameter></term>
+     <term><parameter>required_sections</parameter></term>
      <listitem>
       <para>
        Список разделенных запятой разделов, которые должны быть представлены
@@ -147,11 +147,11 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>arrays</parameter></term>
+     <term><parameter>as_arrays</parameter></term>
      <listitem>
       <para>
        Определяет, формировать ли разделы в виде массивов. Разделы
-       <parameter>sections</parameter>, <literal>COMPUTED</literal>,
+       <parameter>required_sections</parameter>, <literal>COMPUTED</literal>,
        <literal>THUMBNAIL</literal> и <literal>COMMENT</literal> всегда
        делаются массивами, так как они могут содержать значения, имена которых
        будут конфликтовать с именами в других разделах.
@@ -159,7 +159,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>thumbnail</parameter></term>
+     <term><parameter>read_thumbnail</parameter></term>
      <listitem>
       <para>
        Если &true;, будет прочитан сам эскиз. В противном случае будет прочитана
@@ -192,9 +192,15 @@
      </thead>
      <tbody>
       <row>
+       <entry>8.0.0</entry>
+       <entry>
+        <parameter>required_sections</parameter> теперь допускает значение null.
+       </entry>
+      </row>
+      <row>
        <entry>7.2.0</entry>
        <entry>
-        Параметр <parameter>filename</parameter> переименован в
+        Параметр <parameter>file</parameter> переименован в
         <parameter>stream</parameter> и может принимать как локальный путь
         к файлу, так и потоковый ресурс.
        </entry>
@@ -393,7 +399,7 @@
   </note>
   <note>
    <para>
-    Если параметр <parameter>stream</parameter> использован для передачи в функцию
+    Если параметр <parameter>file</parameter> использован для передачи в функцию
     потока, то этот поток должен быть перематываемым. Обратите внимание, что файловый
     позиционный указатель не будет изменен после завершения работы этой функции.
    </para>
@@ -410,7 +416,6 @@
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/ru/trunk/reference/exif/functions/exif-tagname.xml
===================================================================
--- phpdoc/ru/trunk/reference/exif/functions/exif-tagname.xml	2020-11-19 23:05:04 UTC (rev 351452)
+++ phpdoc/ru/trunk/reference/exif/functions/exif-tagname.xml	2020-11-20 06:38:52 UTC (rev 351453)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 305637 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 351452 Maintainer: tmn Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xml:id="function.exif-tagname" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -10,7 +10,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>string</type><methodname>exif_tagname</methodname>
+   <type class="union"><type>string</type><type>false</type></type><methodname>exif_tagname</methodname>
    <methodparam><type>int</type><parameter>index</parameter></methodparam>
   </methodsynopsis>
  </refsect1>
@@ -70,7 +70,6 @@
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/ru/trunk/reference/exif/functions/exif-thumbnail.xml
===================================================================
--- phpdoc/ru/trunk/reference/exif/functions/exif-thumbnail.xml	2020-11-19 23:05:04 UTC (rev 351452)
+++ phpdoc/ru/trunk/reference/exif/functions/exif-thumbnail.xml	2020-11-20 06:38:52 UTC (rev 351453)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 343465 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 351452 Maintainer: tmn Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->

@@ -12,11 +12,11 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>string</type><methodname>exif_thumbnail</methodname>
-   <methodparam><type>mixed</type><parameter>stream</parameter></methodparam>
+   <type class="union"><type>string</type><type>false</type></type><methodname>exif_thumbnail</methodname>
+   <methodparam><type class="union"><type>resource</type><type>string</type></type><parameter>file</parameter></methodparam>
    <methodparam choice="opt"><type>int</type><parameter role="reference">width</parameter></methodparam>
    <methodparam choice="opt"><type>int</type><parameter role="reference">height</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter role="reference">imagetype</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter role="reference">image_type</parameter></methodparam>
   </methodsynopsis>
   <para>
    <function>exif_thumbnail</function> считывает встроенное превью изображения.
@@ -38,7 +38,7 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>stream</parameter></term>
+     <term><parameter>file</parameter></term>
      <listitem>
       <para>
        Местоположение файла с изображением. Может быть как путем к файлу,
@@ -63,7 +63,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>imagetype</parameter></term>
+     <term><parameter>image_type</parameter></term>
      <listitem>
       <para>
        Возвращаемый тип эскиза. Это либо
@@ -121,7 +121,7 @@
       <row>
        <entry>7.2.0</entry>
        <entry>
-        Параметр <parameter>filename</parameter> переименован в
+        Параметр <parameter>file</parameter> переименован в
         <parameter>stream</parameter> и может принимать как локальный путь
         к файлу, так и потоковый ресурс.
        </entry>
@@ -135,7 +135,7 @@
   &reftitle.notes;
   <note>
    <para>
-    Если параметр <parameter>stream</parameter> использован для передачи потока в функцию,
+    Если параметр <parameter>file</parameter> использован для передачи потока в функцию,
     то этот поток должен быть перематываемым. Обратите внимание, что файловый
     позиционный указатель не будет изменен после завершения работы этой функции.
    </para>
@@ -151,7 +151,6 @@
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/ru/trunk/reference/filesystem/functions/realpath.xml
===================================================================
--- phpdoc/ru/trunk/reference/filesystem/functions/realpath.xml	2020-11-19 23:05:04 UTC (rev 351452)
+++ phpdoc/ru/trunk/reference/filesystem/functions/realpath.xml	2020-11-20 06:38:52 UTC (rev 351453)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 350654 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351451 Maintainer: shein Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.realpath">
@@ -75,6 +75,12 @@
     не реальным, а виртуальным.
    </para>
   </note>
+  <note>
+   <para>
+    В Windows переходы и символические ссылки на каталоги расширяются только
+    на один уровень.
+   </para>
+  </note>
   &fs.file.32bit;
  </refsect1>