X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=docs%2Fusers_guide%2Fusing.xml;h=0168123c701e159230df4fedfd21b397b7a72482;hb=d7750a81fa0c721f4b40dac9165c07d11e8405e1;hp=7bf85ef382346138c2d7ed909aab77ca2426b3ee;hpb=93db1991b5cacf8357493a2e17fbbfb485f3205b;p=ghc-hetmet.git

diff --git a/docs/users_guide/using.xml b/docs/users_guide/using.xml
index 7bf85ef..0168123 100644
--- a/docs/users_guide/using.xml
+++ b/docs/users_guide/using.xml
@@ -225,8 +225,7 @@ module X where
     <variablelist>
       <varlistentry>
 	<term>
-	  <cmdsynopsis><command>ghc</command>
-	    <arg choice='plain'>&ndash;&ndash;interactive</arg>
+	  <cmdsynopsis><command>ghc --interactive</command>
 	  </cmdsynopsis>
           <indexterm><primary>interactive mode</primary></indexterm>
           <indexterm><primary>ghci</primary></indexterm>
@@ -240,8 +239,7 @@ module X where
       
       <varlistentry>
 	<term>
-	  <cmdsynopsis><command>ghc</command>
-	    <arg choice='plain'>&ndash;&ndash;make</arg>
+	  <cmdsynopsis><command>ghc --make</command>
 	  </cmdsynopsis>
           <indexterm><primary>make mode</primary></indexterm>
           <indexterm><primary><option>&ndash;&ndash;make</option></primary></indexterm>
@@ -258,8 +256,8 @@ module X where
 
       <varlistentry>
 	<term>
-	  <cmdsynopsis><command>ghc</command>
-	    <arg choice='plain'>&ndash;e</arg> <arg choice='plain'><replaceable>expr</replaceable></arg>
+	  <cmdsynopsis><command>ghc -e</command>
+	     <arg choice='plain'><replaceable>expr</replaceable></arg>
           </cmdsynopsis>
           <indexterm><primary>eval mode</primary></indexterm>
 	</term>
@@ -275,13 +273,10 @@ module X where
       <varlistentry>
 	<term>
           <cmdsynopsis>
-	    <command>ghc</command>
-	    <group>
-	      <arg>-E</arg>
-	      <arg>-C</arg>
-	      <arg>-S</arg>
-	      <arg>-c</arg>
-	    </group>
+	    <command>ghc -E</command>
+	    <command>ghc -c</command>
+	    <command>ghc -S</command>
+	    <command>ghc -c</command>
 	  </cmdsynopsis>
 	  <indexterm><primary><option>-E</option></primary></indexterm>
 	  <indexterm><primary><option>-C</option></primary></indexterm>
@@ -302,8 +297,7 @@ module X where
       <varlistentry>
 	<term>
           <cmdsynopsis>
-            <command>ghc</command>
-	    <arg choice='plain'>&ndash;M</arg>
+            <command>ghc -M</command>
           </cmdsynopsis>
           <indexterm><primary>dependency-generation mode</primary></indexterm>
         </term>
@@ -318,16 +312,73 @@ module X where
       <varlistentry>
 	<term>
           <cmdsynopsis>
-            <command>ghc</command>
-	    <arg choice='plain'>&ndash;&ndash;mk-dll</arg>
+            <command>ghc --mk-dll</command>
           </cmdsynopsis>
-	  <indexterm><primary>dependency-generation mode</primary></indexterm>
+	  <indexterm><primary>DLL-creation mode</primary></indexterm>
         </term>
 	<listitem>
 	  <para>DLL-creation mode (Windows only).  See <xref
 	  linkend="win32-dlls-create"/>.</para>
 	</listitem>
       </varlistentry>
