From 60170b40dd3e3396dc3991884880f2365c9b0c08 Mon Sep 17 00:00:00 2001
From: simonmar <unknown>
Date: Wed, 25 Feb 2004 11:49:15 +0000
Subject: [PATCH] [project @ 2004-02-25 11:49:14 by simonmar] Document
 -threaded and -debug options.

---
 ghc/docs/users_guide/flags.sgml  |   12 ++++++++++++
 ghc/docs/users_guide/phases.sgml |   38 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 50 insertions(+)

diff --git a/ghc/docs/users_guide/flags.sgml b/ghc/docs/users_guide/flags.sgml
index 47ad98d..01c074f 100644
--- a/ghc/docs/users_guide/flags.sgml
+++ b/ghc/docs/users_guide/flags.sgml
@@ -1161,6 +1161,18 @@
 	      <entry>static</entry>
 	      <entry>-</entry>
 	    </row>
+	    <row>
+	      <entry><option>-threaded</option></entry>
+	      <entry>Use the threaded runtime</entry>
+	      <entry>static</entry>
+	      <entry>-</entry>
+	    </row>
+	    <row>
+	      <entry><option>-debug</option></entry>
+	      <entry>Use the debugging runtime</entry>
+	      <entry>static</entry>
+	      <entry>-</entry>
+	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
diff --git a/ghc/docs/users_guide/phases.sgml b/ghc/docs/users_guide/phases.sgml
index 6a43d90..e2cf536 100644
--- a/ghc/docs/users_guide/phases.sgml
+++ b/ghc/docs/users_guide/phases.sgml
@@ -673,6 +673,44 @@ strmod = "\
 	    <literal>Main</literal>).</para>
 	  </listitem>
 	</varlistentry>
+
+	<varlistentry>
+	  <term><option>-debug</option></term>
+	  <indexterm><primary><option>-debug</option></primary>
+	  </indexterm>
+	  <listitem>
+	    <para>Link the program with a debugging version of the
+	    runtime system.  The debugging runtime turns on numerous
+	    assertions and sanity checks, and provides extra options
+	    for producing debugging output at runtime (run the program
+	    with <literal>+RTS&nbsp;-?</literal> to see a list).</para>
+	  </listitem>
+	</varlistentry>
+
+	<varlistentry>
+	  <term><option>-threaded</option></term>
+	  <indexterm><primary><option>-threaded</option></primary>
+	  </indexterm>
+	  <listitem>
+	    <para>Link the program with the "threaded" runtime system.
+	    This version of the runtime is designed to be used in
+	    programs that use multiple operating-system threads.  It
+	    supports calls to foreign-exported functions from multiple
+	    OS threads.  Calls to foreign functions are made using the
+	    same OS thread that created the Haskell thread (if it was
+	    created by a call-in), or an arbitrary OS thread otherwise
+	    (if the Haskell thread was created by
+	    <literal>forkIO</literal>).</para>
+
+	    <para>The threaded RTS does <emphasis>not</emphasis>
+	    support using multiple CPUs to speed up execution of a
+	    multi-threaded Haskell program.  The GHC runtime platform
+	    is still single-threaded, but using the
+	    <option>-threaded</option> option it can be used safely in
+	    a multi-threaded environment.</para>
+	  </listitem>
+	</varlistentry>
+
       </variablelist>
     </sect2>
 
-- 
1.7.10.4