View patterns, record wildcards, and record puns
[ghc-hetmet.git] / docs / users_guide / flags.xml
index 7c21a73..1db7c46 100644 (file)
              <entry>-</entry>
            </row>
            <row>
+             <entry><option>&ndash;&ndash;print-docdir</option></entry>
+             <entry>display GHC documentation directory</entry>
+             <entry>mode</entry>
+             <entry>-</entry>
+           </row>
+           <row>
              <entry><option>-ferror-spans</option></entry>
              <entry>output full span in error messages</entry>
              <entry>static</entry>
              <entry>-</entry>
            </row>
            <row>
-             <entry><option>-fdebugging</option></entry>
-             <entry>Generate bytecode enabled for debugging</entry>
+             <entry><option>-fbreak-on-exception</option></entry>
+             <entry><link linkend="ghci-debugger-exceptions">Break on any exception thrown</link></entry>
              <entry>dynamic</entry>
-             <entry>-</entry>
+             <entry><option>-fno-break-on-exception</option></entry>
            </row>
            <row>
-             <entry><option>-fno-debugging</option></entry>
-             <entry>Do not include debugging information in bytecodes</entry>
+             <entry><option>-fbreak-on-error</option></entry>
+             <entry><link linkend="ghci-debugger-exceptions">Break on uncaught exceptions and errors</link></entry>
              <entry>dynamic</entry>
-             <entry>-</entry>
+             <entry><option>-fno-break-on-error</option></entry>
            </row>
            <row>
+             <entry><option>-fprint-evld-with-show</option></entry>
+             <entry><link linkend="breakpoints">Enable usage of Show instances in <literal>:print</literal></link></entry>
+             <entry>dynamic</entry>
+             <entry><option>-fno-print-evld-with-show</option></entry>
+           </row>          
+           <row>
              <entry><option>-fno-print-bind-result</option></entry>
              <entry><link linkend="ghci-stmts">Turn off printing of binding results in GHCi</link></entry>
              <entry>dynamic</entry>
            </row>
            <row>
              <entry><option>-XGADTs</option></entry>
-             <entry>Enable <link linkend="gadts">generalised algebraic data types</link>.
+             <entry>Enable <link linkend="gadt">generalised algebraic data types</link>.
              </entry>
              <entry>dynamic</entry>
              <entry><option>-XNoGADTs</option></entry>
              <entry><option>-XNoPatternGuards</option></entry>
            </row>
            <row>
+             <entry><option>-XViewPatterns</option></entry>
+             <entry>Enable <link linkend="view-patterns">view patterns</link>.</entry>
+             <entry>dynamic</entry>
+             <entry><option>-XNoViewPatterns</option></entry>
+           </row>
+           <row>
              <entry><option>-XUnicodeSyntax</option></entry>
              <entry>Enable unicode syntax.</entry>
              <entry>dynamic</entry>
            </row>
            <row>
              <entry><option>-XKindSignatures</option></entry>
-             <entry>Enable kind signatures.</entry>
+             <entry>Enable <link linkend="kinding">kind signatures</link>.</entry>
              <entry>dynamic</entry>
              <entry><option>-XNoKindSignatures</option></entry>
            </row>
              <entry><option>-XNoUnliftedFFITypes</option></entry>
            </row>
            <row>
-             <entry><option>-XPartiallyAppliedClosedTypeSynonyms</option></entry>
-             <entry>Enable partially applied type synonyms.</entry>
+             <entry><option>-XLiberalTypeSynonyms</option></entry>
+             <entry>Enable <link linkend="type-synonyms">liberalised type synonyms</link>.</entry>
              <entry>dynamic</entry>
-             <entry><option>-XNoPartiallyAppliedClosedTypeSynonyms</option></entry>
+             <entry><option>-XNoLiberalTypeSynonyms</option></entry>
            </row>
            <row>
              <entry><option>-XNoRank2Types</option></entry>
            </row>
            <row>
              <entry><option>-XStandaloneDeriving</option></entry>
-             <entry>Enable standalone deriving.</entry>
+             <entry>Enable <link linkend="stand-alone-deriving">standalone deriving</link>.</entry>
              <entry>dynamic</entry>
              <entry><option>-XNoStandaloneDeriving</option></entry>
            </row>
            <row>
              <entry><option>-XDeriveDataTypeable</option></entry>
-             <entry>Enable deriving for the Data and Typeable classes.</entry>
+             <entry>Enable <link linkend="deriving-typeable">deriving for the Data and Typeable classes</link>.</entry>
              <entry>dynamic</entry>
              <entry><option>-XNoDeriveDataTypeable</option></entry>
            </row>
            <row>
+             <entry><option>-XGeneralizedNewtypeDeriving</option></entry>
+             <entry>Enable <link linkend="newtype-deriving">newtype deriving</link>.</entry>
+             <entry>dynamic</entry>
+             <entry><option>-XNoGeneralizedNewtypeDeriving</option></entry>
+           </row>
+           <row>
              <entry><option>-XTypeSynonymInstances</option></entry>
              <entry>Enable <link linkend="type-synonyms">type synonyms</link>.</entry>
              <entry>dynamic</entry>
              <entry>dynamic</entry>
              <entry><option>-XNoFunctionalDependencies</option></entry>
            </row>
-           <row>
-             <entry><option>-XGeneralizedNewtypeDeriving</option></entry>
-             <entry>Enable <link linkend="newtype-deriving">newtype deriving</link>.</entry>
-             <entry>dynamic</entry>
-             <entry><option>-XNoGeneralizedNewtypeDeriving</option></entry>
-           </row>
          </tbody>
        </tgroup>
       </informaltable>
            <entry><option>-Werror</option></entry>
            <entry>make warnings fatal</entry>
            <entry>dynamic</entry>
-           <entry></entry>
+           <entry>-Wwarn</entry>
+         </row>
+         <row>
+           <entry><option>-Wwarn</option></entry>
+           <entry>make warnings non-fatal</entry>
+           <entry>dynamic</entry>
+           <entry>-Werror</entry>
          </row>
 
          <row>
            </row>
            <row>
              <entry><option>-hpcdir dir</option></entry>
-             <entry>Directory to deposit .mix files during compilation</entry>
+             <entry>Directory to deposit .mix files during compilation (default is .hpc)</entry>
              <entry>dynamic</entry>
              <entry><option>-</option></entry>
            </row>
              <entry>dynamic</entry>
              <entry>-</entry>
            </row>
-           <row>
-             <entry><option>-unreg</option></entry>
-             <entry>Enable unregisterised compilation</entry>
-             <entry>static</entry>
-             <entry>-</entry>
-           </row>
          </tbody>
        </tgroup>
       </informaltable>