1 <?xml version="1.0" encoding="iso-8859-1"?>
2 <sect1 id="flag-reference">
3 <title>Flag reference</title>
5 <para>This section is a quick-reference for GHC's command-line
6 flags. For each flag, we also list its static/dynamic status (see
7 <xref linkend="static-dynamic-flags"/>), and the flag's opposite
11 <title>Help and verbosity options</title>
13 <para><xref linkend="options-help"/></para>
16 <tgroup cols="4" align="left" colsep="1" rowsep="1">
20 <entry>Description</entry>
21 <entry>Static/Dynamic</entry>
22 <entry>Reverse</entry>
27 <entry><option>-?</option></entry>
33 <entry><option>-help</option></entry>
39 <entry><option>-n</option></entry>
40 <entry>do a dry run</entry>
41 <entry>dynamic</entry>
45 <entry><option>-v</option></entry>
46 <entry>verbose mode (equivalent to <option>-v3</option>)</entry>
47 <entry>dynamic</entry>
51 <entry><option>-v</option><replaceable>n</replaceable></entry>
52 <entry>set verbosity level</entry>
53 <entry>dynamic</entry>
57 <entry><option>-V</option></entry>
58 <entry>display GHC version</entry>
63 <entry><option>––supported-languages</option></entry>
64 <entry>display the supported language extensions</entry>
69 <entry><option>––info</option></entry>
70 <entry>display information about the compiler</entry>
75 <entry><option>––version</option></entry>
76 <entry>display GHC version</entry>
81 <entry><option>––numeric-version</option></entry>
82 <entry>display GHC version (numeric only)</entry>
87 <entry><option>––print-libdir</option></entry>
88 <entry>display GHC library directory</entry>
93 <entry><option>-ferror-spans</option></entry>
94 <entry>output full span in error messages</entry>
99 <entry><option>-H</option><replaceable>size</replaceable></entry>
100 <entry>Set the minimum heap size to <replaceable>size</replaceable></entry>
101 <entry>static</entry>
105 <entry><option>-Rghc-timing</option></entry>
106 <entry>Summarise timing stats for GHC (same as <literal>+RTS -tstderr</literal>)</entry>
107 <entry>static</entry>
116 <title>Which phases to run</title>
118 <para><xref linkend="options-order"/></para>
121 <tgroup cols="4" align="left" colsep="1" rowsep="1">
125 <entry>Description</entry>
126 <entry>Static/Dynamic</entry>
127 <entry>Reverse</entry>
132 <entry><option>-E</option></entry>
133 <entry>Stop after preprocessing (<literal>.hspp</literal> file)</entry>
138 <entry><option>-C</option></entry>
139 <entry>Stop after generating C (<literal>.hc</literal> file)</entry>
144 <entry><option>-S</option></entry>
145 <entry>Stop after generating assembly (<literal>.s</literal> file)</entry>
150 <entry><option>-c</option></entry>
151 <entry>Do not link</entry>
152 <entry>dynamic</entry>
156 <entry><option>-x</option> <replaceable>suffix</replaceable></entry>
157 <entry>Override default behaviour for source files</entry>
158 <entry>static</entry>
167 <title>Alternative modes of operation</title>
169 <para><xref linkend="modes"/></para>
172 <tgroup cols="4" align="left" colsep="1" rowsep="1">
176 <entry>Description</entry>
177 <entry>Static/Dynamic</entry>
178 <entry>Reverse</entry>
183 <entry><option>--interactive</option></entry>
184 <entry>Interactive mode - normally used by just running <command>ghci</command>;
185 see <xref linkend="ghci"/> for details.</entry>
190 <entry><option>--make</option></entry>
191 <entry>Build a multi-module Haskell program, automatically figuring out dependencies. Likely to be much easier, and faster, than using <command>make</command>;
192 see <xref linkend="make-mode"/> for details..</entry>
197 <entry><option>-e <replaceable>expr</replaceable></option></entry>
198 <entry>Evaluate <replaceable>expr</replaceable>;
199 see <xref linkend="eval-mode"/> for details.</entry>
204 <entry><option>-M</option></entry>
205 <entry>Generate dependency information suitable for use in a <filename>Makefile</filename>;
206 see <xref linkend="makefile-dependencies"/> for details.</entry>
216 <title>Redirecting output</title>
218 <para><xref linkend="options-output"/></para>
221 <tgroup cols="4" align="left" colsep="1" rowsep="1">
225 <entry>Description</entry>
226 <entry>Static/Dynamic</entry>
227 <entry>Reverse</entry>
232 <entry><option>-hcsuf</option> <replaceable>suffix</replaceable></entry>
233 <entry>set the suffix to use for intermediate C files</entry>
234 <entry>dynamic</entry>
238 <entry><option>-hidir</option> <replaceable>dir</replaceable></entry>
239 <entry>set directory for interface files</entry>
240 <entry>dynamic</entry>
244 <entry><option>-hisuf</option> <replaceable>suffix</replaceable></entry>
245 <entry>set the suffix to use for interface files</entry>
246 <entry>dynamic</entry>
250 <entry><option>-o</option> <replaceable>filename</replaceable></entry>
251 <entry>set output filename</entry>
252 <entry>dynamic</entry>
256 <entry><option>-odir</option> <replaceable>dir</replaceable></entry>
257 <entry>set directory for object files</entry>
258 <entry>dynamic</entry>
262 <entry><option>-ohi</option> <replaceable>filename</replaceable></entry>
263 <entry>set the filename in which to put the interface</entry>
264 <entry>dynamic</entry>
268 <entry><option>-osuf</option> <replaceable>suffix</replaceable></entry>
269 <entry>set the output file suffix</entry>
270 <entry>dynamic</entry>
274 <entry><option>-stubdir</option> <replaceable>dir</replaceable></entry>
275 <entry>redirect FFi stub files</entry>
276 <entry>dynamic</entry>
280 <entry><option>-outputdir</option> <replaceable>dir</replaceable></entry>
281 <entry>set output directory</entry>
282 <entry>dynamic</entry>
291 <title>Keeping intermediate files</title>
293 <para><xref linkend="keeping-intermediates"/></para>
296 <tgroup cols="4" align="left" colsep="1" rowsep="1">
300 <entry>Description</entry>
301 <entry>Static/Dynamic</entry>
302 <entry>Reverse</entry>
307 <entry><option>-keep-hc-file</option> or
308 <option>-keep-hc-files</option></entry>
309 <entry>retain intermediate <literal>.hc</literal> files</entry>
310 <entry>dynamic</entry>
314 <entry><option>-keep-s-file</option> or
315 <option>-keep-s-files</option></entry>
316 <entry>retain intermediate <literal>.s</literal> files</entry>
317 <entry>dynamic</entry>
321 <entry><option>-keep-raw-s-file</option> or
322 <option>-keep-raw-s-files</option></entry>
323 <entry>retain intermediate <literal>.raw_s</literal> files</entry>
324 <entry>dynamic</entry>
328 <entry><option>-keep-tmp-files</option></entry>
329 <entry>retain all intermediate temporary files</entry>
330 <entry>dynamic</entry>
339 <title>Temporary files</title>
341 <para><xref linkend="temp-files"/></para>
344 <tgroup cols="4" align="left" colsep="1" rowsep="1">
348 <entry>Description</entry>
349 <entry>Static/Dynamic</entry>
350 <entry>Reverse</entry>
355 <entry><option>-tmpdir</option></entry>
356 <entry>set the directory for temporary files</entry>
357 <entry>dynamic</entry>
366 <title>Finding imports</title>
368 <para><xref linkend="search-path"/></para>
371 <tgroup cols="4" align="left" colsep="1" rowsep="1">
376 <entry>Description</entry>
377 <entry>Static/Dynamic</entry>
378 <entry>Reverse</entry>
383 <entry><option>-i</option><replaceable>dir1</replaceable>:<replaceable>dir2</replaceable>:...</entry>
384 <entry>add <replaceable>dir</replaceable>,
385 <replaceable>dir2</replaceable>, etc. to import path</entry>
386 <entry>static/<literal>:set</literal></entry>
390 <entry><option>-i</option></entry>
391 <entry>Empty the import directory list</entry>
392 <entry>static/<literal>:set</literal></entry>
401 <title>Interface file options</title>
403 <para><xref linkend="hi-options"/></para>
406 <tgroup cols="4" align="left" colsep="1" rowsep="1">
411 <entry>Description</entry>
412 <entry>Static/Dynamic</entry>
413 <entry>Reverse</entry>
418 <entry><option>-ddump-hi</option></entry>
419 <entry>Dump the new interface to stdout</entry>
420 <entry>dynamic</entry>
424 <entry><option>-ddump-hi-diffs</option></entry>
425 <entry>Show the differences vs. the old interface</entry>
426 <entry>dynamic</entry>
430 <entry><option>-ddump-minimal-imports</option></entry>
431 <entry>Dump a minimal set of imports</entry>
432 <entry>dynamic</entry>
436 <entry><option>--show-iface</option> <replaceable>file</replaceable></entry>
437 <entry>See <xref linkend="modes"/>.</entry>
445 <title>Recompilation checking</title>
447 <para><xref linkend="recomp"/></para>
450 <tgroup cols="4" align="left" colsep="1" rowsep="1">
455 <entry>Description</entry>
456 <entry>Static/Dynamic</entry>
457 <entry>Reverse</entry>
462 <entry><option>-fforce-recomp</option></entry>
463 <entry>Turn off recompilation checking; implied by any
464 <option>-ddump-X</option> option</entry>
465 <entry>dynamic</entry>
466 <entry><option>-fno-force-recomp</option></entry>
473 <sect2 id="interactive-mode-options">
474 <title>Interactive-mode options</title>
476 <para><xref linkend="ghci-dot-files"/></para>
479 <tgroup cols="4" align="left" colsep="1" rowsep="1">
483 <entry>Description</entry>
484 <entry>Static/Dynamic</entry>
485 <entry>Reverse</entry>
490 <entry><option>-ignore-dot-ghci</option></entry>
491 <entry>Disable reading of <filename>.ghci</filename> files</entry>
492 <entry>static</entry>
496 <entry><option>-read-dot-ghci</option></entry>
497 <entry>Enable reading of <filename>.ghci</filename> files</entry>
498 <entry>static</entry>
502 <entry><option>-fbreak-on-exception</option></entry>
503 <entry><link linkend="ghci-debugger-exceptions">Break on any exception thrown</link></entry>
504 <entry>dynamic</entry>
505 <entry><option>-fno-break-on-exception</option></entry>
508 <entry><option>-fbreak-on-error</option></entry>
509 <entry><link linkend="ghci-debugger-exceptions">Break on uncaught exceptions and errors</link></entry>
510 <entry>dynamic</entry>
511 <entry><option>-fno-break-on-error</option></entry>
514 <entry><option>-fprint-evld-with-show</option></entry>
515 <entry><link linkend="breakpoints">Enable usage of Show instances in <literal>:print</literal></link></entry>
516 <entry>dynamic</entry>
517 <entry><option>-fno-print-evld-with-show</option></entry>
520 <entry><option>-fprint-bind-result</option></entry>
521 <entry><link linkend="ghci-stmts">Turn on printing of binding results in GHCi</link></entry>
522 <entry>dynamic</entry>
523 <entry><option>-fno-print-bind-result</option></entry>
526 <entry><option>-fno-print-bind-contents</option></entry>
527 <entry><link linkend="breakpoints">Turn off printing of binding contents in GHCi</link></entry>
528 <entry>dynamic</entry>
532 <entry><option>-fno-implicit-import-qualified</option></entry>
533 <entry><link linkend="ghci-import-qualified">Turn off
534 implicit qualified import of everything in GHCi</link></entry>
535 <entry>dynamic</entry>
545 <title>Packages</title>
547 <para><xref linkend="packages"/></para>
550 <tgroup cols="4" align="left" colsep="1" rowsep="1">
554 <entry>Description</entry>
555 <entry>Static/Dynamic</entry>
556 <entry>Reverse</entry>
561 <entry><option>-package-name</option> <replaceable>P</replaceable></entry>
562 <entry>Compile to be part of package <replaceable>P</replaceable></entry>
563 <entry>dynamic</entry>
567 <entry><option>-package</option> <replaceable>P</replaceable></entry>
568 <entry>Expose package <replaceable>P</replaceable></entry>
569 <entry>static/<literal>:set</literal></entry>
573 <entry><option>-hide-all-packages</option></entry>
574 <entry>Hide all packages by default</entry>
575 <entry>static</entry>
579 <entry><option>-hide-package</option> <replaceable>name</replaceable></entry>
580 <entry>Hide package <replaceable>P</replaceable></entry>
581 <entry>static/<literal>:set</literal></entry>
585 <entry><option>-ignore-package</option> <replaceable>name</replaceable></entry>
586 <entry>Ignore package <replaceable>P</replaceable></entry>
587 <entry>static/<literal>:set</literal></entry>
591 <entry><option>-package-conf</option> <replaceable>file</replaceable></entry>
592 <entry>Load more packages from <replaceable>file</replaceable></entry>
593 <entry>static</entry>
597 <entry><option>-no-user-package-conf</option></entry>
598 <entry>Don't load the user's package config file.</entry>
599 <entry>static</entry>
608 <title>Language options</title>
610 <para><xref linkend="options-language"/></para>
613 <tgroup cols="4" align="left" colsep="1" rowsep="1">
617 <entry>Description</entry>
618 <entry>Static/Dynamic</entry>
619 <entry>Reverse</entry>
624 <entry><option>-fglasgow-exts</option></entry>
625 <entry>Enable most language extensions</entry>
626 <entry>dynamic</entry>
627 <entry><option>-fno-glasgow-exts</option></entry>
630 <entry><option>-XOverlappingInstances</option></entry>
631 <entry>Enable <link linkend="instance-overlap">overlapping instances</link></entry>
632 <entry>dynamic</entry>
633 <entry><option>-XNoOverlappingInstances</option></entry>
636 <entry><option>-XIncoherentInstances</option></entry>
637 <entry>Enable <link linkend="instance-overlap">incoherent instances</link>.
638 Implies <option>-XOverlappingInstances</option> </entry>
639 <entry>dynamic</entry>
640 <entry><option>-XNoIncoherentInstances</option></entry>
643 <entry><option>-XUndecidableInstances</option></entry>
644 <entry>Enable <link linkend="undecidable-instances">undecidable instances</link></entry>
645 <entry>dynamic</entry>
646 <entry><option>-XNoUndecidableInstances</option></entry>
649 <entry><option>-fcontext-stack=N</option><replaceable>n</replaceable></entry>
650 <entry>set the <link linkend="undecidable-instances">limit for context reduction</link>. Default is 20.</entry>
651 <entry>dynamic</entry>
655 <entry><option>-XArrows</option></entry>
656 <entry>Enable <link linkend="arrow-notation">arrow
657 notation</link> extension</entry>
658 <entry>dynamic</entry>
659 <entry><option>-XNoArrows</option></entry>
662 <entry><option>-XDisambiguateRecordFields</option></entry>
663 <entry>Enable <link linkend="disambiguate-fields">record
664 field disambiguation</link></entry>
665 <entry>dynamic</entry>
666 <entry><option>-XNoDisambiguateRecordFields</option></entry>
669 <entry><option>-XForeignFunctionInterface</option></entry>
670 <entry>Enable <link linkend="ffi">foreign function interface</link> (implied by
671 <option>-fglasgow-exts</option>)</entry>
672 <entry>dynamic</entry>
673 <entry><option>-XNoForeignFunctionInterface</option></entry>
676 <entry><option>-XGenerics</option></entry>
677 <entry>Enable <link linkend="generic-classes">generic classes</link></entry>
678 <entry>dynamic</entry>
679 <entry><option>-XNoGenerics</option></entry>
682 <entry><option>-XImplicitParams</option></entry>
683 <entry>Enable <link linkend="implicit-parameters">Implicit Parameters</link>.
684 Implied by <option>-fglasgow-exts</option>.</entry>
685 <entry>dynamic</entry>
686 <entry><option>-XNoImplicitParams</option></entry>
689 <entry><option>-firrefutable-tuples</option></entry>
690 <entry>Make tuple pattern matching irrefutable</entry>
691 <entry>dynamic</entry>
692 <entry><option>-fno-irrefutable-tuples</option></entry>
695 <entry><option>-XNoImplicitPrelude</option></entry>
696 <entry>Don't implicitly <literal>import Prelude</literal></entry>
697 <entry>dynamic</entry>
698 <entry><option>-XImplicitPrelude</option></entry>
701 <entry><option>-XNoMonomorphismRestriction</option></entry>
702 <entry>Disable the <link linkend="monomorphism">monomorphism restriction</link></entry>
703 <entry>dynamic</entry>
704 <entry><option>-XMonomorphismRrestriction</option></entry>
707 <entry><option>-XNoMonoPatBinds</option></entry>
708 <entry>Make <link linkend="monomorphism">pattern bindings polymorphic</link></entry>
709 <entry>dynamic</entry>
710 <entry><option>-XMonoPatBinds</option></entry>
713 <entry><option>-XRelaxedPolyRec</option></entry>
714 <entry>Relaxed checking for <link linkend="typing-binds">mutually-recursive polymorphic functions</link></entry>
715 <entry>dynamic</entry>
716 <entry><option>-XNoRelaxedPolyRec</option></entry>
719 <entry><option>-XExtendedDefaultRules</option></entry>
720 <entry>Use GHCi's <link linkend="extended-default-rules">extended default rules</link> in a normal module</entry>
721 <entry>dynamic</entry>
722 <entry><option>-XNoExtendedDefaultRules</option></entry>
725 <entry><option>-XOverloadedStrings</option></entry>
726 <entry>Enable <link linkend="overloaded-strings">overloaded string literals</link>.
728 <entry>dynamic</entry>
729 <entry><option>-XNoOverloadedStrings</option></entry>
732 <entry><option>-XGADTs</option></entry>
733 <entry>Enable <link linkend="gadt">generalised algebraic data types</link>.
735 <entry>dynamic</entry>
736 <entry><option>-XNoGADTs</option></entry>
739 <entry><option>-XTypeFamilies</option></entry>
740 <entry>Enable <link linkend="type-families">type families</link>.</entry>
741 <entry>dynamic</entry>
742 <entry><option>-XNoTypeFamilies</option></entry>
745 <entry><option>-XScopedTypeVariables</option></entry>
746 <entry>Enable <link linkend="scoped-type-variables">lexically-scoped type variables</link>.
747 Implied by <option>-fglasgow-exts</option>.</entry>
748 <entry>dynamic</entry>
749 <entry><option>-XNoScopedTypeVariables</option></entry>
752 <entry><option>-XTemplateHaskell</option></entry>
753 <entry>Enable <link linkend="template-haskell">Template Haskell</link>.
754 No longer implied by <option>-fglasgow-exts</option>.</entry>
755 <entry>dynamic</entry>
756 <entry><option>-XNoTemplateHaskell</option></entry>
759 <entry><option>-XQuasiQuotes</option></entry>
760 <entry>Enable <link linkend="th-quasiquotation">quasiquotation</link>.</entry>
761 <entry>dynamic</entry>
762 <entry><option>-XNoQuasiQuotes</option></entry>
765 <entry><option>-XBangPatterns</option></entry>
766 <entry>Enable <link linkend="bang-patterns">bang patterns</link>.</entry>
767 <entry>dynamic</entry>
768 <entry><option>-XNoBangPatterns</option></entry>
771 <entry><option>-XCPP</option></entry>
772 <entry>Enable the <link linkend="c-pre-processor">C preprocessor</link>.</entry>
773 <entry>dynamic</entry>
774 <entry><option>-XNoCPP</option></entry>
777 <entry><option>-XPatternGuards</option></entry>
778 <entry>Enable <link linkend="pattern-guards">pattern guards</link>.</entry>
779 <entry>dynamic</entry>
780 <entry><option>-XNoPatternGuards</option></entry>
783 <entry><option>-XViewPatterns</option></entry>
784 <entry>Enable <link linkend="view-patterns">view patterns</link>.</entry>
785 <entry>dynamic</entry>
786 <entry><option>-XNoViewPatterns</option></entry>
789 <entry><option>-XUnicodeSyntax</option></entry>
790 <entry>Enable unicode syntax.</entry>
791 <entry>dynamic</entry>
792 <entry><option>-XNoUnicodeSyntax</option></entry>
795 <entry><option>-XMagicHash</option></entry>
796 <entry>Allow "#" as a <link linkend="magic-hash">postfix modifier on identifiers</link>.</entry>
797 <entry>dynamic</entry>
798 <entry><option>-XNoMagicHash</option></entry>
801 <entry><option>-XNewQualifiedOperators</option></entry>
802 <entry>Enable <link linkend="new-qualified-operators">new
803 qualified operator syntax</link></entry>
804 <entry>dynamic</entry>
805 <entry><option>-XNoNewQualifiedOperators</option></entry>
808 <entry><option>-XPolymorphicComponents</option></entry>
809 <entry>Enable <link linkend="universal-quantification">polymorphic components for data constructors</link>.</entry>
810 <entry>dynamic</entry>
811 <entry><option>-XNoPolymorphicComponents</option></entry>
814 <entry><option>-XRank2Types</option></entry>
815 <entry>Enable <link linkend="universal-quantification">rank-2 types</link>.</entry>
816 <entry>dynamic</entry>
817 <entry><option>-XNoRank2Types</option></entry>
820 <entry><option>-XRankNTypes</option></entry>
821 <entry>Enable <link linkend="universal-quantification">rank-N types</link>.</entry>
822 <entry>dynamic</entry>
823 <entry><option>-XNoRankNTypes</option></entry>
826 <entry><option>-XImpredicativeTypes</option></entry>
827 <entry>Enable <link linkend="impredicative-polymorphism">impredicative types</link>.</entry>
828 <entry>dynamic</entry>
829 <entry><option>-XNoImpredicativeTypes</option></entry>
832 <entry><option>-XExistentialQuantification</option></entry>
833 <entry>Enable <link linkend="existential-quantification">existential quantification</link>.</entry>
834 <entry>dynamic</entry>
835 <entry><option>-XNoExistentialQuantification</option></entry>
838 <entry><option>-XKindSignatures</option></entry>
839 <entry>Enable <link linkend="kinding">kind signatures</link>.</entry>
840 <entry>dynamic</entry>
841 <entry><option>-XNoKindSignatures</option></entry>
844 <entry><option>-XEmptyDataDecls</option></entry>
845 <entry>Enable empty data declarations.</entry>
846 <entry>dynamic</entry>
847 <entry><option>-XNoEmptyDataDecls</option></entry>
850 <entry><option>-XParallelListComp</option></entry>
851 <entry>Enable <link linkend="parallel-list-comprehensions">parallel list comprehensions</link>.</entry>
852 <entry>dynamic</entry>
853 <entry><option>-XNoParallelListComp</option></entry>
856 <entry><option>-XTransformListComp</option></entry>
857 <entry>Enable <link linkend="generalised-list-comprehensions">transform list comprehensions</link>.</entry>
858 <entry>dynamic</entry>
859 <entry><option>-XNoTransformListComp</option></entry>
862 <entry><option>-XUnliftedFFITypes</option></entry>
863 <entry>Enable unlifted FFI types.</entry>
864 <entry>dynamic</entry>
865 <entry><option>-XNoUnliftedFFITypes</option></entry>
868 <entry><option>-XLiberalTypeSynonyms</option></entry>
869 <entry>Enable <link linkend="type-synonyms">liberalised type synonyms</link>.</entry>
870 <entry>dynamic</entry>
871 <entry><option>-XNoLiberalTypeSynonyms</option></entry>
874 <entry><option>-XTypeOperators</option></entry>
875 <entry>Enable type operators.</entry>
876 <entry>dynamic</entry>
877 <entry><option>-XNoTypeOperators</option></entry>
880 <entry><option>-XRecursiveDo</option></entry>
881 <entry>Enable <link linkend="mdo-notation">recursive do (mdo) notation</link>.</entry>
882 <entry>dynamic</entry>
883 <entry><option>-XNoRecursiveDo</option></entry>
886 <entry><option>-XPArr</option></entry>
887 <entry>Enable parallel arrays.</entry>
888 <entry>dynamic</entry>
889 <entry><option>-XNoPArr</option></entry>
892 <entry><option>-XRecordWildCards</option></entry>
893 <entry>Enable <link linkend="record-wildcards">record wildcards</link>.</entry>
894 <entry>dynamic</entry>
895 <entry><option>-XNoRecordWildCards</option></entry>
898 <entry><option>-XNamedFieldPuns</option></entry>
899 <entry>Enable <link linkend="record-puns">record puns</link>.</entry>
900 <entry>dynamic</entry>
901 <entry><option>-XNoNamedFieldPuns</option></entry>
904 <entry><option>-XDisambiguateRecordFields</option></entry>
905 <entry>Enable <link linkend="disambiguate-fields">record field disambiguation</link>. </entry>
906 <entry>dynamic</entry>
907 <entry><option>-XNoDisambiguateRecordFields</option></entry>
910 <entry><option>-XUnboxedTuples</option></entry>
911 <entry>Enable <link linkend="unboxed-tuples">unboxed tuples</link>.</entry>
912 <entry>dynamic</entry>
913 <entry><option>-XNoUnboxedTuples</option></entry>
916 <entry><option>-XStandaloneDeriving</option></entry>
917 <entry>Enable <link linkend="stand-alone-deriving">standalone deriving</link>.</entry>
918 <entry>dynamic</entry>
919 <entry><option>-XNoStandaloneDeriving</option></entry>
922 <entry><option>-XDeriveDataTypeable</option></entry>
923 <entry>Enable <link linkend="deriving-typeable">deriving for the Data and Typeable classes</link>.</entry>
924 <entry>dynamic</entry>
925 <entry><option>-XNoDeriveDataTypeable</option></entry>
928 <entry><option>-XGeneralizedNewtypeDeriving</option></entry>
929 <entry>Enable <link linkend="newtype-deriving">newtype deriving</link>.</entry>
930 <entry>dynamic</entry>
931 <entry><option>-XNoGeneralizedNewtypeDeriving</option></entry>
934 <entry><option>-XTypeSynonymInstances</option></entry>
935 <entry>Enable <link linkend="type-synonym-instances">type synonyms</link>.</entry>
936 <entry>dynamic</entry>
937 <entry><option>-XNoTypeSynonymInstances</option></entry>
940 <entry><option>-XFlexibleContexts</option></entry>
941 <entry>Enable <link linkend="flexible-contexts">flexible contexts</link>.</entry>
942 <entry>dynamic</entry>
943 <entry><option>-XNoFlexibleContexts</option></entry>
946 <entry><option>-XFlexibleInstances</option></entry>
947 <entry>Enable <link linkend="instance-rules">flexible instances</link>.</entry>
948 <entry>dynamic</entry>
949 <entry><option>-XNoFlexibleInstances</option></entry>
952 <entry><option>-XConstrainedClassMethods</option></entry>
953 <entry>Enable <link linkend="class-method-types">constrained class methods</link>.</entry>
954 <entry>dynamic</entry>
955 <entry><option>-XNoConstrainedClassMethods</option></entry>
958 <entry><option>-XMultiParamTypeClasses</option></entry>
959 <entry>Enable <link linkend="multi-param-type-classes">multi parameter type classes</link>.</entry>
960 <entry>dynamic</entry>
961 <entry><option>-XNoMultiParamTypeClasses</option></entry>
964 <entry><option>-XFunctionalDependencies</option></entry>
965 <entry>Enable <link linkend="functional-dependencies">functional dependencies</link>.</entry>
966 <entry>dynamic</entry>
967 <entry><option>-XNoFunctionalDependencies</option></entry>
970 <entry><option>-XPackageImports</option></entry>
971 <entry>Enable <link linkend="package-imports">package-qualified imports</link>.</entry>
972 <entry>dynamic</entry>
973 <entry><option>-XNoPackageImports</option></entry>
981 <title>Warnings</title>
983 <para><xref linkend="options-sanity"/></para>
986 <tgroup cols="4" align="left" colsep="1" rowsep="1">
990 <entry>Description</entry>
991 <entry>Static/Dynamic</entry>
992 <entry>Reverse</entry>
997 <entry><option>-W</option></entry>
998 <entry>enable normal warnings</entry>
999 <entry>dynamic</entry>
1000 <entry><option>-w</option></entry>
1003 <entry><option>-w</option></entry>
1004 <entry>disable all warnings</entry>
1005 <entry>dynamic</entry>
1009 <entry><option>-Wall</option></entry>
1010 <entry>enable almost all warnings (details in <xref linkend="options-sanity"/>)</entry>
1011 <entry>dynamic</entry>
1012 <entry><option>-w</option></entry>
1015 <entry><option>-Werror</option></entry>
1016 <entry>make warnings fatal</entry>
1017 <entry>dynamic</entry>
1018 <entry>-Wwarn</entry>
1021 <entry><option>-Wwarn</option></entry>
1022 <entry>make warnings non-fatal</entry>
1023 <entry>dynamic</entry>
1024 <entry>-Werror</entry>
1028 <entry><option>-fwarn-warnings-deprecations</option></entry>
1029 <entry>warn about uses of functions & types that have warnings or deprecated pragmas</entry>
1030 <entry>dynamic</entry>
1031 <entry><option>-fno-warn-warnings-deprecations</option></entry>
1035 <entry><option>-fwarn-deprecated-flags</option></entry>
1036 <entry>warn about uses of commandline flags that are deprecated</entry>
1037 <entry>dynamic</entry>
1038 <entry><option>-fno-warn-deprecated-flags</option></entry>
1042 <entry><option>-fwarn-duplicate-exports</option></entry>
1043 <entry>warn when an entity is exported multiple times</entry>
1044 <entry>dynamic</entry>
1045 <entry><option>-fno-warn-duplicate-exports</option></entry>
1049 <entry><option>-fwarn-hi-shadowing</option></entry>
1050 <entry>warn when a <literal>.hi</literal> file in the
1051 current directory shadows a library</entry>
1052 <entry>dynamic</entry>
1053 <entry><option>-fno-warn-hi-shadowing</option></entry>
1057 <entry><option>-fwarn-implicit-prelude</option></entry>
1058 <entry>warn when the Prelude is implicitly imported</entry>
1059 <entry>dynamic</entry>
1060 <entry><option>-fno-warn-implicit-prelude</option></entry>
1064 <entry><option>-fwarn-incomplete-patterns</option></entry>
1065 <entry>warn when a pattern match could fail</entry>
1066 <entry>dynamic</entry>
1067 <entry><option>-fno-warn-incomplete-patterns</option></entry>
1071 <entry><option>-fwarn-incomplete-record-updates</option></entry>
1072 <entry>warn when a record update could fail</entry>
1073 <entry>dynamic</entry>
1074 <entry><option>-fno-warn-incomplete-record-updates</option></entry>
1078 <entry><option>-fwarn-missing-fields</option></entry>
1079 <entry>warn when fields of a record are uninitialised</entry>
1080 <entry>dynamic</entry>
1081 <entry><option>-fno-warn-missing-fields</option></entry>
1085 <entry><option>-fwarn-missing-methods</option></entry>
1086 <entry>warn when class methods are undefined</entry>
1087 <entry>dynamic</entry>
1088 <entry><option>-fno-warn-missing-methods</option></entry>
1092 <entry><option>-fwarn-missing-signatures</option></entry>
1093 <entry>warn about top-level functions without signatures</entry>
1094 <entry>dynamic</entry>
1095 <entry><option>-fno-warn-missing-signatures</option></entry>
1099 <entry><option>-fwarn-name-shadowing</option></entry>
1100 <entry>warn when names are shadowed</entry>
1101 <entry>dynamic</entry>
1102 <entry><option>-fno-warn-name-shadowing</option></entry>
1106 <entry><option>-fwarn-orphans</option></entry>
1107 <entry>warn when the module contains <link linkend="orphan-modules">orphan instance declarations
1108 or rewrite rules</link></entry>
1109 <entry>dynamic</entry>
1110 <entry><option>-fno-warn-orphans</option></entry>
1114 <entry><option>-fwarn-overlapping-patterns</option></entry>
1115 <entry>warn about overlapping patterns</entry>
1116 <entry>dynamic</entry>
1117 <entry><option>-fno-warn-overlapping-patterns</option></entry>
1121 <entry><option>-fwarn-simple-patterns</option></entry>
1122 <entry>warn about lambda-patterns that can fail</entry>
1123 <entry>dynamic</entry>
1124 <entry><option>-fno-warn-simple-patterns</option></entry>
1128 <entry><option>-fwarn-tabs</option></entry>
1129 <entry>warn if there are tabs in the source file</entry>
1130 <entry>dynamic</entry>
1131 <entry><option>-fno-warn-tabs</option></entry>
1135 <entry><option>-fwarn-type-defaults</option></entry>
1136 <entry>warn when defaulting happens</entry>
1137 <entry>dynamic</entry>
1138 <entry><option>-fno-warn-type-defaults</option></entry>
1142 <entry><option>-fwarn-monomorphism-restriction</option></entry>
1143 <entry>warn when the Monomorphism Restriction is applied</entry>
1144 <entry>dynamic</entry>
1145 <entry><option>-fno-warn-monomorphism-restriction</option></entry>
1149 <entry><option>-fwarn-unused-binds</option></entry>
1150 <entry>warn about bindings that are unused</entry>
1151 <entry>dynamic</entry>
1152 <entry><option>-fno-warn-unused-binds</option></entry>
1156 <entry><option>-fwarn-unused-imports</option></entry>
1157 <entry>warn about unnecessary imports</entry>
1158 <entry>dynamic</entry>
1159 <entry><option>-fno-warn-unused-imports</option></entry>
1163 <entry><option>-fwarn-unused-matches</option></entry>
1164 <entry>warn about variables in patterns that aren't used</entry>
1165 <entry>dynamic</entry>
1166 <entry><option>-fno-warn-unused-matches</option></entry>
1175 <title>Optimisation levels</title>
1177 <para><xref linkend="options-optimise"/></para>
1180 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1184 <entry>Description</entry>
1185 <entry>Static/Dynamic</entry>
1186 <entry>Reverse</entry>
1191 <entry><option>-O</option></entry>
1192 <entry>Enable default optimisation (level 1)</entry>
1193 <entry>dynamic</entry>
1194 <entry><option>-O0</option></entry>
1197 <entry><option>-O</option><replaceable>n</replaceable></entry>
1198 <entry>Set optimisation level <replaceable>n</replaceable></entry>
1199 <entry>dynamic</entry>
1200 <entry><option>-O0</option></entry>
1208 <title>Individual optimisations</title>
1210 <para><xref linkend="options-f"/></para>
1213 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1217 <entry>Description</entry>
1218 <entry>Static/Dynamic</entry>
1219 <entry>Reverse</entry>
1224 <entry><option>-fcase-merge</option></entry>
1225 <entry>Enable case-merging. Implied by <option>-O</option>.</entry>
1226 <entry>dynamic</entry>
1227 <entry><option>-fno-case-merge</option></entry>
1231 <entry><option>-fdicts-strict</option></entry>
1232 <entry>Make dictionaries strict</entry>
1233 <entry>static</entry>
1234 <entry><option>-fno-dicts-strict</option></entry>
1238 <entry><option>-fmethod-sharing</option></entry>
1239 <entry>Share specialisations of overloaded functions (default)</entry>
1240 <entry>dynamic</entry>
1241 <entry><option>-fno-method-sharing</option></entry>
1245 <entry><option>-fdo-eta-reduction</option></entry>
1246 <entry>Enable eta-reduction. Implied by <option>-O</option>.</entry>
1247 <entry>dynamic</entry>
1248 <entry><option>-fno-do-eta-reduction</option></entry>
1252 <entry><option>-fdo-lambda-eta-expansion</option></entry>
1253 <entry>Enable lambda eta-reduction</entry>
1254 <entry>dynamic</entry>
1255 <entry><option>-fno-do-lambda-eta-expansion</option></entry>
1259 <entry><option>-fexcess-precision</option></entry>
1260 <entry>Enable excess intermediate precision</entry>
1261 <entry>dynamic</entry>
1262 <entry><option>-fno-excess-precision</option></entry>
1266 <entry><option>-fignore-asserts</option></entry>
1267 <entry>Ignore assertions in the source</entry>
1268 <entry>dynamic</entry>
1269 <entry><option>-fno-ignore-asserts</option></entry>
1273 <entry><option>-fignore-interface-pragmas</option></entry>
1274 <entry>Ignore pragmas in interface files</entry>
1275 <entry>dynamic</entry>
1276 <entry><option>-fno-ignore-interface-pragmas</option></entry>
1280 <entry><option>-fomit-interface-pragmas</option></entry>
1281 <entry>Don't generate interface pragmas</entry>
1282 <entry>dynamic</entry>
1283 <entry><option>-fno-omit-interface-pragmas</option></entry>
1287 <entry><option>-fmax-worker-args</option></entry>
1288 <entry>If a worker has that many arguments, none will be
1289 unpacked anymore (default: 10)</entry>
1290 <entry>static</entry>
1295 <entry><option>-fsimplifier-phases</option></entry>
1296 <entry>Set the number of phases for the simplifier (default 2).
1297 Ignored with <option>-O0</option>.</entry>
1298 <entry>dynamic</entry>
1303 <entry><option>-fmax-simplifier-iterations</option></entry>
1304 <entry>Set the max iterations for the simplifier</entry>
1305 <entry>dynamic</entry>
1310 <entry><option>-fno-state-hack</option></entry>
1311 <entry>Turn off the "state hack" whereby any lambda with a real-world state token
1312 as argument is considered to be single-entry. Hence OK to inline things inside it.</entry>
1313 <entry>static</entry>
1318 <entry><option>-fcse</option></entry>
1319 <entry>Turn on common sub-expression elimination. Implied by <option>-O</option>.</entry>
1320 <entry>dynamic</entry>
1321 <entry>-fno-cse</entry>
1325 <entry><option>-ffull-laziness</option></entry>
1326 <entry>Turn on full laziness (floating bindings outwards). Implied by <option>-O</option>.</entry>
1327 <entry>dynamic</entry>
1328 <entry>-fno-full-laziness</entry>
1332 <entry><option>-frewrite-rules</option></entry>
1333 <entry>Switch on all rewrite rules (including rules
1334 generated by automatic specialisation of overloaded functions).
1335 Implied by <option>-O</option>. </entry>
1336 <entry>dynamic</entry>
1337 <entry><option>-fno-rewrite-rules</option></entry>
1341 <entry><option>-fstrictness</option></entry>
1342 <entry>Turn on strictness analysis. Implied by <option>-O</option>.</entry>
1343 <entry>dynamic</entry>
1344 <entry>-fno-strictness</entry>
1348 <entry><option>-fspec-constr</option></entry>
1349 <entry>Turn on the SpecConstr transformation. Implied by <option>-O2</option>.</entry>
1350 <entry>dynamic</entry>
1351 <entry>-fno-spec-constr</entry>
1355 <entry><option>-fspec-constr-threshold</option>=<replaceable>n</replaceable></entry>
1356 <entry>Set the size threshold for the SpecConstr transformation to <replaceable>n</replaceable> (default: 200)</entry>
1357 <entry>static</entry>
1358 <entry><option>-fno-spec-constr-threshold</option></entry>
1362 <entry><option>-fspec-constr-count</option>=<replaceable>n</replaceable></entry>
1363 <entry>Set to <replaceable>n</replaceable> (default: 3) the maximum number of
1364 specialisations that will be created for any one function
1365 by the SpecConstr transformation</entry>
1366 <entry>static</entry>
1367 <entry><option>-fno-spec-constr-count</option></entry>
1371 <entry><option>-fliberate-case</option></entry>
1372 <entry>Turn on the liberate-case transformation. Implied by <option>-O2</option>.</entry>
1373 <entry>dynamic</entry>
1374 <entry>-fno-liberate-case</entry>
1378 <entry><option>-fstatic-argument-transformation</option></entry>
1379 <entry>Turn on the static argument transformation. Implied by <option>-O2</option>.</entry>
1380 <entry>dynamic</entry>
1381 <entry>-fno-static-argument-transformation</entry>
1385 <entry><option>-fliberate-case-threshold</option>=<replaceable>n</replaceable></entry>
1386 <entry>Set the size threshold for the liberate-case transformation to <replaceable>n</replaceable> (default: 200)</entry>
1387 <entry>static</entry>
1388 <entry><option>-fno-liberate-case-threshold</option></entry>
1392 <entry><option>-funbox-strict-fields</option></entry>
1393 <entry>Flatten strict constructor fields</entry>
1394 <entry>dynamic</entry>
1395 <entry><option>-fno-unbox-strict-fields</option></entry>
1399 <entry><option>-funfolding-creation-threshold</option></entry>
1400 <entry>Tweak unfolding settings</entry>
1401 <entry>static</entry>
1402 <entry><option>-fno-unfolding-creation-threshold</option></entry>
1406 <entry><option>-funfolding-fun-discount</option></entry>
1407 <entry>Tweak unfolding settings</entry>
1408 <entry>static</entry>
1409 <entry><option>-fno-unfolding-fun-discount</option></entry>
1413 <entry><option>-funfolding-keeness-factor</option></entry>
1414 <entry>Tweak unfolding settings</entry>
1415 <entry>static</entry>
1416 <entry><option>-fno-unfolding-keeness-factor</option></entry>
1420 <entry><option>-funfolding-use-threshold</option></entry>
1421 <entry>Tweak unfolding settings</entry>
1422 <entry>static</entry>
1423 <entry><option>-fno-unfolding-use-threshold</option></entry>
1427 <entry><option>-fno-pre-inlining</option></entry>
1428 <entry>Turn off pre-inlining</entry>
1429 <entry>static</entry>
1438 <title>Profiling options</title>
1440 <para><xref linkend="profiling"/></para>
1443 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1447 <entry>Description</entry>
1448 <entry>Static/Dynamic</entry>
1449 <entry>Reverse</entry>
1454 <entry><option>-auto</option></entry>
1455 <entry>Auto-add <literal>_scc_</literal>s to all
1456 exported functions</entry>
1457 <entry>static</entry>
1458 <entry><option>-no-auto</option></entry>
1461 <entry><option>-auto-all</option></entry>
1462 <entry>Auto-add <literal>_scc_</literal>s to all
1463 top-level functions</entry>
1464 <entry>static</entry>
1465 <entry><option>-no-auto-all</option></entry>
1468 <entry><option>-caf-all</option></entry>
1469 <entry>Auto-add <literal>_scc_</literal>s to all CAFs</entry>
1470 <entry>static</entry>
1471 <entry><option>-no-caf-all</option></entry>
1474 <entry><option>-prof</option></entry>
1475 <entry>Turn on profiling</entry>
1476 <entry>static</entry>
1480 <entry><option>-ticky</option></entry>
1481 <entry>Turn on ticky-ticky profiling</entry>
1482 <entry>static</entry>
1491 <title>Program coverage options</title>
1493 <para><xref linkend="hpc"/></para>
1496 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1500 <entry>Description</entry>
1501 <entry>Static/Dynamic</entry>
1502 <entry>Reverse</entry>
1507 <entry><option>-fhpc</option></entry>
1508 <entry>Turn on Haskell program coverage instrumentation</entry>
1509 <entry>static</entry>
1510 <entry><option>-</option></entry>
1513 <entry><option>-hpcdir dir</option></entry>
1514 <entry>Directory to deposit .mix files during compilation (default is .hpc)</entry>
1515 <entry>dynamic</entry>
1516 <entry><option>-</option></entry>
1524 <title>Haskell pre-processor options</title>
1526 <para><xref linkend="pre-processor"/></para>
1529 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1533 <entry>Description</entry>
1534 <entry>Static/Dynamic</entry>
1535 <entry>Reverse</entry>
1540 <entry><option>-F</option></entry>
1542 Enable the use of a pre-processor
1543 (set with <option>-pgmF</option>)
1545 <entry>dynamic</entry>
1554 <title>C pre-processor options</title>
1556 <para><xref linkend="c-pre-processor"/></para>
1559 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1563 <entry>Description</entry>
1564 <entry>Static/Dynamic</entry>
1565 <entry>Reverse</entry>
1570 <entry><option>-cpp</option></entry>
1571 <entry>Run the C pre-processor on Haskell source files</entry>
1572 <entry>dynamic</entry>
1576 <entry><option>-D</option><replaceable>symbol</replaceable><optional>=<replaceable>value</replaceable></optional></entry>
1577 <entry>Define a symbol in the C pre-processor</entry>
1578 <entry>dynamic</entry>
1579 <entry><option>-U</option><replaceable>symbol</replaceable></entry>
1582 <entry><option>-U</option><replaceable>symbol</replaceable></entry>
1583 <entry>Undefine a symbol in the C pre-processor</entry>
1584 <entry>dynamic</entry>
1588 <entry><option>-I</option><replaceable>dir</replaceable></entry>
1589 <entry>Add <replaceable>dir</replaceable> to the
1590 directory search list for <literal>#include</literal> files</entry>
1591 <entry>dynamic</entry>
1600 <title>C compiler options</title>
1602 <para><xref linkend="options-C-compiler"/></para>
1604 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1608 <entry>Description</entry>
1609 <entry>Static/Dynamic</entry>
1610 <entry>Reverse</entry>
1615 <entry><option>-#include</option> <replaceable>file</replaceable></entry>
1616 <entry>Include <replaceable>file</replaceable> when
1617 compiling the <filename>.hc</filename> file</entry>
1618 <entry>dynamic</entry>
1627 <title>Code generation options</title>
1629 <para><xref linkend="options-codegen"/></para>
1632 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1636 <entry>Description</entry>
1637 <entry>Static/Dynamic</entry>
1638 <entry>Reverse</entry>
1643 <entry><option>-fasm</option></entry>
1644 <entry>Use the native code generator</entry>
1645 <entry>dynamic</entry>
1646 <entry>-fvia-C</entry>
1649 <entry><option>-fvia-C</option></entry>
1650 <entry>Compile via C</entry>
1651 <entry>dynamic</entry>
1652 <entry>-fasm</entry>
1655 <entry><option>-fno-code</option></entry>
1656 <entry>Omit code generation</entry>
1657 <entry>dynamic</entry>
1661 <entry><option>-fbyte-code</option></entry>
1662 <entry>Generate byte-code</entry>
1663 <entry>dynamic</entry>
1667 <entry><option>-fobject-code</option></entry>
1668 <entry>Generate object code</entry>
1669 <entry>dynamic</entry>
1678 <title>Linking options</title>
1680 <para><xref linkend="options-linker"/></para>
1683 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1687 <entry>Description</entry>
1688 <entry>Static/Dynamic</entry>
1689 <entry>Reverse</entry>
1694 <entry><option>-fPIC</option></entry>
1695 <entry>Generate position-independent code (where available)</entry>
1696 <entry>static</entry>
1700 <entry><option>-dynamic</option></entry>
1701 <entry>Use dynamic Haskell libraries (if available)</entry>
1702 <entry>static</entry>
1706 <entry><option>-framework</option> <replaceable>name</replaceable></entry>
1707 <entry>On Darwin/MacOS X only, link in the framework <replaceable>name</replaceable>.
1708 This option corresponds to the <option>-framework</option> option for Apple's Linker.</entry>
1709 <entry>dynamic</entry>
1713 <entry><option>-framework-path</option> <replaceable>name</replaceable></entry>
1714 <entry>On Darwin/MacOS X only, add <replaceable>dir</replaceable> to the list of
1715 directories searched for frameworks.
1716 This option corresponds to the <option>-F</option> option for Apple's Linker.</entry>
1717 <entry>dynamic</entry>
1721 <entry><option>-l</option><replaceable>lib</replaceable></entry>
1722 <entry>Link in library <replaceable>lib</replaceable></entry>
1723 <entry>dynamic</entry>
1727 <entry><option>-L</option><replaceable>dir</replaceable></entry>
1728 <entry>Add <replaceable>dir</replaceable> to the list of
1729 directories searched for libraries</entry>
1730 <entry>dynamic</entry>
1734 <entry><option>-main-is</option></entry>
1735 <entry>Set main module and function</entry>
1736 <entry>dynamic</entry>
1740 <entry><option>--mk-dll</option></entry>
1741 <entry>DLL-creation mode (Windows only)</entry>
1742 <entry>dynamic</entry>
1746 <entry><option>-no-hs-main</option></entry>
1747 <entry>Don't assume this program contains <literal>main</literal></entry>
1748 <entry>dynamic</entry>
1752 <entry><option>-no-link</option></entry>
1753 <entry>Omit linking</entry>
1754 <entry>dynamic</entry>
1758 <entry><option>-split-objs</option></entry>
1759 <entry>Split objects (for libraries)</entry>
1760 <entry>dynamic</entry>
1764 <entry><option>-static</option></entry>
1765 <entry>Use static Haskell libraries</entry>
1766 <entry>static</entry>
1770 <entry><option>-threaded</option></entry>
1771 <entry>Use the threaded runtime</entry>
1772 <entry>static</entry>
1776 <entry><option>-debug</option></entry>
1777 <entry>Use the debugging runtime</entry>
1778 <entry>static</entry>
1782 <entry><option>-fno-gen-manifest</option></entry>
1783 <entry>Do not generate a manifest file (Windows only)</entry>
1784 <entry>dynamic</entry>
1788 <entry><option>-fno-embed-manifest</option></entry>
1789 <entry>Do not embed the manifest in the executable (Windows only)</entry>
1790 <entry>dynamic</entry>
1799 <title>Replacing phases</title>
1801 <para><xref linkend="replacing-phases"/></para>
1804 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1808 <entry>Description</entry>
1809 <entry>Static/Dynamic</entry>
1810 <entry>Reverse</entry>
1815 <entry><option>-pgmL</option> <replaceable>cmd</replaceable></entry>
1816 <entry>Use <replaceable>cmd</replaceable> as the literate pre-processor</entry>
1817 <entry>dynamic</entry>
1821 <entry><option>-pgmP</option> <replaceable>cmd</replaceable></entry>
1822 <entry>Use <replaceable>cmd</replaceable> as the C
1823 pre-processor (with <option>-cpp</option> only)</entry>
1824 <entry>dynamic</entry>
1828 <entry><option>-pgmc</option> <replaceable>cmd</replaceable></entry>
1829 <entry>Use <replaceable>cmd</replaceable> as the C compiler</entry>
1830 <entry>dynamic</entry>
1834 <entry><option>-pgmm</option> <replaceable>cmd</replaceable></entry>
1835 <entry>Use <replaceable>cmd</replaceable> as the mangler</entry>
1836 <entry>dynamic</entry>
1840 <entry><option>-pgms</option> <replaceable>cmd</replaceable></entry>
1841 <entry>Use <replaceable>cmd</replaceable> as the splitter</entry>
1842 <entry>dynamic</entry>
1846 <entry><option>-pgma</option> <replaceable>cmd</replaceable></entry>
1847 <entry>Use <replaceable>cmd</replaceable> as the assembler</entry>
1848 <entry>dynamic</entry>
1852 <entry><option>-pgml</option> <replaceable>cmd</replaceable></entry>
1853 <entry>Use <replaceable>cmd</replaceable> as the linker</entry>
1854 <entry>dynamic</entry>
1858 <entry><option>-pgmdll</option> <replaceable>cmd</replaceable></entry>
1859 <entry>Use <replaceable>cmd</replaceable> as the DLL generator</entry>
1860 <entry>dynamic</entry>
1864 <entry><option>-pgmF</option> <replaceable>cmd</replaceable></entry>
1865 <entry>Use <replaceable>cmd</replaceable> as the pre-processor
1866 (with <option>-F</option> only)</entry>
1867 <entry>dynamic</entry>
1871 <entry><option>-pgmwindres</option> <replaceable>cmd</replaceable></entry>
1872 <entry>Use <replaceable>cmd</replaceable> as the program for
1873 embedding manifests on Windows.</entry>
1874 <entry>dynamic</entry>
1880 <indexterm><primary><option>-pgmL</option></primary></indexterm>
1881 <indexterm><primary><option>-pgmP</option></primary></indexterm>
1882 <indexterm><primary><option>-pgmc</option></primary></indexterm>
1883 <indexterm><primary><option>-pgma</option></primary></indexterm>
1884 <indexterm><primary><option>-pgml</option></primary></indexterm>
1885 <indexterm><primary><option>-pgmdll</option></primary></indexterm>
1886 <indexterm><primary><option>-pgmF</option></primary></indexterm>
1891 <title>Forcing options to particular phases</title>
1893 <para><xref linkend="forcing-options-through"/></para>
1896 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1900 <entry>Description</entry>
1901 <entry>Static/Dynamic</entry>
1902 <entry>Reverse</entry>
1907 <entry><option>-optL</option> <replaceable>option</replaceable></entry>
1908 <entry>pass <replaceable>option</replaceable> to the literate pre-processor</entry>
1909 <entry>dynamic</entry>
1913 <entry><option>-optP</option> <replaceable>option</replaceable></entry>
1914 <entry>pass <replaceable>option</replaceable> to cpp (with
1915 <option>-cpp</option> only)</entry>
1916 <entry>dynamic</entry>
1920 <entry><option>-optF</option> <replaceable>option</replaceable></entry>
1921 <entry>pass <replaceable>option</replaceable> to the
1922 custom pre-processor</entry>
1923 <entry>dynamic</entry>
1927 <entry><option>-optc</option> <replaceable>option</replaceable></entry>
1928 <entry>pass <replaceable>option</replaceable> to the C compiler</entry>
1929 <entry>dynamic</entry>
1933 <entry><option>-optm</option> <replaceable>option</replaceable></entry>
1934 <entry>pass <replaceable>option</replaceable> to the mangler</entry>
1935 <entry>dynamic</entry>
1939 <entry><option>-opta</option> <replaceable>option</replaceable></entry>
1940 <entry>pass <replaceable>option</replaceable> to the assembler</entry>
1941 <entry>dynamic</entry>
1945 <entry><option>-optl</option> <replaceable>option</replaceable></entry>
1946 <entry>pass <replaceable>option</replaceable> to the linker</entry>
1947 <entry>dynamic</entry>
1951 <entry><option>-optdll</option> <replaceable>option</replaceable></entry>
1952 <entry>pass <replaceable>option</replaceable> to the DLL generator</entry>
1953 <entry>dynamic</entry>
1957 <entry><option>-optdep</option> <replaceable>option</replaceable></entry>
1958 <entry>pass <replaceable>option</replaceable> to the dependency generator</entry>
1959 <entry>dynamic</entry>
1963 <entry><option>-optwindres</option> <replaceable>option</replaceable></entry>
1964 <entry>pass <replaceable>option</replaceable> to <literal>windres</literal>.</entry>
1965 <entry>dynamic</entry>
1974 <title>Platform-specific options</title>
1976 <para><xref linkend="options-platform"/></para>
1979 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1983 <entry>Description</entry>
1984 <entry>Static/Dynamic</entry>
1985 <entry>Reverse</entry>
1990 <entry><option>-monly-[432]-regs</option></entry>
1991 <entry>(x86 only) give some registers back to the C compiler</entry>
1992 <entry>dynamic</entry>
2002 <title>External core file options</title>
2004 <para><xref linkend="ext-core"/></para>
2007 <tgroup cols="4" align="left" colsep="1" rowsep="1">
2011 <entry>Description</entry>
2012 <entry>Static/Dynamic</entry>
2013 <entry>Reverse</entry>
2018 <entry><option>-fext-core</option></entry>
2019 <entry>Generate <filename>.hcr</filename> external Core files</entry>
2020 <entry>static</entry>
2030 <title>Compiler debugging options</title>
2032 <para><xref linkend="options-debugging"/></para>
2035 <tgroup cols="4" align="left" colsep="1" rowsep="1">
2039 <entry>Description</entry>
2040 <entry>Static/Dynamic</entry>
2041 <entry>Reverse</entry>
2046 <entry><option>-dcore-lint</option></entry>
2047 <entry>Turn on internal sanity checking</entry>
2048 <entry>dynamic</entry>
2052 <entry><option>-ddump-asm</option></entry>
2053 <entry>Dump assembly</entry>
2054 <entry>dynamic</entry>
2058 <entry><option>-ddump-bcos</option></entry>
2059 <entry>Dump interpreter byte code</entry>
2060 <entry>dynamic</entry>
2064 <entry><option>-ddump-cmm</option></entry>
2065 <entry>Dump C-- output</entry>
2066 <entry>dynamic</entry>
2070 <entry><option>-ddump-cpranal</option></entry>
2071 <entry>Dump output from CPR analysis</entry>
2072 <entry>dynamic</entry>
2076 <entry><option>-ddump-cse</option></entry>
2077 <entry>Dump CSE output</entry>
2078 <entry>dynamic</entry>
2082 <entry><option>-ddump-deriv</option></entry>
2083 <entry>Dump deriving output</entry>
2084 <entry>dynamic</entry>
2088 <entry><option>-ddump-ds</option></entry>
2089 <entry>Dump desugarer output</entry>
2090 <entry>dynamic</entry>
2094 <entry><option>-ddump-flatC</option></entry>
2095 <entry>Dump “flat” C</entry>
2096 <entry>dynamic</entry>
2100 <entry><option>-ddump-foreign</option></entry>
2101 <entry>Dump <literal>foreign export</literal> stubs</entry>
2102 <entry>dynamic</entry>
2106 <entry><option>-ddump-hpc</option></entry>
2107 <entry>Dump after instrumentation for program coverage</entry>
2108 <entry>dynamic</entry>
2112 <entry><option>-ddump-inlinings</option></entry>
2113 <entry>Dump inlining info</entry>
2114 <entry>dynamic</entry>
2118 <entry><option>-ddump-occur-anal</option></entry>
2119 <entry>Dump occurrence analysis output</entry>
2120 <entry>dynamic</entry>
2124 <entry><option>-ddump-opt-cmm</option></entry>
2125 <entry>Dump the results of C-- to C-- optimising passes</entry>
2126 <entry>dynamic</entry>
2130 <entry><option>-ddump-parsed</option></entry>
2131 <entry>Dump parse tree</entry>
2132 <entry>dynamic</entry>
2136 <entry><option>-ddump-prep</option></entry>
2137 <entry>Dump prepared core</entry>
2138 <entry>dynamic</entry>
2142 <entry><option>-ddump-rn</option></entry>
2143 <entry>Dump renamer output</entry>
2144 <entry>dynamic</entry>
2148 <entry><option>-ddump-rules</option></entry>
2149 <entry>Dump rules</entry>
2150 <entry>dynamic</entry>
2154 <entry><option>-ddump-simpl</option></entry>
2155 <entry>Dump final simplifier output</entry>
2156 <entry>dynamic</entry>
2160 <entry><option>-ddump-simpl-phases</option></entry>
2161 <entry>Dump output from each simplifier phase</entry>
2162 <entry>dynamic</entry>
2166 <entry><option>-ddump-simpl-iterations</option></entry>
2167 <entry>Dump output from each simplifier iteration</entry>
2168 <entry>dynamic</entry>
2172 <entry><option>-ddump-spec</option></entry>
2173 <entry>Dump specialiser output</entry>
2174 <entry>dynamic</entry>
2178 <entry><option>-ddump-splices</option></entry>
2179 <entry>Dump TH spliced expressions, and what they evaluate to</entry>
2180 <entry>dynamic</entry>
2184 <entry><option>-ddump-stg</option></entry>
2185 <entry>Dump final STG</entry>
2186 <entry>dynamic</entry>
2190 <entry><option>-ddump-stranal</option></entry>
2191 <entry>Dump strictness analyser output</entry>
2192 <entry>dynamic</entry>
2196 <entry><option>-ddump-tc</option></entry>
2197 <entry>Dump typechecker output</entry>
2198 <entry>dynamic</entry>
2202 <entry><option>-ddump-types</option></entry>
2203 <entry>Dump type signatures</entry>
2204 <entry>dynamic</entry>
2208 <entry><option>-ddump-worker-wrapper</option></entry>
2209 <entry>Dump worker-wrapper output</entry>
2210 <entry>dynamic</entry>
2214 <entry><option>-ddump-if-trace</option></entry>
2215 <entry>Trace interface files</entry>
2216 <entry>dynamic</entry>
2220 <entry><option>-ddump-tc-trace</option></entry>
2221 <entry>Trace typechecker</entry>
2222 <entry>dynamic</entry>
2226 <entry><option>-ddump-rn-trace</option></entry>
2227 <entry>Trace renamer</entry>
2228 <entry>dynamic</entry>
2232 <entry><option>-ddump-rn-stats</option></entry>
2233 <entry>Renamer stats</entry>
2234 <entry>dynamic</entry>
2238 <entry><option>-ddump-simpl-stats</option></entry>
2239 <entry>Dump simplifier stats</entry>
2240 <entry>dynamic</entry>
2244 <entry><option>-dno-debug-output</option></entry>
2245 <entry>Suppress unsolicited debugging output</entry>
2246 <entry>static</entry>
2250 <entry><option>-dppr-debug</option></entry>
2251 <entry>Turn on debug printing (more verbose)</entry>
2252 <entry>static</entry>
2256 <entry><option>-dsuppress-uniques</option></entry>
2257 <entry>Suppress the printing of uniques in debug output (easier to use <command>diff</command>.</entry>
2258 <entry>static</entry>
2262 <entry><option>-dppr-noprags</option></entry>
2263 <entry>Don't output pragma info in dumps</entry>
2264 <entry>static</entry>
2268 <entry><option>-dppr-user-length</option></entry>
2269 <entry>Set the depth for printing expressions in error msgs</entry>
2270 <entry>static</entry>
2274 <entry><option>-dsource-stats</option></entry>
2275 <entry>Dump haskell source stats</entry>
2276 <entry>dynamic</entry>
2280 <entry><option>-dcmm-lint</option></entry>
2281 <entry>C-- pass sanity checking</entry>
2282 <entry>dynamic</entry>
2286 <entry><option>-dstg-lint</option></entry>
2287 <entry>STG pass sanity checking</entry>
2288 <entry>dynamic</entry>
2292 <entry><option>-dstg-stats</option></entry>
2293 <entry>Dump STG stats</entry>
2294 <entry>dynamic</entry>
2298 <entry><option>-dverbose-core2core</option></entry>
2299 <entry>Show output from each core-to-core pass</entry>
2300 <entry>dynamic</entry>
2304 <entry><option>-dverbose-stg2stg</option></entry>
2305 <entry>Show output from each STG-to-STG pass</entry>
2306 <entry>dynamic</entry>
2310 <entry><option>-dshow-passes</option></entry>
2311 <entry>Print out each pass name as it happens</entry>
2312 <entry>dynamic</entry>
2316 <entry><option>-dfaststring-stats</option></entry>
2317 <entry>Show statistics for fast string usage when finished</entry>
2318 <entry>dynamic</entry>
2327 <title>Misc compiler options</title>
2330 <tgroup cols="4" align="left" colsep="1" rowsep="1">
2334 <entry>Description</entry>
2335 <entry>Static/Dynamic</entry>
2336 <entry>Reverse</entry>
2341 <entry><option>-fno-hi-version-check</option></entry>
2342 <entry>Don't complain about <literal>.hi</literal> file mismatches</entry>
2343 <entry>static</entry>
2347 <entry><option>-dno-black-holing</option></entry>
2348 <entry>Turn off black holing (probably doesn't work)</entry>
2349 <entry>static</entry>
2353 <entry><option>-fhistory-size</option></entry>
2354 <entry>Set simplification history size</entry>
2355 <entry>static</entry>
2359 <entry><option>-funregisterised</option></entry>
2360 <entry>Unregisterised compilation (use <option>-unreg</option> instead)</entry>
2361 <entry>static</entry>
2365 <entry><option>-fno-asm-mangling</option></entry>
2366 <entry>Turn off assembly mangling (use <option>-unreg</option> instead)</entry>
2367 <entry>dynamic</entry>
2381 , ( "H" , HasArg (setHeapSize . fromIntegral . decodeSize) )
2387 ;;; Local Variables: ***
2389 ;;; sgml-parent-document: ("users_guide.xml" "book" "chapter") ***