From 7e70df17aee2e39bc599b43e59a52bb30064df4d Mon Sep 17 00:00:00 2001
From: Ben Gamari <ben@smart-cactus.org>
Date: Mon, 22 May 2023 20:17:25 -0400
Subject: [PATCH] docs: 9.6.2 release notes
---
docs/users_guide/9.6.2-notes.rst | 88 ++++++++++++++++++++++++++++++
docs/users_guide/release-notes.rst | 1 +
2 files changed, 89 insertions(+)
create mode 100644 docs/users_guide/9.6.2-notes.rst
diff --git a/docs/users_guide/9.6.2-notes.rst b/docs/users_guide/9.6.2-notes.rst
new file mode 100644
index 000000000000..bbcd4d1be043
--- /dev/null
+++ b/docs/users_guide/9.6.2-notes.rst
@@ -0,0 +1,88 @@
+.. _release-9-6-2:
+
+Version 9.6.2
+==============
+
+The significant changes to the various parts of the compiler are listed below.
+See the `migration guide
+<https://gitlab.haskell.org/ghc/ghc/-/wikis/migration/9.6>`_ on the GHC Wiki
+for specific guidance on migrating programs to this release.
+
+The :ghc-flag:`LLVM backend <-fllvm>` of this release is to be used with LLVM
+11, 12, 13, 14 or 15.
+
+- A :ghc-ticket:`simplifier bug <22761>` resulting in compiler crashes in some
+ situations involving rules has been fixed.
+
+- Several issues affecting the bytecode interpreter's handling of optimised
+ programs have been fixed (:ghc-ticket:`23068`, :ghc-ticket:`22958`)
+
+- A specialisation bug resulting looping of some programs involving
+ non-trivial chains of instances (namely, requiring
+ :extension:`UndecidableInstances`) has been fixed (:ghc-ticket:`22549`)
+
+- A bug resulting in crashes of programs using the new ``listThreads#`` primop
+ has been fixed (:ghc-ticket:`23071`).
+
+- A compiler crash triggered by certain uses of quantified constraints has been
+ fixed (:ghc-ticket:`23171`)
+
+- Various bugs in the Javascript backend have been fixed (:ghc-ticket:`23399`,
+ :ghc-ticket:`23360`, :ghc-ticket:`23346`)
+
+- The non-moving garbage collector's treatment of weak pointers has been
+ revamped which should allow more reliable finalization of ``Weak#``
+ closures (:ghc-ticket:`22327`)
+
+- The non-moving garbage collector now bounds the amount of marking it will
+ do during the post-marking stop-the-world phase, greatly reducing tail
+ latencies in some programs (:ghc-ticket:`22929`)
+
+- A missing write barrier in the non-moving collector's handling of selector
+ thunks has been fixed (:ghc-ticket:`22930`).
+
+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: Dependency of ``ghc`` library
+ libraries/Cabal/Cabal/Cabal.cabal: Dependency of ``ghc-pkg`` utility
+ libraries/Cabal/Cabal-syntax/Cabal-syntax.cabal: Dependency of ``ghc-pkg`` utility
+ libraries/containers/containers/containers.cabal: Dependency of ``ghc`` library
+ libraries/deepseq/deepseq.cabal: Dependency of ``ghc`` library
+ libraries/directory/directory.cabal: Dependency of ``ghc`` library
+ libraries/exceptions/exceptions.cabal: Dependency of ``ghc`` and ``haskeline`` 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-boot-th/ghc-boot-th.cabal: Internal compiler library
+ libraries/ghc-compact/ghc-compact.cabal: Core library
+ libraries/ghc-heap/ghc-heap.cabal: GHC heap-walking 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/libiserv/libiserv.cabal: Internal compiler library
+ libraries/mtl/mtl.cabal: Dependency of ``Cabal`` library
+ libraries/parsec/parsec.cabal: Dependency of ``Cabal`` library
+ libraries/pretty/pretty.cabal: Dependency of ``ghc`` library
+ libraries/process/process.cabal: Dependency of ``ghc`` library
+ libraries/stm/stm.cabal: Dependency of ``haskeline`` library
+ libraries/template-haskell/template-haskell.cabal: Core library
+ libraries/terminfo/terminfo.cabal: Dependency of ``haskeline`` 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/release-notes.rst b/docs/users_guide/release-notes.rst
index 8c29746c7c1a..f98b748aa293 100644
--- a/docs/users_guide/release-notes.rst
+++ b/docs/users_guide/release-notes.rst
@@ -5,3 +5,4 @@ Release notes
:maxdepth: 1
9.6.1-notes
+ 9.6.2-notes
--
GitLab