Improve the correlation betweens documented and existent options

[ghc-hetmet.git] / docs / users_guide / using.xml

diff --git a/docs/users_guide/using.xml b/docs/users_guide/using.xml
index 7bf85ef..aa133ee 100644 (file)
--- a/docs/users_guide/using.xml
+++ b/docs/users_guide/using.xml
@@ -592,6 +592,18 @@ ghc -c Foo.hs</screen>
 
       <varlistentry>
        <term>
+          <option>-n</option>
+          <indexterm><primary><option>-n</option></primary></indexterm>
+        </term>
+       <listitem>
+         <para>Does a dry-run, i.e. GHC goes through all the motions
+          of compiling as normal, but does not actually run any
+          external commands.</para>
+       </listitem>
+      </varlistentry>
+
+      <varlistentry>
+       <term>
           <option>-v</option>
           <indexterm><primary><option>-v</option></primary></indexterm>
         </term>
@@ -748,6 +760,20 @@ ghc -c Foo.hs</screen>
       </varlistentry>
 
       <varlistentry>
+        <term><option>-H</option><replaceable>size</replaceable>
+        <indexterm><primary><option>-H</option></primary></indexterm>
+        </term>
+        <listitem>
+          <para>Set the minimum size of the heap to
+          <replaceable>size</replaceable>.
+          This option is equivalent to
+          <literal>+RTS&nbsp;-H<replaceable>size</replaceable></literal>,
+          see <xref linkend="rts-options-gc" />.
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
         <term><option>-Rghc-timing</option>
         <indexterm><primary><option>-Rghc-timing</option></primary></indexterm>
         </term>
@@ -793,8 +819,7 @@ ghc -c Foo.hs</screen>
          <para>Provides the standard warnings plus
          <option>-fwarn-incomplete-patterns</option>,
          <option>-fwarn-unused-matches</option>,
-         <option>-fwarn-unused-imports</option>,
-         <option>-fwarn-misc</option>, and
+         <option>-fwarn-unused-imports</option>, and
          <option>-fwarn-unused-binds</option>.</para>
        </listitem>
       </varlistentry>
@@ -929,19 +954,6 @@ f foo = foo { x = 6 }
 
       <varlistentry>
        <term>
-          <option>-fwarn-misc</option>:
-          <indexterm><primary><option>-fwarn-misc</option></primary></indexterm>
-        </term>
-       <listitem>
-         <para>Turns on warnings for various harmless but untidy
-         things.  This currently includes: importing a type with
-         <literal>(..)</literal> when the export is abstract, and
-         listing duplicate class assertions in a qualified type.</para>
-       </listitem>
-      </varlistentry>
-
-      <varlistentry>
-       <term>
           <option>-fwarn-missing-fields</option>:
          <indexterm><primary><option>-fwarn-missing-fields</option></primary></indexterm>
          <indexterm><primary>missing fields, warning</primary></indexterm>
@@ -1624,18 +1636,6 @@ f "2"    = 2
     <variablelist>
 
       <varlistentry>
-       <term><option>-mv8</option>:</term>
-       <listitem>
-         <para>(SPARC machines)<indexterm><primary>-mv8 option (SPARC
-          only)</primary></indexterm> Means to pass the like-named
-          option to GCC; it says to use the Version 8 SPARC
-          instructions, notably integer multiply and divide.  The
-          similar <option>-m*</option> GCC options for SPARC also
-          work, actually.</para>
-       </listitem>
-      </varlistentry>
-
-      <varlistentry>
        <term><option>-monly-[32]-regs</option>:</term>
        <listitem>
          <para>(iX86 machines)<indexterm><primary>-monly-N-regs