[project @ 1998-11-26 09:17:22 by sof]
[ghc-hetmet.git] / ghc / docs / users_guide / 2-03-notes.vsgml
1 <sect1>Release notes for version~2.03---4/97
2 <label id="release-2-03">
3 <p>
4
5 GHC 2.03 is a minor upgrade of GHC 2.02.  It differs in the following
6 ways:
7
8 <itemize>
9 <item>
10     A slew of small bugs are fixed.  You can find the complete list
11     at:
12
13 <tscreen><verb>
14 http://www.cse.ogi.edu/~simonpj/ghc-bugs.html
15 </verb></tscreen>
16
17     One bug remains un-fixes, namely the crash when there's an empty 
18     comment at the end of file.  It's wierd!
19
20 <item>
21     Last-minute language changes have been implemented (minor changes
22     to the libraries, and to module export/hiding scope rules)
23
24 <item>
25     It is only available as a source distribution.  If you want to
26     use it you'll have to build it from source.  Nowadays this is
27     a well-documented process (see the build and installation guide, but
28     note that this release is still not self-booting, you still need
29     to have The Good Old Compiler (0.29) at your disposal).
30 </itemize>
31
32 None of the bugs in GHC 2.02 are show-stoppers, so you'll only want
33 to upgrade if you are a build-from-source junkie and the bugs are 
34 irritating you.
35
36 Apart from bug-fixes, which are itemized elsewhere, 
37 the exact language and standard-library changes are as follows:
38 <itemize>
39 <item>
40 A hiding clause hides the unqualified name, but not the qualified name.
41 <item> 
42 There's a new @Numeric@ library, containing mostly mildly marginal
43 code for showing and reading numbers.  Parts of its exports used to be
44 exported by @Prelude@, but now you'll have to import them explicitly.
45 It also defines some functions that weren't provided before; have a
46 look in the Haskell library report for details of complete interface.
47 <item>
48 The following extra functions are exported from @IO@: 
49 @try@, @bracket@, @bracket_@, @hGetLine@, @hWaitForInput@.
50 </itemize>
51
52 In addition, we've made following changes to GHC libraries/GHC's
53 implementation of the Haskell standard prelude:
54
55 <itemize>
56 <item> The function @fromRational__@, exported from @PrelNum@, is now called @fromRat@.
57 (And it's exported by @Numeric@.)
58 <item>
59 Documentation for the Glasgow specific interfaces plus the system
60 libraries have been re-instated. Posix library documentation included also.
61 <item>
62 @maybe@ is now exported from Prelude, as it should have been in 2.02.
63 <item>
64 Equality on @IO.Handle@ is now defined as specified by the library
65 report.
66 <item>
67 @Ix.rangeSize@ returns @0@ on an empty range;previously it failed.
68 <item>
69 The new interface @GlaExts@ which is meant to be the gateway to the
70 various Glasgow extensions has now been documented.
71 <item>
72 @GlaExts@ now exports the representation of @Char@.
73 <item>
74 The mutable variable interface, @MutVar@, has also been documented,
75 together with @ByteArray@, @MutableArray@ and @Foreign@.
76 <item>
77 Added documentation on how to compile mutually recursive modules with
78 2.03.
79 </itemize>