ghc/docs/ANNOUNCE-0.20

   1 This is version 0.20 of the Glorious Glasgow Haskell compilation
   2 system (GHC).
   3
   4 Version 0.20 is an "internal" release, intended *ONLY* for the most
   5 fanatical GHC hackers.
   6
   7 * Many things about it may be broken, though it
   8 does compile and run most programs.
   9
  10 * I/O and ccall scheme re-done; any such low-level code probably needs
  11   fixing; I/O attempts to follow 1.3 I/O proposal.  All ccall
  12   arguments and results are automagically "boxed".
  13
  14 * PrimOps fiddled; any code that uses them directly will probably need
  15   attention.
  16
  17 * We've renamed some things, so as to move to a we-don't-steal-user-
  18   name-space policy.  Thus "tagCmp" has become "_tagCmp".  Names starting
  19   with underscores are now cool if -fglasgow-exts.
  20
  21   You might want to see our "state-interface" document if you mess
  22   with all this low-level/non-standard stuff; I'll try to remember to
  23   put a copy up for FTP.
  24
  25 * No promises about profiling.
  26
  27 * Documentation is untouched since 0.19.
  28
  29 Version 0.19 was the last public release.  It has held up pretty well
  30 and should be available wherever you got 0.20 from.  I commend 0.19 to
  31 all sane people.
  32
  33 Configuring 0.20 is a little different than 0.19:
  34
  35     % cd <very-top>
  36     % ./configure --with-boot=c
  37     % ./STARTUP-ghc std
  38     % cd ghc; make
  39
  40 Things to note:
  41
  42 * It's wrong for jmake to tell you "0: unknown flag -traditional"; but
  43   it is harmless.
  44
  45 * The 0.20 compiler seems more likely to run out of stack; use
  46   -Rmax-stksize2m (or something) to increase; within the distribution,
  47   probably something like...
  48
  49     % make EXTRA_HC_OPTS="-H20m -Rmax-stksize4m"
  50
  51 See the "configure" script if you want to know what other options are
  52 -- there is no other documentation at this time!
  53
  54 Will Partain, AQUA project typist
  55 partain@dcs.glasgow.ac.uk