[project @ 1996-01-08 20:28:12 by partain]
[ghc-hetmet.git] / ghc / docs / users_guide / intro.lit
1 %
2 % $Header: /srv/cvs/cvs.haskell.org/fptools/ghc/docs/users_guide/Attic/intro.lit,v 1.1 1996/01/08 20:25:10 partain Exp $
3 %
4 \section[introduction-GHC]{Introduction to GHC}
5
6 This is a guide to using the Glasgow Haskell compilation (GHC) system.
7 It is a batch compiler for the Haskell~1.2 language, with support for
8 various extensions, including the DRAFT 1.3 I/O proposal.
9
10 Many people will use GHC very simply: compile some
11 modules---\tr{ghc -c -O Foo.hs Bar.hs}; and link them---
12 \tr{ghc -o wiggle -O Foo.o Bar.o}.
13
14 But if you need to do something more complicated, GHC can do that,
15 too:
16 \begin{verbatim}
17 ghc -c -O -fno-foldr-build -dcore-lint -fvia-C -ddump-simpl Foo.lhs
18 \end{verbatim}
19 Stay tuned---all will be revealed!
20
21 In this document, we assume that GHC has been installed at your
22 site as \tr{ghc}.
23 If you are unfamiliar with the conventions of UNIX compilers, the
24 material in \sectionref{compiler-tutorial} may help.
25
26 %--------------------------------------------------------------------
27 \section[mailing-lists-GHC]{Knowing us, knowing you: Web sites, mailing lists, etc.}
28 \index{mailing lists, Glasgow Haskell}
29 \index{Glasgow Haskell mailing lists}
30
31 On the World-Wide Web, there are several URLs of likely interest:
32 \begin{display}
33 GHC home page -- http://www.dcs.glasgow.ac.uk/fp/software/ghc.html
34 Glasgow FP group page -- http://www.dcs.glasgow.ac.uk/fp/
35 comp.lang.functional FAQ -- http://www.cs.nott.ac.uk/Department/Staff/mpj/faq.html
36 programming language research page --
37    http://www.cs.cmu.edu/afs/cs.cmu.edu/user/mleone/web/language-research.html
38 \end{display}
39 We run two mailing lists about Glasgow Haskell.  We encourage you to
40 join, as you feel is appropriate.
41 \begin{description}
42 \item[glasgow-haskell-users:]
43 This list is for GHC users to chat among themselves.  Subscribe by
44 sending mail to \tr{glasgow-haskell-users-request@dcs.glasgow.ac.uk}.
45 Messages for the list go to \tr{glasgow-haskell-users}.
46
47 \item[glasgow-haskell-bugs:]
48 Send bug reports for GHC to this address!  The sad and lonely people
49 who subscribe to this list will muse upon what's wrong and what you
50 might do about it.
51
52 Subscribe via \tr{glasgow-haskell-bugs-request@dcs.glasgow.ac.uk}.
53 \end{description}
54
55 There is also the general Haskell mailing list.  Subscribe by sending
56 email to \tr{haskell-request@dcs.glasgow.ac.uk} or
57 \tr{haskell-request@cs.yale.edu}, whichever is geographically closer
58 to you.
59
60 Some Haskell-related discussion takes place in the Usenet newsgroup
61 \tr{comp.lang.functional}.  (But note: news propagation to Glasgow can
62 be terrible.  That's one reason Glaswegians aren't too active in
63 c.f.l.)
64
65 The main anonymous-FTP site for Glasgow Haskell is
66 \tr{ftp.dcs.glasgow.ac.uk}, in \tr{pub/haskell/glasgow/}.
67 ``Important'' bits are mirrored at other Haskell archive sites (and we
68 have their stuff, too).
69