From 35bb2f775101aac79d5d2f827016e1fceda3eaf0 Mon Sep 17 00:00:00 2001
From: IWASE Shigeaki <siwa32@gmail.com>
Date: Sun, 5 Jan 2025 02:20:02 +0900
Subject: [PATCH 1/2] =?UTF-8?q?Document=20PHP=208.4=20ext-hash=20changes?=
 =?UTF-8?q?=20=E3=82=92=E5=8F=96=E3=82=8A=E8=BE=BC=E3=81=BF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

E_DEPRECATEDを発生させるコード例
hash_init('murmur3f', 0, "", ["seed" => "10"]);// E_DEPRECATED
hash_init('murmur3f', 0, "", ["seed" => 10]);// OK
---
 reference/hash/functions/hash-init.xml   | 30 ++++++++++++++++++------
 reference/hash/functions/hash-update.xml |  9 ++++++-
 2 files changed, 31 insertions(+), 8 deletions(-)

diff --git a/reference/hash/functions/hash-init.xml b/reference/hash/functions/hash-init.xml
index 5bd288e223..44c1449a80 100644
--- a/reference/hash/functions/hash-init.xml
+++ b/reference/hash/functions/hash-init.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 539a9823a805ac29cab7fa4baf3ae3a28116a2f5 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: fe4ff341037cab316f76ca414f9a1a8ecdc4abfd Maintainer: takagi Status: ready -->
 <!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. -->
 <!-- Credits: mumumu -->
 <refentry xml:id="function.hash-init" xmlns="http://docbook.org/ns/docbook">
@@ -85,12 +85,24 @@
 
  <refsect1 role="errors">
   &reftitle.errors;
-  <para>
-   <parameter>algo</parameter> が不明な場合や、
-   暗号に適さないハッシュ関数の場合、
-   または <parameter>key</parameter> が空の場合に
-   <classname>ValueError</classname> がスローされます。
-  </para>
+  <itemizedlist>
+   <listitem>
+    <simpara>
+     <parameter>algo</parameter> が不明な場合や、
+     暗号に適さないハッシュ関数の場合、
+     または <parameter>key</parameter> が空の場合に
+     <classname>ValueError</classname> がスローされます。
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara>
+     <parameter>options</parameter> に渡す構成オプションに間違った型の値があると、
+     誤った解釈をする恐れがあるため、<constant>E_DEPRECATED</constant>
+     エラーを発生するようになりました。
+     これは、将来 <exceptionname>ValueError</exceptionname> になる予定です。
+    </simpara>
+   </listitem>
+  </itemizedlist>  
  </refsect1>
 
  <refsect1 role="changelog">
@@ -105,6 +117,10 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>誤った型のオプションを渡すことは非推奨となりました。</entry>
+      </row>
       <row>
        <entry>8.1.0</entry>
        <entry><parameter>options</parameter> パラメータが追加されました。</entry>
diff --git a/reference/hash/functions/hash-update.xml b/reference/hash/functions/hash-update.xml
index 34835a4777..7a825fde05 100644
--- a/reference/hash/functions/hash-update.xml
+++ b/reference/hash/functions/hash-update.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: db22a7cfcbc3af221f67e228336ac3e2d62aaf2c Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 4c852f20e9039176dc75d7c0ce7eea61d6f909c7 Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 <refentry xml:id="function.hash-update" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -59,6 +59,13 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        戻り値の型が <type>bool</type> ではなく <type>true</type>
+        になりました。
+       </entry>
+      </row>
       <row>
        <entry>7.2.0</entry>
        <entry>

From 10bf02e0bed7d20f23811178306f62ee4108fbc6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=AD=A6=E7=94=B0=20=E6=86=B2=E5=A4=AA=E9=83=8E?=
 <takeda@youmind.jp>
Date: Mon, 13 Jan 2025 11:23:50 +0900
Subject: [PATCH 2/2] =?UTF-8?q?`E=5FDEPRECATED`=20=E3=81=AE=E8=AA=AC?=
 =?UTF-8?q?=E6=98=8E=E3=82=92=E6=97=A5=E6=9C=AC=E8=AA=9E=E3=81=AE=E8=A8=80?=
 =?UTF-8?q?=E3=81=84=E5=9B=9E=E3=81=97=E3=82=92=E5=84=AA=E5=85=88=E3=81=97?=
 =?UTF-8?q?=E8=A8=B3=E3=82=92=E5=B4=A9=E3=81=99?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 reference/hash/functions/hash-init.xml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/reference/hash/functions/hash-init.xml b/reference/hash/functions/hash-init.xml
index 44c1449a80..5a2ea3fad6 100644
--- a/reference/hash/functions/hash-init.xml
+++ b/reference/hash/functions/hash-init.xml
@@ -96,10 +96,10 @@
    </listitem>
    <listitem>
     <simpara>
-     <parameter>options</parameter> に渡す構成オプションに間違った型の値があると、
-     誤った解釈をする恐れがあるため、<constant>E_DEPRECATED</constant>
-     エラーを発生するようになりました。
-     これは、将来 <exceptionname>ValueError</exceptionname> になる予定です。
+     <parameter>options</parameter> に渡す設定値に型の誤りがあった場合
+     <constant>E_DEPRECATED</constant> が発生するようになりました。
+     予期しない解釈が行われる可能性があるためです。
+     これは将来 <exceptionname>ValueError</exceptionname> になる予定です。
     </simpara>
    </listitem>
   </itemizedlist>