doc-en と同期し FallbackResource や switch のセミコロン非推奨ほかを反映（6ファイル） (#410)

## 翻訳内容

### 独立ファイル

- install/unix/apache2.xml — FallbackResource についての注記を追加
  1. php/doc-en@a38e360ae1
- language/control-structures/switch.xml — switch 文のセミコロンの非推奨化と changelog を追加
  1. php/doc-en@d149b6ddca
- language/predefined/attributes/nodiscard.xml — インターフェイス・抽象・オーバーライドメソッドでの #[\NoDiscard] の挙動を追加
  1. php/doc-en@e7f89579e2
- language/operators.xml — ext/operator（オブジェクトの演算子オーバーロード）への誘導を追加
  1. php/doc-en@6043cd2541
- install/windows/index.xml — サードパーティ Windows ツール（XAMPP）の節を削除。あわせて install/windows/tools.xml を削除
  1. php/doc-en@838c897fc7
- language/predefined/error/getprevious.xml — 例のクラスを実在の Error サブクラス（TypeError）に変更
  1. php/doc-en@e565d17dc8

Author: KentarouTakeda

install/unix/apache2.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: e51792efe0f103ec8724ad199524d7543610c978 Maintainer: haruki Status: ready -->
+<!-- EN-Revision: a38e360ae1ce4169b331013958c519d17f19114e Maintainer: haruki Status: ready -->
 <!-- Credits: hirokawa, haruki -->
 <sect1 xml:id="install.unix.apache2" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Apache 2.x (Unixシステム用)</title>
@@ -268,6 +268,34 @@ LoadModule php7_module modules/libphp7.so
     </programlisting>
    </informalexample>
 
+   <simpara>
+    他にハンドラが見つからないときのデフォルトのハンドラとして PHP ファイルを使いたい場合
+    （ルーティングエンジンを使うときなど）は、<literal>FallbackResource</literal> ディレクティブが使えます。
+    このディレクティブは Apache 2.4.4 以降で使用できます。
+   </simpara>
+
+   <simpara>
+    <literal>SetHandler</literal> ディレクティブはファイルが存在するかどうかにかかわらず適用され、
+    <literal>FallbackResource</literal> はハンドラがまだ設定されていない場合にのみ適用されます。
+    そのため、ファイルが存在する場合にのみハンドラが適用されるようにするには、
+    <literal>If</literal> ディレクティブを使う必要があるかもしれません。
+    こうすることで、<literal>.php</literal> で終わるものの、実際にはファイルが存在しないパスを
+    <literal>FallbackResource</literal> で処理できるようになります。これは、エラー処理やルーティングに便利でしょう。
+   </simpara>
+
+   <informalexample>
+    <programlisting role="apache-conf">
+<![CDATA[
+<FilesMatch "\.php$">
+    <If "-f %{REQUEST_FILENAME}">
+        SetHandler application/x-httpd-php
+    </If>
+</FilesMatch>
+FallbackResource /index.php
+]]>
+    </programlisting>
+   </informalexample>
+
    <para>
     <literal>mod_rewrite</literal> を使うと、<literal>.php</literal> ファイルに名前を変えたりコピーしたりしなくても
     任意の <literal>.phps</literal> ファイルを構文ハイライトつきのソースコードとして表示させることができます。

install/windows/index.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 2dbf3d9064d4cb07f0a2f7d06641c877a2e5ed24 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 838c897fc7d0c50689a748ae4a59baebfe99920b Maintainer: mumumu Status: ready -->
 <chapter xml:id="install.windows" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Windows システムへのインストール</title>
 
@@ -28,7 +28,6 @@
  &install.windows.manual;
  &install.windows.apache2;
  &install.windows.iis;
- &install.windows.tools;
  &install.windows.building;
  &install.windows.commandline;
 </chapter>

install/windows/tools.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: cdc9d28d334bbc08386fecf8aade66080004a9dd Maintainer: takagi Status: ready -->
+<!-- EN-Revision: d149b6ddca64beb9de38cbd4bfd8d19d3bd0b60e Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 
 <sect1 xml:id="control-structures.switch" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -293,8 +293,32 @@ switch($beer)
 ]]>
    </programlisting>
   </informalexample>
