[commit: ghc] ghc-8.6: users guide: Add release notes for 8.6.3 (d59812c)

[git at git.haskell.org]

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

On branch  : ghc-8.6
Link       : http://ghc.haskell.org/trac/ghc/changeset/d59812ce904461cd6e14125976e3053543634ca9/ghc

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

commit d59812ce904461cd6e14125976e3053543634ca9
Author: Ben Gamari <ben at smart-cactus.org>
Date:   Thu Dec 6 16:57:16 2018 -0500

    users guide: Add release notes for 8.6.3


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

d59812ce904461cd6e14125976e3053543634ca9
 .../{8.6.2-notes.rst => 8.6.3-notes.rst}           | 41 +++++++++-------------
 docs/users_guide/index.rst                         |  1 +
 2 files changed, 17 insertions(+), 25 deletions(-)

diff --git a/docs/users_guide/8.6.2-notes.rst b/docs/users_guide/8.6.3-notes.rst
similarity index 70%
copy from docs/users_guide/8.6.2-notes.rst
copy to docs/users_guide/8.6.3-notes.rst
index 5fc6d8f..f666e52 100644
--- a/docs/users_guide/8.6.2-notes.rst
+++ b/docs/users_guide/8.6.3-notes.rst
@@ -1,36 +1,27 @@
-.. _release-8-6-2:
+.. _release-8-6-3:
 
-Release notes for version 8.6.2
+Release notes for version 8.6.3
 ===============================
 
-GHC 8.6.2 is a bug-fix release, fixing a few regressions found in 8.6.1.
+GHC 8.6.3 is a bug-fix release, fixing a few regressions found in 8.6.1 and
+8.6.2. As some of these issues are soundness issues users are strongly
+encouraged to upgrade.
 
 
 Highlights
 ----------
 
-The highlights, since the 8.6.1 release, are:
-
-- A long-standing bug exposed in GHC 8.6.1, :ghc-ticket:`15696`, has been fixed.
-  This issue resulted in undefined runtime behavior with some uses of the
-  ``dataToTag#`` primop. Note that this issue, while less likely to manifest,
-  has existed in some form in all GHC releases prior to this release and may
-  result in silent, incorrect evaluation. For this reason, users are strongly
-  encouraged to upgrade to 8.6.2.
-
-- A long-standing bug in the LLVM code generator (:ghc-ticket:`14251`),
-  resulting in incorrect floating point evaluation, has been fixed.
-
-- Several compiler panics observed in GHC 8.6.1 have been fixed
-  (:ghc-ticket:`15499`, :ghc-ticket:`15053`, :ghc-ticket:`15692`,
-  :ghc-ticket:`15695`)
-
-- GHC now runs without complaining when installed to a read-only location on
-  Windows (:ghc-ticket:`15667`)
-
-- An integer overflow, resulting in some ``encodeFloat`` uses returning
-  incorrect results, has been fixed (:ghc-ticket:`15271`)
-
+The highlights, since the 8.6.2 release, are:
+
+- A bug resulting in segmentation faults in some programs has been fixed
+  (:ghc-ticket:`15892`)
+- Darwin binary distributions are now correctly built against an in-tree
+  ``libgmp`` (:ghc-ticket:`15404`)
+- Three bugs leading to linker failures on Windows has been fixed
+  (:ghc-ticket:`15105`, :ghc-ticket:`15894`, :ghc-ticket:`15934`)
+- A bug leading to programs with deep stacks crashing when run with retainer profiling enabled has been fixed (:ghc-ticket:`14758`)
+- A bug resulting in potential heap corruption during stable name allocation has been fixed (:ghc-ticket:`15906`)
+- Plugins are now loaded during GHCi sessions (:ghc-ticket:`15633`)
 
 Known issues
 ------------
diff --git a/docs/users_guide/index.rst b/docs/users_guide/index.rst
index 2d184ab..11718d8 100644
--- a/docs/users_guide/index.rst
+++ b/docs/users_guide/index.rst
@@ -14,6 +14,7 @@ Contents:
    intro
    8.6.1-notes
    8.6.2-notes
+   8.6.3-notes
    ghci
    runghc
    usage