Skip to content

Commit a2d89e1

Browse files
authored
Document new errors in XML{Reader,Writer} の翻訳 (#186)
1 parent 1bb4baf commit a2d89e1

File tree

6 files changed

+71
-24
lines changed

6 files changed

+71
-24
lines changed

appendices/migration80/incompatible.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision: 351500 $ -->
3-
<!-- EN-Revision: 61374bbe228e8e9c55a24aba59a1e2bb2a871148 Maintainer: mumumu Status: ready -->
3+
<!-- EN-Revision: b94d63fc0884d83ba43433ab33cc4810d955bf6d Maintainer: mumumu Status: ready -->
44

55
<sect1 xml:id="migration80.incompatible" xmlns:xlink="http://www.w3.org/1999/xlink">
66
<title>下位互換性のない変更点</title>
@@ -1885,7 +1885,7 @@ echo file_get_contents('http://example.org', false, $ctx);
18851885

18861886
<para>
18871887
<methodname>XMLReader::open</methodname>,
1888-
<methodname>XMLReader::xml</methodname> が staticメソッドになりました。
1888+
<methodname>XMLReader::XML</methodname> が staticメソッドになりました。
18891889
これらは、まだインスタンスメソッドとして呼び出すことが出来ますが、
18901890
クラスを継承し、これらのメソッドをオーバーライドする場合は、
18911891
それらは static として宣言する必要があります。

reference/xmlreader/xmlreader/close.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: bad9acb50797346b072f9ff6addf05ee6c385570 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: b94d63fc0884d83ba43433ab33cc4810d955bf6d Maintainer: takagi Status: ready -->
44
<refentry xml:id="xmlreader.close" xmlns="http://docbook.org/ns/docbook">
55
<refnamediv>
66
<refname>XMLReader::close</refname>
@@ -31,7 +31,7 @@
3131
<para>
3232
<simplelist>
3333
<member><methodname>XMLReader::open</methodname></member>
34-
<member><methodname>XMLReader::xml</methodname></member>
34+
<member><methodname>XMLReader::XML</methodname></member>
3535
</simplelist>
3636
</para>
3737
</refsect1>

reference/xmlreader/xmlreader/open.xml

Lines changed: 25 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 76875b513cc18a8f5db4a65f1ae51b6e6fb5374c Maintainer: takagi Status: ready -->
4-
<!-- Credits: mumumu -->
3+
<!-- EN-Revision: ca220fb756e8dd45398fcef20c493cdedd67ecb5 Maintainer: takagi Status: ready -->
4+
<!-- Credits: mumumu,jdkfx -->
55
<refentry xml:id="xmlreader.open" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
77
<refname>XMLReader::open</refname>
@@ -71,12 +71,21 @@
7171

7272
<refsect1 role="errors">
7373
&reftitle.errors;
74-
<para>
75-
このメソッドは、staticメソッドとしてコールすることが出来ます。
76-
しかし、PHP 8.0.0 より前のバージョンでは、
77-
staticメソッドとしてコールすると <constant>E_DEPRECATED</constant>
78-
が発生していました。
79-
</para>
74+
<itemizedlist>
75+
<listitem>
76+
<simpara>
77+
無効な <parameter>encoding</parameter> を指定すると、
78+
<exceptionname>ValueError</exceptionname> がスローされます。
79+
</simpara>
80+
</listitem>
81+
<listitem>
82+
<simpara>
83+
このメソッドは、staticメソッドとしてコールすることが出来ます。
84+
しかし、PHP 8.0.0 より前のバージョンでは、
85+
staticメソッドとしてコールすると <constant>E_DEPRECATED</constant> が発生していました。
86+
</simpara>
87+
</listitem>
88+
</itemizedlist>
8089
</refsect1>
8190

8291
<refsect1 role="changelog">
@@ -90,6 +99,13 @@
9099
</row>
91100
</thead>
92101
<tbody>
102+
<row>
103+
<entry>8.4.0</entry>
104+
<entry>
105+
無効な <parameter>encoding</parameter> を指定すると、
106+
<exceptionname>ValueError</exceptionname> がスローされるようになりました。
107+
</entry>
108+
</row>
93109
<row>
94110
<entry>8.0.0</entry>
95111
<entry>
@@ -106,7 +122,7 @@
106122
&reftitle.seealso;
107123
<para>
108124
<simplelist>
109-
<member><methodname>XMLReader::xml</methodname></member>
125+
<member><methodname>XMLReader::XML</methodname></member>
110126
<member><methodname>XMLReader::close</methodname></member>
111127
</simplelist>
112128
</para>

reference/xmlreader/xmlreader/setparserproperty.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 4a742792da6fd1ba27acd118bfeeed326c8d9aaf Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: b94d63fc0884d83ba43433ab33cc4810d955bf6d Maintainer: takagi Status: ready -->
44
<refentry xml:id="xmlreader.setparserproperty" xmlns="http://docbook.org/ns/docbook">
55
<refnamediv>
66
<refname>XMLReader::setParserProperty</refname>
@@ -16,7 +16,7 @@
1616
<para>
1717
パーサのオプションを設定します。オプションは、
1818
<methodname>XMLReader::open</methodname> あるいは
19-
<methodname>XMLReader::xml</methodname> がコールされた後で、かつ
19+
<methodname>XMLReader::XML</methodname> がコールされた後で、かつ
2020
<methodname>XMLReader::read</methodname> が最初にコールされる前に
2121
設定する必要があります。
2222
</para>

reference/xmlreader/xmlreader/xml.xml

Lines changed: 24 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 76875b513cc18a8f5db4a65f1ae51b6e6fb5374c Maintainer: takagi Status: ready -->
4-
<!-- Credits: mumumu -->
3+
<!-- EN-Revision: ca220fb756e8dd45398fcef20c493cdedd67ecb5 Maintainer: takagi Status: ready -->
4+
<!-- Credits: mumumu,jdkfx -->
55
<refentry xml:id="xmlreader.xml" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
77
<refname>XMLReader::XML</refname>
@@ -71,12 +71,21 @@
7171

7272
<refsect1 role="errors">
7373
&reftitle.errors;
74-
<para>
75-
このメソッドは、staticメソッドとしてコールすることが出来ます。
76-
しかし、PHP 8.0.0 より前のバージョンでは、
77-
staticメソッドとしてコールすると <constant>E_DEPRECATED</constant>
78-
が発生していました。
79-
</para>
74+
<itemizedlist>
75+
<listitem>
76+
<simpara>
77+
無効な <parameter>encoding</parameter> を指定すると、
78+
<exceptionname>ValueError</exceptionname> がスローされます。
79+
</simpara>
80+
</listitem>
81+
<listitem>
82+
<simpara>
83+
このメソッドは、staticメソッドとしてコールすることが出来ます。
84+
しかし、PHP 8.0.0 より前のバージョンでは、
85+
staticメソッドとしてコールすると <constant>E_DEPRECATED</constant> が発生していました。
86+
</simpara>
87+
</listitem>
88+
</itemizedlist>
8089
</refsect1>
8190

8291
<refsect1 role="changelog">
@@ -90,6 +99,13 @@
9099
</row>
91100
</thead>
92101
<tbody>
102+
<row>
103+
<entry>8.4.0</entry>
104+
<entry>
105+
無効な <parameter>encoding</parameter> を指定すると、
106+
<exceptionname>ValueError</exceptionname> がスローされるようになりました。
107+
</entry>
108+
</row>
93109
<row>
94110
<entry>8.0.0</entry>
95111
<entry>

reference/xmlwriter/xmlwriter/startdocument.xml

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 4a742792da6fd1ba27acd118bfeeed326c8d9aaf Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: ca220fb756e8dd45398fcef20c493cdedd67ecb5 Maintainer: takagi Status: ready -->
44
<!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
55
<refentry xml:id="xmlwriter.startdocument" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -69,6 +69,14 @@
6969
</para>
7070
</refsect1>
7171

72+
<refsect1 role="errors">
73+
&reftitle.errors;
74+
<simpara>
75+
<parameter>encoding</parameter> に null バイトを含む値を指定すると、
76+
<exceptionname>ValueError</exceptionname> がスローされます。
77+
</simpara>
78+
</refsect1>
79+
7280
<refsect1 role="changelog">
7381
&reftitle.changelog;
7482
<informaltable>
@@ -80,6 +88,13 @@
8088
</row>
8189
</thead>
8290
<tbody>
91+
<row>
92+
<entry>8.4.0</entry>
93+
<entry>
94+
<parameter>encoding</parameter> に null バイトを含む値を指定すると、
95+
<exceptionname>ValueError</exceptionname> がスローされるようになりました。
96+
</entry>
97+
</row>
8398
&xmlwriter.changelog.writer-param;
8499
</tbody>
85100
</tgroup>

0 commit comments

Comments
 (0)