+  &warn.deprecated.feature-8-5-0;
  </para>
 
+
+ <sect2 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.5.0</entry>
+      <entry>
+       <literal>case</literal> のあとにセミコロンを使う別の構文は、非推奨になりました。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </sect2>
+
  <sect2 role="seealso">
   &reftitle.seealso;
   <para>

language/control-structures/switch.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 2946c8a267734a9e8696e1764f7436e6caa8909c Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 6043cd25418a3c45c64a4af118ee939c1835251b Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa,mumumu -->
 <chapter xml:id="language.operators" xmlns="http://docbook.org/ns/docbook" annotations="interactive">
  <title>演算子</title>
@@ -29,6 +29,11 @@
   の欄にあります。この節では演算子の優先順位と結合性について説明します。
   複数の演算子を組み合わせたときにどう評価されるのかは、優先順位と結合性で決まります。
  </para>
+ <simpara>
+  オブジェクトに対して一部の演算子をオーバーロードできる PECL 拡張モジュールがあります。
+  詳細は <link linkend="book.operator">オブジェクトの演算子オーバーロード</link>
+  の節を参照ください。
+ </simpara>
 
  &language.operators.precedence;
  &language.operators.arithmetic;

language/operators.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 30bda33771e1c8fa8fc8a5ee7559fd7fa189caa0 Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: e7f89579e2abcecad5a62dd96f11a4926df62e13 Maintainer: KentarouTakeda Status: ready -->
 <reference xml:id="class.nodiscard" 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>NoDiscard アトリビュート</title>
  <titleabbrev>NoDiscard</titleabbrev>
@@ -29,6 +29,18 @@
      警告を抑制するには、<code>$_</code> のような変数を使うことを検討してください。
     </simpara>
    </note>
+   <note>
+    <simpara>
+     <code>#[\NoDiscard]</code> は、このアトリビュートが記述された個々の関数やメソッドの宣言にのみ適用されます。
+     警告が発生するかどうかは、実際に呼び出された関数やメソッドの宣言によって決まります。
+     そのため、インターフェイスのメソッドや抽象メソッドに <code>#[\NoDiscard]</code>
+     を追加しても、警告は発生しません。呼び出されるのは、それを実装またはオーバーライドしたメソッドだからです。
+     同様に、<code>#[\NoDiscard]</code> が付いたメソッドをオーバーライドした場合、
+     オーバーライドする側のメソッドにアトリビュートを付けない限り、警告は発生しません。
+     一方、トレイトからインポートされたメソッドはアトリビュートを保持します。
+     トレイトのメソッドは、トレイトを使うクラスに、そのクラスで宣言されたかのようにコピーされるからです。
+    </simpara>
+   </note>
   </section>
 
   <section xml:id="nodiscard.synopsis">

language/predefined/attributes/nodiscard.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 09c49da6f0167fcdfe53a76e3ea28ecfc0eb337b Maintainer: iwamot Status: ready -->
+<!-- EN-Revision: e565d17dc87b0c5946ea603fbcfb1777316fb6fc Maintainer: iwamot Status: ready -->
 <refentry xml:id="error.getprevious" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Error::getPrevious</refname>
@@ -46,7 +46,7 @@ class MyCustomError extends Error {}
 
 function doStuff() {
     try {
-        throw new InvalidArgumentError("You are doing it wrong!", 112);
+        throw new TypeError("You are doing it wrong!", 112);
     } catch(Error $e) {
         throw new MyCustomError("Something happened", 911, $e);
     }
@@ -67,7 +67,7 @@ try {
     <screen>
 <![CDATA[
 /home/bjori/ex.php:8 Something happened (911) [MyCustomError]
-/home/bjori/ex.php:6 You are doing it wrong! (112) [InvalidArgumentError]
+/home/bjori/ex.php:6 You are doing it wrong! (112) [TypeError]
 ]]>
     </screen>
    </example>