Preliminary monad-comprehension patch (Trac #4370)

[ghc-hetmet.git] / docs / users_guide / flags.xml

diff --git a/docs/users_guide/flags.xml b/docs/users_guide/flags.xml
index 8482a7c..add2f5e 100644 (file)
--- a/docs/users_guide/flags.xml
+++ b/docs/users_guide/flags.xml
@@ -325,13 +325,6 @@
              <entry>-</entry>
            </row>
            <row>
-             <entry><option>-keep-raw-s-file</option> or
-                 <option>-keep-raw-s-files</option></entry>
-             <entry>retain intermediate <literal>.raw_s</literal> files</entry>
-             <entry>dynamic</entry>
-             <entry>-</entry>
-           </row>
-           <row>
              <entry><option>-keep-tmp-files</option></entry>
              <entry>retain all intermediate temporary files</entry>
              <entry>dynamic</entry>
@@ -567,7 +560,7 @@
            <row>
              <entry><option>-package-name</option> <replaceable>P</replaceable></entry>
              <entry>Compile to be part of package <replaceable>P</replaceable></entry>
-             <entry>dynamic</entry>
+              <entry>static</entry>
              <entry>-</entry>
            </row>
            <row>
@@ -763,6 +756,13 @@
              <entry><option>-XNoGADTs</option></entry>
            </row>
            <row>
+             <entry><option>-XGADTSyntax</option></entry>
+             <entry>Enable <link linkend="gadt-style">generalised algebraic data type syntax</link>.
+             </entry>
+             <entry>dynamic</entry>
+             <entry><option>-XNoGADTSyntax</option></entry>
+           </row>
+           <row>
              <entry><option>-XTypeFamilies</option></entry>
              <entry>Enable <link linkend="type-families">type families</link>.</entry>
              <entry>dynamic</entry>
@@ -832,13 +832,6 @@
              <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>-XExplicitForALl</option></entry>
              <entry>Enable <link linkend="explicit-foralls">explicit universal quantification</link>.
               Implied by <option>-XScopedTypeVariables</option>,
@@ -905,6 +898,12 @@
              <entry>dynamic</entry>
              <entry><option>-XNoTransformListComp</option></entry>
            </row>
+        <row>
+             <entry><option>-XMonadComprehensions</option></entry>
+             <entry>Enable <link linkend="monad-comprehensions">monad comprehensions</link>.</entry>
+             <entry>dynamic</entry>
+             <entry><option>-XNoMonadComprehensions</option></entry>
+           </row>
            <row>
              <entry><option>-XUnliftedFFITypes</option></entry>
              <entry>Enable unlifted FFI types.</entry>
@@ -997,8 +996,9 @@
            </row>
            <row>
              <entry><option>-XFlexibleInstances</option></entry>
-             <entry>Enable <link linkend="instance-rules">flexible instances</link>.</entry>
-             <entry>dynamic</entry>
+              <entry>Enable <link linkend="instance-rules">flexible instances</link>.
+              Implies <option>-XTypeSynonymInstances</option> </entry>
+              <entry>dynamic</entry>
              <entry><option>-XNoFlexibleInstances</option></entry>
            </row>
            <row>
@@ -1114,6 +1114,14 @@
          </row>
 
           <row>
+            <entry><option>-fwarn-identities</option></entry>
+            <entry>warn about uses of Prelude numeric conversions that are probably
+                   the identity (and hence could be omitted)</entry>
+            <entry>dynamic</entry>
+            <entry><option>-fno-warn-identities</option></entry>
+          </row>
+
+          <row>
             <entry><option>-fwarn-implicit-prelude</option></entry>
             <entry>warn when the Prelude is implicitly imported</entry>
             <entry>dynamic</entry>
@@ -1128,6 +1136,13 @@
          </row>
 
          <row>
+           <entry><option>-fwarn-incomplete-uni-patterns</option></entry>
+           <entry>warn when a pattern match in a lambda expression or pattern binding could fail</entry>
+           <entry>dynamic</entry>
+           <entry><option>-fno-warn-incomplete-uni-patterns</option></entry>
+         </row>
+
+         <row>
            <entry><option>-fwarn-incomplete-record-updates</option></entry>
            <entry>warn when a record update could fail</entry>
            <entry>dynamic</entry>
@@ -1135,6 +1150,13 @@
          </row>
 
          <row>
+            <entry><option>-fwarn-lazy-unlifted-bindings</option></entry>
+            <entry>warn when a pattern binding looks lazy but must be strict</entry>
+           <entry>dynamic</entry>
+            <entry><option>-fno-warn-lazy-unlifted-bindings</option></entry>
+         </row>
+
+         <row>
            <entry><option>-fwarn-missing-fields</option></entry>
            <entry>warn when fields of a record are uninitialised</entry>
            <entry>dynamic</entry>
@@ -1164,6 +1186,13 @@
          </row>
 
          <row>
+           <entry><option>-fwarn-missing-local-sigs</option></entry>
+           <entry>warn about polymorphic local bindings without signatures</entry>
+           <entry>dynamic</entry>
+           <entry><option>-fno-warn-missing-local-sigs</option></entry>
+         </row>
+
+         <row>
            <entry><option>-fwarn-name-shadowing</option></entry>
            <entry>warn when names are shadowed</entry>
            <entry>dynamic</entry>
@@ -1528,6 +1557,13 @@ phase <replaceable>n</replaceable></entry>
            </row>
 
            <row>
+             <entry><option>-fno-opt-coercion</option></entry>
+             <entry>Turn off the coercion optimiser</entry>
+             <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>
@@ -1720,13 +1756,7 @@ phase <replaceable>n</replaceable></entry>
              <entry><option>-fasm</option></entry>
              <entry>Use the native code generator</entry>
              <entry>dynamic</entry>
-             <entry>-fvia-C</entry>
-           </row>
-           <row>
-             <entry><option>-fvia-C</option></entry>
-             <entry>Compile via C</entry>
-             <entry>dynamic</entry>
-             <entry>-fasm</entry>
+             <entry>-fllvm</entry>
            </row>
            <row>
              <entry><option>-fllvm</option></entry>
@@ -1975,12 +2005,6 @@ phase <replaceable>n</replaceable></entry>
            </row>
            </row>
            <row>
-             <entry><option>-pgmm</option> <replaceable>cmd</replaceable></entry>
-             <entry>Use <replaceable>cmd</replaceable> as the mangler</entry>
-             <entry>dynamic</entry>
-             <entry>-</entry>
-           </row>
-           <row>
              <entry><option>-pgms</option> <replaceable>cmd</replaceable></entry>
              <entry>Use <replaceable>cmd</replaceable> as the splitter</entry>
              <entry>dynamic</entry>
@@ -2227,6 +2251,13 @@ phase <replaceable>n</replaceable></entry>
              <entry>-</entry>
            </row>
            <row>
+             <entry><option>-ddump-core-stats</option></entry>
+             <entry>Print a one-line summary of the size of the Core program
+                     at the end of the optimisation pipeline </entry>
+             <entry>dynamic</entry>
+             <entry>-</entry>
+           </row>
+           <row>
              <entry><option>-ddump-cpranal</option></entry>
              <entry>Dump output from CPR analysis</entry>
              <entry>dynamic</entry>
@@ -2311,11 +2342,29 @@ phase <replaceable>n</replaceable></entry>
              <entry>-</entry>
            </row>
            <row>
-             <entry><option>-ddump-rules</option></entry>
-             <entry>Dump rules</entry>
+             <entry><option>-ddump-rule-firings</option></entry>
+             <entry>Dump rule firing info</entry>
+             <entry>dynamic</entry>
+             <entry>-</entry>
+           </row>
+           <row>
+             <entry><option>-ddump-rule-rewrites</option></entry>
+             <entry>Dump detailed rule firing info</entry>
              <entry>dynamic</entry>
              <entry>-</entry>
            </row>
+      <row>
+        <entry><option>-ddump-rules</option></entry>
+        <entry>Dump rules</entry>
+        <entry>dynamic</entry>
+        <entry>-</entry>
+      </row>
+      <row>
+        <entry><option>-ddump-vect</option></entry>
+        <entry>Dump vectoriser input and output</entry>
+        <entry>dynamic</entry>
+        <entry>-</entry>
+      </row>
            <row>
              <entry><option>-ddump-simpl</option></entry>
              <entry>Dump final simplifier output</entry>
@@ -2382,12 +2431,18 @@ phase <replaceable>n</replaceable></entry>
              <entry>dynamic</entry>
              <entry>-</entry>
            </row>
-           <row>
-             <entry><option>-ddump-tc-trace</option></entry>
-             <entry>Trace typechecker</entry>
-             <entry>dynamic</entry>
-             <entry>-</entry>
-           </row>
+      <row>
+        <entry><option>-ddump-tc-trace</option></entry>
+        <entry>Trace typechecker</entry>
+        <entry>dynamic</entry>
+        <entry>-</entry>
+      </row>
+      <row>
+        <entry><option>-ddump-vt-trace</option></entry>
+        <entry>Trace vectoriser</entry>
+        <entry>dynamic</entry>
+        <entry>-</entry>
+      </row>
            <row>
              <entry><option>-ddump-rn-trace</option></entry>
              <entry>Trace renamer</entry>
@@ -2540,12 +2595,6 @@ phase <replaceable>n</replaceable></entry>
              <entry>-</entry>
            </row>
            <row>
-             <entry><option>-fno-asm-mangling</option></entry>
-             <entry>Turn off assembly mangling (use <option>-unreg</option> instead)</entry>
-             <entry>dynamic</entry>
-             <entry>-</entry>
-           </row>
-           <row>
              <entry><option>-fno-ghci-sandbox</option></entry>
              <entry>Turn off the GHCi sandbox. Means computations are run in teh main thread, rather than a forked thread.</entry>
              <entry>dynamic</entry>