[project @ 1996-01-11 14:06:51 by partain]
[ghc-hetmet.git] / ghc / docs / ANNOUNCE-0.27
1 A binary-only from-working-sources no-guarantees snapshot of the
2 Glasgow Haskell compiler (GHC) for i386-unknown-linuxaout and
3 i386-unknown-solaris2 platforms is now available from
4 ftp://ftp.dcs.glasgow.ac.uk/pub/haskell/glasgow/ghc-0.27-<platform>.tar.gz.
5 (The files ghc-0.26-docs-and-examples.tar.gz and
6 ghc-0.26-ps-docs.tar.gz [PostScript] may also be of interest.)
7
8 This pseudo-release adds profiling and concurrent-Haskell support for
9 i386-*-linuxaout.  It is the first GHC that works on i386-*-solaris2
10 machines (sequential, profiling, and concurrent support provided).
11
12 As 0.27 is a snapshot and not a "proper" release, it may have serious,
13 show-stopping bugs in it.  If you *need* what 0.27 provides, use it;
14 otherwise, you should stick with 0.26.
15
16 It should be relatively straightforward to tweak
17 ghc/driver/ghc-asm.(l)prl to support Linux ELF format; ditto for other
18 Unices on x86 platforms.  Please let us know if you make such changes.
19
20 GCC 2.7.x is required; GCC 2.6.x will *not* work.
21
22 Binaries (.o files and executables) produced by GHC 0.27 cannot be
23 intermixed with those from GHC 0.26 or 0.25; you'll need to recompile
24 everything.
25
26 The -concurrent stuff *definitely* has at least one bug we haven't
27 been able to catch.  Concurrent programs that show
28 readily-reproducible buggy behavior would be most welcome.
29
30 The profiling libraries for *solaris2 are huge, for reasons we don't
31 understand.  If you need to scrap them for space reasons, see the end
32 of the installation notes below.  Insights into the problem would also
33 be most appreciated.
34
35 Please report any bugs to glasgow-haskell-bugs@dcs.glasgow.ac.uk.
36
37 Will Partain
38 AQUA project (slave)
39
40 Dated: 95/12/20
41
42 === INSTALLATION NOTES ==============================================
43
44 Ignore the installation instructions in any documentation.  This is
45 the stuff that applies for this distribution.
46
47 Unpack the distribution.
48
49 Move "ghc-0.27-<platform>" to wherever you like.
50
51 Make a link to ghc-0.27-<platform>/ghc/driver/ghc, so that "ghc" will
52 be in your PATH.
53
54 Change the hardwired paths in ghc/driver/ghc and in
55 ghc/utils/hscpp/hscpp to point to where things are on your system.
56 (Also: ghc/utils/mkdependHS/mkdependHS, if you want to use it.)
57 Notably: where "perl" is (first line of each script), where $TopPwd is
58 (ghc script), where your gcc cpp ($OrigCpp) is (hscpp and mkdependHS
59 scripts).  *Don't* set any environment variables to do this.
60
61 GHC should then work.  Try "ghc -v" on something simple, to make sure
62 it compiles and links a program correctly.
63
64 If you don't want the profiling libraries (e.g., to save disk space), do:
65
66     cd ghc
67     rm runtime/*_p.a lib/*_p.a
68
69 If you don't want to concurrent-Haskell libraries (e.g., same reason), do:
70
71     cd ghc
72     rm runtime/*_mc.a lib/*_mc.a