[commit: ghc] ghc-7.2: tweak to the text about the Typeable changes (fe722ce)

[Simon Marlow]

Repository : ssh://darcs.haskell.org//srv/darcs/ghc

On branch  : ghc-7.2

http://hackage.haskell.org/trac/ghc/changeset/fe722ce5e1e396c009f20540bcba1d8b2de1aff0

>---------------------------------------------------------------

commit fe722ce5e1e396c009f20540bcba1d8b2de1aff0
Author: Simon Marlow <marlowsd at gmail.com>
Date:   Wed Jul 20 12:14:59 2011 +0100

    tweak to the text about the Typeable changes

>---------------------------------------------------------------

 docs/users_guide/7.2.1-notes.xml |   22 ++++++++++++++--------
 1 files changed, 14 insertions(+), 8 deletions(-)

diff --git a/docs/users_guide/7.2.1-notes.xml b/docs/users_guide/7.2.1-notes.xml
index af007bf..4742872 100644
--- a/docs/users_guide/7.2.1-notes.xml
+++ b/docs/users_guide/7.2.1-notes.xml
@@ -963,15 +963,21 @@ GhcStage3DefaultNewCodegen=YES
             <listitem>
                 <para>
                     The <literal>Typeable</literal> module has been
-                    overhauled. The <literal>mkTyCon</literal> function
-                    has been deprecated in favour of a new function
+                    overhauled. The <literal>mkTyCon</literal>
+                    function has been deprecated; the preferable fix
+                    is to derive <literal>Typeable</literal> instead
+                    (see <xref linkend="deriving-typeable"/>),
+                    although there is also a replacement
+                    for <literal>mkTyCon</literal> in the form of a
+                    new function
                     <literal>mkTyCon3</literal>, which takes separate
-                    strings for the package, module and name of the type
-                    constructor. Also, there is a new type
-                    <literal>TypeRepKey</literal>, and
-                    <literal>typeRepKey</literal> now
-                    returns <literal>IO TypeRepKey</literal> rather than
-                    <literal>IO Int</literal>.
+                    strings for the package, module and name of the
+                    type constructor.
+                    Also, <literal>typeRepKey</literal> is deprecated,
+                    and both <literal>TypeRep</literal>
+                    and <literal>TyCon</literal> now
+                    have <literal>Ord</literal> instances which means
+                    they can be used as Map keys.
                 </para>
             </listitem>