Documentation for -fno-code and -fwrite-iface.
[ghc-hetmet.git] / ghc / docs / users_guide / flags.xml
index 4b2a276..e288da2 100644 (file)
@@ -8,10 +8,12 @@
     (if available).</para>
 
     <sect2>
-      <title>Help and verbosity options (<xref linkend="options-help"/>)</title>
+      <title>Help and verbosity options</title>
+
+      <para><xref linkend="options-help"/></para>
 
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
            <row>
              <entry><option>-?</option></entry>
              <entry>help</entry>
-             <entry>static</entry>
+             <entry>mode</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-help</option></entry>
              <entry>help</entry>
-             <entry>static</entry>
+             <entry>mode</entry>
              <entry>-</entry>
            </row>
            <row>
            <row>
              <entry><option>-V</option></entry>
              <entry>display GHC version</entry>
-             <entry>static</entry>
+             <entry>mode</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>&ndash;&ndash;version</option></entry>
              <entry>display GHC version</entry>
-             <entry>static</entry>
+             <entry>mode</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>&ndash;&ndash;numeric-version</option></entry>
              <entry>display GHC version (numeric only)</entry>
-             <entry>static</entry>
+             <entry>mode</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>&ndash;&ndash;print-libdir</option></entry>
              <entry>display GHC library directory</entry>
-             <entry>static</entry>
+             <entry>mode</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry>static</entry>
              <entry>-</entry>
            </row>
+           <row>
+             <entry><option>-Rghc-timing</option></entry>
+             <entry>Summarise timing stats for GHC (same as <literal>+RTS -tstderr</literal>)</entry>
+             <entry>static</entry>
+             <entry>-</entry>
+           </row>
          </tbody>
        </tgroup>
       </informaltable>
 
     </sect2>
     <sect2>
-      <title>Which phases to run (<xref linkend="options-order"/>)</title>
+      <title>Which phases to run</title>
       
+      <para><xref linkend="options-order"/></para>
+
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
            <row>
              <entry><option>-E</option></entry>
              <entry>Stop after preprocessing (<literal>.hspp</literal> file)</entry>
-             <entry>static</entry>
+             <entry>mode</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-C</option></entry>
              <entry>Stop after generating C (<literal>.hc</literal> file)</entry>
-             <entry>static</entry>
+             <entry>mode</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-S</option></entry>
              <entry>Stop after generating assembly (<literal>.s</literal> file)</entry>
-             <entry>static</entry>
+             <entry>mode</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-c</option></entry>
-             <entry>Stop after compiling to object code (<literal>.o</literal> file)</entry>
+             <entry>Do not link</entry>
+             <entry>dynamic</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>
     </sect2>
 
      <sect2>
-      <title>Alternative modes of operation (<xref linkend="modes"/>)</title>
+      <title>Alternative modes of operation</title>
       
+      <para><xref linkend="modes"/></para>
+
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
            <row>
              <entry><option>--interactive</option></entry>
              <entry>Interactive mode - normally used by just running <command>ghci</command></entry>
-             <entry>static</entry>
+             <entry>mode</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>--make</option></entry>
              <entry>Build a multi-module Haskell program, automatically figuring out dependencies. Likely to be much easier, and faster, than using <command>make</command>.</entry>
-             <entry>static</entry>
+             <entry>mode</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-e <replaceable>expr</replaceable></option></entry>
              <entry>Evaluate <replaceable>expr</replaceable></entry>
-             <entry>static</entry>
+             <entry>mode</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-M</option></entry>
              <entry>Generate dependency information suitable for use in a <filename>Makefile</filename>.</entry>
-             <entry>static</entry>
-             <entry>-</entry>
-           </row>
-           <row>
-             <entry><option>--mk-dll</option></entry>
-             <entry>DLL-creation mode (Windows only)</entry>
-             <entry>static</entry>
+             <entry>mode</entry>
              <entry>-</entry>
            </row>
          </tbody>
     </sect2>
 
     <sect2>
-      <title>Redirecting output (<xref linkend="options-output"/>)</title>
+      <title>Redirecting output</title>
       
