Remove unused option -femit-extern-decls
[ghc-hetmet.git] / docs / users_guide / flags.xml
index e6e22fe..1fd054c 100644 (file)
          </thead>
          <tbody>
            <row>
-             <entry><option>-no-recomp</option></entry>
+             <entry><option>-fforce-recomp</option></entry>
              <entry>Turn off recompilation checking; implied by any
              <option>-ddump-X</option> option</entry>
              <entry>dynamic</entry>
-             <entry><option>-recomp</option></entry>
+             <entry><option>-fno-force-recomp</option></entry>
            </row>
          </tbody>
        </tgroup>
          <tbody>
            <row>
              <entry><option>-fallow-overlapping-instances</option></entry>
-             <entry>Enable overlapping instances</entry>
+             <entry>Enable <link linkend="instance-overlap">overlapping instances</link></entry>
              <entry>dynamic</entry>
              <entry><option>-fno-allow-overlapping-instances</option></entry>
            </row>
            <row>
+             <entry><option>-fallow-incoherent-instances</option></entry>
+             <entry>Enable <link linkend="instance-overlap">incoherent instances</link>.  
+             Implies <option>-fallow-overlapping-instances</option> </entry>
+             <entry>dynamic</entry>
+             <entry><option>-fno-allow-incoherent-instances</option></entry>
+           </row>
+           <row>
              <entry><option>-fallow-undecidable-instances</option></entry>
-             <entry>Enable undecidable instances</entry>
+             <entry>Enable <link linkend="undecidable-instances">undecidable instances</link></entry>
              <entry>dynamic</entry>
              <entry><option>-fno-allow-undecidable-instances</option></entry>
            </row>
            <row>
-             <entry><option>-fallow-incoherent-instances</option></entry>
-             <entry>Enable incoherent instances.  
-             Implies <option>-fallow-overlapping-instances</option> </entry>
+             <entry><option>-fcontext-stack=N</option><replaceable>n</replaceable></entry>
+             <entry>set the <link linkend="undecidable-instances">limit for context reduction</link></entry>
              <entry>dynamic</entry>
-             <entry><option>-fno-allow-incoherent-instances</option></entry>
+             <entry><option>20</option></entry>
            </row>
            <row>
              <entry><option>-farrows</option></entry>
-             <entry>Enable arrow notation extension</entry>
+             <entry>Enable <link linkend="arrow-notation">arrow
+             notation</link> extension</entry>
              <entry>dynamic</entry>
              <entry><option>-fno-arrows</option></entry>
            </row>
            <row>
-             <entry><option>-fcontext-stack</option><replaceable>n</replaceable></entry>
-             <entry>set the limit for context reduction</entry>
-             <entry>static</entry>
-             <entry><option>-</option></entry>
-           </row>
-           <row>
              <entry><option>-ffi</option> or <option>-fffi</option></entry>
