From 80d27b41e8e674d93d090e2314076f61a1e04f1e Mon Sep 17 00:00:00 2001
From: simonmar <unknown>
Date: Tue, 18 Dec 2001 12:13:05 +0000
Subject: [PATCH] [project @ 2001-12-18 12:13:05 by simonmar] Add the missing
 options list to the section "Replacing the program for one
 or more phases".

---
 ghc/docs/users_guide/phases.sgml |   88 ++++++++++++++++++++++++++++++++++++--
 1 file changed, 85 insertions(+), 3 deletions(-)

diff --git a/ghc/docs/users_guide/phases.sgml b/ghc/docs/users_guide/phases.sgml
index e7f4694..864ee5c 100644
--- a/ghc/docs/users_guide/phases.sgml
+++ b/ghc/docs/users_guide/phases.sgml
@@ -2,7 +2,7 @@
     <title>Options related to a particular phase</title>
 
     <sect2 id="replacing-phases">
-      <title>Replacing the program for one or more phases.</title>
+      <title>Replacing the program for one or more phases</title>
       <indexterm><primary>phases, changing</primary></indexterm>
 
       <para>You may specify that a different program be used for one
@@ -10,12 +10,94 @@
       the <Command>ghc</Command> has wired into it.  For example, you
       might want to try a different assembler.  The following options
       allow you to change the external program used for a given
-      compilation phases:</para>
+      compilation phase:</para>
+
+      <variablelist>
+	<varlistentry>
+	  <term><option>-pgmL</option> <replaceable>cmd</replaceable></term>
+	  <indexterm><primary><option>-pgmL</option></primary>
+	  </indexterm>
+	  <listitem>
+	    <para>Use <replaceable>cmd</replaceable> as the literate
+	    pre-processor.</para>
+	  </listitem>
+	</varlistentry>
+
+	<varlistentry>
+	  <term><option>-pgmP</option> <replaceable>cmd</replaceable></term>
+	  <indexterm><primary><option>-pgmP</option></primary>
+	  </indexterm>
+	  <listitem>
+	    <para>Use <replaceable>cmd</replaceable> as the C
+	    pre-processor (with <option>-cpp</option> only).</para>
+	  </listitem>
+	</varlistentry>
+
+	<varlistentry>
+	  <term><option>-pgmc</option> <replaceable>cmd</replaceable></term>
+	  <indexterm><primary><option>-pgmc</option></primary>
+	  </indexterm>
+	  <listitem>
+	    <para>Use <replaceable>cmd</replaceable> as the C
+	    compiler.</para>
+	  </listitem>
+	</varlistentry>
+
+	<varlistentry>
+	  <term><option>-pgma</option> <replaceable>cmd</replaceable></term>
+	  <indexterm><primary><option>-pgma</option></primary>
+	  </indexterm>
+	  <listitem>
+	    <para>Use <replaceable>cmd</replaceable> as the
+	    assembler.</para>
+	  </listitem>
+	</varlistentry>
+
+	<varlistentry>
+	  <term><option>-pgml</option> <replaceable>cmd</replaceable></term>
+	  <indexterm><primary><option>-pgml</option></primary>
+	  </indexterm>
+	  <listitem>
+	    <para>Use <replaceable>cmd</replaceable> as the
+	    linker.</para>
+	  </listitem>
+	</varlistentry>
+
+	<varlistentry>
+	  <term><option>-pgmdll</option> <replaceable>cmd</replaceable></term>
+	  <indexterm><primary><option>-pgmdll</option></primary>
+	  </indexterm>
+	  <listitem>
+	    <para>Use <replaceable>cmd</replaceable> as the DLL
+	    generator.</para>
+	  </listitem>
+	</varlistentry>
+
+	<varlistentry>
+	  <term><option>-pgmdep</option> <replaceable>cmd</replaceable></term>
+	  <indexterm><primary><option>-pgmdep</option></primary>
+	  </indexterm>
+	  <listitem>
+	    <para>Use <replaceable>cmd</replaceable> as the dependency
+	    generator.</para>
+	  </listitem>
+	</varlistentry>
+
+	<varlistentry>
+	  <term><option>-pgmF</option> <replaceable>cmd</replaceable></term>
+	  <indexterm><primary><option>-pgmF</option></primary>
+	  </indexterm>
+	  <listitem>
+	    <para>Use <replaceable>cmd</replaceable> as the
+	    pre-processor (with <option>-F</option> only).</para>
+	  </listitem>
+	</varlistentry>
+      </variablelist>
 
     </sect2>
 
     <sect2 id="forcing-options-through">
-      <title>Forcing options to a particular phase.</title>
+      <title>Forcing options to a particular phase</title>
       <indexterm><primary>forcing GHC-phase options</primary></indexterm>
 
       <para>Options can be forced through to a particlar compilation
-- 
1.7.10.4