[project @ 2001-11-13 03:28:03 by chak]
[ghc-hetmet.git] / ghc / ANNOUNCE
index aabfb65..4df3c97 100644 (file)
-            The Glasgow Haskell Compiler -- version 4.06
-           ==============================================
 
-We are pleased to announce a new release of the Glasgow Haskell
-Compiler (GHC), version 4.06.  The source distribution is freely
-available via the World-Wide Web and through anon. FTP; details below.
+   ============================================================
+    The (Interactive) Glasgow Haskell Compiler -- version 5.02
+   ============================================================
 
-Haskell is "the" standard lazy functional programming language; the
-current language version is Haskell 98, agreed in December 1998.
-Haskell related information is available from the Haskell home page at
+We are pleased to announce a new major release of the Glasgow Haskell
+Compiler (GHC), version 5.02.  
 
-       http://www.haskell.org/
+This is the first version of GHC that has all of the following:
 
-GHC's Web page lives at
+  * An interactive read-eval-print loop, similar to Hugs.
+    You can load a mixture of compiled and interpreted modules;
+    in particular, you automatically use the precompiled libraries,
+    so your "interpreted" programs often run pretty fast.
 
-       http://www.haskell.org/ghc/
+  * Works solidly on Windows platforms.  Installation is simple
+    (Installshield); you don't have to install anything else; 
+    and GHC does not get confused if you also happen to 
+    have (say) Cygwin installed.
 
-+ What's new
-=============
+  * Implements the changes adopted for the (now almost finalised)
+    Revised Haskell 98 Language and Library Reports.
 
-This should be a stable release. We have not made major changes
-since 4.04 to the core compiler, but we have fixed lots of bugs.
-We believe that 4.06 is in a nice stable well-tested state.  (Ha!)
+  * The ability to emit "External Core", a documented typed 
+    intermediate language, suitable for slurping up into other
+    tools.  [Andrew Tolmach's work.]
 
-Apart from that, there are the following changes
+  * A particularly thorough pre-release test programme.
+    Some releases are more solid than others; this one is
+    at the solid end of the spectrum.  We fondly hope.
 
-   - Major library reorganisation.  All libraries, except the ones that
-     are part of the Haskell 98 *language* specification, have moved to
-     fptools/hslibs/.  The hslibs tree is independent of GHC, shared between
-     GHC, Hugs, and (we hope) other Haskell implementations.  
-     The idea is to make it easier for people to contribute and maintain 
-     libraries.
+So if you have been waiting to upgrade your GHC 4.08, this is 
+the moment. 
 
-     The hslibs/ tree is organised in a Java-like fashion.  Details in 
-     the new Library guide.  <url please>
 
-     Existing programs that use the -syslib flag may need to change which
-     syslibs they include.
+How to get it
+~~~~~~~~~~~~~
+The easy way is to go to the WWW page, which should be self-explanatory:
 
-   - Support for "foreign export dynamic".
+        http://www.haskell.org/ghc/
 
-   - Clean up of concurrent I/O system; in particular, I/O is now non-blocking,
-     except (alas) on stdout/stderr for tiresome reasons.
+We supply binary builds in the native package format for various
+flavours of Linux and BSD, and in InstallShield form for Windows
+folks.  Binary builds for other platforms are available as a .tar.gz
+which can be installed wherever you want.  The source distribution is
+also available from the same place.
 
-   - Some refinements to the exceptions mechanism <url please>
+Once you have the distribution, please follow the pointers in the
+README file to find all of the documentation about this release.
 
-   - More performance tuning: compiled programs now allocate 10% less than 4.04
 
-For full details see the release notes:
+More details about what's new
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-       http://www.haskell.org/ghc/docs/latest/users_guide/users_guide-1.html#ss1.4
+5.02 incorporates many small refinements and bug fixes over the previous 
+stable release (5.00.2).  There are no major language changes.
 
-+ Mailing lists
-================
+   - Implements Haskell 98 (revised)
 
-We run mailing lists for GHC users and bug reports; to subscribe, send
-mail to majordomo@haskell.org; the msg body should be:
+   - Ability to emit External Core.  (But GhC can't read External Core
+     back in.  Yet.)
 
-    subscribe glasgow-haskell-<which> Your Name <your-email@where.you.are>
+   - Much improved support for Windows platforms.  Binary builds are
+     now entirely freestanding.  There's no need to install Cygwin or
+     Mingwin to use it.  It's a one-click-install-and-off-you-go story now.
 
-Please send bug reports about GHC to glasgow-haskell-bugs@haskell.org ; GHC
-users hang out on glasgow-haskell-users@haskell.org
+   - Several small changes to bring GHC into line with the newest Haskell 98 
+     report.
 
+   - GHCi (the interactive system) now works on Windows.
 
-+ On-line GHC-related resources
-================================
+   - Partial FFI support in GHCi.  At the moment, foreign import (both
+     static and dynamic) is supported on x86 and sparc platforms.
 
-Relevant URLs on the World-Wide Web:
+   - A compacting garbage collector, to try and reduce space use.
 
-GHC home page            http://www.haskell.org/ghc/
-Haskell home page        http://www.haskell.org/
-comp.lang.functional FAQ  http://www.cs.nott.ac.uk/Department/Staff/mpj/faq.html
+   - Ability to disconnect built-in numeric syntax from the supplied 
+     Prelude. This allows you to define your own arithmetic packages,
+     which Haskell98 doesn't quite support.
 
+   - Experimental: partial support for hierarchical module names.
 
-+ How to get it
-================
+   - Experimental: following heroic hacking by Ken Shan, 5.02 now
+     works on Alpha (Tru64 only).  Many 64-bit bugs have been shaken
+     out.  At the moment only the batch-mode compiler works -- no GHCi
+     or native code generator yet.
 
-The easy way is to go to the WWW page, which should be
-self-explanatory:
+We've found and fixed more bugs than you could possibly imagine.  A
+big thank-you to all those who reported bugs in the 5.00.X series.  We
+claim to have fixed almost all reported bugs.  In general we've spent
+a large amount of effort trying to improve the stability of the
+system relative to 5.00.X.  (Famous last words ...)
 
-       http://www.haskell.org/ghc/
+For full details see the release notes:
 
-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)!
+        http://www.haskell.org/ghc/docs/5.02/set/release-5-02.html
 
 
-+ System requirements
-======================
+Background
+~~~~~~~~~~
+Haskell is a standard lazy functional programming language; the
+current language version is Haskell 98, agreed in December 1998.
 
