[Add some runghc docs to the users guide
Ian Lynagh <igloo@earth.li>**20070819000258] {
addfile ./docs/users_guide/runghc.xml
hunk ./docs/users_guide/runghc.xml 1
+<?xml version="1.0" encoding="iso-8859-1"?>
+<chapter id="ghci">
+  <title>Using runghc</title>
+  <indexterm><primary>runghc</primary></indexterm>
+
+  <para>runghc allows you to run Haskell programs without first having
+  to compile them.</para>
+
+  <sect1 id="ghci-introduction">
+    <title>Flags</title>
+
+    <para>The runghc commandline looks like:</para>
+<screen>
+runghc [runghc flags] [GHC flags] module [program flags]
+</screen>
+    <para>The only runghc flag currently is
+    <literal>-f /path/to/ghc</literal>,
+    which tells runghc which GHC to use to run the program. If it is
+    not given then runghc will search for GHC in the directories in the
+    system search path.</para>
+
+    <para>runghc will try to work out where the boundaries between
+    <literal>[runghc flags]</literal> and
+    <literal>[GHC flags]</literal>, and
+    <literal>[GHC flags]</literal> and
+    <literal>module</literal> are, but you can use a
+    <literal>--</literal> flag if it doesn't get it right. For example,
+    <literal>runghc -- -fglasgow-exts Foo</literal> means runghc
+    won't try to use <literal>glasgow-exts</literal> as the path to GHC,
+    but instead will pass the flag to GHC.
+    </para>
+
+  </sect1>
+
+</chapter>
+
+<!-- Emacs stuff:
+     ;;; Local Variables: ***
+     ;;; mode: xml ***
+     ;;; sgml-parent-document: ("users_guide.xml" "book" "chapter") ***
+     ;;; End: ***
+ -->
hunk ./docs/users_guide/ug-book.xml.in 14
+&runghc;
hunk ./docs/users_guide/ug-ent.xml 2
+<!ENTITY runghc         SYSTEM "runghc.xml">
}