[commit: ghc] ghc-8.6: users-guide: Add release notes for 8.6.2 (9f80277)

[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/9f802777f958a6bc2152662d90edb6016b40a43d/ghc

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

commit 9f802777f958a6bc2152662d90edb6016b40a43d
Author: Ben Gamari <ben at smart-cactus.org>
Date:   Sun Oct 28 16:02:51 2018 -0400

    users-guide: Add release notes for 8.6.2


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

9f802777f958a6bc2152662d90edb6016b40a43d
 docs/users_guide/8.6.2-notes.rst | 70 ++++++++++++++++++++++++++++++++++++++++
 docs/users_guide/index.rst       |  1 +
 2 files changed, 71 insertions(+)

diff --git a/docs/users_guide/8.6.2-notes.rst b/docs/users_guide/8.6.2-notes.rst
new file mode 100644
index 0000000..9ee94df
--- /dev/null
+++ b/docs/users_guide/8.6.2-notes.rst
@@ -0,0 +1,70 @@
+.. _release-8-6-2:
+
+Release notes for version 8.6.2
+===============================
+
+GHC 8.6.2 is a bug-fix release, fixing a few regressions found in 8.6.1.
+
+
+Highlights
+----------
+
+The highlights, since the 8.6.2 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`)
+
+
+Included libraries
+------------------
+
+The package database provided with this distribution also contains a number of
+packages other than GHC itself. See the changelogs provided with these packages
+for further change information.
+
+.. ghc-package-list::
+
+    libraries/array/array.cabal:             Dependency of ``ghc`` library
+    libraries/base/base.cabal:               Core library
+    libraries/binary/binary.cabal:           Dependency of ``ghc`` library
+    libraries/bytestring/bytestring.cabal:   Deppendency of ``ghc`` library
+    libraries/Cabal/Cabal/Cabal.cabal:       Dependency of ``ghc-pkg`` utility
+    libraries/containers/containers.cabal:   Dependency of ``ghc`` library
+    libraries/deepseq/deepseq.cabal:         Dependency of ``ghc`` library
+    libraries/directory/directory.cabal:     Dependency of ``ghc`` library
+    libraries/filepath/filepath.cabal:       Dependency of ``ghc`` library
+    compiler/ghc.cabal:                      The compiler itself
+    libraries/ghci/ghci.cabal:               The REPL interface
+    libraries/ghc-boot/ghc-boot.cabal:       Internal compiler library
+    libraries/ghc-compact/ghc-compact.cabal: Core library
+    libraries/ghc-prim/ghc-prim.cabal:       Core library
+    libraries/haskeline/haskeline.cabal:     Dependency of ``ghci`` executable
+    libraries/hpc/hpc.cabal:                 Dependency of ``hpc`` executable
+    libraries/integer-gmp/integer-gmp.cabal: Core library
+    libraries/mtl/mtl.cabal:                 Dependency of ``Cabal`` library
+    libraries/parsec/parsec.cabal:           Dependency of ``Cabal`` library
+    libraries/process/process.cabal:         Dependency of ``ghc`` library
+    libraries/template-haskell/template-haskell.cabal:     Core library
+    libraries/text/text.cabal:               Dependency of ``Cabal`` library
+    libraries/time/time.cabal:               Dependency of ``ghc`` library
+    libraries/transformers/transformers.cabal: Dependency of ``ghc`` library
+    libraries/unix/unix.cabal:               Dependency of ``ghc`` library
+    libraries/Win32/Win32.cabal:             Dependency of ``ghc`` library
+    libraries/xhtml/xhtml.cabal:             Dependency of ``haddock`` executable
diff --git a/docs/users_guide/index.rst b/docs/users_guide/index.rst
index b1b0141..2d184ab 100644
--- a/docs/users_guide/index.rst
+++ b/docs/users_guide/index.rst
@@ -13,6 +13,7 @@ Contents:
    license
    intro
    8.6.1-notes
+   8.6.2-notes
    ghci
    runghc
    usage