エラーと例外のページを原文の変更に追従 (7ファイル)

language/control-structures/finally.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 7c915c0c28b8e2e4306333c64602ee4800c73754 Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 31d9f67dd1a2574dd870a2dc2ccacbed75d2ce36 Maintainer: KentarouTakeda Status: ready -->
 <sect1 xml:id="control-structures.finally" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>finally</title>
  <?phpdoc print-version-for="finally"?>
@@ -29,15 +29,15 @@ function inverse($x) {
 try {
     echo inverse(5) . "\n";
 } catch (\DivisionByZeroError $e) {
-    echo 'Caught error: ',  $e->getMessage(), "\n";
+    echo 'Caught error: ', $e->getMessage(), "\n";
 } finally {
     echo "First finally.\n";
 }
 
 try {
     echo inverse(0) . "\n";
 } catch (\DivisionByZeroError $e) {
-    echo 'Caught error: ',  $e->getMessage(), "\n";
+    echo 'Caught error: ', $e->getMessage(), "\n";
 } finally {
     echo "Second finally.\n";
 }
@@ -248,7 +248,7 @@ function generate()
     try {
         yield 1;
         yield 2;
-    } catch(\Exception $e) {
+    } catch (\Exception $e) {
         echo 'catch';
     } finally {
         echo "finally\n";
@@ -260,7 +260,7 @@ try {
         echo $i, "\n";
         throw new Exception();
     }
-} catch(Exception $e) {
+} catch (Exception $e) {
     echo 'outer catch';
 }
 ]]>
@@ -294,7 +294,7 @@ function generate()
     try {
         yield 1;
         yield 2;
-    } catch(\Exception $e) {
+    } catch (\Exception $e) {
         echo 'catch';
     } finally {
         echo "finally\n";
@@ -307,7 +307,7 @@ try {
         echo $i, "\n";
         throw new Exception();
     }
-} catch(Exception $e) {
+} catch (Exception $e) {
     echo 'outer catch';
 }
 ]]>
@@ -407,7 +407,7 @@ quit
 
   <simpara>
    &finally; ブロックの中で <function>exit</function> を呼び出すと、
-   その外側にある他の &finally; ブロックはすべてスキップされます。
+   その外側にある &finally; ブロックはすべてスキップされます。
   </simpara>
   <example>
    <title><function>exit</function> を呼び出して外側の &finally; ブロックをスキップする</title>
@@ -450,7 +450,7 @@ function generate()
     try {
         yield 1;
         yield 2;
-    } catch(\Exception $e) {
+    } catch (\Exception $e) {
         echo 'catch';
     } finally {
         echo "inner finally\n";

language/control-structures/match.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: e674990649cd2b111b8dd1175a7a1befcc621635 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: f0aab5b5f496704a2c21e4960c9f620e19f6d3c4 Maintainer: mumumu Status: ready -->
 
 <sect1 xml:id="control-structures.match" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>match</title>
@@ -208,7 +208,7 @@ try {
         1, 2 => foo(),
         3, 4 => bar(),
     };
-} catch (\UnhandledMatchError $e) {
+} catch (UnhandledMatchError $e) {
     var_dump($e);
 }
 ]]>

language/control-structures/throw.xml

@@ -1,17 +1,17 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 7c915c0c28b8e2e4306333c64602ee4800c73754 Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 31d9f67dd1a2574dd870a2dc2ccacbed75d2ce36 Maintainer: KentarouTakeda Status: ready -->
 <sect1 xml:id="control-structures.throw" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>throw</title>
  <?phpdoc print-version-for="throw"?>
  <simpara>
   &throw; キーワードは式であり、式を書ける場所ならどこでも使えます。
   引数として <exceptionname>Throwable</exceptionname>
-  のインスタンスを受け取ります。
+  オブジェクトを受け取ります。
  </simpara>
  <caution>
   <simpara>
-   PHP 8.0 より前のバージョンでは、&throw; キーワードは式ではなく文でした。
+   PHP 8.0.0 より前のバージョンでは、&throw; キーワードは式ではなく文でした。
   </simpara>
  </caution>
  <para>

language/control-structures/try-catch.xml

@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 7c915c0c28b8e2e4306333c64602ee4800c73754 Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 31d9f67dd1a2574dd870a2dc2ccacbed75d2ce36 Maintainer: KentarouTakeda Status: ready -->
 <sect1 xml:id="control-structures.try-catch" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <title>Try...Catch</title>
+ <title>try...catch</title>
  <sect2 xml:id="control-structures.try" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>try</title>
   <?phpdoc print-version-for="try"?>
@@ -180,9 +180,9 @@ class B extends Exception {}
 
 try {
     throw new A;
-} catch(A $e) {
+} catch (A $e) {
     throw new B;
-} catch(B) {
+} catch (B) {
     echo 'Hello';
 }
 

language/error-handling.xml

@@ -1,14 +1,14 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 7c915c0c28b8e2e4306333c64602ee4800c73754 Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 31d9f67dd1a2574dd870a2dc2ccacbed75d2ce36 Maintainer: KentarouTakeda Status: ready -->
 <chapter xml:id="language.error-handling" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="interactive">
  <title>エラー処理</title>
  <note>
   <simpara><exceptionname>Exception</exceptionname> クラスも参照ください</simpara>
  </note>
  <simpara>
   エラーは、アプリケーションの開発やライフサイクルの中でごく普通に起こるものです。
