ghc/docs/users_guide/intro.lit

   1 %
   2 % $Header: /srv/cvs/cvs.haskell.org/fptools/ghc/docs/users_guide/Attic/intro.lit,v 1.2 1996/07/25 20:48:26 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.3 language, with support for
   8 various Glasgow-only extensions.
   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.gla.ac.uk/fp/software/ghc/
  34 Glasgow FP group page -- http://www.dcs.gla.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{majordomo@dcs.gla.ac.uk}, with
  45 a message body (not header) like this:
  46 \begin{verbatim}
  47 subscribe glasgow-haskell-users My Name <m.y.self@bigbucks.com>
  48 \end{verbatim}
  49 (The last bit is your all-important e-mail address, of course.)
  50
  51 To communicate with your fellow users, send mail to \tr{glasgow-haskell-users}.
  52
  53 To contact the list administrator, send mail to
  54 \tr{glasgow-haskell-users-request}.  An archive of the list is
  55 available on the Web at:
  56 \begin{verbatim}
  57 \tr{http://www.dcs.gla.ac.uk/mail-www/glasgow-haskell-users}.
  58 \end{verbatim}
  59
  60 \item[glasgow-haskell-bugs:]
  61 Send bug reports for GHC to this address!  The sad and lonely people
  62 who subscribe to this list will muse upon what's wrong and what you
  63 might do about it.
  64
  65 Subscribe via \tr{majordomo@dcs.gla.ac.uk} with:
  66 \begin{verbatim}
  67 subscribe glasgow-haskell-bugs My Name <m.y.self@hackers.r.us>
  68 \end{verbatim}
  69
  70 Again, you may contact the list administrator at
  71 \tr{glasgow-haskell-bugs-request}.
  72 And, yes,  an archive of the list is
  73 available on the Web at:
  74 \begin{verbatim}
  75 \tr{http://www.dcs.gla.ac.uk/mail-www/glasgow-haskell-bugs}.
  76 \end{verbatim}
  77 \end{description}
  78
  79 There is also the general Haskell mailing list.  Subscribe by sending
  80 email to \tr{majordomo@dcs.gla.ac.uk}, with the usual message body:
  81 \begin{verbatim}
  82 subscribe haskell My Name <m.y.self@fp.rules.ok.org>
  83 \end{verbatim}
  84
  85 Some Haskell-related discussion takes place in the Usenet newsgroup
  86 \tr{comp.lang.functional}.  (But note: news is basically dead at Glasgow.
  87 That's one reason Glaswegians aren't too active in c.f.l.)
  88
  89 The main anonymous-FTP site for Glasgow Haskell is
  90 \tr{ftp.dcs.gla.ac.uk}, in \tr{pub/haskell/glasgow/}.
  91 ``Important'' bits are mirrored at other Haskell archive sites (and we
  92 have their stuff, too).
  93