From d7243ce2912375bbdccda318f754a45825d6195c Mon Sep 17 00:00:00 2001
From: Nikita Popov <nikita.ppv@gmail.com>
Date: Fri, 2 Oct 2020 09:39:15 +0200
Subject: Add UPGRADING note for substr() behavior

[ci skip]
---
 UPGRADING | 3 +++
 1 file changed, 3 insertions(+)

(limited to 'UPGRADING')

diff --git a/UPGRADING b/UPGRADING
index 05c8eef1e9..0c15b1ecbe 100644
--- a/UPGRADING
+++ b/UPGRADING
@@ -608,6 +608,9 @@ PHP 8.0 UPGRADE NOTES
   . Calling crypt() without an explicit salt is no longer supported. If you
     would like to produce a strong hash with an auto-generated salt, use
     password_hash() instead.
+  . substr(), mb_substr(), iconv_substr() and grapheme_substr() now consistently
+    clamp out-of-bounds offsets to the string boundary. Previously, false was
+    returned instead of the empty string in some cases.
 
 - Sysvmsg:
   . msg_get_queue() will now return an SysvMessageQueue object rather than a
-- 
cgit v1.2.1