+
+      <varlistentry>
+	<term>
+	  <cmdsynopsis>
+          <command>ghc --help</command> <command>ghc -?</command>
+	    </cmdsynopsis>
+          <indexterm><primary><option>&ndash;&ndash;help</option></primary></indexterm>
+        </term>
+	<listitem>
+	  <para>Cause GHC to spew a long usage message to standard
+          output and then exit.</para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term>
+          <cmdsynopsis>
+          <command>ghc --version</command> <command>ghc -V</command> 
+          <indexterm><primary><option>-V</option></primary></indexterm>
+          <indexterm><primary><option>&ndash;&ndash;version</option></primary></indexterm>
+	    </cmdsynopsis>
+        </term>
+	<listitem>
+	  <para>Print a one-line string including GHC's version number.</para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term>
+          <cmdsynopsis>
+          <command>ghc --numeric-version</command>
+          <indexterm><primary><option>&ndash;&ndash;numeric-version</option></primary></indexterm>
+	    </cmdsynopsis>
+        </term>
+	<listitem>
+	  <para>Print GHC's numeric version number only.</para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term>
+	  <cmdsynopsis>
+          <command>ghc --print-libdir</command>
+          <indexterm><primary><option>&ndash;&ndash;print-libdir</option></primary></indexterm>
+	    </cmdsynopsis>
+        </term>
+	<listitem>
+	  <para>Print the path to GHC's library directory.  This is
+	  the top of the directory tree containing GHC's libraries,
+	  interfaces, and include files (usually something like
+	  <literal>/usr/local/lib/ghc-5.04</literal> on Unix).  This
+	  is the value of
+	  <literal>$libdir</literal><indexterm><primary><literal>libdir</literal></primary>
+	  </indexterm>in the package configuration file (see <xref
+	  linkend="packages"/>).</para>
+	</listitem>
+      </varlistentry>
+
     </variablelist>
 
     <sect2 id="make-mode">
@@ -574,19 +625,18 @@ ghc -c Foo.hs</screen>
     <indexterm><primary>help options</primary></indexterm>
     <indexterm><primary>verbosity options</primary></indexterm>
 
+    See also the <option>--help</option>, <option>--version</option>, <option>--numeric-version</option>,
+    and <option>--print-libdir</option> modes in <xref linkend="modes"/>.
     <variablelist>
       <varlistentry>
 	<term>
-          <option>&ndash;&ndash;help</option>
-          <indexterm><primary><option>&ndash;&ndash;help</option></primary></indexterm>
-        </term>
-	<term>
-          <option>-?</option>
-          <indexterm><primary><option>-?</option></primary></indexterm>
+          <option>-n</option>
+          <indexterm><primary><option>-n</option></primary></indexterm>
         </term>
 	<listitem>
-	  <para>Cause GHC to spew a long usage message to standard
-          output and then exit.</para>
+	  <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>
 
@@ -673,47 +723,6 @@ ghc -c Foo.hs</screen>
       </varlistentry>
       
       <varlistentry>
-	<term>
-          <option>-V</option>
-          <indexterm><primary><option>-V</option></primary></indexterm>
-        </term>
-	<term>
-          <option>&ndash;&ndash;version</option>
-          <indexterm><primary><option>&ndash;&ndash;version</option></primary></indexterm>
-        </term>
-	<listitem>
-	  <para>Print a one-line string including GHC's version number.</para>
-	</listitem>
-      </varlistentry>
-
-      <varlistentry>
-	<term>
-          <option>&ndash;&ndash;numeric-version</option>
-          <indexterm><primary><option>&ndash;&ndash;numeric-version</option></primary></indexterm>
-        </term>
-	<listitem>
-	  <para>Print GHC's numeric version number only.</para>
-	</listitem>
-      </varlistentry>
-
-      <varlistentry>
-	<term>
-          <option>&ndash;&ndash;print-libdir</option>
-          <indexterm><primary><option>&ndash;&ndash;print-libdir</option></primary></indexterm>
-        </term>
-	<listitem>
-	  <para>Print the path to GHC's library directory.  This is
-	  the top of the directory tree containing GHC's libraries,
-	  interfaces, and include files (usually something like
-	  <literal>/usr/local/lib/ghc-5.04</literal> on Unix).  This
-	  is the value of
-	  <literal>$libdir</literal><indexterm><primary><literal>libdir</literal></primary>
-	  </indexterm>in the package configuration file (see <xref
-	  linkend="packages"/>).</para>
-	</listitem>
-      </varlistentry>
-
-      <varlistentry>
 	<term><option>-ferror-spans</option>
           <indexterm><primary><option>-ferror-spans</option></primary>
 	  </indexterm>
@@ -748,6 +757,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 +816,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 +951,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>
@@ -1243,10 +1252,6 @@ f "2"    = 2
 	    <para>Means: &ldquo;Generate good-quality code without
             taking too long about it.&rdquo; Thus, for example:
             <command>ghc -c -O Main.lhs</command></para>
-
-	    <para><option>-O</option> currently also implies
-	    <option>-fvia-C</option>.  This may change in the
-	    future.</para>
 	  </listitem>
 	</varlistentry>
 
@@ -1624,18 +1629,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