UPGRADING: Add xxHash notes [ci skip]

Signed-off-by: Anatol Belski <ab@php.net>

1 files changed, 14 insertions, 0 deletions

diff --git a/UPGRADING b/UPGRADING
index f3d155d4f1..f30c0fb6bf 100644
--- a/UPGRADING
+++ b/UPGRADING
@@ -103,6 +103,20 @@ PHP 8.1 UPGRADE NOTES
 
     A valid seed value is within the range from 0 to the plaform defined UINT_MAX, usually 4294967295.
 
+  . Added xxHash. The implementation brings in the following arguments
+
+    - xxh32, 32-bit hash
+    - xxh64, 64-bit hash
+    - xxh3, 64-bit hash
+    - xxh128, 128-bit hash
+
+    The initial hash state can be passed through the `seed` key in the `$options` array, for example:
+
+    ```php
+    $h = hash("xxh3", $data, options: ["seed" => 42]);
+    echo $h, "\n";
+    ```
+
 ========================================
 3. Changes in SAPI modules
 ========================================