#257 で誤って翻訳がスキップされたコミットを翻訳 (part 1/2) (#292)

* language-snippets.ent: スキップされていた 8b502f81f951a1af64396b69823f7a35b7637541 を取り込み

* language-snippets.ent: スキップされていた 9a5b92a30888d6423db112f07a9b344cf6fc4891 を取り込み

* language-snippets.ent: スキップされていた c75f19c74fa3b64abfafd7a35aaa652b07834a5a を取り込み

* language-snippets.ent: スキップされていた 53054bf8decc8648cf2e90a493692a161e2371af を取り込み

* language-snippets.ent: スキップされていた ed1aff13602c94f86344bdd7c4fbc31f5a71bf84 を取り込み

* language-snippets.ent: スキップされていた bead080a991889bf281d32095f2197e61413ac70 を取り込み

* language-snippets.ent: スキップされていた ebbc5bb97c8c063d31309725c0bb93d21213993b を取り込み

* language-snippets.ent: スキップされていた 810229e31c049ee7240aad2be5694fca7901ce60 を取り込み

Author: nsfisis

language-snippets.ent

@@ -762,14 +762,8 @@ DLL ファイルを PHP のフォルダから Windows のシステムディレ
 <!ENTITY style.oop 'オブジェクト指向型'>
 <!ENTITY style.procedural '手続き型'>
 
-<!ENTITY resource '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.resource">リソース</link>'>
-
-<!ENTITY foreach '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.foreach">foreach</link>'>
-
 <!ENTITY match '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.match">match</link>'>
 
-<!ENTITY yield '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.yield">yield</link>'>
-
 <!ENTITY parameter.context '<literal xmlns="http://docbook.org/ns/docbook">コンテキスト</literal> についての説明は、
 マニュアルの <link xmlns="http://docbook.org/ns/docbook" linkend="context">コンテキスト</link> の節を参照ください。'>
 
@@ -1640,22 +1634,32 @@ object</parameter></term><listitem><para>手続き型のみ: <function>date_crea
 が使えます。
 </para>'>
 <!ENTITY dom.note.utf8 '<note xmlns="http://docbook.org/ns/docbook"><para>DOM拡張モジュール は UTF-8 エンコーディングを使います。他のエンコーディングを扱う場合は、<function>mb_convert_encoding</function>, <methodname>UConverter::transcode</methodname>, <function>iconv</function> を使ってください。</para></note>'>
+<!ENTITY dom.note.modern.utf8 '<note xmlns="http://docbook.org/ns/docbook">
+ <simpara>
+  DOM拡張モジュールは、メソッドやプロパティで UTF-8 エンコーディングを使います。
+  パースをおこなうメソッドは、エンコーディングを自動的に判別し、呼び出し側でエンコーディングを指定することもできます。
+ </simpara>
+</note>'>
 <!ENTITY dom.note.json '<note xmlns="http://docbook.org/ns/docbook"><para><classname>DOMDocument</classname> オブジェクトに対して <function>json_encode</function> を使うと、結果は空オブジェクトをエンコードしたものになります。</para></note>'>
 <!ENTITY dom.domdocument.html5 '<warning xmlns="http://docbook.org/ns/docbook">
- <para>
+ <simpara>
+  モダンな HTML をパースしたり処理したりするには、<classname>DOMDocument</classname> の代わりに
+  <classname>Dom\HTMLDocument</classname> を使ってください。
+ </simpara>
+ <simpara>
   この関数は、HTML4 のパーサを使って入力をパースします。モダンなWebブラウザが採用している HTML5 のパースルールとは異なります。入力によっては、このことが原因で異なるDOM構造になるかもしれません。よって、この関数はHTMLを無害化する目的で安全に使えません。
- </para>
- <para>
+ </simpara>
+ <simpara>
   HTML をパースする挙動は、利用している 
   <literal>libxml</literal> のバージョンに依存します。
   特にエッジケースやエラーハンドリングについてそれが当てはまります。
   HTML5 に準拠したパースを行うには、PHP 8.4 で追加される
   <methodname>Dom\HTMLDocument::createFromString</methodname> や
   <methodname>Dom\HTMLDocument::createFromFile</methodname> を使いましょう。
- </para>
- <para>
+ </simpara>
+ <simpara>
   例を挙げましょう。HTML要素によっては、暗黙のうちに親の要素を閉じるものがあります。親要素を自動で閉じるルールは、HTML4 と HTML5 で異なります。よって、<classname>DOMDocument</classname> が表す DOM 構造は Webブラウザ上のそれと異なる可能性があります。このことから、攻撃者がHTMLを壊す攻撃を許す可能性があります。
- </para>
+ </simpara>
 </warning>'>
 
 
@@ -1800,9 +1804,15 @@ object</parameter></term><listitem><para>手続き型のみ: <function>date_crea
 <!ENTITY haru.error '<para xmlns="http://docbook.org/ns/docbook">エラー時に <classname>HaruException</classname> をスローします。</para>'>
 
 <!-- ODBC -->
-<!ENTITY odbc.connection.id '<para xmlns="http://docbook.org/ns/docbook">ODBC 接続 ID。詳細は
+<!ENTITY odbc.connection.id '<para xmlns="http://docbook.org/ns/docbook">ODBC 接続オブジェクト。詳細は
 <function>odbc_connect</function> を参照ください。</para>'>
 
