From 6ad8aaa91a59ae821781b08e32a305d958a48c1c Mon Sep 17 00:00:00 2001
From: Ian Lynagh <igloo@earth.li>
Date: Sun, 7 Aug 2011 15:10:34 +0100
Subject: [PATCH] Expand on the unicode changes in the release notes

---
 docs/users_guide/7.2.1-notes.xml | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/docs/users_guide/7.2.1-notes.xml b/docs/users_guide/7.2.1-notes.xml
index 91bb50312adc..87a572793249 100644
--- a/docs/users_guide/7.2.1-notes.xml
+++ b/docs/users_guide/7.2.1-notes.xml
@@ -995,7 +995,25 @@ GhcStage3DefaultNewCodegen=YES
         <listitem>
             <para>
                 Unicode support has generally been improved across
-                the core libraries.
+                the core libraries. This has a few consequences:
+            </para>
+            
+            <para>
+                Code that has been using the <literal>*CString</literal>
+                functions may need to be corrected to use the
+                <literal>*CAString</literal> functions.
+            </para>
+
+            <para>
+                Users may now observe strings &mdash; particularly
+                those from the commandline &mdash; containing
+                private-use characters, i.e. those in the range 0xEF00
+                to 0xEFFF inclusive.
+            </para>
+
+            <para>
+                Programs may now get exceptions when writing strings
+                in the wrong encoding to (for example) stdout.
             </para>
         </listitem>
     </itemizedlist>
-- 
GitLab