Use modern markup for E_* constants を取り込み: 内容を更新 (#4056)

Author: nsfisis

reference/errorfunc/constants.xml

@@ -7,23 +7,29 @@
  &extension.constants.core;
 
  <simpara>
-  上記の値（数値も論理値も）はどのエラーをレポートするかを指定する
-  ビットマスクを組み立てる。<link linkend="language.operators.bitwise">ビット演算子</link>
-  を使用して値を組み合わせたり特定のエラータイプをマスクすることができる。
+  以下の定数 (対応する数値またはそのシンボル名) は、
+  どのエラーを報告するかを指定するビットマスクとして使用します。
+  <link linkend="language.operators.bitwise">ビット演算子</link>
+  を使用して、値を組み合わせたり特定のエラータイプを除外したりできます。
  </simpara>
 
  <tip>
   <simpara>
-   &php.ini; では'|', '~', '!', '^' および '&amp;'のみが解釈されることに
-   注意すべきである。
+   &php.ini; では、対応する生の数値の代わりに定数名を使うことができます。
+   ただし、&php.ini; では
+   <literal>|</literal>、
+   <literal>~</literal>、
+   <literal>^</literal>、
+   <literal>!</literal>、
+   <literal>&amp;</literal>
+   の演算子のみが解釈されます。
   </simpara>
  </tip>
 
  <warning>
   <simpara>
-   以下の定数を&php.ini;で使用することができますが、
-   <filename>httpd.conf</filename>のようなPHPの外部では、
-   代わりにビットマスク値を使用する必要があります。
+   PHP の外部では、シンボル名を使うことはできません。
+   例えば、&httpd.conf; の中では計算済みのビットマスク値を代わりに使わなければなりません。
   </simpara>
  </warning>
 
@@ -35,11 +41,12 @@
    </term>
    <listitem>
     <simpara>
-     重大な実行時エラー。これは、メモリ確保に関する問題のように復帰で
-     きないエラーを示します。スクリプトの実行は中断されます。
+     重大な実行時エラー。
+     これは、メモリ確保の問題といった復帰できないエラーを表します。
+     スクリプトの実行は中断されます。
     </simpara>
     <simpara>
-     <literal>1</literal>
+     定数の値：<literal>1</literal>
     </simpara>
    </listitem>
   </varlistentry>
@@ -51,11 +58,11 @@
    </term>
    <listitem>
     <simpara>
-     実行時の警告 (致命的なエラーではない)。スクリプトの実行は中断さ
-     れません。
+     実行時の警告 (致命的でないエラー)。
+     スクリプトの実行は中断されません。
     </simpara>
     <simpara>
-     <literal>2</literal>
+     定数の値：<literal>2</literal>
     </simpara>
    </listitem>
   </varlistentry>
@@ -67,10 +74,11 @@
    </term>
    <listitem>
     <simpara>
-     コンパイル時のパースエラー。パースエラーはパーサでのみ生成されま
+     コンパイル時のパースエラー。
+     パースエラーはパーサでのみ生成されます。
     </simpara>
     <simpara>
-     <literal>4</literal>
+     定数の値：<literal>4</literal>
     </simpara>
    </listitem>
   </varlistentry>
@@ -82,11 +90,12 @@
    </term>
    <listitem>
     <simpara>
-     実行時の警告。エラーを発しうる状況に遭遇したことを示す。
-     ただし通常のスクリプト実行の場合にもこの警告を発することがありうる。
+     実行時の注意。
+     エラーを示しているかもしれない何かに遭遇したことを表します。
+     ただし、スクリプトを問題なく実行しているときに起こることもあります。
     </simpara>
     <simpara>
-     <literal>8</literal>
+     定数の値：<literal>8</literal>
     </simpara>
    </listitem>
   </varlistentry>
@@ -98,11 +107,12 @@
    </term>
    <listitem>
     <simpara>
-     PHPの初期始動時点での致命的なエラー。<constant>E_ERROR</constant>に
-     似ているがPHPのコアによって発行される点が違う。
+     PHP の初期始動時点で発生した致命的なエラー。
+     <constant>E_ERROR</constant> に似ていますが、
+     PHP のコアによって生成される点が異なります。
     </simpara>
     <simpara>
-     <literal>16</literal>
+     定数の値：<literal>16</literal>
     </simpara>
    </listitem>
   </varlistentry>
@@ -114,12 +124,12 @@
    </term>
    <listitem>
     <simpara>
-     （致命的ではない）警告。PHPの初期始動時に発生する。
-     <constant>E_WARNING</constant>に似ているがPHPのコアによって発行される
-     点が違う。
+     PHP の初期始動時点で発生した (致命的でない) 警告。
+     <constant>E_WARNING</constant> に似ていますが、
+     PHP のコアによって生成される点が異なります。
     </simpara>
     <simpara>
-     <literal>32</literal>
+     定数の値：<literal>32</literal>
     </simpara>
    </listitem>
   </varlistentry>
@@ -131,11 +141,12 @@
    </term>
    <listitem>
     <simpara>
-     コンパイル時の致命的なエラー。<constant>E_ERROR</constant>に
-     似ているがZendスクリプティングエンジンによって発行される点が違う。
+     コンパイル時の致命的なエラー。
+     <constant>E_ERROR</constant>に似ていますが、
+     Zend スクリプティングエンジンによって生成される点が異なります。
     </simpara>
     <simpara>
-     <literal>64</literal>
+     定数の値：<literal>64</literal>
     </simpara>
    </listitem>
   </varlistentry>
@@ -147,11 +158,12 @@
    </term>
    <listitem>
     <simpara>
-     コンパイル時の警告（致命的ではない）。<constant>E_WARNING</constant>に
-     似ているがZendスクリプティングエンジンによって発行される点が違う。
+     コンパイル時の (致命的でない) 警告。
+     <constant>E_WARNING</constant>に似ていますが、
+     Zend スクリプティングエンジンによって生成される点が異なります。
     </simpara>
     <simpara>
-     <literal>128</literal>
+     定数の値：<literal>128</literal>
     </simpara>
    </listitem>
   </varlistentry>
@@ -163,11 +175,12 @@
    </term>
    <listitem>
     <simpara>
-     実行時の注意。これを有効にすると、
-     将来のバージョンで動作しなくなるコードについての警告を受け取ることができる。
+     実行時の非推奨の注意。
+     これを有効にすると、将来のバージョンで
+     動作しなくなるコードについての警告を受け取ることができます。
     </simpara>
     <simpara>
-     <literal>8192</literal>
+     定数の値：<literal>8192</literal>
     </simpara>
    </listitem>
   </varlistentry>
@@ -179,13 +192,22 @@
    </term>
    <listitem>
     <simpara>
-     ユーザーによって発行されるエラーメッセージ。<constant>E_ERROR</constant>
-     に似ているがPHPコード上で<function>trigger_error</function>関数を
-     使用した場合に発行される点が違う。
+     ユーザーによって生成されるエラーメッセージ。
+     <constant>E_ERROR</constant> に似ていますが、
+     <function>trigger_error</function> 関数を用いて PHP コード上で
+     生成される点が異なります。
     </simpara>
     <simpara>
-     <literal>256</literal>
+     定数の値：<literal>256</literal>
     </simpara>
+    <warning>
+     <simpara>
+      この定数を <function>trigger_error</function> と使うのは
+      PHP 8.4.0 で非推奨となりました。
+      代わりに、<exceptionname>Exception</exceptionname> を &throw; するか、
+      <function>exit</function> を呼ぶことが推奨されます。
+     </simpara>
+    </warning>
    </listitem>
   </varlistentry>
 
@@ -196,12 +218,13 @@
    </term>
    <listitem>
     <simpara>
-     ユーザーによって発行される警告メッセージ。<constant>E_WARNING</constant>
-     に似ているがPHPコード上で<function>trigger_error</function>関数を
-     使用した場合に発行される点が違う。
+     ユーザーによって生成される警告メッセージ。
+     <constant>E_WARNING</constant> に似ていますが、
+     <function>trigger_error</function> 関数を用いて PHP コード上で
+     生成される点が異なります。
     </simpara>
     <simpara>
-     <literal>512</literal>
+     定数の値：<literal>512</literal>
     </simpara>
    </listitem>
   </varlistentry>
@@ -213,12 +236,13 @@
    </term>
    <listitem>
     <simpara>
-     ユーザーによって発行される注意メッセージ。<constant>E_NOTICE</constant>に
-     に似ているがPHPコード上で<function>trigger_error</function>関数を
-     使用した場合に発行される点が違う。
+     ユーザーによって生成される注意メッセージ。
+     <constant>E_NOTICE</constant> に似ていますが、
+     <function>trigger_error</function> 関数を用いて PHP コード上で
+     生成される点が異なります。
     </simpara>
     <simpara>
-     <literal>1024</literal>
+     定数の値：<literal>1024</literal>
     </simpara>
    </listitem>
   </varlistentry>
@@ -230,13 +254,13 @@
    </term>
    <listitem>
     <simpara>
-     ユーザー定義の警告メッセージ。これは
-     <constant>E_DEPRECATED</constant> と同等だが、
-     PHP のコード上で関数 <function>trigger_error</function>
-     によって作成されるという点が異なる。
+     ユーザーによって生成される非推奨メッセージ。
+     <constant>E_DEPRECATED</constant> に似ていますが、
+     <function>trigger_error</function> 関数を用いて PHP コード上で
+     生成される点が異なります。
     </simpara>
     <simpara>
-     <literal>16384</literal>
+     定数の値：<literal>16384</literal>
     </simpara>
    </listitem>
   </varlistentry>
@@ -248,12 +272,18 @@
    </term>
    <listitem>
     <simpara>
-     コードの相互運用性や互換性を維持するために
-     PHP がコードの変更を提案する。
+     PHP が実行時に発行する提案。
+     コードの前方互換性を担保するために、実行中のコードについて改善が提案されます。
     </simpara>
     <simpara>
-     <literal>2048</literal>
+     定数の値：<literal>2048</literal>
     </simpara>
+    <warning>
+     <simpara>
+      このエラーレベルは使われておらず、
+      PHP 8.4.0 で非推奨となりました。
+     </simpara>
+    </warning>
    </listitem>
   </varlistentry>
 
@@ -264,15 +294,25 @@
    </term>
    <listitem>
     <simpara>
-     キャッチできる致命的なエラー。危険なエラーが発生したが、
-     エンジンが不安定な状態になるほどではないことを表す。
-     ユーザー定義のハンドラでエラーがキャッチされなかった場合
-     (<function>set_error_handler</function> も参照ください) は、
-     <constant>E_ERROR</constant> として異常終了する。
-    </simpara>
-    <simpara>
-     <literal>4096</literal>
-    </simpara>
+     キャッチできる致命的なエラーに相当する従来のエンジン「例外」(訳注: この文脈での括弧付きの「例外」は、<exceptionname>Error</exceptionname> が登場するより前に用いられていた例外の「ような」仕組みを指したものです)。
+     <exceptionname>Error</exceptionname> に似ていますが、
+     ユーザー定義のエラーハンドラー (<function>set_error_handler</function> を参照のこと) によってキャッチしなければなりません。
+     キャッチされなかった場合、<constant>E_ERROR</constant> と同様にスクリプトの実行を中断します。
+    </simpara>
+    <simpara>
+     定数の値：<literal>4096</literal>
+    </simpara>
+    <note>
+     <simpara>
+      このエラーレベルは実質的に使われていません。
+      唯一発生しうるのは、&object; を <type>bool</type> として解釈するのに失敗したときだけです。
+      これは、内部的なオブジェクトでしか起こりえません。
+     </simpara>
+     <simpara>
+      PHP 8.4.0 より前のバージョンにおける最もよくある例としては、
+      <classname>GMP</classname> インスタンスを条件式で使ったときです。
+     </simpara>
+    </note>
    </listitem>
   </varlistentry>
 
@@ -283,10 +323,10 @@
    </term>
    <listitem>
     <simpara>
-     全てのエラーと警告。
+     すべてのエラー、警告、注意を含んだビットマスク。
     </simpara>
     <simpara>
-     <literal>32767</literal>
+     定数の値：<literal>32767</literal>
     </simpara>
    </listitem>
   </varlistentry>