From 3b13e88830322caeecc90fda2303793ce627a395 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 8 Aug 2023 15:27:50 +0200
Subject: [PATCH] Fix GH-2209: update return value and changelog of
 stream_set_chunk_size()

---
 .../functions/stream-set-chunk-size.xml       | 34 ++++++++++++++++---
 1 file changed, 29 insertions(+), 5 deletions(-)

diff --git a/reference/stream/functions/stream-set-chunk-size.xml b/reference/stream/functions/stream-set-chunk-size.xml
index e9462499e5e7..56f1ffa0565c 100644
--- a/reference/stream/functions/stream-set-chunk-size.xml
+++ b/reference/stream/functions/stream-set-chunk-size.xml
@@ -45,20 +45,44 @@
   <para>
    Returns the previous chunk size on success.
   </para>
-  <para>
-   Will return &false; if <parameter>size</parameter> is less than 1 or
-   greater than <constant>PHP_INT_MAX</constant>.
-  </para>
  </refsect1>
 
  <refsect1 role="errors">
   &reftitle.errors;
   <para>
-   Will emit an <constant>E_WARNING</constant> level error if <parameter>size</parameter>
+   A <classname>ValueError</classname> is thrown if <parameter>size</parameter>
    is less than 1 or greater than <constant>PHP_INT_MAX</constant>.
   </para>
  </refsect1>
 
+ <refsect1 role="changelog"><!-- {{{ -->
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>PHP 8.0.0</entry>
+       <entry>
+        A <classname>ValueError</classname> is now thrown if
+        <parameter>size</parameter> is less than 1 or greater than
+        <constant>PHP_INT_MAX</constant>. Previously, an
+        <constant>E_WARNING</constant> level error was emitted and &false; was
+        returned.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1><!-- }}} -->
+
 </refentry>
 <!-- Keep this comment at the end of the file
 Local variables: