[commit: ghc] master: Some 8.2.1 release notes for my stuff (e7e5f7a)

[git at git.haskell.org]

Repository : ssh://git@git.haskell.org/ghc

On branch  : master
Link       : http://ghc.haskell.org/trac/ghc/changeset/e7e5f7accbb7d9a12aee5d1468371a8ba09b598d/ghc

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

commit e7e5f7accbb7d9a12aee5d1468371a8ba09b598d
Author: Simon Marlow <marlowsd at gmail.com>
Date:   Tue Jan 17 15:48:37 2017 -0500

    Some 8.2.1 release notes for my stuff
    
    Test Plan: Built it and looked at it
    
    Reviewers: niteria, erikd, dfeuer, austin, hvr, bgamari
    
    Reviewed By: bgamari
    
    Subscribers: dfeuer, thomie, erikd
    
    Differential Revision: https://phabricator.haskell.org/D2959


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

e7e5f7accbb7d9a12aee5d1468371a8ba09b598d
 configure.ac                      |  1 +
 docs/users_guide/8.2.1-notes.rst  | 23 +++++++++++++++++++++--
 docs/users_guide/ghc_config.py.in |  1 +
 docs/users_guide/sooner.rst       | 10 +++++-----
 4 files changed, 28 insertions(+), 7 deletions(-)

diff --git a/configure.ac b/configure.ac
index 7dcde09..b3d2e17 100644
--- a/configure.ac
+++ b/configure.ac
@@ -1122,6 +1122,7 @@ AC_SUBST(BUILD_SPHINX_PDF)
 LIBRARY_VERSION(base)
 LIBRARY_VERSION(Cabal, Cabal/Cabal)
 LIBRARY_VERSION(ghc-prim)
+LIBRARY_VERSION(compact)
 LIBRARY_ghc_VERSION="$ProjectVersion"
 AC_SUBST(LIBRARY_ghc_VERSION)
 
diff --git a/docs/users_guide/8.2.1-notes.rst b/docs/users_guide/8.2.1-notes.rst
index 2c237db..c5e3cb6 100644
--- a/docs/users_guide/8.2.1-notes.rst
+++ b/docs/users_guide/8.2.1-notes.rst
@@ -151,13 +151,32 @@ Template Haskell
 Runtime system
 ~~~~~~~~~~~~~~
 
--  TODO FIXME.
+- TODO FIXME.
+
+- Added support for *Compact Regions*, which offer a way to manually
+  move long-lived data outside of the heap so that the garbage
+  collector does not have to trace it repeatedly.  Compacted data can
+  also be serialized, stored, and deserialized again later by the same
+  program.  For more details see the :compact-ref:`Data.Compact
+  <Data-Compact.html>` module.
+
+- There is new support for improving performance on machines with a
+  Non-Uniform Memory Architecture (NUMA).  See :rts-flag:`--numa`.
+  This is supported on Linux and Windows systems.
+
+- The garbage collector can be told to use fewer threads than the
+  global number of capabilities set by :rts-flag:`-N`.  See
+  :rts-flag:`-qn`, and a `blog post
+  <http://simonmar.github.io/posts/2016-12-08-Haskell-in-the-datacentre.html>`_
+  that describes this.
 
 - The :ref:`heap profiler <prof-heap>` can now emit heap census data to the GHC
   event log, allowing heap profiles to be correlated with other tracing events
   (see :ghc-ticket:`11094`).
 
-- Added NUMA support to Windows.
+- Some bugs have been fixed in the stack-trace implementation in the
+  profiler that sometimes resulted in incorrect stack traces and
+  costs attributed to the wrong cost centre stack (see :ghc-ticket:`5654`).
 
 - Added processor group support for Windows. This allows the runtime to allocate
   threads to all cores in systems which have multiple processor groups.
diff --git a/docs/users_guide/ghc_config.py.in b/docs/users_guide/ghc_config.py.in
index 41aee8d..e2783e4 100644
--- a/docs/users_guide/ghc_config.py.in
+++ b/docs/users_guide/ghc_config.py.in
@@ -1,6 +1,7 @@
 extlinks = {
     'base-ref': ('../libraries/base- at LIBRARY_base_VERSION@/%s', ''),
     'cabal-ref': ('../libraries/Cabal- at LIBRARY_Cabal_VERSION@/%s', ''),
+    'compact-ref': ('../libraries/compact- at LIBRARY_compact_VERSION@/%s', ''),
     'ghc-prim-ref': ('../libraries/ghc-prim- at LIBRARY_ghc_prim_VERSION@/%s', ''),
     'ghc-ticket': ('http://ghc.haskell.org/trac/ghc/ticket/%s', 'Trac #'),
     'ghc-wiki': ('http://ghc.haskell.org/trac/ghc/wiki/%s', 'Trac #'),
diff --git a/docs/users_guide/sooner.rst b/docs/users_guide/sooner.rst
index 8b7a985..702648f 100644
--- a/docs/users_guide/sooner.rst
+++ b/docs/users_guide/sooner.rst
@@ -312,11 +312,11 @@ Use a bigger heap!
     calculate a value based on the amount of live data.
 
 Compact your data:
-    The ``Data.Compact`` library (in the ``compact`` package) provides
-    a way to make garbage collection more efficient for long-lived
-    data structures.  Compacting a data structure collects the objects
-    together in memory, where they are treated as a single object by
-    the garbage collector and not traversed individually.
+    The :compact-ref:`Data.Compact <Data-Compact.html>` module
+    provides a way to make garbage collection more efficient for
+    long-lived data structures. Compacting a data structure collects
+    the objects together in memory, where they are treated as a single
+    object by the garbage collector and not traversed individually.
 
 .. _smaller: