Apply suggestions from code review part II.

Author: mumumu

appendices/migration85/deprecated.xml

@@ -435,7 +435,7 @@
   <title>Reflection</title>
 
   <simpara>
-   リフレクション関連の様々な setAccessible() メソッドは、
+   リフレクション関連の様々な <code>setAccessible()</code> メソッドは、
    推奨されなくなりました。
    使っても効果がないためです。
    <!-- RFC: https://wiki.php.net/rfc/deprecations_php_8_5#deprecate_reflectionsetaccessible -->

appendices/migration85/incompatible.xml

@@ -197,7 +197,7 @@
    <classname>Dom\HTMLCollection</classname>,
    <classname>Dom\DtdNamedNodeMap</classname> を clone すると、
    失敗するようになりました。
-   現在動いているオブジェクトが、実際に失敗することはありません。
+   この変更で、動作しているオブジェクトが実際に失敗することはありません。
    よって、実際の影響はゼロのはずです。
   </simpara>
 
@@ -237,116 +237,116 @@
  <sect2 xml:id="migration85.incompatible.ldap">
   <title>LDAP</title>
 
-  <para>
+  <simpara>
    不正なオプションを渡した場合、
    <function>ldap_get_option</function>
    と <function>ldap_set_option</function> は
    <exceptionname>ValueError</exceptionname>
    をスローするようになりました。
-  </para>
+  </simpara>
 
  </sect2>
 
  <sect2 xml:id="migration85.incompatible.mbstring">
   <title>MBString</title>
 
-  <para>
+  <simpara>
    Unicode データテーブルが、Unicode 17.0 に更新されました。
-  </para>
+  </simpara>
 
  </sect2>
 
  <sect2 xml:id="migration85.incompatible.mysqli">
   <title>MySQLi</title>
 
-  <para>
+  <simpara>
    既に構築済みのオブジェクトに対して、
    mysqli のコンストラクタをコールすることはできなくなりました。
    コールした場合、<exceptionname>Error</exceptionname> がスローされます。
-  </para>
+  </simpara>
 
  </sect2>
 
  <sect2 xml:id="migration85.incompatible.odbc">
   <title>ODBC</title>
 
-  <para>
+  <simpara>
    ODBC は、最低でも ODBC 3.5 の機能が使えると想定するようになりました。
    ODBCVER の定義や、それを制御するビルドシステムフラグは削除されました。
-  </para>
+  </simpara>
 
-  <para>
+  <simpara>
    ODBC は、
    特定のドライバ向けにビルドするためのビルドフラグを(DB2以外に)
    持たなくなり、
    それらのドライバ向けの特別なケースも削除されました。
    Windows 以外の環境では、
    iODBC や unixODBC のようなドライバマネージャの使用を強く推奨します。
-  </para>
+  </simpara>
 
  </sect2>
 
  <sect2 xml:id="migration85.incompatible.opcache">
   <title>Opcache</title>
 
-  <para>
+  <simpara>
    Opcache 拡張モジュールは、
    常に PHP バイナリに組み込まれ、ロードされるようになりました。
    <link linkend="ini.opcache.enable">opcache.enable</link>
    と <link linkend="ini.opcache.enable-cli">opcache.enable_cli</link>
    の設定はまだ有効です。
-  </para>
+  </simpara>
 
-  <para>
+  <simpara>
    <option role="configure">--enable-opcache</option>/<option role="configure">--disable-opcache</option>
    configure オプションは削除され、
    ビルドしても <filename>opcache.so</filename>
    や <filename>php_opcache.dll</filename> はもはや生成されません。
-  </para>
+  </simpara>
 
-  <para>
+  <simpara>
    <literal>zend_extension=opcache.so</literal> や
    <literal>zend_extension=php_opcache.dll</literal>
    INI 設定を使うと、警告が発生するようになりました。
-  </para>
+  </simpara>
 
  </sect2>
 
  <sect2 xml:id="migration85.incompatible.pcntl">
   <title>PCNTL</title>
 
-  <para>
+  <simpara>
    <function>pcntl_exec</function> の
    <parameter>$args</parameter> パラメータのエントリに、
    null バイトが含まれていた場合、
    <exceptionname>ValueError</exceptionname> がスローされるようになりました。
-  </para>
+  </simpara>
 
-  <para>
+  <simpara>
    <function>pcntl_exec</function> の
    <parameter>$env_vars</parameter> パラメータのエントリまたはキーに、
    null バイトが含まれていた場合、
    <exceptionname>ValueError</exceptionname> がスローされるようになりました。
-  </para>
+  </simpara>
 
  </sect2>
 
  <sect2 xml:id="migration85.incompatible.pcre">
   <title>PCRE</title>
 
