Add some lock contention checking
[ghc.git] / ANNOUNCE
index dd66b2c..9e1676b 100644 (file)
--- a/ANNOUNCE
+++ b/ANNOUNCE
-            The Glasgow Haskell Compiler -- version 2.09
-           ==============================================
 
-We are pleased to announce a new release of the Glasgow Haskell
-Compiler (GHC), version 2.09. Source distribution is freely available
-via the World-Wide Web and through anon. FTP; details below.
+           ===============================================
+            The Glasgow Haskell Compiler -- version 8.2.2
+           ===============================================
 
-Haskell is "the" standard lazy functional programming language; the
-current language version is 1.4, agreed in April, 1997.  Haskell
-related information is available from the Haskell home page at
+The GHC Team is pleased to announce a new minor release of GHC. This release
+builds on the performance and stability improvements of 8.2.1, fixing a variety
+of correctness bugs, improving error messages, and making the compiler more
+portable.
 
-       http://haskell.org/
+Notable bug-fixes include
 
-+ What's new
-=============
+ * A correctness issue resulting in segmentation faults in some
+   FFI-users (#13707, #14346)
 
-Release 2.09 contains some library changes that may break programs
-using glasgow extensions.  The main points:
+ * A correctness issue resulting in undefined behavior in some programs
+   using STM (#14171)
 
-       * PrimIO has been removed, replaced by IO in all places
-         (including the type of C calls).
-       * The types of IO and ST have changed, to make them more
-         efficient.  This won't bite you unless you go digging
-         around in the IO or ST monads, which you shouldn't...
-       * Several extension libraries have been moved to be
-         compatible with Hugs.  See 
+ * A bug which may have manifested in segmentation faults in
+   out-of-memory condition (#14329)
 
-               ftp://haskell.org/pub/reid/libs971028/libs.html
-       
-         for the definitions of the new libraries.
-       * Several of the interfaces exported by GlaExts are deprecated,
-         as they have been moved into common libraries (ST for instance).
-         GlaExts will eventually contain only extensions that are
-         exclusive to GHC.
+ * clearBit of Natural no longer bottoms (#13203)
 
-We've also fixed several bugs, one space leak, and added better
-handling of warnings (-W, -Wall and -Wnot flags).  As usual, see the
-release notes in the Users' Guide for the full story.
+ * A specialisation bug resulting in exponential blowup of compilation
+   time in some specialisation-intensive programs (#14379)
 
-+ Mailing lists
-================
+ * ghc-pkg now works even in environments with misconfigured NFS mounts
+   (#13945)
 
-We run mailing lists for GHC users and bug reports; to subscribe, send
-mail to majordomo@dcs.gla.ac.uk; the msg body should be:
+ * GHC again supports production of position-independent executables
+   (#13702)
 
-    subscribe glasgow-haskell-<which> Your Name <your-email@where.you.are>
+ * Better error messages around kind mismatches (#11198, #12373, #13530,
+   #13610)
 
-Please send bug reports about GHC to glasgow-haskell-bugs@dcs.gla.ac.uk ; GHC
-users hang out on glasgow-haskell-users@dcs.gla.ac.uk
+A thorough list of the changes in the release can be found in the release
+notes,
 
+    https://haskell.org/ghc/docs/8.2.2/html/users_guide/8.2.2-notes.html
 
-+ On-line GHC-related resources
-================================
 
-Relevant URLs on the World-Wide Web:
+How to get it
+~~~~~~~~~~~~~
 
-GHC home page            http://www.dcs.gla.ac.uk/fp/software/ghc/
-Haskell home page        http://haskell.org/
-Glasgow FP group page     http://www.dcs.gla.ac.uk/fp/
-comp.lang.functional FAQ  http://www.cs.nott.ac.uk/Department/Staff/mpj/faq.html
+This release can be downloaded from
 
+    https://www.haskell.org/ghc/download_ghc_8_2_2.html
 
-+ How to get it
-================
+For older versions see
 
-The easy way is to go to the WWW GHC distribution page, which should
-be self-explanatory:
+    https://www.haskell.org/ghc/
 
-       ftp://ftp.dcs.gla.ac.uk/pub/haskell/glasgow/README.html
+We supply binary builds in the native package format for many platforms, and the
+source distribution is available from the same place.
 
-Once you have the distribution, please follow the pointers in the
-README file to find all of the documentation about this release.  NB:
-preserve modification times when un-tarring the files (no `m' option
-for tar, please)!
 
+Background
+~~~~~~~~~~
 
-+ System requirements
-======================
+Haskell is a standardized lazy functional programming language.
 
-To compile up this source-only release, you need a machine with 16+MB
-memory, GNU C (`gcc'), `perl' plus a version of GHC installed (either
-version 0.29 or 2.02 onwards). We have seen GHC work on these platforms:
+GHC is a state-of-the-art programming suite for Haskell. Included is an
+optimising compiler generating efficient code for a variety of platforms,
+together with an interactive system for convenient, quick development. The
+distribution includes space and time profiling facilities, a large collection of
+libraries, and support for various language extensions, including concurrency,
+exceptions, and foreign language interfaces. GHC is distributed under a
+BSD-style open source license.
 
-  * alpha-dec-osf2
-  * hppa1.1-hp-hpux{9,10}
-  * sparc-sun-{sunos4,solaris2}
-  * mips-sgi-irix{5,6}
-  * i386-unknown-{linux,solaris2,freebsd,cygwin32}.
-  * {rs6000,powerpc}-ibm-aix
+A wide variety of Haskell related resources (tutorials, libraries,
+specifications, documentation, compilers, interpreters, references, contact
+information, links to research groups) are available from the Haskell home page
+(see below).
 
-Similar platforms should work with minimal hacking effort.  The installer's
-guide included in distribution gives a complete run-down of what-ports-work;
-an on-line version can be found at
 
-   http://www.dcs.gla.ac.uk/fp/software/ghc/ghc-doc/install-guide.html
+On-line GHC-related resources
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Relevant URLs:
+
+GHC home page              https://www.haskell.org/ghc/
+GHC developers' home page  https://ghc.haskell.org/trac/ghc/
+Haskell home page          https://www.haskell.org/
+
+
+Supported Platforms
+~~~~~~~~~~~~~~~~~~~
+
+The list of platforms we support, and the people responsible for them, is here:
+
+    https://ghc.haskell.org/trac/ghc/wiki/TeamGHC
+
+Ports to other platforms are possible with varying degrees of difficulty. The
+Building Guide describes how to go about porting to a new platform:
+
+    https://ghc.haskell.org/trac/ghc/wiki/Building
+
+
+Developers
+~~~~~~~~~~
+
+We welcome new contributors. Instructions on accessing our source code
+repository, and getting started with hacking on GHC, are available from the
+GHC's developer's site:
+
+    https://ghc.haskell.org/trac/ghc/
+
+
+Mailing lists
+~~~~~~~~~~~~~
+
+We run mailing lists for GHC users and bug reports; to subscribe, use the web
+interfaces at
+
+    https://mail.haskell.org/cgi-bin/mailman/listinfo/glasgow-haskell-users
+    https://mail.haskell.org/cgi-bin/mailman/listinfo/ghc-tickets
+
+There are several other haskell and ghc-related mailing lists on
+www.haskell.org; for the full list, see
+
+    https://mail.haskell.org/cgi-bin/mailman/listinfo
+
+Many GHC developers hang out on #haskell on IRC:
+
+    https://www.haskell.org/haskellwiki/IRC_channel
+
+Please report bugs using our bug tracking system. Instructions on reporting bugs
+can be found here:
+
+    https://www.haskell.org/ghc/reportabug
 
-EOF