+      <para><xref linkend="options-output"/></para>
+
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
            <row>
              <entry><option>-hcsuf</option> <replaceable>suffix</replaceable></entry>
              <entry>set the suffix to use for intermediate C files</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-hidir</option> <replaceable>dir</replaceable></entry>
              <entry>set directory for interface files</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-hisuf</option> <replaceable>suffix</replaceable></entry>
              <entry>set the suffix to use for interface files</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-o</option> <replaceable>filename</replaceable></entry>
              <entry>set output filename</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-odir</option> <replaceable>dir</replaceable></entry>
              <entry>set output directory</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-ohi</option> <replaceable>filename</replaceable></entry>
              <entry>set the filename in which to put the interface</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry></entry>
            </row>
            <row>
              <entry><option>-osuf</option> <replaceable>suffix</replaceable></entry>
              <entry>set the output file suffix</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
+             <entry>-</entry>
+           </row>
+           <row>
+             <entry><option>-stubdir</option> <replaceable>dir</replaceable></entry>
+             <entry>redirect FFi stub files</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
          </tbody>
     </sect2>
 
     <sect2>
-      <title>Keeping intermediate files (<xref linkend="keeping-intermediates"/>)</title>
+      <title>Keeping intermediate files</title>
+      
+      <para><xref linkend="keeping-intermediates"/></para>
       
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
            <row>
              <entry><option>-keep-hc-file</option></entry>
              <entry>retain intermediate <literal>.hc</literal> files</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-keep-s-file</option></entry>
              <entry>retain intermediate <literal>.s</literal> files</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-keep-raw-s-file</option></entry>
              <entry>retain intermediate <literal>.raw_s</literal> files</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-keep-tmp-files</option></entry>
              <entry>retain all intermediate temporary files</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
          </tbody>
     </sect2>
 
     <sect2>
-      <title>Temporary files (<xref linkend="temp-files"/>)</title>
+      <title>Temporary files</title>
       
+      <para><xref linkend="temp-files"/></para>
+
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
            <row>
              <entry><option>-tmpdir</option></entry>
              <entry>set the directory for temporary files</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
          </tbody>
     </sect2>
 
     <sect2>
-      <title>Finding imports (<xref linkend="search-path"/>)</title>
+      <title>Finding imports</title>
+
+      <para><xref linkend="search-path"/></para>
 
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
              <entry><option>-i</option><replaceable>dir1</replaceable>:<replaceable>dir2</replaceable>:...</entry>
              <entry>add <replaceable>dir</replaceable>,
                  <replaceable>dir2</replaceable>, etc. to import path</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-i</option></entry>
              <entry>Empty the import directory list</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
          </tbody>
     </sect2>
 
     <sect2>
-      <title>Interface file options (<xref linkend="hi-options"/>)</title>
+      <title>Interface file options</title>
+
+      <para><xref linkend="hi-options"/></para>
 
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
              <entry>Read the interface in
              <replaceable>file</replaceable> and dump it as text to
              <literal>stdout</literal>.</entry>
-             <entry>static</entry>
+             <entry>mode</entry>
              <entry>-</entry>
            </row>
          </tbody>
     </sect2>
     
     <sect2>
-      <title>Recompilation checking (<xref linkend="recomp"/>)</title>
+      <title>Recompilation checking</title>
+
+      <para><xref linkend="recomp"/></para>
 
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
          <tbody>
            <row>
              <entry><option>-no-recomp</option></entry>
-             <entry>Turn off recompilation checking</entry>
-             <entry>static</entry>
+             <entry>Turn off recompilation checking; implied by any
+             <option>-ddump-X</option> option</entry>
+             <entry>dynamic</entry>
              <entry><option>-recomp</option></entry>
            </row>
          </tbody>
     </sect2>
 
     <sect2>
-      <title>Interactive-mode options (<xref linkend="ghci-dot-files"/>)</title>
+      <title>Interactive-mode options</title>
       
+      <para><xref linkend="ghci-dot-files"/></para>
+
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
     </sect2>
 
     <sect2>
