[project @ 1998-12-02 13:17:09 by simonm]
[ghc-hetmet.git] / ghc / docs / users_guide / intro.vsgml
index f23c342..f4315b6 100644 (file)
@@ -74,9 +74,13 @@ The <em>ANSI~C Haskell high-level assembler :-)</em>
 <nidx>ANSI C compiler</nidx>
 <nidx>high-level assembler</nidx>
 <nidx>assembler, high-level</nidx>
+
 compiles @hsc@'s C output into assembly language for a particular
-target architecture.  (It doesn't have to be an ANSI C compiler, but
-that's preferred; to go fastest, you need GNU C, version 2.x.)
+target architecture.  In fact, the only C compiler we currently
+support is <tt/gcc/, because we make use of certain extensions to the
+C language only supported by gcc.  Version 2.x is a must; we recommend
+version 2.7.2.1 for stability (we've heard both good and bad reports
+of later versions).
 
 <item>
 The <em>assembler</em><nidx>assembler</nidx>---a standard UNIX one, probably
@@ -132,8 +136,7 @@ compiler), which produces an object file and passes it to
 <item>
 The linker, which links your code with the appropriate libraries
 (including the standard prelude), producing an executable program in
-the default output file named either @a.out@ (*NIX platforms) or @main.exe@
-(Windows port.)
+the default output file named @a.out@.
 </enum>
 
 You have considerable control over the compilation process.  You feed
@@ -172,23 +175,23 @@ join, as you feel is appropriate.
 <tag>glasgow-haskell-users:</tag>
 
 This list is for GHC users to chat among themselves.  Subscribe by
-sending mail to <htmlurl name="majordomo@dcs.gla.ac.uk"
-url="mailto:majordomo@dcs.gla.ac.uk">, with a message body (not
+sending mail to <htmlurl name="majordomo@@dcs.gla.ac.uk"
+url="mailto:majordomo@@dcs.gla.ac.uk">, with a message body (not
 header) like this:
 
 <tscreen><verb> 
-subscribe glasgow-haskell-users MyName <m.y.self@bigbucks.com> 
+subscribe glasgow-haskell-users MyName <m.y.self@@bigbucks.com> 
 </verb></tscreen> 
 
 (The last bit is your all-important e-mail address, of course.)
 
 To communicate with your fellow users, send mail to <url
-name="glasgow-haskell-users@dcs.gla.ac.uk"
-url="mailto:glasgow-haskell-users@dcs.gla.ac.uk">.
+name="glasgow-haskell-users@@dcs.gla.ac.uk"
+url="mailto:glasgow-haskell-users@@dcs.gla.ac.uk">.
 
 To contact the list administrator, send mail to <htmlurl
-name="glasgow-haskell-users-request@dcs.gla.ac.uk"
-url="mailto:glasgow-haskell-users-request@dcs.gla.ac.uk">.  An archive
+name="glasgow-haskell-users-request@@dcs.gla.ac.uk"
+url="mailto:glasgow-haskell-users-request@@dcs.gla.ac.uk">.  An archive
 of the list is available on the Web: <url name="glasgow-haskell-users
 mailing list archive"
 url="http://www.dcs.gla.ac.uk/mail-www/glasgow-haskell-users">.
@@ -198,16 +201,16 @@ Send bug reports for GHC to this address!  The sad and lonely people
 who subscribe to this list will muse upon what's wrong and what you
 might do about it.
 
-Subscribe via <htmlurl name="majordomo@dcs.gla.ac.uk"
-url="mailto:majordomo@dcs.gla.ac.uk"> with:
+Subscribe via <htmlurl name="majordomo@@dcs.gla.ac.uk"
+url="mailto:majordomo@@dcs.gla.ac.uk"> with:
 
 <tscreen><verb>
-subscribe glasgow-haskell-bugs My Name <m.y.self@hackers.r.us>
+subscribe glasgow-haskell-bugs My Name <m.y.self@@hackers.r.us>
 </verb></tscreen>
 
 Again, you may contact the list administrator at <htmlurl
-name="glasgow-haskell-bugs-request@dcs.gla.ac.uk"
-url="mailto:glasgow-haskell-bugs-request@dcs.gla.ac.uk">.
+name="glasgow-haskell-bugs-request@@dcs.gla.ac.uk"
+url="mailto:glasgow-haskell-bugs-request@@dcs.gla.ac.uk">.
 And, yes, an archive of the list is available on the Web at: : <url
 name="glasgow-haskell-bugs mailing list archive"
 url="http://www.dcs.gla.ac.uk/mail-www/glasgow-haskell-bugs">
@@ -215,11 +218,11 @@ url="http://www.dcs.gla.ac.uk/mail-www/glasgow-haskell-bugs">
 </descrip>
 
 There is also the general Haskell mailing list.  Subscribe by sending
-email to <htmlurl name="majordomo@dcs.gla.ac.uk"
-url="mailto:majordomo@dcs.gla.ac.uk">, with the usual message body:
+email to <htmlurl name="majordomo@@dcs.gla.ac.uk"
+url="mailto:majordomo@@dcs.gla.ac.uk">, with the usual message body:
 
 <tscreen><verb>
-subscribe haskell My Name <m.y.self@fp.rules.ok.org>
+subscribe haskell My Name <m.y.self@@fp.rules.ok.org>
 </verb></tscreen>
 
 Some Haskell-related discussion takes place in the Usenet newsgroup