From: simonmar <unknown>
Date: Wed, 21 Sep 2005 09:54:59 +0000 (+0000)
Subject: [project @ 2005-09-21 09:54:59 by simonmar]
X-Git-Tag: Initial_conversion_from_CVS_complete~201
X-Git-Url: http://git.megacz.com/?a=commitdiff_plain;h=20a40a62e69d0cfce063b2e1b415d77eb35c0b86;p=ghc-hetmet.git

[project @ 2005-09-21 09:54:59 by simonmar]
Document the -x flag
---

diff --git a/ghc/docs/users_guide/flags.xml b/ghc/docs/users_guide/flags.xml
index 0e3147d..8342dcc 100644
--- a/ghc/docs/users_guide/flags.xml
+++ b/ghc/docs/users_guide/flags.xml
@@ -122,6 +122,12 @@
 	      <entry>static</entry>
 	      <entry>-</entry>
 	    </row>
+	    <row>
+	      <entry><option>-x</option> <replaceable>suffix</replaceable></entry>
+	      <entry>Override default behaviour for source files</entry>
+	      <entry>static</entry>
+	      <entry>-</entry>
+	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
diff --git a/ghc/docs/users_guide/using.xml b/ghc/docs/users_guide/using.xml
index 25869d9..22de98c 100644
--- a/ghc/docs/users_guide/using.xml
+++ b/ghc/docs/users_guide/using.xml
@@ -515,6 +515,30 @@ ghc -c Foo.hs</screen>
       of the compiler, dumping the result in a file.  Note that this
       differs from the previous behaviour of dumping the file to
       standard output.</para>
+
+      <sect3 id="overriding-suffixes">
+	<title>Overriding the default behaviour for a file</title>
+
+	<para>As described above, the way in which a file is processed by GHC
+	  depends on its suffix.  This behaviour can be overriden using the
+	  <option>-x</option> option:</para>
+
+	<variablelist>
+	  <varlistentry>
+	    <term><option>-x</option> <replaceable>suffix</replaceable></term>
+	      <indexterm><primary><option>-x</option></primary>
+	      </indexterm>
+	      <listitem>
+		<para>Causes all files following this option on the command
+		  line to be processed as if they had the suffix
+		  <replaceable>suffix</replaceable>.  For example, to compile a
+		  Haskell module in the file <literal>M.my-hs</literal>,
+		  use <literal>ghc -c -x hs M.my-hs</literal>.</para>
+	      </listitem>
+	  </varlistentry>
+	</variablelist>
+      </sect3>
+
     </sect2>
   </sect1>