-      <title>Packages (<xref linkend="packages"/>)</title>
+      <title>Packages</title>
+
+      <para><xref linkend="packages"/></para>
+
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
            <row>
              <entry><option>-package</option> <replaceable>P</replaceable></entry>
              <entry>Expose package <replaceable>P</replaceable></entry>
+             <entry>dynamic</entry>
+             <entry>-</entry>
+           </row>
+           <row>
+             <entry><option>-hide-all-packages</option></entry>
+             <entry>Hide all packages by default</entry>
              <entry>static</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-hide-package</option> <replaceable>name</replaceable></entry>
              <entry>Hide package <replaceable>P</replaceable></entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-ignore-package</option> <replaceable>name</replaceable></entry>
              <entry>Ignore package <replaceable>P</replaceable></entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-package-conf</option> <replaceable>file</replaceable></entry>
              <entry>Load more packages from <replaceable>file</replaceable></entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-no-user-package-conf</option></entry>
              <entry>Don't load the user's package config file.</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
          </tbody>
     </sect2>
 
     <sect2>
-      <title>Language options (<xref linkend="options-language"/>)</title>
+      <title>Language options</title>
+
+      <para><xref linkend="options-language"/></para>
 
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
            </row>
            <row>
              <entry><option>-fallow-incoherent-instances</option></entry>
-             <entry>Enable incoherent instances</entry>
+             <entry>Enable incoherent instances.  
+             Implies <option>-fallow-overlapping-instances</option> </entry>
              <entry>dynamic</entry>
              <entry><option>-fno-allow-incoherent-instances</option></entry>
            </row>
              <entry><option>-fno-glasgow-exts</option></entry>
            </row>
            <row>
-             <entry><option>-fignore-asserts</option></entry>
-             <entry>Ignore assertions</entry>
-             <entry>dynamic</entry>
-             <entry><option>-fno-ignore-asserts</option></entry>
-           </row>
-           <row>
              <entry><option>-fimplicit-params</option></entry>
              <entry>Enable Implicit Parameters.
              Implied by <option>-fglasgow-exts</option>.</entry>
     </sect2>
 
     <sect2>
-      <title>Warnings (<xref linkend="options-sanity"/>)</title>
+      <title>Warnings</title>
       
