From 2b87e5d2fe409d395309f72720ae87400efdfc08 Mon Sep 17 00:00:00 2001
From: Colin O'Dell <colinodell@gmail.com>
Date: Tue, 22 Oct 2019 06:32:41 -0400
Subject: [PATCH] Document the changes to substr functions

---
 UPGRADING | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/UPGRADING b/UPGRADING
index 8b2bbfee460f1..40af9ca458827 100644
--- a/UPGRADING
+++ b/UPGRADING
@@ -271,6 +271,10 @@ PHP 8.0 UPGRADE NOTES
     point. An explicit call to chr() can be used to restore the previous
     behavior.
   . The needle argument for strpos(), strrpos(), stripos(), strripos(), strstr() and stristr() can now be empty.
+  . The length argument for substr(), substr_count(), substr_compare(), and
+    iconv_substr() can now be null. Null values will behave as if no length
+    argument was provided and will therefore return the remainder of the string
+    instead of an empty string.
   . The 'salt' option of password_hash() is no longer supported. If the 'salt'
     option is used a warning is generated, the provided salt is ignored, and a
     generated salt is used instead.