# HG changeset patch
# User Stefan Behnel <stefan_ml@behnel.de>
# Date 1594106026 -7200
#      Tue Jul 07 09:13:46 2020 +0200
# Node ID dccd25ac322e2af38aadadeed92a64bf0e1dedf6
# Parent  c93e0b4b81770e95ab1bec87665a942d74a1583e
Update changelog.

diff --git a/CHANGES.rst b/CHANGES.rst
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -26,9 +26,11 @@
 * The ``PyUnicode_GET_LENGTH()`` macro was missing from the ``cpython.*`` declarations.
   Patch by Thomas Caswell.  (Github issue #3692)
 
-* The deprecated C-API functions ``PyUnicode_FromUnicode()`` and ``PyUnicode_AS_UNICODE()``
-  are no longer used.
-  Patches by Inada Naoki and Victor Stinner.  (Github issues #3677, #3721)
+* The deprecated ``PyUnicode_*()`` C-API functions are no longer used, except for Unicode
+  strings that contain lone surrogates.  Unicode strings that contain non-BMP characters
+  or surrogate pairs now generate different C code on 16-bit Python 2.x Unicode deployments
+  (such as MS-Windows).  Generating the C code on Python 3.x is recommended in this case.
+  Original patches by Inada Naoki and Victor Stinner.  (Github issues #3677, #3721, #3697)
 
 * Several internal code generation issues regarding temporary variables were resolved.
   (Github issue #3708)