[project @ 1996-01-08 20:28:12 by partain]

[ghc-hetmet.git] / ghc / docs / users_guide / intro.lit

diff --git a/ghc/docs/users_guide/intro.lit b/ghc/docs/users_guide/intro.lit
new file mode 100644 (file)
index 0000000..4a85d28
--- /dev/null
+++ b/ghc/docs/users_guide/intro.lit
@@ -0,0 +1,69 @@
+%
+% $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).
+