-  <para>
+  <simpara>
    semi-deprecated 扱いになっていた、
    コンパイルオプション PCRE2_EXTRA_ALLOW_LOOKAROUND_BSK
    抜きでビルドされるようになりました。
    <!-- https://github.com/PCRE2Project/pcre2/issues/736#issuecomment-2754024651 -->
-  </para>
+  </simpara>
 
  </sect2>
 
  <sect2 xml:id="migration85.incompatible.pdo">
   <title>PDO</title>
 
-  <para>
+  <simpara>
    <constant>PDO::FETCH_CLASS</constant>
    と組み合わせて設定されるコンストラクタ引数は、
    通常の CUFA (<function>call_user_func_array</function>)
@@ -357,9 +357,9 @@
    通常の <constant>E_WARNING</constant> が発生するようになりました。
    コンストラクタ引数に変数をリファレンス渡しするには、
    配列の値にリファレンスの値を代入します: <code>$ctor_args = [&amp;$valByRef]</code>
-  </para>
+  </simpara>
 
-  <para>
+  <simpara>
    <methodname>PDO::fetch</methodname>,
    <methodname>PDO::fetchObject</methodname>,
    <methodname>PDO::fetchAll</methodname> の呼び出し中に、
@@ -369,74 +369,74 @@
    オブジェクトのフェッチ中に Statement
    オブジェクトをコンストラクタの引数として渡す際に、
    <methodname>PDOStatement::setFetchMode</methodname> を呼び出す場合が該当します。
-  </para>
+  </simpara>
 
-  <para>
+  <simpara>
    定数 <constant>PDO::FETCH_GROUP</constant>,
    <constant>PDO::FETCH_UNIQUE</constant>,
    <constant>PDO::FETCH_CLASSTYPE</constant>,
    <constant>PDO::FETCH_PROPS_LATE</constant>,
    <constant>PDO::FETCH_SERIALIZE</constant> の値が変更されました。
-  </para>
+  </simpara>
 
-  <para>
+  <simpara>
    <constant>PDO::FETCH_PROPS_LATE</constant>
    が <constant>PDO::FETCH_CLASS</constant>
    以外のフェッチモードと一緒に使われた場合、
    <exceptionname>ValueError</exceptionname> がスローされるようになりました。
    これは、他のフェッチフラグの動作と一貫性を持たせるためです。
-  </para>
+  </simpara>
 
-  <para>
+  <simpara>
    <methodname>PDO::fetchAll</methodname> で、
    <constant>PDO::FETCH_INTO</constant> をフェッチモードとして使おうとすると、
    <constant>PDO::FETCH_LAZY</constant>
    と同様に <exceptionname>ValueError</exceptionname> がスローされるようになりました。
-  </para>
+  </simpara>
 
  </sect2>
 
  <sect2 xml:id="migration85.incompatible.pdo-firebird">
   <title>PDO_FIREBIRD</title>
 
-  <para>
+  <simpara>
    Firebird ドライバが生成した <classname>PDOStatement</classname>
    に対して、長過ぎるカーソル名を設定しようとすると、
    <exceptionname>ValueError</exceptionname> がスローされるようになりました。
-  </para>
+  </simpara>
 
  </sect2>
 
  <sect2 xml:id="migration85.incompatible.session">
   <title>Session</title>
 
-  <para>
+  <simpara>
    パイプ文字 (<literal>|</literal>)
    が含まれたキーを持つ <varname>$_SESSION</varname>
    にセッションデータを書き込もうとすると、
    黙って失敗するのではなく、警告が発生するようになりました。
    <!-- https://github.com/php/php-src/pull/18653 -->
-  </para>
+  </simpara>
 
  </sect2>
 
  <sect2 xml:id="migration85.incompatible.simplexml">
   <title>SimpleXML</title>
 
-  <para>
+  <simpara>
    ノードの集合以外を返す XPath 式を
    <methodname>SimpleXMLElement::xpath</methodname>
    に渡した場合、警告が発生し、&false; を返すようになりました。
    これより前のバージョンでは、黙って失敗し、
    空の配列を返していました。
-  </para>
+  </simpara>
 
  </sect2>
 
  <sect2 xml:id="migration85.incompatible.soap">
   <title>SOAP</title>
 
-  <para>
+  <simpara>
    <methodname>SoapClient::__doRequest</methodname> に、
    オプションの <parameter>$uriParserClass</parameter>
    パラメータが新しく追加されました。
@@ -447,36 +447,36 @@
    <classname>Uri\WhatWg\Url</classname> を渡すと、
    新しいバックエンドを使います。
    <!-- RFC: https://wiki.php.net/rfc/url_parsing_api#plugability -->