-To compile up this source-only release, you need a machine with 32+MB
-memory, GNU C (`gcc'), `perl' plus a version of GHC installed (3.02 at
-least).  This release is known to work on the following platforms:
+GHC is a state-of-the-art programming suite for Haskell.  Included is
+an optimising compiler generating good 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 (C, whatever).  GHC is distributed under a
+BSD-style open source license.
 
-  * i386-unknown-{linux,solaris2,freebsd,netbsd,cygwin32}
-  * sparc-sun-{sunos4,solaris2}
-  * hppa1.1-hp-hpux{9,10}
+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 at
+
+        http://www.haskell.org/
+
+GHC's Web page lives at
+
+        http://www.haskell.org/ghc/
+
+
+On-line GHC-related resources
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Relevant URLs on the World-Wide Web:
 
-Ports to the following platforms should be relatively easy, but
-haven't been tested due to lack of time/hardware:
+GHC home page             http://www.haskell.org/ghc/
+Haskell home page         http://www.haskell.org/
+comp.lang.functional FAQ  http://www.cs.nott.ac.uk/~gmh/faq.html
 
+
+
+System requirements
+~~~~~~~~~~~~~~~~~~~
+To compile programs with GHC, you need a machine with 64+MB memory, GNU C
+and perl. This release is known to work on the following platforms:
+
+  * i386-unknown-{linux,freebsd,mingw32}
+  * sparc-sun-solaris2
+
+Ports to the following platforms should be relatively easy (for a
+wunderhacker), but haven't been tested due to lack of time/hardware:
+
+  * hppa1.1-hp-hpux{9,10}
+  * i386-unknown-solaris2
   * alpha-dec-osf{2,3}
   * mips-sgi-irix{5,6}
   * {rs6000,powerpc}-ibm-aix
 
-The installer's guide included in distribution gives a complete
-run-down of what-ports-work; an on-line version can be found at
+The builder's guide included in distribution gives a complete
+run-down of what ports work; an on-line version can be found at
+
+   http://www.haskell.org/ghc/docs/5.02/building/building-guide.html
+
+
+
+Mailing lists
+~~~~~~~~~~~~~
+We run mailing lists for GHC users and bug reports; to subscribe, use
+the web interfaces at
+
+       http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
+       http://www.haskell.org/mailman/listinfo/glasgow-haskell-bugs
+
+There are several other haskell and ghc-related mailing lists on
+www.haskell.org; for the full list, see
+
+       http://www.haskell.org/mailman/listinfo/
+
+Please report bugs using our SourceForge page at
+       
+       http://sourceforge.net/projects/ghc/
+
+or send them to glasgow-haskell-bugs@haskell.org.
+
+GHC users hang out on glasgow-haskell-users@haskell.org.  Bleeding
+edge CVS users party on cvs-ghc@haskell.org.
 
-   http://www.haskell.org/ghc/docs/latest/installation_guide/installing.html