X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;ds=sidebyside;f=docs%2Fusers_guide%2Fflags.xml;h=978ddf7464aeb50c19129741eb57978f575f4309;hb=432b9c9322181a3644083e3c19b7e240d90659e7;hp=abcca5d3a1c417f7c5d55cd8b95154f479d4282d;hpb=368f9fc139a24b771b5b3282753544fb087f6b55;p=ghc-hetmet.git

diff --git a/docs/users_guide/flags.xml b/docs/users_guide/flags.xml
index abcca5d..978ddf7 100644
--- a/docs/users_guide/flags.xml
+++ b/docs/users_guide/flags.xml
@@ -254,7 +254,7 @@
 	    </row>
 	    <row>
 	      <entry><option>-odir</option> <replaceable>dir</replaceable></entry>
-	      <entry>set output directory</entry>
+	      <entry>set directory for object files</entry>
 	      <entry>dynamic</entry>
 	      <entry>-</entry>
 	    </row>
@@ -276,6 +276,12 @@
 	      <entry>dynamic</entry>
 	      <entry>-</entry>
 	    </row>
+	    <row>
+	      <entry><option>-outputdir</option> <replaceable>dir</replaceable></entry>
+	      <entry>set output directory</entry>
+	      <entry>dynamic</entry>
+	      <entry>-</entry>
+	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
@@ -522,6 +528,13 @@
 	      <entry>dynamic</entry>
 	      <entry>-</entry>
 	    </row>
+	    <row>
+	      <entry><option>-fno-implicit-import-qualified</option></entry>
+	      <entry><link linkend="ghci-import-qualified">Turn off
+	      implicit qualified import of everything in GHCi</link></entry>
+	      <entry>dynamic</entry>
+	      <entry>-</entry>
+	    </row>
 
 	  </tbody>
 	</tgroup>
@@ -594,7 +607,9 @@
     <sect2>
       <title>Language options</title>
 
