%
% $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 $
%
\section[introduction-GHC]{Introduction to GHC}

This is a guide to using the Glasgow Haskell compilation (GHC) system.
It is a batch compiler for the Haskell~1.2 language, with support for
various extensions, including the DRAFT 1.3 I/O proposal.

Many people will use GHC very simply: compile some
modules---\tr{ghc -c -O Foo.hs Bar.hs}; and link them---
\tr{ghc -o wiggle -O Foo.o Bar.o}.

But if you need to do something more complicated, GHC can do that,
too:
\begin{verbatim}
ghc -c -O -fno-foldr-build -dcore-lint -fvia-C -ddump-simpl Foo.lhs
\end{verbatim}
Stay tuned---all will be revealed!

In this document, we assume that GHC has been installed at your
site as \tr{ghc}.
If you are unfamiliar with the conventions of UNIX compilers, the
material in \sectionref{compiler-tutorial} may help.

%--------------------------------------------------------------------
\section[mailing-lists-GHC]{Knowing us, knowing you: Web sites, mailing lists, etc.}
\index{mailing lists, Glasgow Haskell}
\index{Glasgow Haskell mailing lists}

On the World-Wide Web, there are several URLs of likely interest:
\begin{display}
GHC home page -- http://www.dcs.glasgow.ac.uk/fp/software/ghc.html
Glasgow FP group page -- http://www.dcs.glasgow.ac.uk/fp/
comp.lang.functional FAQ -- http://www.cs.nott.ac.uk/Department/Staff/mpj/faq.html
programming language research page --
   http://www.cs.cmu.edu/afs/cs.cmu.edu/user/mleone/web/language-research.html
\end{display}
We run two mailing lists about Glasgow Haskell.  We encourage you to
join, as you feel is appropriate.
\begin{description}
\item[glasgow-haskell-users:]
This list is for GHC users to chat among themselves.  Subscribe by
sending mail to \tr{glasgow-haskell-users-request@dcs.glasgow.ac.uk}.
Messages for the list go to \tr{glasgow-haskell-users}.

\item[glasgow-haskell-bugs:]
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 \tr{glasgow-haskell-bugs-request@dcs.glasgow.ac.uk}.
\end{description}

There is also the general Haskell mailing list.  Subscribe by sending
email to \tr{haskell-request@dcs.glasgow.ac.uk} or
\tr{haskell-request@cs.yale.edu}, whichever is geographically closer
to you.

Some Haskell-related discussion takes place in the Usenet newsgroup
\tr{comp.lang.functional}.  (But note: news propagation to Glasgow can
be terrible.  That's one reason Glaswegians aren't too active in
c.f.l.)

The main anonymous-FTP site for Glasgow Haskell is
\tr{ftp.dcs.glasgow.ac.uk}, in \tr{pub/haskell/glasgow/}.
``Important'' bits are mirrored at other Haskell archive sites (and we
have their stuff, too).