Document new errors in XML{Reader,Writer} の翻訳 (#186)

php · Nov 23, 2024 · a2d89e1 · a2d89e1
1 parent 1bb4baf
commit a2d89e1
Show file tree

Hide file tree

Showing 6 changed files with 71 additions and 24 deletions.
diff --git a/appendices/migration80/incompatible.xml b/appendices/migration80/incompatible.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision: 351500 $ -->
-<!-- EN-Revision: 61374bbe228e8e9c55a24aba59a1e2bb2a871148 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: b94d63fc0884d83ba43433ab33cc4810d955bf6d Maintainer: mumumu Status: ready -->
 
 <sect1 xml:id="migration80.incompatible" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>下位互換性のない変更点</title>
@@ -1885,7 +1885,7 @@ echo file_get_contents('http://example.org', false, $ctx);
 
   <para>
    <methodname>XMLReader::open</methodname>,
-   <methodname>XMLReader::xml</methodname> が staticメソッドになりました。
+   <methodname>XMLReader::XML</methodname> が staticメソッドになりました。
    これらは、まだインスタンスメソッドとして呼び出すことが出来ますが、
    クラスを継承し、これらのメソッドをオーバーライドする場合は、
    それらは static として宣言する必要があります。

diff --git a/reference/xmlreader/xmlreader/close.xml b/reference/xmlreader/xmlreader/close.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: bad9acb50797346b072f9ff6addf05ee6c385570 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: b94d63fc0884d83ba43433ab33cc4810d955bf6d Maintainer: takagi Status: ready -->
 <refentry xml:id="xmlreader.close" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>XMLReader::close</refname>
@@ -31,7 +31,7 @@
   <para>
    <simplelist>
     <member><methodname>XMLReader::open</methodname></member>
-    <member><methodname>XMLReader::xml</methodname></member>
+    <member><methodname>XMLReader::XML</methodname></member>
    </simplelist>
   </para>
  </refsect1>

diff --git a/reference/xmlreader/xmlreader/open.xml b/reference/xmlreader/xmlreader/open.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 76875b513cc18a8f5db4a65f1ae51b6e6fb5374c Maintainer: takagi Status: ready -->
-<!-- Credits: mumumu -->
+<!-- EN-Revision: ca220fb756e8dd45398fcef20c493cdedd67ecb5 Maintainer: takagi Status: ready -->
+<!-- Credits: mumumu,jdkfx -->
 <refentry xml:id="xmlreader.open" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>XMLReader::open</refname>
@@ -71,12 +71,21 @@
 
  <refsect1 role="errors">
   &reftitle.errors;
-  <para>
-   このメソッドは、staticメソッドとしてコールすることが出来ます。
-   しかし、PHP 8.0.0 より前のバージョンでは、
-   staticメソッドとしてコールすると <constant>E_DEPRECATED</constant>
-   が発生していました。
-  </para>
+  <itemizedlist>
+   <listitem>
+    <simpara>
+     無効な <parameter>encoding</parameter> を指定すると、
+     <exceptionname>ValueError</exceptionname> がスローされます。
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara>
+     このメソッドは、staticメソッドとしてコールすることが出来ます。
+     しかし、PHP 8.0.0 より前のバージョンでは、
+     staticメソッドとしてコールすると <constant>E_DEPRECATED</constant> が発生していました。
+    </simpara>
+   </listitem>
+  </itemizedlist>
  </refsect1>
 
  <refsect1 role="changelog">
@@ -90,6 +99,13 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       無効な <parameter>encoding</parameter> を指定すると、
+       <exceptionname>ValueError</exceptionname> がスローされるようになりました。
+      </entry>
+     </row>
      <row>
       <entry>8.0.0</entry>
       <entry>
@@ -106,7 +122,7 @@
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><methodname>XMLReader::xml</methodname></member>
+    <member><methodname>XMLReader::XML</methodname></member>
     <member><methodname>XMLReader::close</methodname></member>
    </simplelist>
   </para>

diff --git a/reference/xmlreader/xmlreader/setparserproperty.xml b/reference/xmlreader/xmlreader/setparserproperty.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 4a742792da6fd1ba27acd118bfeeed326c8d9aaf Maintainer: takagi Status: ready -->
+<!-- EN-Revision: b94d63fc0884d83ba43433ab33cc4810d955bf6d Maintainer: takagi Status: ready -->
 <refentry xml:id="xmlreader.setparserproperty" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>XMLReader::setParserProperty</refname>
@@ -16,7 +16,7 @@
   <para>
    パーサのオプションを設定します。オプションは、
    <methodname>XMLReader::open</methodname> あるいは
-   <methodname>XMLReader::xml</methodname> がコールされた後で、かつ
+   <methodname>XMLReader::XML</methodname> がコールされた後で、かつ
    <methodname>XMLReader::read</methodname> が最初にコールされる前に
    設定する必要があります。
   </para>

diff --git a/reference/xmlreader/xmlreader/xml.xml b/reference/xmlreader/xmlreader/xml.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 76875b513cc18a8f5db4a65f1ae51b6e6fb5374c Maintainer: takagi Status: ready -->
-<!-- Credits: mumumu -->
+<!-- EN-Revision: ca220fb756e8dd45398fcef20c493cdedd67ecb5 Maintainer: takagi Status: ready -->
+<!-- Credits: mumumu,jdkfx -->
 <refentry xml:id="xmlreader.xml" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>XMLReader::XML</refname>
@@ -71,12 +71,21 @@
 
  <refsect1 role="errors">
   &reftitle.errors;
-  <para>
-   このメソッドは、staticメソッドとしてコールすることが出来ます。
-   しかし、PHP 8.0.0 より前のバージョンでは、
-   staticメソッドとしてコールすると <constant>E_DEPRECATED</constant>
-   が発生していました。
-  </para>
+  <itemizedlist>
+   <listitem>
+    <simpara>
+     無効な <parameter>encoding</parameter> を指定すると、
+     <exceptionname>ValueError</exceptionname> がスローされます。
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara>
+     このメソッドは、staticメソッドとしてコールすることが出来ます。
+     しかし、PHP 8.0.0 より前のバージョンでは、
+     staticメソッドとしてコールすると <constant>E_DEPRECATED</constant> が発生していました。
+    </simpara>
+   </listitem>
+  </itemizedlist>
  </refsect1>
 
  <refsect1 role="changelog">
@@ -90,6 +99,13 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       無効な <parameter>encoding</parameter> を指定すると、
+       <exceptionname>ValueError</exceptionname> がスローされるようになりました。
+      </entry>
+     </row>
      <row>
       <entry>8.0.0</entry>
       <entry>

diff --git a/reference/xmlwriter/xmlwriter/startdocument.xml b/reference/xmlwriter/xmlwriter/startdocument.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 4a742792da6fd1ba27acd118bfeeed326c8d9aaf Maintainer: takagi Status: ready -->
+<!-- EN-Revision: ca220fb756e8dd45398fcef20c493cdedd67ecb5 Maintainer: takagi Status: ready -->
 <!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
 <refentry xml:id="xmlwriter.startdocument" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -69,6 +69,14 @@
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   <parameter>encoding</parameter> に null バイトを含む値を指定すると、
+   <exceptionname>ValueError</exceptionname> がスローされます。
+  </simpara>
+ </refsect1>
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <informaltable>
@@ -80,6 +88,13 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       <parameter>encoding</parameter> に null バイトを含む値を指定すると、
+       <exceptionname>ValueError</exceptionname> がスローされるようになりました。
+      </entry>
+     </row>
      &xmlwriter.changelog.writer-param;
     </tbody>
    </tgroup>