-      <para><xref linkend="options-language"/></para>
+      <para>Language options can be enabled either by a command-line option 
+      <option>-Xblah</option>, or by a <literal>{-# LANGUAGE blah #-}</literal>
+      pragma in the file itself.  See <xref linkend="options-language"/></para>
 
       <informaltable>
 	<tgroup cols="4" align="left" colsep="1" rowsep="1">
@@ -646,11 +661,11 @@
 	      <entry><option>-XNoArrows</option></entry>
 	    </row>
 	    <row>
-	      <entry><option>-fdisambiguate-record-fields</option></entry>
+	      <entry><option>-XDisambiguateRecordFields</option></entry>
 	      <entry>Enable <link linkend="disambiguate-fields">record 
 	      field disambiguation</link></entry>
 	      <entry>dynamic</entry>
-	      <entry><option>-fno-disambiguate-record-fields</option></entry>
+	      <entry><option>-XNoDisambiguateRecordFields</option></entry>
 	    </row>
 	    <row>
 	      <entry><option>-XForeignFunctionInterface</option></entry>
@@ -743,6 +758,12 @@
 	      <entry><option>-XNoTemplateHaskell</option></entry>
 	    </row>
 	    <row>
+	      <entry><option>-XQuasiQuotes</option></entry>
+	      <entry>Enable <link linkend="th-quasiquotation">quasiquotation</link>.</entry>
+	      <entry>dynamic</entry>
+	      <entry><option>-XNoQuasiQuotes</option></entry>
+	    </row>
+	    <row>
 	      <entry><option>-XBangPatterns</option></entry>
 	      <entry>Enable <link linkend="bang-patterns">bang patterns</link>.</entry>
 	      <entry>dynamic</entry>
@@ -768,17 +789,24 @@
 	    </row>
 	    <row>
 	      <entry><option>-XUnicodeSyntax</option></entry>
-	      <entry>Enable unicode syntax.</entry>
+	      <entry>Enable <link linkend="unicode-syntax">unicode syntax</link>.</entry>
 	      <entry>dynamic</entry>
 	      <entry><option>-XNoUnicodeSyntax</option></entry>
 	    </row>
 	    <row>
 	      <entry><option>-XMagicHash</option></entry>
-	      <entry>Enable the &ldquo;magic hash&rdquo;.</entry>
+	      <entry>Allow "#" as a <link linkend="magic-hash">postfix modifier on identifiers</link>.</entry>
 	      <entry>dynamic</entry>
 	      <entry><option>-XNoMagicHash</option></entry>
 	    </row>
 	    <row>
+	      <entry><option>-XNewQualifiedOperators</option></entry>
+	      <entry>Enable <link linkend="new-qualified-operators">new
+	      qualified operator syntax</link></entry>
+	      <entry>dynamic</entry>
+	      <entry><option>-XNoNewQualifiedOperators</option></entry>
+	    </row>
+	    <row>
 	      <entry><option>-XPolymorphicComponents</option></entry>
 	      <entry>Enable <link linkend="universal-quantification">polymorphic components for data constructors</link>.</entry>
 	      <entry>dynamic</entry>
@@ -797,6 +825,12 @@
 	      <entry><option>-XNoRankNTypes</option></entry>
 	    </row>
 	    <row>
+	      <entry><option>-XImpredicativeTypes</option></entry>
+	      <entry>Enable <link linkend="impredicative-polymorphism">impredicative types</link>.</entry>
+	      <entry>dynamic</entry>
+	      <entry><option>-XNoImpredicativeTypes</option></entry>
+	    </row>
+	    <row>
 	      <entry><option>-XExistentialQuantification</option></entry>
 	      <entry>Enable <link linkend="existential-quantification">existential quantification</link>.</entry>
 	      <entry>dynamic</entry>
@@ -809,12 +843,6 @@
 	      <entry><option>-XNoKindSignatures</option></entry>
 	    </row>
 	    <row>
-	      <entry><option>-XPatternSignatures</option></entry>
-	      <entry>Enable <link linkend="pattern-type-sigs">pattern type signatures</link>.</entry>
-	      <entry>dynamic</entry>
-	      <entry><option>-XNoPatternSignatures</option></entry>
-	    </row>
-	    <row>
 	      <entry><option>-XEmptyDataDecls</option></entry>
 	      <entry>Enable empty data declarations.</entry>
 	      <entry>dynamic</entry>
@@ -827,6 +855,12 @@
 	      <entry><option>-XNoParallelListComp</option></entry>
 	    </row>
 	    <row>
+	      <entry><option>-XTransformListComp</option></entry>
+	      <entry>Enable <link linkend="generalised-list-comprehensions">generalised list comprehensions</link>.</entry>
+	      <entry>dynamic</entry>
+	      <entry><option>-XNoTransformListComp</option></entry>
+	    </row>
+	    <row>
 	      <entry><option>-XUnliftedFFITypes</option></entry>
 	      <entry>Enable unlifted FFI types.</entry>
 	      <entry>dynamic</entry>
@@ -863,10 +897,10 @@
 	      <entry><option>-XNoRecordWildCards</option></entry>
 	    </row>
 	    <row>
-	      <entry><option>-XRecordPuns</option></entry>
+	      <entry><option>-XNamedFieldPuns</option></entry>
 	      <entry>Enable <link linkend="record-puns">record puns</link>.</entry>
 	      <entry>dynamic</entry>
-	      <entry><option>-XNoRecordPuns</option></entry>
+	      <entry><option>-XNoNamedFieldPuns</option></entry>
 	    </row>
 	    <row>
 	      <entry><option>-XDisambiguateRecordFields</option></entry>
@@ -900,7 +934,7 @@
 	    </row>
 	    <row>
 	      <entry><option>-XTypeSynonymInstances</option></entry>
-	      <entry>Enable <link linkend="type-synonyms">type synonyms</link>.</entry>
+	      <entry>Enable <link linkend="flexible-instance-head">type synonyms in instance heads</link>.</entry>
 	      <entry>dynamic</entry>
 	      <entry><option>-XNoTypeSynonymInstances</option></entry>
 	    </row>
@@ -934,6 +968,12 @@
 	      <entry>dynamic</entry>
 	      <entry><option>-XNoFunctionalDependencies</option></entry>
 	    </row>
+	    <row>
+	      <entry><option>-XPackageImports</option></entry>
+	      <entry>Enable <link linkend="package-imports">package-qualified imports</link>.</entry>
+	      <entry>dynamic</entry>
+	      <entry><option>-XNoPackageImports</option></entry>
+	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
@@ -987,10 +1027,24 @@
 	  </row>
 
 	  <row>
-	    <entry><option>-fwarn-deprecations</option></entry>
-	    <entry>warn about uses of functions &amp; types that are deprecated</entry>
+	    <entry><option>-fwarn-unrecognised-pragmas</option></entry>
+	    <entry>warn about uses of pragmas that GHC doesn't recognise</entry>
 	    <entry>dynamic</entry>
-	    <entry><option>-fno-warn-deprecations</option></entry>
+	    <entry><option>-fno-warn-unrecognised-pragmas</option></entry>
+	  </row>
+
+	  <row>
+	    <entry><option>-fwarn-warnings-deprecations</option></entry>
+	    <entry>warn about uses of functions &amp; types that have warnings or deprecated pragmas</entry>
+	    <entry>dynamic</entry>
+	    <entry><option>-fno-warn-warnings-deprecations</option></entry>
+	  </row>
+
+	  <row>
+	    <entry><option>-fwarn-deprecated-flags</option></entry>
+	    <entry>warn about uses of commandline flags that are deprecated</entry>
+	    <entry>dynamic</entry>
+	    <entry><option>-fno-warn-deprecated-flags</option></entry>
 	  </row>
 
 	  <row>
@@ -1190,6 +1244,13 @@
 	    </row>
 
 	    <row>
+	      <entry><option>-fmethod-sharing</option></entry>
+	      <entry>Share specialisations of overloaded functions (default)</entry>
+	      <entry>dynamic</entry>
+	      <entry><option>-fno-method-sharing</option></entry>
+	    </row>
+
+	    <row>
 	      <entry><option>-fdo-eta-reduction</option></entry>
 	      <entry>Enable eta-reduction. Implied by <option>-O</option>.</entry>
 	      <entry>dynamic</entry>
@@ -1240,6 +1301,14 @@
 	    </row>
 
 	    <row>
+	      <entry><option>-fsimplifier-phases</option></entry>
+	      <entry>Set the number of phases for the simplifier (default 2).
+              Ignored with <option>-O0</option>.</entry>
+	      <entry>dynamic</entry>
+	      <entry>-</entry>
+	    </row>
+
+	    <row>
 	      <entry><option>-fmax-simplifier-iterations</option></entry>
 	      <entry>Set the max iterations for the simplifier</entry>
 	      <entry>dynamic</entry>
@@ -1292,6 +1361,22 @@
 	    </row>
 
 	    <row>
+	      <entry><option>-fspec-constr-threshold</option>=<replaceable>n</replaceable></entry>
+	      <entry>Set the size threshold for the SpecConstr transformation to <replaceable>n</replaceable> (default: 200)</entry>
+	      <entry>static</entry>
+	      <entry><option>-fno-spec-constr-threshold</option></entry>
+	    </row>
+
+	    <row>
+	      <entry><option>-fspec-constr-count</option>=<replaceable>n</replaceable></entry>
+	      <entry>Set to <replaceable>n</replaceable> (default: 3) the maximum number of 
+		specialisations that will be created for any one function
+		by the SpecConstr transformation</entry>
+	      <entry>static</entry>
+	      <entry><option>-fno-spec-constr-count</option></entry>
+	    </row>
+
+	    <row>
 	      <entry><option>-fliberate-case</option></entry>
 	      <entry>Turn on the liberate-case transformation. Implied by <option>-O2</option>.</entry>
 	      <entry>dynamic</entry>
@@ -1299,11 +1384,17 @@
 	    </row>
 
 	    <row>
-	      <entry><option>-fspec-threshold</option>=<replaceable>n</replaceable></entry>
-	      <entry>Set the size threshold for function specialisation to <replaceable>n</replaceable>, for both
-		the liberate-case and SpecConstr transformations (default: 200)</entry>
+	      <entry><option>-fstatic-argument-transformation</option></entry>
+	      <entry>Turn on the static argument transformation. Implied by <option>-O2</option>.</entry>
+	      <entry>dynamic</entry>
+	      <entry>-fno-static-argument-transformation</entry>
+	    </row>
+
+	    <row>
+	      <entry><option>-fliberate-case-threshold</option>=<replaceable>n</replaceable></entry>
+	      <entry>Set the size threshold for the liberate-case transformation to <replaceable>n</replaceable> (default: 200)</entry>
 	      <entry>static</entry>
-	      <entry><option>-</option></entry>
+	      <entry><option>-fno-liberate-case-threshold</option></entry>
 	    </row>
 
 	    <row>
@@ -1335,13 +1426,6 @@
 	    </row>
 
 	    <row>
-	      <entry><option>-funfolding-update-in-place</option></entry>
-	      <entry>Tweak unfolding settings</entry>
-	      <entry>static</entry>
-	      <entry><option>-fno-unfolding-update-in-place</option></entry>
-	    </row>
-
-	    <row>
 	      <entry><option>-funfolding-use-threshold</option></entry>
 	      <entry>Tweak unfolding settings</entry>
 	      <entry>static</entry>
@@ -1354,6 +1438,13 @@
 	      <entry>static</entry>
 	      <entry>-</entry>
 	    </row>
+
+	    <row>
+	      <entry><option>-feager-blackholing</option></entry>
+	      <entry>Turn on <link linkend="parallel-compile-options">eager blackholing</link></entry>
+	      <entry>dynamic</entry>
+	      <entry>-</entry>
+	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
@@ -1379,20 +1470,20 @@
 	      <entry><option>-auto</option></entry>
 	      <entry>Auto-add <literal>_scc_</literal>s to all
 	      exported functions</entry>
-	      <entry>static</entry>
+	      <entry>dynamic</entry>
 	      <entry><option>-no-auto</option></entry>
 	    </row>
 	    <row>
 	      <entry><option>-auto-all</option></entry>
 	      <entry>Auto-add <literal>_scc_</literal>s to all
 	      top-level functions</entry>
-	      <entry>static</entry>
+	      <entry>dynamic</entry>
 	      <entry><option>-no-auto-all</option></entry>
 	    </row>
 	    <row>
 	      <entry><option>-caf-all</option></entry>
 	      <entry>Auto-add <literal>_scc_</literal>s to all CAFs</entry>
-	      <entry>static</entry>
+	      <entry>dynamic</entry>
 	      <entry><option>-no-caf-all</option></entry>
 	    </row>
 	    <row>
@@ -1879,12 +1970,6 @@
 	      <entry>-</entry>
 	    </row>
 	    <row>
-	      <entry><option>-optdep</option> <replaceable>option</replaceable></entry>
-	      <entry>pass <replaceable>option</replaceable> to the dependency generator</entry>
-	      <entry>dynamic</entry>
-	      <entry>-</entry>
-	    </row>
-	    <row>
 	      <entry><option>-optwindres</option> <replaceable>option</replaceable></entry>
 	      <entry>pass <replaceable>option</replaceable> to <literal>windres</literal>.</entry>
 	      <entry>dynamic</entry>
@@ -2166,12 +2251,24 @@
 	      <entry>-</entry>
 	    </row>
 	    <row>
+	      <entry><option>-dno-debug-output</option></entry>
+	      <entry>Suppress unsolicited debugging output</entry>
+	      <entry>static</entry>
+	      <entry>-</entry>
+	    </row>
+	    <row>
 	      <entry><option>-dppr-debug</option></entry>
 	      <entry>Turn on debug printing (more verbose)</entry>
 	      <entry>static</entry>
 	      <entry>-</entry>
 	    </row>
 	    <row>
+	      <entry><option>-dsuppress-uniques</option></entry>
+	      <entry>Suppress the printing of uniques in debug output (easier to use <command>diff</command>.</entry>
+	      <entry>static</entry>
+	      <entry>-</entry>
+	    </row>
+	    <row>
 	      <entry><option>-dppr-noprags</option></entry>
 	      <entry>Don't output pragma info in dumps</entry>
 	      <entry>static</entry>
@@ -2263,12 +2360,6 @@
 	      <entry>-</entry>
 	    </row>
 	    <row>
-	      <entry><option>-fno-method-sharing</option></entry>
-	      <entry>Don't share specialisations of overloaded functions</entry>
-	      <entry>static</entry>
-	      <entry>-</entry>
-	    </row>
-	    <row>
 	      <entry><option>-fhistory-size</option></entry>
 	      <entry>Set simplification history size</entry>
 	      <entry>static</entry>