Add a WARNING pragma
[ghc-hetmet.git] / docs / users_guide / flags.xml
index abcca5d..f13d34c 100644 (file)
              <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>
              <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>
              <entry><option>-XNoParallelListComp</option></entry>
            </row>
            <row>
+             <entry><option>-XTransformListComp</option></entry>
+             <entry>Enable <link linkend="generalised-list-comprehensions">transform 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>
              <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>
          </row>
 
          <row>
-           <entry><option>-fwarn-deprecations</option></entry>
-           <entry>warn about uses of functions &amp; types that are deprecated</entry>
+           <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-deprecations</option></entry>
+           <entry><option>-fno-warn-deprecated-flags</option></entry>
          </row>
 
          <row>
            </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>
            </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>
            </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>
            </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>
            </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>
              <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>-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>