+<!ENTITY odbc.result.object 'ODBC 結果オブジェクト'>
+
+<!ENTITY odbc.result.object-return 'ODBC 結果オブジェクトを返します'>
+
+<!ENTITY odbc.result.object-return-falseforfailure '&odbc.result.object-return;。&return.falseforfailure;。'>
+
 <!ENTITY odbc.parameter.catalog 'カタログ(ODBC 2 の用語では &apos;修飾子&apos;)。'>
 
 <!ENTITY odbc.parameter.schema 'スキーマ (ODBC 2 の用語では &apos;所有者&apos;)。'>
@@ -1813,6 +1823,39 @@ object</parameter></term><listitem><para>手続き型のみ: <function>date_crea
 
 <!ENTITY odbc.result.driver-specific 'ドライバは追加のカラムを返すことが出来ます。'>
 
+<!ENTITY odbc.changelog.connection-param '<row xmlns="http://docbook.org/ns/docbook">
+ <entry>8.4.0</entry>
+ <entry>
+  引数 <parameter>odbc</parameter> は、<classname>Odbc\Connection</classname> クラスのインスタンスを期待するようになりました。
+  これより前のバージョンでは、<type>resource</type> を期待していました。
+ </entry>
+</row>'>
+
+<!ENTITY odbc.changelog.connection-return '&odbc.changelog.connection-param;
+ <row xmlns="http://docbook.org/ns/docbook">
+  <entry>8.4.0</entry>
+  <entry>
+   この関数は <classname>Odbc\Connection</classname> クラスのインスタンスを返すようになりました。
+   これより前のバージョンでは、<type>resource</type> を返していました。
+  </entry>
+ </row>'>
+
+<!ENTITY odbc.changelog.result-param '<row xmlns="http://docbook.org/ns/docbook">
+ <entry>8.4.0</entry>
+ <entry>
+  引数 <parameter>statement</parameter> は、<classname>Odbc\Result</classname> クラスのインスタンスを期待するようになりました。
+  これより前のバージョンでは、<type>resource</type> を期待していました。
+ </entry>
+</row>'>
+
+<!ENTITY odbc.changelog.result-return '<row xmlns="http://docbook.org/ns/docbook">
+ <entry>8.4.0</entry>
+ <entry>
+  この関数は <classname>Odbc\Result</classname> クラスのインスタンスを返すようになりました。
+  これより前のバージョンでは、<type>resource</type> を返していました。
+ </entry>
+</row>'>
+
 <!-- OAUTH -->
 <!ENTITY oauth.callback.error 'コールバック関数をコールできなかったり、
 あるいは定義されていなかったりした場合は <constant xmlns="http://docbook.org/ns/docbook">E_ERROR</constant>
@@ -2052,6 +2095,10 @@ PECL 拡張モジュールのインストール</link> という章にありま
 この拡張モジュールは &link.pecl; レポジトリに移動
 されており、以下のバージョン以降 PHP にバンドルされなくなっています。 PHP '>
 
+<!ENTITY warn.pecl.unmaintained '<warning xmlns="http://docbook.org/ns/docbook">
+ <simpara>この拡張モジュールは、<emphasis>メンテナンスされていません</emphasis>。</simpara>
+</warning>'>
+
 <!-- PGSQL entities -->
 
 <!ENTITY pgsql.parameter.connection '<para xmlns="http://docbook.org/ns/docbook"><classname>PgSql\Connection</classname> クラスのインスタンス。</para>'>
@@ -2146,6 +2193,12 @@ PHP 8.1.0 以降は、ctype関数 に文字列でない引数を渡すことは
 <!-- GMP Notes -->
 <!ENTITY gmp.return '<classname xmlns="http://docbook.org/ns/docbook">GMP</classname> オブジェクトを返します。'>
 <!ENTITY gmp.parameter '<para xmlns="http://docbook.org/ns/docbook"><classname>GMP</classname> オブジェクト、整数、あるいは数値に変換可能な数値形式の文字列。</para>'>
+<!ENTITY gmp.parameter '<para xmlns="http://docbook.org/ns/docbook">
+ <classname>GMP</classname> オブジェクト、&integer;、
+ あるいは数値として解釈可能な &string;。
+ 文字列の場合、<function>gmp_init</function> で基数を自動検出するとき
+ (<parameter>base</parameter> に 0 を指定したとき) と同じ方法で解釈されます。
+</para>'>
 
 <!-- MySQLi Notes -->
 <!ENTITY mysqli.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>result</parameter></term><listitem>
@@ -4904,17 +4957,21 @@ local: {
 '>
 
 <!-- filter snippets -->
+<!-- TODO: Remove -->
 <!ENTITY filter.param.filter '
  <varlistentry xmlns="http://docbook.org/ns/docbook">
   <term><parameter>filter</parameter></term>
   <listitem>
    <para>
-    適用するフィルタの ID。<xref linkend="filter.filters" />
-    に、利用できるフィルタの一覧があります。
+    適用するフィルタ。
+    <constant>FILTER_VALIDATE_<replaceable>*</replaceable></constant> 定数の一つを用いた検証フィルタ、
+    <constant>FILTER_SANITIZE_<replaceable>*</replaceable></constant> 定数の一つを用いた除去フィルタ、
+    <constant>FILTER_UNSAFE_RAW</constant>、
+    <constant>FILTER_CALLBACK</constant> を用いたカスタムフィルタのいずれかを指定できます。
    </para>
    <para>
-    省略した場合は <constant>FILTER_DEFAULT</constant> を使います。これは
-    <link linkend="filter.filters.sanitize"><constant>FILTER_UNSAFE_RAW</constant></link> と同等です。
+    デフォルトの値は <constant>FILTER_DEFAULT</constant> で、
+    これは <constant>FILTER_UNSAFE_RAW</constant> のエイリアスです。
     結果的に、デフォルトでは何もフィルタリングをしません。
    </para>
   </listitem>