-             <entry>Enable foreign function interface (implied by
+             <entry>Enable <link linkend="ffi">foreign function interface</link> (implied by
              <option>-fglasgow-exts</option>)</entry>
              <entry>dynamic</entry>
              <entry><option>-fno-ffi</option></entry>
            </row>
            <row>
              <entry><option>-fgenerics</option></entry>
-             <entry>Enable generics</entry>
+             <entry>Enable <link linkend="generic-classes">generic classes</link></entry>
              <entry>dynamic</entry>
              <entry><option>-fno-fgenerics</option></entry>
            </row>
            </row>
            <row>
              <entry><option>-fimplicit-params</option></entry>
-             <entry>Enable Implicit Parameters.
+             <entry>Enable <link linkend="implicit-parameters">Implicit Parameters</link>.
              Implied by <option>-fglasgow-exts</option>.</entry>
              <entry>dynamic</entry>
              <entry><option>-fno-implicit-params</option></entry>
            </row>
            <row>
              <entry><option>-fno-monomorphism-restriction</option></entry>
-             <entry>Disable the monomorphism restriction</entry>
+             <entry>Disable the <link linkend="monomorphism">monomorphism restriction</link></entry>
              <entry>dynamic</entry>
              <entry><option>-fmonomorphism-restriction</option></entry>
            </row>
            <row>
+             <entry><option>-fno-mono-pat-binds</option></entry>
+             <entry>Make <link linkend="monomorphism">pattern bindings polymorphic</link></entry>
+             <entry>dynamic</entry>
+             <entry><option>-fmono-pat-binds</option></entry>
+           </row>
+           <row>
+             <entry><option>-fextended-default-rules</option></entry>
+             <entry>Use GHCi's <link linkend="extended-default-rules">extended default rules</link> in a normal module</entry>
+             <entry>dynamic</entry>
+             <entry><option>-fno-extended-default-rules</option></entry>
+           </row>
+           <row>
              <entry><option>-fscoped-type-variables</option></entry>
-             <entry>Enable lexically-scoped type variables.
+             <entry>Enable <link linkend="scoped-type-variables">lexically-scoped type variables</link>.
              Implied by <option>-fglasgow-exts</option>.</entry>
              <entry>dynamic</entry>
              <entry><option>-fno-scoped-type-variables</option></entry>
            </row>
            <row>
              <entry><option>-fth</option></entry>
-             <entry>Enable Template Haskell. 
+             <entry>Enable <link linkend="template-haskell">Template Haskell</link>. 
                No longer implied by <option>-fglasgow-exts</option>.</entry>
              <entry>dynamic</entry>
              <entry><option>-fno-th</option></entry>
            </row>
+           <row>
+             <entry><option>-fbang-patterns</option></entry>
+             <entry>Enable <link linkend="sec-bang-patterns">bang patterns</link>.</entry>
+             <entry>dynamic</entry>
+             <entry><option>-fno-bang-patterns</option></entry>
+           </row>
          </tbody>
        </tgroup>
       </informaltable>
     <sect2>
       <title>Warnings</title>
       
-      <para>(<xref linkend="options-sanity"/></para>
+      <para><xref linkend="options-sanity"/></para>
 
     <informaltable>
       <tgroup cols="4" align="left" colsep="1" rowsep="1">
          </row>
 
          <row>
-           <entry><option>-fwarn-misc</option></entry>
-           <entry>enable miscellaneous warnings</entry>
-           <entry>dynamic</entry>
-           <entry><option>-fno-warn-misc</option></entry>
-         </row>
-
-         <row>
            <entry><option>-fwarn-missing-fields</option></entry>
            <entry>warn when fields of a record are uninitialised</entry>
            <entry>dynamic</entry>
          </row>
 
          <row>
-           <entry><option>-fwarn-oprhans</option></entry>
+           <entry><option>-fwarn-orphans</option></entry>
            <entry>warn when the module contains "orphan" instance declarations
            or rewrite rules</entry>
            <entry>dynamic</entry>
              <entry><option>-no-auto-all</option></entry>
            </row>
            <row>
-             <entry><option>-auto-dicts</option></entry>
-             <entry>Auto-add <literal>_scc_</literal>s to all dictionaries</entry>
-             <entry>static</entry>
-             <entry><option>-no-auto-dicts</option></entry>
-           </row>
-           <row>
              <entry><option>-caf-all</option></entry>
              <entry>Auto-add <literal>_scc_</literal>s to all CAFs</entry>
              <entry>static</entry>
     </sect2>
 
     <sect2>
-      <title>Parallelism options</title>
+      <title>Haskell pre-processor options</title>
 
-      <para><xref linkend="sec-using-parallel"/></para>
+      <para><xref linkend="pre-processor"/></para>
 
       <informaltable>
        <tgroup cols="4" align="left" colsep="1" rowsep="1">
          </thead>
          <tbody>
            <row>
-             <entry><option>-gransim</option></entry>
-             <entry>Enable GRANSIM</entry>
-             <entry>static</entry>
-             <entry>-</entry>
-           </row>
-           <row>
-             <entry><option>-parallel</option></entry>
-             <entry>Enable Parallel Haskell</entry>
-             <entry>static</entry>
-             <entry>-</entry>
-           </row>
-           <row>
-             <entry><option>-smp</option></entry>
-             <entry>Enable SMP support</entry>
-             <entry>static</entry>
+             <entry><option>-F</option></entry>
+             <entry>
+                  Enable the use of a pre-processor
+                  (set with <option>-pgmF</option>)
+              </entry>
+             <entry>dynamic</entry>
              <entry>-</entry>
            </row>
          </tbody>
              <entry>-</entry>
            </row>
            <row>
-             <entry><option>-package</option> <replaceable>name</replaceable></entry>
-             <entry>Link in package <replaceable>name</replaceable></entry>
-             <entry>dynamic</entry>
-             <entry>-</entry>
-           </row>
-           <row>
              <entry><option>-split-objs</option></entry>
              <entry>Split objects (for libraries)</entry>
              <entry>dynamic</entry>
          </thead>
          <tbody>
            <row>
-             <entry><option>-mv8</option></entry>
-             <entry>(SPARC only) enable version 8 support</entry>
-             <entry>static</entry>
-             <entry>-</entry>
-           </row>
-           <row>
-             <entry><option>-monly-[32]-regs</option></entry>
+             <entry><option>-monly-[432]-regs</option></entry>
              <entry>(x86 only) give some registers back to the C compiler</entry>
              <entry>dynamic</entry>
              <entry>-</entry>
              <entry>-</entry>
            </row>
            <row>
-             <entry><option>-ddump-absC</option></entry>
-             <entry>Dump abstract C</entry>
-             <entry>dynamic</entry>
-             <entry>-</entry>
-           </row>
-           <row>
              <entry><option>-ddump-asm</option></entry>
              <entry>Dump assembly</entry>
              <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
-             <entry><option>-ddump-realC</option></entry>
-             <entry>Dump &ldquo;real&rdquo; C</entry>
-             <entry>dynamic</entry>
-             <entry>-</entry>
-           </row>
-           <row>
              <entry><option>-ddump-rn</option></entry>
              <entry>Dump renamer output</entry>
              <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
-             <entry><option>-ddump-sat</option></entry>
-             <entry>Dump saturated output</entry>
-             <entry>dynamic</entry>
-             <entry>-</entry>
-           </row>
-           <row>
              <entry><option>-ddump-simpl</option></entry>
              <entry>Dump final simplifier output</entry>
              <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
-             <entry><option>-ddump-usagesp</option></entry>
-             <entry>Dump UsageSP analysis output</entry>
-             <entry>dynamic</entry>
-             <entry>-</entry>
-           </row>
-           <row>
              <entry><option>-ddump-worker-wrapper</option></entry>
              <entry>Dump worker-wrapper output</entry>
              <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
-             <entry><option>-ddump-stix</option></entry>
-             <entry>Native code generator intermediate form</entry>
-             <entry>dynamic</entry>
-             <entry>-</entry>
-           </row>
-           <row>
              <entry><option>-ddump-simpl-stats</option></entry>
              <entry>Dump simplifier stats</entry>
              <entry>dynamic</entry>
              <entry>-</entry>
            </row>
            <row>
-             <entry><option>-dusagesp-lint</option></entry>
-             <entry>UsageSP sanity checker</entry>
-             <entry>dynamic</entry>
-             <entry>-</entry>
-           </row>
-           <row>
              <entry><option>-dverbose-core2core</option></entry>
              <entry>Show output from each core-to-core pass</entry>
              <entry>dynamic</entry>
          </thead>
          <tbody>
            <row>
-             <entry><option>-femit-extern-decls</option></entry>
-             <entry>???</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>dynamic</entry>
              <entry>-</entry>
            </row>
+           <row>
+             <entry><option>-fno-print-bind-result</option></entry>
+             <entry><link id="ghci-stmts">Turn off printing of binding results in GHCi</link></entry>
+             <entry>dynamic</entry>
+             <entry>-</entry>
+           </row>
          </tbody>
        </tgroup>
       </informaltable>