-  </para>
+  </simpara>
 
  </sect2>
 
  <sect2 xml:id="migration85.incompatible.spl">
   <title>SPL</title>
 
-  <para>
+  <simpara>
 
    <classname>ArrayObject</classname> は 列挙型を受け入れなくなりました。
    列挙型の <property>$name</property> や <property>$value</property>
    プロパティが、PHP エンジンの想定を壊す可能性があるからです。
-  </para>
+  </simpara>
 
-  <para>
+  <simpara>
    <methodname>SplFileObject::fwrite</methodname> の
    <parameter>$length</parameter> パラメータは、nullable になりました。
    デフォルト値が <literal>0</literal> から &null; に変更されています。
-  </para>
+  </simpara>
 
  </sect2>
 
  <sect2 xml:id="migration85.incompatible.standard">
   <title>Standard</title>
 
-  <para>
+  <simpara>
    printf ファミリの関数に精度を指定しないフォーマットを使った場合、
    精度を 0 として扱うようになりました。
    これより前のバージョンでは、誤って精度をリセットしていました。
-  </para>
+  </simpara>
 
  </sect2>
 

appendices/migration85/new-features.xml

@@ -383,24 +383,24 @@ print T1 . PHP_EOL;   // Prints "0"
 
   <simpara>
    クラス定数
-   <constant>Pdo_Sqlite::ATTR_BUSY_STATEMENT</constant> が追加されました。
+   <constant>Pdo\Sqlite::ATTR_BUSY_STATEMENT</constant> が追加されました。
   </simpara>
 
   <simpara>
    クラス定数
-   <constant>Pdo_Sqlite::ATTR_EXPLAIN_STATEMENT</constant>,
-   <constant>Pdo_Sqlite::EXPLAIN_MODE_PREPARED</constant>,
-   <constant>Pdo_Sqlite::EXPLAIN_MODE_EXPLAIN</constant>,
-   <constant>Pdo_Sqlite::EXPLAIN_MODE_EXPLAIN_QUERY_PLAN</constant> が追加されました。
+   <constant>Pdo\Sqlite::ATTR_EXPLAIN_STATEMENT</constant>,
+   <constant>Pdo\Sqlite::EXPLAIN_MODE_PREPARED</constant>,
+   <constant>Pdo\Sqlite::EXPLAIN_MODE_EXPLAIN</constant>,
+   <constant>Pdo\Sqlite::EXPLAIN_MODE_EXPLAIN_QUERY_PLAN</constant> が追加されました。
   </simpara>
 
   <simpara>
    接続する際の属性として、
-   <constant>PDO\Sqlite::ATTR_TRANSACTION_MODE</constant> を追加しました。
+   <constant>Pdo\Sqlite::ATTR_TRANSACTION_MODE</constant> を追加しました。
    これに指定可能な値は、
-   <constant>PDO\Sqlite::TRANSACTION_MODE_DEFERRED</constant>,
-   <constant>PDO\Sqlite::TRANSACTION_MODE_IMMEDIATE</constant>,
-   <constant>PDO\Sqlite::TRANSACTION_MODE_EXCLUSIVE</constant> があります。
+   <constant>Pdo\Sqlite::TRANSACTION_MODE_DEFERRED</constant>,
+   <constant>Pdo\Sqlite::TRANSACTION_MODE_IMMEDIATE</constant>,
+   <constant>Pdo\Sqlite::TRANSACTION_MODE_EXCLUSIVE</constant> があります。
    これを使うと、beginTransaction()
    呼び出し時に使用するトランザクションモードを構成できます。
   </simpara>

appendices/migration85/other-changes.xml

@@ -121,7 +121,7 @@
     <function>transliterator_get_error_message</function>,
     <methodname>TransLiterator::getErrorCode</methodname>,
     <methodname>TransLiterator::getErrorMessage</methodname> の戻り値の
-    union 型から false を削除しました。
+    union 型から &false; を削除しました。
     &false; を返すことは実際には起こり得なかったからです。
    </simpara>
 
@@ -209,8 +209,8 @@
    <title>PDO_PGSQL</title>
 
    <simpara>
-    <methodname>PDO::pgsqlCopyFromArray</methodname> は、
-    Iterable の入力をサポートするようになりました。
+    <methodname>Pdo\Pgsql::copyFromArray</methodname> は、
+    <type>iterable</type> の入力をサポートするようになりました。
    </simpara>
 
    <simpara>
@@ -237,7 +237,7 @@
     コールバック関数の戻り値の型が間違っている場合に、
     例外をスローするようになりました。
     この変更によって、
-    <methodname>Pdo_Sqlite::createCollation</methodname>
+    <methodname>Pdo\Sqlite::createCollation</methodname>
     の動作とより一致するようになります。
    </simpara>