[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 (file)
--- 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 (file)
--- 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>