+      <para>(<xref linkend="options-sanity"/></para>
+
     <informaltable>
-      <tgroup cols="3" align="left" colsep="1" rowsep="1">
+      <tgroup cols="4" align="left" colsep="1" rowsep="1">
        <thead>
          <row>
            <entry>Flag</entry>
 
     </sect2>
     <sect2>
-      <title>Optimisation levels (<xref linkend="options-optimise"/>)</title>
+      <title>Optimisation levels</title>
+
+      <para><xref linkend="options-optimise"/></para>
 
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
              
     </sect2>
     <sect2>
-      <title>Individual optimisations (<xref linkend="options-f"/>)</title>
+      <title>Individual optimisations</title>
+
+      <para><xref linkend="options-f"/></para>
 
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
            <row>
              <entry><option>-fexcess-precision</option></entry>
              <entry>Enable excess intermediate precision</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry><option>-fno-excess-precision</option></entry>
            </row>
 
            <row>
              <entry><option>-fignore-asserts</option></entry>
              <entry>Ignore assertions in the source</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry><option>-fno-ignore-asserts</option></entry>
            </row>
 
            <row>
              <entry><option>-fignore-interface-pragmas</option></entry>
              <entry>Ignore pragmas in interface files</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry><option>-fno-ignore-interface-pragmas</option></entry>
            </row>
 
            </row>
 
            <row>
-             <entry><option>-fno-cpr</option></entry>
-             <entry>Turn off CPR analysis</entry>
-             <entry>static</entry>
-             <entry>-fcpr</entry>
-           </row>
-
-           <row>
              <entry><option>-fno-cse</option></entry>
              <entry>Turn off common sub-expression</entry>
              <entry>dynamic</entry>
 
            <row>
              <entry><option>-fno-full-laziness</option></entry>
-             <entry>Turn off full laziness (floating bindings outwards).  It is on by default.</entry>
+             <entry>Turn off full laziness (floating bindings outwards).</entry>
              <entry>dynamic</entry>
              <entry>-ffull-laziness</entry>
            </row>
            </row>
 
            <row>
-             <entry><option>-fnumbers-strict</option></entry>
-             <entry>Make numbers strict</entry>
-             <entry>dynamic</entry>
-             <entry><option>-fno-numbers-strict</option></entry>
-           </row>
-
-           <row>
              <entry><option>-funbox-strict-fields</option></entry>
              <entry>Flatten strict constructor fields</entry>
              <entry>dynamic</entry>
     </sect2>
 
     <sect2>
-      <title>Profiling options (<xref linkend="profiling"/>)</title>
+      <title>Profiling options</title>
+      
+      <para><xref linkend="profiling"/></para>
 
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
     </sect2>
 
     <sect2>
-      <title>Parallelism options (<xref linkend="sec-using-parallel"/>)</title>
+      <title>Parallelism options</title>
+
+      <para><xref linkend="sec-using-parallel"/></para>
 
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
     </sect2>
 
     <sect2>
-      <title>C pre-processor options (<xref linkend="c-pre-processor"/>)</title>
+      <title>C pre-processor options</title>
+
+      <para><xref linkend="c-pre-processor"/></para>
 
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
              <entry><option>-I</option><replaceable>dir</replaceable></entry>
              <entry>Add <replaceable>dir</replaceable> to the
              directory search list for <literal>#include</literal> files</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
          </tbody>
     </sect2>
 
     <sect2>
-      <title>C compiler options (<xref linkend="options-C-compiler"/>)</title>
+      <title>C compiler options</title>
+
+      <para><xref linkend="options-C-compiler"/></para>
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
     </sect2>
 
     <sect2>
-      <title>Code generation options (<xref linkend="options-codegen"/>)</title>
+      <title>Code generation options</title>
+
+      <para><xref linkend="options-codegen"/></para>
 
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
            <row>
              <entry><option>-fno-code</option></entry>
              <entry>Omit code generation</entry>
-             <entry>static</entry>
+             <entry>mode</entry>
              <entry>-</entry>
            </row>
          </tbody>
     </sect2>
 
     <sect2>
-      <title>Linking options (<xref linkend="options-linker"/>)</title>
+      <title>Linking options</title>
+
+      <para><xref linkend="options-linker"/></para>
 
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
              <entry><option>-framework</option> <replaceable>name</replaceable></entry>
              <entry>On Darwin/MacOS X only, link in the framework <replaceable>name</replaceable>.
                This option corresponds to the <option>-framework</option> option for Apple's Linker.</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry>On Darwin/MacOS X only, add <replaceable>dir</replaceable> to the list of
                directories searched for frameworks.
                This option corresponds to the <option>-F</option> option for Apple's Linker.</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-l</option><replaceable>lib</replaceable></entry>
              <entry>Link in library <replaceable>lib</replaceable></entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-L</option><replaceable>dir</replaceable></entry>
              <entry>Add <replaceable>dir</replaceable> to the list of
              directories searched for libraries</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-main-is</option></entry>
              <entry>Set main function</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
+             <entry>-</entry>
+           </row>
+           <row>
+             <entry><option>--mk-dll</option></entry>
+             <entry>DLL-creation mode (Windows only)</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-no-hs-main</option></entry>
              <entry>Don't assume this program contains <literal>main</literal></entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-no-link</option></entry>
              <entry>Omit linking</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-package</option> <replaceable>name</replaceable></entry>
              <entry>Link in package <replaceable>name</replaceable></entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-split-objs</option></entry>
              <entry>Split objects (for libraries)</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
     </sect2>
 
     <sect2>
-      <title>Replacing phases (<xref linkend="replacing-phases"/>)</title>
+      <title>Replacing phases</title>
+
+      <para><xref linkend="replacing-phases"/></para>
 
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
            <row>
              <entry><option>-pgmL</option> <replaceable>cmd</replaceable></entry>
              <entry>Use <replaceable>cmd</replaceable> as the literate pre-processor</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-pgmP</option> <replaceable>cmd</replaceable></entry>
              <entry>Use <replaceable>cmd</replaceable> as the C
              pre-processor (with <option>-cpp</option> only)</entry>
-             <entry>static</entry> <entry>-</entry>
+             <entry>dynamic</entry>
+             <entry>-</entry>
            </row>
            <row>
              <entry><option>-pgmc</option> <replaceable>cmd</replaceable></entry>
              <entry>Use <replaceable>cmd</replaceable> as the C compiler</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-pgma</option> <replaceable>cmd</replaceable></entry>
              <entry>Use <replaceable>cmd</replaceable> as the assembler</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-pgml</option> <replaceable>cmd</replaceable></entry>
              <entry>Use <replaceable>cmd</replaceable> as the linker</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-pgmdll</option> <replaceable>cmd</replaceable></entry>
              <entry>Use <replaceable>cmd</replaceable> as the DLL generator</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-pgmdep</option> <replaceable>cmd</replaceable></entry>
              <entry>Use <replaceable>cmd</replaceable> as the dependency generator</entry>
-             <entry>static</entry>
+             <entry>dyanmic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-pgmF</option> <replaceable>cmd</replaceable></entry>
              <entry>Use <replaceable>cmd</replaceable> as the pre-processor
              (with <option>-F</option> only)</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
          </tbody>
     </sect2>
 
     <sect2>
-      <title>Forcing options to particular phases (<xref linkend="forcing-options-through"/>)</title>
+      <title>Forcing options to particular phases</title>
+
+      <para><xref linkend="forcing-options-through"/></para>
 
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
            <row>
              <entry><option>-optl</option> <replaceable>option</replaceable></entry>
              <entry>pass <replaceable>option</replaceable> to the linker</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-optdll</option> <replaceable>option</replaceable></entry>
              <entry>pass <replaceable>option</replaceable> to the DLL generator</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
              <entry><option>-optdep</option> <replaceable>option</replaceable></entry>
              <entry>pass <replaceable>option</replaceable> to the dependency generator</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
          </tbody>
     </sect2>
 
     <sect2>
-      <title>Platform-specific options (<xref linkend="options-platform"/>)</title>
+      <title>Platform-specific options</title>
       
+      <para><xref linkend="options-platform"/></para>
+
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
 
          
     <sect2>
-      <title>External core file options (<xref linkend="ext-core"/>)</title>
+      <title>External core file options</title>
+
+      <para><xref linkend="ext-core"/></para>
 
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
        </tgroup>
       </informaltable>
     </sect2>
-       
+
 
     <sect2>
-      <title>Compiler debugging options (<xref linkend="options-debugging"/>)</title>
+      <title>Compiler debugging options</title>
+
+      <para><xref linkend="options-debugging"/></para>
 
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
       <title>Misc compiler options</title>
 
       <informaltable>
-       <tgroup cols="3" align="left" colsep="1" rowsep="1">
+       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          <thead>
            <row>
              <entry>Flag</entry>
              <entry>-</entry>
            </row>
            <row>
-             <entry><option>-fglobalise-toplev-names</option></entry>
-             <entry>Make all top-level names global (for <option>-split-objs</option>)</entry>
-             <entry>static</entry>
-             <entry>-</entry>
-           </row>
-           <row>
              <entry><option>-fno-hi-version-check</option></entry>
              <entry>Don't complain about <literal>.hi</literal> file mismatches</entry>
              <entry>static</entry>
              <entry>-</entry>
            </row>
            <row>
-             <entry><option>-fno-prune-decls</option></entry>
-             <entry>Renamer: don't prune declarations</entry>
-             <entry>static</entry>
-             <entry>-</entry>
-           </row>
-           <row>
              <entry><option>-fhistory-size</option></entry>
              <entry>Set simplification history size</entry>
              <entry>static</entry>
            <row>
              <entry><option>-fno-asm-mangling</option></entry>
              <entry>Turn off assembly mangling (use <option>-unreg</option> instead)</entry>
-             <entry>static</entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
          </tbody>
@@ -1834,7 +1882,6 @@ Still to document:
 
 Misc:
   ,  ( "H"                 , HasArg (setHeapSize . fromIntegral . decodeSize) )
-  ,  ( "Rghc-timing"      , NoArg  (enableTimingStats) )
 
   -Bdir
 -->