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>-v</option></entry>
40 <entry>verbose mode (equivalent to <option>-v3</option>)</entry>
41 <entry>dynamic</entry>
45 <entry><option>-v</option><replaceable>n</replaceable></entry>
46 <entry>set verbosity level</entry>
47 <entry>dynamic</entry>
51 <entry><option>-V</option></entry>
52 <entry>display GHC version</entry>
57 <entry><option>––version</option></entry>
58 <entry>display GHC version</entry>
63 <entry><option>––numeric-version</option></entry>
64 <entry>display GHC version (numeric only)</entry>
69 <entry><option>––print-libdir</option></entry>
70 <entry>display GHC library directory</entry>
75 <entry><option>-ferror-spans</option></entry>
76 <entry>output full span in error messages</entry>
81 <entry><option>-Rghc-timing</option></entry>
82 <entry>Summarise timing stats for GHC (same as <literal>+RTS -tstderr</literal>)</entry>
92 <title>Which phases to run</title>
94 <para><xref linkend="options-order"/></para>
97 <tgroup cols="4" align="left" colsep="1" rowsep="1">
101 <entry>Description</entry>
102 <entry>Static/Dynamic</entry>
103 <entry>Reverse</entry>
108 <entry><option>-E</option></entry>
109 <entry>Stop after preprocessing (<literal>.hspp</literal> file)</entry>
114 <entry><option>-C</option></entry>
115 <entry>Stop after generating C (<literal>.hc</literal> file)</entry>
120 <entry><option>-S</option></entry>
121 <entry>Stop after generating assembly (<literal>.s</literal> file)</entry>
126 <entry><option>-c</option></entry>
127 <entry>Do not link</entry>
128 <entry>dynamic</entry>
132 <entry><option>-x</option> <replaceable>suffix</replaceable></entry>
133 <entry>Override default behaviour for source files</entry>
134 <entry>static</entry>
143 <title>Alternative modes of operation</title>
145 <para><xref linkend="modes"/></para>
148 <tgroup cols="4" align="left" colsep="1" rowsep="1">
152 <entry>Description</entry>
153 <entry>Static/Dynamic</entry>
154 <entry>Reverse</entry>
159 <entry><option>--interactive</option></entry>
160 <entry>Interactive mode - normally used by just running <command>ghci</command></entry>
165 <entry><option>--make</option></entry>
166 <entry>Build a multi-module Haskell program, automatically figuring out dependencies. Likely to be much easier, and faster, than using <command>make</command>.</entry>
171 <entry><option>-e <replaceable>expr</replaceable></option></entry>
172 <entry>Evaluate <replaceable>expr</replaceable></entry>
177 <entry><option>-M</option></entry>
178 <entry>Generate dependency information suitable for use in a <filename>Makefile</filename>.</entry>
188 <title>Redirecting output</title>
190 <para><xref linkend="options-output"/></para>
193 <tgroup cols="4" align="left" colsep="1" rowsep="1">
197 <entry>Description</entry>
198 <entry>Static/Dynamic</entry>
199 <entry>Reverse</entry>
204 <entry><option>-hcsuf</option> <replaceable>suffix</replaceable></entry>
205 <entry>set the suffix to use for intermediate C files</entry>
206 <entry>dynamic</entry>
210 <entry><option>-hidir</option> <replaceable>dir</replaceable></entry>
211 <entry>set directory for interface files</entry>
212 <entry>dynamic</entry>
216 <entry><option>-hisuf</option> <replaceable>suffix</replaceable></entry>
217 <entry>set the suffix to use for interface files</entry>
218 <entry>dynamic</entry>
222 <entry><option>-o</option> <replaceable>filename</replaceable></entry>
223 <entry>set output filename</entry>
224 <entry>dynamic</entry>
228 <entry><option>-odir</option> <replaceable>dir</replaceable></entry>
229 <entry>set output directory</entry>
230 <entry>dynamic</entry>
234 <entry><option>-ohi</option> <replaceable>filename</replaceable></entry>
235 <entry>set the filename in which to put the interface</entry>
236 <entry>dynamic</entry>
240 <entry><option>-osuf</option> <replaceable>suffix</replaceable></entry>
241 <entry>set the output file suffix</entry>
242 <entry>dynamic</entry>
246 <entry><option>-stubdir</option> <replaceable>dir</replaceable></entry>
247 <entry>redirect FFi stub files</entry>
248 <entry>dynamic</entry>
257 <title>Keeping intermediate files</title>
259 <para><xref linkend="keeping-intermediates"/></para>
262 <tgroup cols="4" align="left" colsep="1" rowsep="1">
266 <entry>Description</entry>
267 <entry>Static/Dynamic</entry>
268 <entry>Reverse</entry>
273 <entry><option>-keep-hc-file</option></entry>
274 <entry>retain intermediate <literal>.hc</literal> files</entry>
275 <entry>dynamic</entry>
279 <entry><option>-keep-s-file</option></entry>
280 <entry>retain intermediate <literal>.s</literal> files</entry>
281 <entry>dynamic</entry>
285 <entry><option>-keep-raw-s-file</option></entry>
286 <entry>retain intermediate <literal>.raw_s</literal> files</entry>
287 <entry>dynamic</entry>
291 <entry><option>-keep-tmp-files</option></entry>
292 <entry>retain all intermediate temporary files</entry>
293 <entry>dynamic</entry>
302 <title>Temporary files</title>
304 <para><xref linkend="temp-files"/></para>
307 <tgroup cols="4" align="left" colsep="1" rowsep="1">
311 <entry>Description</entry>
312 <entry>Static/Dynamic</entry>
313 <entry>Reverse</entry>
318 <entry><option>-tmpdir</option></entry>
319 <entry>set the directory for temporary files</entry>
320 <entry>dynamic</entry>
329 <title>Finding imports</title>
331 <para><xref linkend="search-path"/></para>
334 <tgroup cols="4" align="left" colsep="1" rowsep="1">
339 <entry>Description</entry>
340 <entry>Static/Dynamic</entry>
341 <entry>Reverse</entry>
346 <entry><option>-i</option><replaceable>dir1</replaceable>:<replaceable>dir2</replaceable>:...</entry>
347 <entry>add <replaceable>dir</replaceable>,
348 <replaceable>dir2</replaceable>, etc. to import path</entry>
349 <entry>dynamic</entry>
353 <entry><option>-i</option></entry>
354 <entry>Empty the import directory list</entry>
355 <entry>dynamic</entry>
364 <title>Interface file options</title>
366 <para><xref linkend="hi-options"/></para>
369 <tgroup cols="4" align="left" colsep="1" rowsep="1">
374 <entry>Description</entry>
375 <entry>Static/Dynamic</entry>
376 <entry>Reverse</entry>
381 <entry><option>-ddump-hi</option></entry>
382 <entry>Dump the new interface to stdout</entry>
383 <entry>dynamic</entry>
387 <entry><option>-ddump-hi-diffs</option></entry>
388 <entry>Show the differences vs. the old interface</entry>
389 <entry>dynamic</entry>
393 <entry><option>-ddump-minimal-imports</option></entry>
394 <entry>Dump a minimal set of imports</entry>
395 <entry>dynamic</entry>
399 <entry><option>--show-iface</option> <replaceable>file</replaceable></entry>
400 <entry>Read the interface in
401 <replaceable>file</replaceable> and dump it as text to
402 <literal>stdout</literal>.</entry>
412 <title>Recompilation checking</title>
414 <para><xref linkend="recomp"/></para>
417 <tgroup cols="4" align="left" colsep="1" rowsep="1">
422 <entry>Description</entry>
423 <entry>Static/Dynamic</entry>
424 <entry>Reverse</entry>
429 <entry><option>-fforce-recomp</option></entry>
430 <entry>Turn off recompilation checking; implied by any
431 <option>-ddump-X</option> option</entry>
432 <entry>dynamic</entry>
433 <entry><option>-fno-force-recomp</option></entry>
441 <title>Interactive-mode options</title>
443 <para><xref linkend="ghci-dot-files"/></para>
446 <tgroup cols="4" align="left" colsep="1" rowsep="1">
450 <entry>Description</entry>
451 <entry>Static/Dynamic</entry>
452 <entry>Reverse</entry>
457 <entry><option>-ignore-dot-ghci</option></entry>
458 <entry>Disable reading of <filename>.ghci</filename> files</entry>
459 <entry>static</entry>
463 <entry><option>-read-dot-ghci</option></entry>
464 <entry>Enable reading of <filename>.ghci</filename> files</entry>
465 <entry>static</entry>
474 <title>Packages</title>
476 <para><xref linkend="packages"/></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>-package</option> <replaceable>P</replaceable></entry>
491 <entry>Expose package <replaceable>P</replaceable></entry>
492 <entry>dynamic</entry>
496 <entry><option>-hide-all-packages</option></entry>
497 <entry>Hide all packages by default</entry>
498 <entry>static</entry>
502 <entry><option>-hide-package</option> <replaceable>name</replaceable></entry>
503 <entry>Hide package <replaceable>P</replaceable></entry>
504 <entry>dynamic</entry>
508 <entry><option>-ignore-package</option> <replaceable>name</replaceable></entry>
509 <entry>Ignore package <replaceable>P</replaceable></entry>
510 <entry>dynamic</entry>
514 <entry><option>-package-conf</option> <replaceable>file</replaceable></entry>
515 <entry>Load more packages from <replaceable>file</replaceable></entry>
516 <entry>dynamic</entry>
520 <entry><option>-no-user-package-conf</option></entry>
521 <entry>Don't load the user's package config file.</entry>
522 <entry>dynamic</entry>
531 <title>Language options</title>
533 <para><xref linkend="options-language"/></para>
536 <tgroup cols="4" align="left" colsep="1" rowsep="1">
540 <entry>Description</entry>
541 <entry>Static/Dynamic</entry>
542 <entry>Reverse</entry>
547 <entry><option>-fallow-overlapping-instances</option></entry>
548 <entry>Enable <link linkend="instance-overlap">overlapping instances</link></entry>
549 <entry>dynamic</entry>
550 <entry><option>-fno-allow-overlapping-instances</option></entry>
553 <entry><option>-fallow-incoherent-instances</option></entry>
554 <entry>Enable <link linkend="instance-overlap">incoherent instances</link>.
555 Implies <option>-fallow-overlapping-instances</option> </entry>
556 <entry>dynamic</entry>
557 <entry><option>-fno-allow-incoherent-instances</option></entry>
560 <entry><option>-fallow-undecidable-instances</option></entry>
561 <entry>Enable <link linkend="undecidable-instances">undecidable instances</link></entry>
562 <entry>dynamic</entry>
563 <entry><option>-fno-allow-undecidable-instances</option></entry>
566 <entry><option>-fcontext-stack=N</option><replaceable>n</replaceable></entry>
567 <entry>set the <link linkend="undecidable-instances">limit for context reduction</link></entry>
568 <entry>dynamic</entry>
569 <entry><option>20</option></entry>
572 <entry><option>-farrows</option></entry>
573 <entry>Enable <link linkend="arrow-notation">arrow
574 notation</link> extension</entry>
575 <entry>dynamic</entry>
576 <entry><option>-fno-arrows</option></entry>
579 <entry><option>-ffi</option> or <option>-fffi</option></entry>
580 <entry>Enable <link linkend="ffi">foreign function interface</link> (implied by
581 <option>-fglasgow-exts</option>)</entry>
582 <entry>dynamic</entry>
583 <entry><option>-fno-ffi</option></entry>
586 <entry><option>-fgenerics</option></entry>
587 <entry>Enable <link linkend="generic-classes">generic classes</link></entry>
588 <entry>dynamic</entry>
589 <entry><option>-fno-fgenerics</option></entry>
592 <entry><option>-fglasgow-exts</option></entry>
593 <entry>Enable most language extensions</entry>
594 <entry>dynamic</entry>
595 <entry><option>-fno-glasgow-exts</option></entry>
598 <entry><option>-fimplicit-params</option></entry>
599 <entry>Enable <link linkend="implicit-parameters">Implicit Parameters</link>.
600 Implied by <option>-fglasgow-exts</option>.</entry>
601 <entry>dynamic</entry>
602 <entry><option>-fno-implicit-params</option></entry>
605 <entry><option>-firrefutable-tuples</option></entry>
606 <entry>Make tuple pattern matching irrefutable</entry>
607 <entry>dynamic</entry>
608 <entry><option>-fno-irrefutable-tuples</option></entry>
611 <entry><option>-fno-implicit-prelude</option></entry>
612 <entry>Don't implicitly <literal>import Prelude</literal></entry>
613 <entry>dynamic</entry>
614 <entry><option>-fimplicit-prelude</option></entry>
617 <entry><option>-fno-monomorphism-restriction</option></entry>
618 <entry>Disable the <link linkend="monomorphism">monomorphism restriction</link></entry>
619 <entry>dynamic</entry>
620 <entry><option>-fmonomorphism-restriction</option></entry>
623 <entry><option>-fno-mono-pat-binds</option></entry>
624 <entry>Make <link linkend="monomorphism">pattern bindings polymorphic</link></entry>
625 <entry>dynamic</entry>
626 <entry><option>-fmono-pat-binds</option></entry>
629 <entry><option>-fextended-default-rules</option></entry>
630 <entry>Use GHCi's <link linkend="extended-default-rules">extended default rules</link> in a normal module</entry>
631 <entry>dynamic</entry>
632 <entry><option>-fno-extended-default-rules</option></entry>
635 <entry><option>-fscoped-type-variables</option></entry>
636 <entry>Enable <link linkend="scoped-type-variables">lexically-scoped type variables</link>.
637 Implied by <option>-fglasgow-exts</option>.</entry>
638 <entry>dynamic</entry>
639 <entry><option>-fno-scoped-type-variables</option></entry>
642 <entry><option>-fth</option></entry>
643 <entry>Enable <link linkend="template-haskell">Template Haskell</link>.
644 No longer implied by <option>-fglasgow-exts</option>.</entry>
645 <entry>dynamic</entry>
646 <entry><option>-fno-th</option></entry>
649 <entry><option>-fbang-patterns</option></entry>
650 <entry>Enable <link linkend="sec-bang-patterns">bang patterns</link>.</entry>
651 <entry>dynamic</entry>
652 <entry><option>-fno-bang-patterns</option></entry>
660 <title>Warnings</title>
662 <para><xref linkend="options-sanity"/></para>
665 <tgroup cols="4" align="left" colsep="1" rowsep="1">
669 <entry>Description</entry>
670 <entry>Static/Dynamic</entry>
671 <entry>Reverse</entry>
676 <entry><option>-W</option></entry>
677 <entry>enable normal warnings</entry>
678 <entry>dynamic</entry>
679 <entry><option>-w</option></entry>
682 <entry><option>-w</option></entry>
683 <entry>disable all warnings</entry>
684 <entry>dynamic</entry>
688 <entry><option>-Wall</option></entry>
689 <entry>enable all warnings</entry>
690 <entry>dynamic</entry>
691 <entry><option>-w</option></entry>
694 <entry><option>-Werror</option></entry>
695 <entry>make warnings fatal</entry>
696 <entry>dynamic</entry>
701 <entry><option>-fwarn-deprecations</option></entry>
702 <entry>warn about uses of functions & types that are deprecated</entry>
703 <entry>dynamic</entry>
704 <entry><option>-fno-warn-deprecations</option></entry>
708 <entry><option>-fwarn-duplicate-exports</option></entry>
709 <entry>warn when an entity is exported multiple times</entry>
710 <entry>dynamic</entry>
711 <entry><option>-fno-warn-duplicate-exports</option></entry>
715 <entry><option>-fwarn-hi-shadowing</option></entry>
716 <entry>warn when a <literal>.hi</literal> file in the
717 current directory shadows a library</entry>
718 <entry>dynamic</entry>
719 <entry><option>-fno-warn-hi-shadowing</option></entry>
723 <entry><option>-fwarn-incomplete-patterns</option></entry>
724 <entry>warn when a pattern match could fail</entry>
725 <entry>dynamic</entry>
726 <entry><option>-fno-warn-incomplete-patterns</option></entry>
730 <entry><option>-fwarn-incomplete-record-updates</option></entry>
731 <entry>warn when a record update could fail</entry>
732 <entry>dynamic</entry>
733 <entry><option>-fno-warn-incomplete-record-updates</option></entry>
737 <entry><option>-fwarn-misc</option></entry>
738 <entry>enable miscellaneous warnings</entry>
739 <entry>dynamic</entry>
740 <entry><option>-fno-warn-misc</option></entry>
744 <entry><option>-fwarn-missing-fields</option></entry>
745 <entry>warn when fields of a record are uninitialised</entry>
746 <entry>dynamic</entry>
747 <entry><option>-fno-warn-missing-fields</option></entry>
751 <entry><option>-fwarn-missing-methods</option></entry>
752 <entry>warn when class methods are undefined</entry>
753 <entry>dynamic</entry>
754 <entry><option>-fno-warn-missing-methods</option></entry>
758 <entry><option>-fwarn-missing-signatures</option></entry>
759 <entry>warn about top-level functions without signatures</entry>
760 <entry>dynamic</entry>
761 <entry><option>-fno-warn-missing-signatures</option></entry>
765 <entry><option>-fwarn-name-shadowing</option></entry>
766 <entry>warn when names are shadowed</entry>
767 <entry>dynamic</entry>
768 <entry><option>-fno-warn-name-shadowing</option></entry>
772 <entry><option>-fwarn-oprhans</option></entry>
773 <entry>warn when the module contains "orphan" instance declarations
774 or rewrite rules</entry>
775 <entry>dynamic</entry>
776 <entry><option>-fno-warn-orphans</option></entry>
780 <entry><option>-fwarn-overlapping-patterns</option></entry>
781 <entry>warn about overlapping patterns</entry>
782 <entry>dynamic</entry>
783 <entry><option>-fno-warn-overlapping-patterns</option></entry>
787 <entry><option>-fwarn-simple-patterns</option></entry>
788 <entry>warn about lambda-patterns that can fail</entry>
789 <entry>dynamic</entry>
790 <entry><option>-fno-warn-simple-patterns</option></entry>
794 <entry><option>-fwarn-type-defaults</option></entry>
795 <entry>warn when defaulting happens</entry>
796 <entry>dynamic</entry>
797 <entry><option>-fno-warn-type-defaults</option></entry>
801 <entry><option>-fwarn-unused-binds</option></entry>
802 <entry>warn about bindings that are unused</entry>
803 <entry>dynamic</entry>
804 <entry><option>-fno-warn-unused-binds</option></entry>
808 <entry><option>-fwarn-unused-imports</option></entry>
809 <entry>warn about unnecessary imports</entry>
810 <entry>dynamic</entry>
811 <entry><option>-fno-warn-unused-imports</option></entry>
815 <entry><option>-fwarn-unused-matches</option></entry>
816 <entry>warn about variables in patterns that aren't used</entry>
817 <entry>dynamic</entry>
818 <entry><option>-fno-warn-unused-matches</option></entry>
827 <title>Optimisation levels</title>
829 <para><xref linkend="options-optimise"/></para>
832 <tgroup cols="4" align="left" colsep="1" rowsep="1">
836 <entry>Description</entry>
837 <entry>Static/Dynamic</entry>
838 <entry>Reverse</entry>
843 <entry><option>-O</option></entry>
844 <entry>Enable default optimisation (level 1)</entry>
845 <entry>dynamic</entry>
846 <entry><option>-O0</option></entry>
849 <entry><option>-O</option><replaceable>n</replaceable></entry>
850 <entry>Set optimisation level <replaceable>n</replaceable></entry>
851 <entry>dynamic</entry>
852 <entry><option>-O0</option></entry>
860 <title>Individual optimisations</title>
862 <para><xref linkend="options-f"/></para>
865 <tgroup cols="4" align="left" colsep="1" rowsep="1">
869 <entry>Description</entry>
870 <entry>Static/Dynamic</entry>
871 <entry>Reverse</entry>
876 <entry><option>-fcase-merge</option></entry>
877 <entry>Enable case-merging</entry>
878 <entry>dynamic</entry>
879 <entry><option>-fno-case-merge</option></entry>
883 <entry><option>-fdicts-strict</option></entry>
884 <entry>Make dictionaries strict</entry>
885 <entry>static</entry>
886 <entry><option>-fno-dicts-strict</option></entry>
890 <entry><option>-fdo-eta-reduction</option></entry>
891 <entry>Enable eta-reduction</entry>
892 <entry>dynamic</entry>
893 <entry><option>-fno-do-eta-reduction</option></entry>
897 <entry><option>-fdo-lambda-eta-expansion</option></entry>
898 <entry>Enable lambda eta-reduction</entry>
899 <entry>dynamic</entry>
900 <entry><option>-fno-do-lambda-eta-expansion</option></entry>
904 <entry><option>-fexcess-precision</option></entry>
905 <entry>Enable excess intermediate precision</entry>
906 <entry>dynamic</entry>
907 <entry><option>-fno-excess-precision</option></entry>
911 <entry><option>-frules-off</option></entry>
912 <entry>Switch off all rewrite rules (including rules
913 generated by automatic specialisation of overloaded functions)</entry>
914 <entry>static</entry>
915 <entry><option>-frules-off</option></entry>
919 <entry><option>-fignore-asserts</option></entry>
920 <entry>Ignore assertions in the source</entry>
921 <entry>dynamic</entry>
922 <entry><option>-fno-ignore-asserts</option></entry>
926 <entry><option>-fignore-interface-pragmas</option></entry>
927 <entry>Ignore pragmas in interface files</entry>
928 <entry>dynamic</entry>
929 <entry><option>-fno-ignore-interface-pragmas</option></entry>
933 <entry><option>-fliberate-case-threshold</option></entry>
934 <entry>Tweak the liberate-case optimisation (default: 10)</entry>
935 <entry>static</entry>
936 <entry><option>-fno-liberate-case-threshold</option></entry>
940 <entry><option>-fomit-interface-pragmas</option></entry>
941 <entry>Don't generate interface pragmas</entry>
942 <entry>dynamic</entry>
943 <entry><option>-fno-omit-interface-pragmas</option></entry>
947 <entry><option>-fmax-worker-args</option></entry>
948 <entry>If a worker has that many arguments, none will be
949 unpacked anymore (default: 10)</entry>
950 <entry>static</entry>
955 <entry><option>-fmax-simplifier-iterations</option></entry>
956 <entry>Set the max iterations for the simplifier</entry>
957 <entry>dynamic</entry>
962 <entry><option>-fno-state-hack</option></entry>
963 <entry>Turn off the "state hack" whereby any lambda with a real-world state token
964 as argument is considered to be single-entry. Hence OK to inline things inside it.</entry>
965 <entry>static</entry>
970 <entry><option>-fno-cse</option></entry>
971 <entry>Turn off common sub-expression</entry>
972 <entry>dynamic</entry>
977 <entry><option>-fno-full-laziness</option></entry>
978 <entry>Turn off full laziness (floating bindings outwards).</entry>
979 <entry>dynamic</entry>
980 <entry>-ffull-laziness</entry>
984 <entry><option>-fno-pre-inlining</option></entry>
985 <entry>Turn off pre-inlining</entry>
986 <entry>static</entry>
991 <entry><option>-fno-strictness</option></entry>
992 <entry>Turn off strictness analysis</entry>
993 <entry>dynamic</entry>
998 <entry><option>-funbox-strict-fields</option></entry>
999 <entry>Flatten strict constructor fields</entry>
1000 <entry>dynamic</entry>
1001 <entry><option>-fno-unbox-strict-fields</option></entry>
1005 <entry><option>-funfolding-creation-threshold</option></entry>
1006 <entry>Tweak unfolding settings</entry>
1007 <entry>static</entry>
1008 <entry><option>-fno-unfolding-creation-threshold</option></entry>
1012 <entry><option>-funfolding-fun-discount</option></entry>
1013 <entry>Tweak unfolding settings</entry>
1014 <entry>static</entry>
1015 <entry><option>-fno-unfolding-fun-discount</option></entry>
1019 <entry><option>-funfolding-keeness-factor</option></entry>
1020 <entry>Tweak unfolding settings</entry>
1021 <entry>static</entry>
1022 <entry><option>-fno-unfolding-keeness-factor</option></entry>
1026 <entry><option>-funfolding-update-in-place</option></entry>
1027 <entry>Tweak unfolding settings</entry>
1028 <entry>static</entry>
1029 <entry><option>-fno-unfolding-update-in-place</option></entry>
1033 <entry><option>-funfolding-use-threshold</option></entry>
1034 <entry>Tweak unfolding settings</entry>
1035 <entry>static</entry>
1036 <entry><option>-fno-unfolding-use-threshold</option></entry>
1044 <title>Profiling options</title>
1046 <para><xref linkend="profiling"/></para>
1049 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1053 <entry>Description</entry>
1054 <entry>Static/Dynamic</entry>
1055 <entry>Reverse</entry>
1060 <entry><option>-auto</option></entry>
1061 <entry>Auto-add <literal>_scc_</literal>s to all
1062 exported functions</entry>
1063 <entry>static</entry>
1064 <entry><option>-no-auto</option></entry>
1067 <entry><option>-auto-all</option></entry>
1068 <entry>Auto-add <literal>_scc_</literal>s to all
1069 top-level functions</entry>
1070 <entry>static</entry>
1071 <entry><option>-no-auto-all</option></entry>
1074 <entry><option>-auto-dicts</option></entry>
1075 <entry>Auto-add <literal>_scc_</literal>s to all dictionaries</entry>
1076 <entry>static</entry>
1077 <entry><option>-no-auto-dicts</option></entry>
1080 <entry><option>-caf-all</option></entry>
1081 <entry>Auto-add <literal>_scc_</literal>s to all CAFs</entry>
1082 <entry>static</entry>
1083 <entry><option>-no-caf-all</option></entry>
1086 <entry><option>-prof</option></entry>
1087 <entry>Turn on profiling</entry>
1088 <entry>static</entry>
1092 <entry><option>-ticky</option></entry>
1093 <entry>Turn on ticky-ticky profiling</entry>
1094 <entry>static</entry>
1103 <title>Haskell pre-processor options</title>
1105 <para><xref linkend="pre-processor"/></para>
1108 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1112 <entry>Description</entry>
1113 <entry>Static/Dynamic</entry>
1114 <entry>Reverse</entry>
1119 <entry><option>-F</option></entry>
1121 Enable the use of a pre-processor
1122 (set with <option>-pgmF</option>)
1124 <entry>dynamic</entry>
1133 <title>C pre-processor options</title>
1135 <para><xref linkend="c-pre-processor"/></para>
1138 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1142 <entry>Description</entry>
1143 <entry>Static/Dynamic</entry>
1144 <entry>Reverse</entry>
1149 <entry><option>-cpp</option></entry>
1150 <entry>Run the C pre-processor on Haskell source files</entry>
1151 <entry>dynamic</entry>
1155 <entry><option>-D</option><replaceable>symbol</replaceable><optional>=<replaceable>value</replaceable></optional></entry>
1156 <entry>Define a symbol in the C pre-processor</entry>
1157 <entry>dynamic</entry>
1158 <entry><option>-U</option><replaceable>symbol</replaceable></entry>
1161 <entry><option>-U</option><replaceable>symbol</replaceable></entry>
1162 <entry>Undefine a symbol in the C pre-processor</entry>
1163 <entry>dynamic</entry>
1167 <entry><option>-I</option><replaceable>dir</replaceable></entry>
1168 <entry>Add <replaceable>dir</replaceable> to the
1169 directory search list for <literal>#include</literal> files</entry>
1170 <entry>dynamic</entry>
1179 <title>C compiler options</title>
1181 <para><xref linkend="options-C-compiler"/></para>
1183 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1187 <entry>Description</entry>
1188 <entry>Static/Dynamic</entry>
1189 <entry>Reverse</entry>
1194 <entry><option>-#include</option> <replaceable>file</replaceable></entry>
1195 <entry>Include <replaceable>file</replaceable> when
1196 compiling the <filename>.hc</filename> file</entry>
1197 <entry>dynamic</entry>
1206 <title>Code generation options</title>
1208 <para><xref linkend="options-codegen"/></para>
1211 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1215 <entry>Description</entry>
1216 <entry>Static/Dynamic</entry>
1217 <entry>Reverse</entry>
1222 <entry><option>-fasm</option></entry>
1223 <entry>Use the native code generator</entry>
1224 <entry>dynamic</entry>
1225 <entry>-fvia-C</entry>
1228 <entry><option>-fvia-C</option></entry>
1229 <entry>Compile via C</entry>
1230 <entry>dynamic</entry>
1231 <entry>-fasm</entry>
1234 <entry><option>-fno-code</option></entry>
1235 <entry>Omit code generation</entry>
1245 <title>Linking options</title>
1247 <para><xref linkend="options-linker"/></para>
1250 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1254 <entry>Description</entry>
1255 <entry>Static/Dynamic</entry>
1256 <entry>Reverse</entry>
1261 <entry><option>-dynamic</option></entry>
1262 <entry>Use dynamic Haskell libraries (if available)</entry>
1263 <entry>static</entry>
1267 <entry><option>-framework</option> <replaceable>name</replaceable></entry>
1268 <entry>On Darwin/MacOS X only, link in the framework <replaceable>name</replaceable>.
1269 This option corresponds to the <option>-framework</option> option for Apple's Linker.</entry>
1270 <entry>dynamic</entry>
1274 <entry><option>-framework-path</option> <replaceable>name</replaceable></entry>
1275 <entry>On Darwin/MacOS X only, add <replaceable>dir</replaceable> to the list of
1276 directories searched for frameworks.
1277 This option corresponds to the <option>-F</option> option for Apple's Linker.</entry>
1278 <entry>dynamic</entry>
1282 <entry><option>-l</option><replaceable>lib</replaceable></entry>
1283 <entry>Link in library <replaceable>lib</replaceable></entry>
1284 <entry>dynamic</entry>
1288 <entry><option>-L</option><replaceable>dir</replaceable></entry>
1289 <entry>Add <replaceable>dir</replaceable> to the list of
1290 directories searched for libraries</entry>
1291 <entry>dynamic</entry>
1295 <entry><option>-main-is</option></entry>
1296 <entry>Set main function</entry>
1297 <entry>dynamic</entry>
1301 <entry><option>--mk-dll</option></entry>
1302 <entry>DLL-creation mode (Windows only)</entry>
1303 <entry>dynamic</entry>
1307 <entry><option>-no-hs-main</option></entry>
1308 <entry>Don't assume this program contains <literal>main</literal></entry>
1309 <entry>dynamic</entry>
1313 <entry><option>-no-link</option></entry>
1314 <entry>Omit linking</entry>
1315 <entry>dynamic</entry>
1319 <entry><option>-split-objs</option></entry>
1320 <entry>Split objects (for libraries)</entry>
1321 <entry>dynamic</entry>
1325 <entry><option>-static</option></entry>
1326 <entry>Use static Haskell libraries</entry>
1327 <entry>static</entry>
1331 <entry><option>-threaded</option></entry>
1332 <entry>Use the threaded runtime</entry>
1333 <entry>static</entry>
1337 <entry><option>-debug</option></entry>
1338 <entry>Use the debugging runtime</entry>
1339 <entry>static</entry>
1348 <title>Replacing phases</title>
1350 <para><xref linkend="replacing-phases"/></para>
1353 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1357 <entry>Description</entry>
1358 <entry>Static/Dynamic</entry>
1359 <entry>Reverse</entry>
1364 <entry><option>-pgmL</option> <replaceable>cmd</replaceable></entry>
1365 <entry>Use <replaceable>cmd</replaceable> as the literate pre-processor</entry>
1366 <entry>dynamic</entry>
1370 <entry><option>-pgmP</option> <replaceable>cmd</replaceable></entry>
1371 <entry>Use <replaceable>cmd</replaceable> as the C
1372 pre-processor (with <option>-cpp</option> only)</entry>
1373 <entry>dynamic</entry>
1377 <entry><option>-pgmc</option> <replaceable>cmd</replaceable></entry>
1378 <entry>Use <replaceable>cmd</replaceable> as the C compiler</entry>
1379 <entry>dynamic</entry>
1383 <entry><option>-pgma</option> <replaceable>cmd</replaceable></entry>
1384 <entry>Use <replaceable>cmd</replaceable> as the assembler</entry>
1385 <entry>dynamic</entry>
1389 <entry><option>-pgml</option> <replaceable>cmd</replaceable></entry>
1390 <entry>Use <replaceable>cmd</replaceable> as the linker</entry>
1391 <entry>dynamic</entry>
1395 <entry><option>-pgmdll</option> <replaceable>cmd</replaceable></entry>
1396 <entry>Use <replaceable>cmd</replaceable> as the DLL generator</entry>
1397 <entry>dynamic</entry>
1401 <entry><option>-pgmdep</option> <replaceable>cmd</replaceable></entry>
1402 <entry>Use <replaceable>cmd</replaceable> as the dependency generator</entry>
1403 <entry>dyanmic</entry>
1407 <entry><option>-pgmF</option> <replaceable>cmd</replaceable></entry>
1408 <entry>Use <replaceable>cmd</replaceable> as the pre-processor
1409 (with <option>-F</option> only)</entry>
1410 <entry>dynamic</entry>
1416 <indexterm><primary><option>-pgmL</option></primary></indexterm>
1417 <indexterm><primary><option>-pgmP</option></primary></indexterm>
1418 <indexterm><primary><option>-pgmc</option></primary></indexterm>
1419 <indexterm><primary><option>-pgma</option></primary></indexterm>
1420 <indexterm><primary><option>-pgml</option></primary></indexterm>
1421 <indexterm><primary><option>-pgmdll</option></primary></indexterm>
1422 <indexterm><primary><option>-pgmdep</option></primary></indexterm>
1423 <indexterm><primary><option>-pgmF</option></primary></indexterm>
1428 <title>Forcing options to particular phases</title>
1430 <para><xref linkend="forcing-options-through"/></para>
1433 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1437 <entry>Description</entry>
1438 <entry>Static/Dynamic</entry>
1439 <entry>Reverse</entry>
1444 <entry><option>-optL</option> <replaceable>option</replaceable></entry>
1445 <entry>pass <replaceable>option</replaceable> to the literate pre-processor</entry>
1446 <entry>dynamic</entry>
1450 <entry><option>-optP</option> <replaceable>option</replaceable></entry>
1451 <entry>pass <replaceable>option</replaceable> to cpp (with
1452 <option>-cpp</option> only)</entry>
1453 <entry>dynamic</entry>
1457 <entry><option>-optF</option> <replaceable>option</replaceable></entry>
1458 <entry>pass <replaceable>option</replaceable> to the
1459 custom pre-processor</entry>
1460 <entry>dynamic</entry>
1464 <entry><option>-optc</option> <replaceable>option</replaceable></entry>
1465 <entry>pass <replaceable>option</replaceable> to the C compiler</entry>
1466 <entry>dynamic</entry>
1470 <entry><option>-opta</option> <replaceable>option</replaceable></entry>
1471 <entry>pass <replaceable>option</replaceable> to the assembler</entry>
1472 <entry>dynamic</entry>
1476 <entry><option>-optl</option> <replaceable>option</replaceable></entry>
1477 <entry>pass <replaceable>option</replaceable> to the linker</entry>
1478 <entry>dynamic</entry>
1482 <entry><option>-optdll</option> <replaceable>option</replaceable></entry>
1483 <entry>pass <replaceable>option</replaceable> to the DLL generator</entry>
1484 <entry>dynamic</entry>
1488 <entry><option>-optdep</option> <replaceable>option</replaceable></entry>
1489 <entry>pass <replaceable>option</replaceable> to the dependency generator</entry>
1490 <entry>dynamic</entry>
1499 <title>Platform-specific options</title>
1501 <para><xref linkend="options-platform"/></para>
1504 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1508 <entry>Description</entry>
1509 <entry>Static/Dynamic</entry>
1510 <entry>Reverse</entry>
1515 <entry><option>-mv8</option></entry>
1516 <entry>(SPARC only) enable version 8 support</entry>
1517 <entry>static</entry>
1521 <entry><option>-monly-[32]-regs</option></entry>
1522 <entry>(x86 only) give some registers back to the C compiler</entry>
1523 <entry>dynamic</entry>
1533 <title>External core file options</title>
1535 <para><xref linkend="ext-core"/></para>
1538 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1542 <entry>Description</entry>
1543 <entry>Static/Dynamic</entry>
1544 <entry>Reverse</entry>
1549 <entry><option>-fext-core</option></entry>
1550 <entry>Generate <filename>.hcr</filename> external Core files</entry>
1551 <entry>static</entry>
1561 <title>Compiler debugging options</title>
1563 <para><xref linkend="options-debugging"/></para>
1566 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1570 <entry>Description</entry>
1571 <entry>Static/Dynamic</entry>
1572 <entry>Reverse</entry>
1577 <entry><option>-dcore-lint</option></entry>
1578 <entry>Turn on internal sanity checking</entry>
1579 <entry>dynamic</entry>
1583 <entry><option>-ddump-absC</option></entry>
1584 <entry>Dump abstract C</entry>
1585 <entry>dynamic</entry>
1589 <entry><option>-ddump-asm</option></entry>
1590 <entry>Dump assembly</entry>
1591 <entry>dynamic</entry>
1595 <entry><option>-ddump-bcos</option></entry>
1596 <entry>Dump interpreter byte code</entry>
1597 <entry>dynamic</entry>
1601 <entry><option>-ddump-cpranal</option></entry>
1602 <entry>Dump output from CPR analysis</entry>
1603 <entry>dynamic</entry>
1607 <entry><option>-ddump-cse</option></entry>
1608 <entry>Dump CSE output</entry>
1609 <entry>dynamic</entry>
1613 <entry><option>-ddump-deriv</option></entry>
1614 <entry>Dump deriving output</entry>
1615 <entry>dynamic</entry>
1619 <entry><option>-ddump-ds</option></entry>
1620 <entry>Dump desugarer output</entry>
1621 <entry>dynamic</entry>
1625 <entry><option>-ddump-flatC</option></entry>
1626 <entry>Dump “flat” C</entry>
1627 <entry>dynamic</entry>
1631 <entry><option>-ddump-foreign</option></entry>
1632 <entry>Dump <literal>foreign export</literal> stubs</entry>
1633 <entry>dynamic</entry>
1637 <entry><option>-ddump-inlinings</option></entry>
1638 <entry>Dump inlining info</entry>
1639 <entry>dynamic</entry>
1643 <entry><option>-ddump-occur-anal</option></entry>
1644 <entry>Dump occurrence analysis output</entry>
1645 <entry>dynamic</entry>
1649 <entry><option>-ddump-parsed</option></entry>
1650 <entry>Dump parse tree</entry>
1651 <entry>dynamic</entry>
1655 <entry><option>-ddump-realC</option></entry>
1656 <entry>Dump “real” C</entry>
1657 <entry>dynamic</entry>
1661 <entry><option>-ddump-rn</option></entry>
1662 <entry>Dump renamer output</entry>
1663 <entry>dynamic</entry>
1667 <entry><option>-ddump-rules</option></entry>
1668 <entry>Dump rules</entry>
1669 <entry>dynamic</entry>
1673 <entry><option>-ddump-sat</option></entry>
1674 <entry>Dump saturated output</entry>
1675 <entry>dynamic</entry>
1679 <entry><option>-ddump-simpl</option></entry>
1680 <entry>Dump final simplifier output</entry>
1681 <entry>dynamic</entry>
1685 <entry><option>-ddump-simpl-iterations</option></entry>
1686 <entry>Dump output from each simplifier iteration</entry>
1687 <entry>dynamic</entry>
1691 <entry><option>-ddump-spec</option></entry>
1692 <entry>Dump specialiser output</entry>
1693 <entry>dynamic</entry>
1697 <entry><option>-ddump-stg</option></entry>
1698 <entry>Dump final STG</entry>
1699 <entry>dynamic</entry>
1703 <entry><option>-ddump-stranal</option></entry>
1704 <entry>Dump strictness analyser output</entry>
1705 <entry>dynamic</entry>
1709 <entry><option>-ddump-tc</option></entry>
1710 <entry>Dump typechecker output</entry>
1711 <entry>dynamic</entry>
1715 <entry><option>-ddump-types</option></entry>
1716 <entry>Dump type signatures</entry>
1717 <entry>dynamic</entry>
1721 <entry><option>-ddump-usagesp</option></entry>
1722 <entry>Dump UsageSP analysis output</entry>
1723 <entry>dynamic</entry>
1727 <entry><option>-ddump-worker-wrapper</option></entry>
1728 <entry>Dump worker-wrapper output</entry>
1729 <entry>dynamic</entry>
1733 <entry><option>-ddump-rn-trace</option></entry>
1734 <entry>Trace renamer</entry>
1735 <entry>dynamic</entry>
1739 <entry><option>-ddump-rn-stats</option></entry>
1740 <entry>Renamer stats</entry>
1741 <entry>dynamic</entry>
1745 <entry><option>-ddump-stix</option></entry>
1746 <entry>Native code generator intermediate form</entry>
1747 <entry>dynamic</entry>
1751 <entry><option>-ddump-simpl-stats</option></entry>
1752 <entry>Dump simplifier stats</entry>
1753 <entry>dynamic</entry>
1757 <entry><option>-dppr-debug</option></entry>
1758 <entry>Turn on debug printing (more verbose)</entry>
1759 <entry>static</entry>
1763 <entry><option>-dppr-noprags</option></entry>
1764 <entry>Don't output pragma info in dumps</entry>
1765 <entry>static</entry>
1769 <entry><option>-dppr-user-length</option></entry>
1770 <entry>Set the depth for printing expressions in error msgs</entry>
1771 <entry>static</entry>
1775 <entry><option>-dsource-stats</option></entry>
1776 <entry>Dump haskell source stats</entry>
1777 <entry>dynamic</entry>
1781 <entry><option>-dstg-lint</option></entry>
1782 <entry>STG pass sanity checking</entry>
1783 <entry>dynamic</entry>
1787 <entry><option>-dstg-stats</option></entry>
1788 <entry>Dump STG stats</entry>
1789 <entry>dynamic</entry>
1793 <entry><option>-dusagesp-lint</option></entry>
1794 <entry>UsageSP sanity checker</entry>
1795 <entry>dynamic</entry>
1799 <entry><option>-dverbose-core2core</option></entry>
1800 <entry>Show output from each core-to-core pass</entry>
1801 <entry>dynamic</entry>
1805 <entry><option>-dverbose-stg2stg</option></entry>
1806 <entry>Show output from each STG-to-STG pass</entry>
1807 <entry>dynamic</entry>
1811 <entry><option>-unreg</option></entry>
1812 <entry>Enable unregisterised compilation</entry>
1813 <entry>static</entry>
1822 <title>Misc compiler options</title>
1825 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1829 <entry>Description</entry>
1830 <entry>Static/Dynamic</entry>
1831 <entry>Reverse</entry>
1836 <entry><option>-femit-extern-decls</option></entry>
1838 <entry>static</entry>
1842 <entry><option>-fno-hi-version-check</option></entry>
1843 <entry>Don't complain about <literal>.hi</literal> file mismatches</entry>
1844 <entry>static</entry>
1848 <entry><option>-dno-black-holing</option></entry>
1849 <entry>Turn off black holing (probably doesn't work)</entry>
1850 <entry>static</entry>
1854 <entry><option>-fno-method-sharing</option></entry>
1855 <entry>Don't share specialisations of overloaded functions</entry>
1856 <entry>static</entry>
1860 <entry><option>-fhistory-size</option></entry>
1861 <entry>Set simplification history size</entry>
1862 <entry>static</entry>
1866 <entry><option>-funregisterised</option></entry>
1867 <entry>Unregisterised compilation (use <option>-unreg</option> instead)</entry>
1868 <entry>static</entry>
1872 <entry><option>-fno-asm-mangling</option></entry>
1873 <entry>Turn off assembly mangling (use <option>-unreg</option> instead)</entry>
1874 <entry>dynamic</entry>
1878 <entry><option>-fno-print-bind-result</option></entry>
1879 <entry><link id="ghci-stmts">Turn off printing of binding results in GHCi</link></entry>
1880 <entry>dynamic</entry>
1894 , ( "H" , HasArg (setHeapSize . fromIntegral . decodeSize) )
1900 ;;; Local Variables: ***
1902 ;;; sgml-parent-document: ("users_guide.xml" "book" "chapter") ***