From bfbcdbabca5cc0b2be27a127af78353c70efc197 Mon Sep 17 00:00:00 2001
From: Gareth Rees <gdr@ravenbrook.com>
Date: Thu, 11 Jul 2013 16:44:40 +0100
Subject: [PATCH] Bring release notes up to date.

Copied from Perforce
 Change: 183008
 ServerID: perforce.ravenbrook.com
---
 mps/manual/source/release.rst      | 36 ++++++++++++++++++++++++------
 mps/manual/source/topic/thread.rst |  2 ++
 2 files changed, 31 insertions(+), 7 deletions(-)

diff --git a/mps/manual/source/release.rst b/mps/manual/source/release.rst
index 212b7cc92db..034ececbeb8 100644
--- a/mps/manual/source/release.rst
+++ b/mps/manual/source/release.rst
@@ -8,13 +8,28 @@ Release notes
 Release 1.112.0
 ---------------
 
+New features
+............
+
+1. On Windows, you can now request that the MPS allocate address space
+   from the top down, allowing a 32-bit executable linked with
+   ``/LARGEADDRESSAWARE`` to use the top half of the address space.
+   Use the keyword argument :c:macro:`MPS_KEY_VMW3_TOP_DOWN` when
+   creating an arena of class :c:func:`mps_arena_class_vm`.
+
+2. On OS X, multi-threaded programs are now supported. See
+   :ref:`topic-thread`.
+
+3. On OS X, you can now debug the MPS using ``lldb``.
+
+
 Interface changes
 .................
 
 1. In the :term:`hot` (production) variety, the default assertion handler
    now prints messages to standard error but does *not* terminate the
    program. Even though assertions indicate serious problems in the
-   program, an end-user does not want an application to terminate when
+   program, an end-user does not always want an application to terminate when
    there is a chance to shut down safely and save work, or even to limp
    along indefinitely.  See :ref:`topic-error-assertion-handling`.
 
@@ -33,7 +48,7 @@ Interface changes
    provides forward compatibility. See :ref:`topic-keyword`.
 
    (The old interface continues to be supported, but new features will
-   only be available through the keyword interface.)
+   become available through the keyword interface only.)
 
 4. :ref:`pool-mfs` no longer refuses to manage blocks that are smaller
    than the platform alignment. It now rounds up smaller sizes
@@ -44,11 +59,14 @@ Interface changes
    :c:macro:`MPS_KEY_ALIGN` when creating a pool of class
    :c:func:`mps_class_mvt`.
 
-6. On Windows, you can now request that the MPS allocate address space
-   from the top down, allowing a 32-bit executable linked with
-   ``/LARGEADDRESSAWARE`` to use the top half of the address space.
-   Use the keyword argument :c:macro:`MPS_KEY_VMW3_TOP_DOWN` when
-   creating an arena of class :c:func:`mps_arena_class_vm`.
+6. On OS X, signals are no longer used for handling memory protection
+   exceptions. This means that programs are free to handle ``SIGBUS``,
+   but must not install a thread-local Mach exception handler for
+   ``EXC_BAD_ACCESS`` exceptions. See :ref:`topic-thread-signal`.
+
+7. On OS X, when debugging with ``gdb``, you no longer need to turn on
+   ``dont-handle-bad-access`` or to request special handling of
+   ``SIGBUS``.
 
 
 Other changes
@@ -70,3 +88,7 @@ Other changes
 
    .. _job003486: https://www.ravenbrook.com/project/mps/issue/job003486/
 
+4. The ``-i`` and ``-o`` options no longer cause
+   :program:`mpseventsql` to crash. See job003507_.
+
+   .. _job003507: https://www.ravenbrook.com/project/mps/issue/job003507/
diff --git a/mps/manual/source/topic/thread.rst b/mps/manual/source/topic/thread.rst
index d235b0832d8..fe16b1e450d 100644
--- a/mps/manual/source/topic/thread.rst
+++ b/mps/manual/source/topic/thread.rst
@@ -63,6 +63,8 @@ than this. See the documentation for the pool class.
    single: thread; signal handling
    single: thread; exception handling
 
+.. _topic-thread-signal:
+
 Signal and exception handling issues
 ------------------------------------