-  そのため PHP には、エラーを通知したり、エラーに対処したりする方法が複数用意されています。
+  そのため PHP には、エラーを報告したり、エラーに対処したりする方法が複数用意されています。
  </simpara>
  <para>
   PHP がエラーを報告する仕組みには、主に次のふたつがあります。
@@ -81,7 +81,7 @@
   </warning>
 
   <sect2 xml:id="language.error-handling.throwable.user">
-   <title><literal>グローバルな例外ハンドラ</literal></title>
+   <title>グローバルな例外ハンドラ</title>
    <simpara>
     <function>set_exception_handler</function> を使うと、
     キャッチされないあらゆる <exceptionname>Throwable</exceptionname>
@@ -97,8 +97,6 @@
    <simpara>
     ユーザー定義の例外は、組み込みの <exceptionname>Exception</exceptionname>
     クラスを拡張して定義できます。
-    子クラスの中でアクセスできるメソッドやプロパティについては、
-    派生元である <exceptionname>Exception</exceptionname> クラスのページを参照ください。
    </simpara>
    <simpara>
     組み込みの <exceptionname>Exception</exceptionname> クラスを拡張したクラスで
@@ -222,7 +220,7 @@ A custom function for this type of exception
    さまざまな状況を知らせるために使われます。
    必要に応じて、画面に表示したりログに記録したりできます。
    デフォルトでは、PHP はすべての診断エラーを報告します。
-   (PHP 8.0 より前のバージョンでは、<constant>E_NOTICE</constant> と
+   (PHP 8.0.0 より前のバージョンでは、<constant>E_NOTICE</constant> と
    <constant>E_DEPRECATED</constant> の診断エラーはデフォルトでは報告されませんでした)
   </simpara>
   <simpara>
@@ -243,7 +241,7 @@ A custom function for this type of exception
     開発環境では常に、
     <link linkend="ini.error-reporting"><parameter>error_reporting</parameter></link>
     を <constant>E_ALL</constant> にしておくべきです。
-    PHP が発する報告をすべて確認して対応する必要があるからです。
+    PHP が発する報告にすべて気づいて対応できるようにするためです。
     一方、運用環境では、もう少しレベルを下げて
     <code>E_ALL &amp; ~E_NOTICE &amp; ~E_DEPRECATED</code> にすることもできますが、
     多くの場合は <constant>E_ALL</constant> のままでも適切です。
@@ -301,8 +299,8 @@ A custom function for this type of exception
     などの一部の診断エラーは、この方法では処理できません
     (完全な一覧は <function>set_error_handler</function> を参照ください)。
     それ以外の診断エラーは、さまざまな方法で処理できます。
-    たとえば、ユーザーにはカスタムエラーページを表示しつつ、
-    メールの送信など、ログよりも直接的な方法で報告するといった使い方ができます。
+    たとえば、独自のハンドラで、ユーザーにはエラーページを表示しつつ、
+    メールの送信など、ログよりも直接的な方法でエラーを報告できます。
    </simpara>
 
    <simpara>
@@ -317,7 +315,7 @@ A custom function for this type of exception
 <?php
 function exceptions_error_handler($severity, $message, $filename, $lineno) {
     if (error_reporting() & $severity) {
-       throw new ErrorException($message, 0, $severity, $filename, $lineno);
+        throw new ErrorException($message, 0, $severity, $filename, $lineno);
     }
 }
 

language/predefined/error.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 603435cd84951fc720eded819c62ef2466d21b5c Maintainer: takagi Status: ready -->
+<!-- EN-Revision: c4f95a6974306cf162dd4a6c89162cb310429762 Maintainer: takagi Status: ready -->
 <reference xml:id="class.error" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>Error</title>
  <titleabbrev>Error</titleabbrev>
@@ -9,10 +9,12 @@
 
   <section xml:id="error.intro">
    &reftitle.intro;
-   <para>
+   <simpara>
     <ooclass><classname>Error</classname></ooclass>
-    は、PHP のすべての内部エラーの基底クラスです。
-   </para>
+    は、プログラミング上の誤りを示すエラーの基底クラスです。
+    こうしたエラーは一般に、通常の動作中に処理するのではなく、
+    プログラムを修正して対処する必要があります。
+   </simpara>
   </section>
 
   <section xml:id="error.synopsis">

language/predefined/exception.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 603435cd84951fc720eded819c62ef2466d21b5c Maintainer: takagi Status: ready -->
+<!-- EN-Revision: c4f95a6974306cf162dd4a6c89162cb310429762 Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 <reference xml:id="class.exception" role="exception" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>Exception</title>
@@ -10,10 +10,10 @@
 
   <section xml:id="exception.intro">
    &reftitle.intro;
-   <para>
+   <simpara>
     <ooclass><classname>Exception</classname></ooclass> は、
-    すべてのユーザー例外の基底クラスです。
-   </para>
+    通常の動作中に処理できる例外の基底クラスです。
+   </simpara>
   </section>
 
   <section xml:id="exception.synopsis">