29de82f6696a96f1c40f12f11fa27474b756de34
[ghc.git] / docs / users_guide / flags.xml
1 <?xml version="1.0" encoding="iso-8859-1"?>
2 <sect1 id="flag-reference">
3 <title>Flag reference</title>
4
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
8 (if available).</para>
9
10 <sect2>
11 <title>Help and verbosity options</title>
12
13 <para><xref linkend="options-help"/></para>
14
15 <informaltable>
16 <tgroup cols="4" align="left" colsep="1" rowsep="1">
17 <thead>
18 <row>
19 <entry>Flag</entry>
20 <entry>Description</entry>
21 <entry>Static/Dynamic</entry>
22 <entry>Reverse</entry>
23 </row>
24 </thead>
25 <tbody>
26 <row>
27 <entry><option>-?</option></entry>
28 <entry>help</entry>
29 <entry>mode</entry>
30 <entry>-</entry>
31 </row>
32 <row>
33 <entry><option>-help</option></entry>
34 <entry>help</entry>
35 <entry>mode</entry>
36 <entry>-</entry>
37 </row>
38 <row>
39 <entry><option>-n</option></entry>
40 <entry>do a dry run</entry>
41 <entry>dynamic</entry>
42 <entry>-</entry>
43 </row>
44 <row>
45 <entry><option>-v</option></entry>
46 <entry>verbose mode (equivalent to <option>-v3</option>)</entry>
47 <entry>dynamic</entry>
48 <entry>-</entry>
49 </row>
50 <row>
51 <entry><option>-v</option><replaceable>n</replaceable></entry>
52 <entry>set verbosity level</entry>
53 <entry>dynamic</entry>
54 <entry>-</entry>
55 </row>
56 <row>
57 <entry><option>-V</option></entry>
58 <entry>display GHC version</entry>
59 <entry>mode</entry>
60 <entry>-</entry>
61 </row>
62 <row>
63 <entry><option>&ndash;&ndash;version</option></entry>
64 <entry>display GHC version</entry>
65 <entry>mode</entry>
66 <entry>-</entry>
67 </row>
68 <row>
69 <entry><option>&ndash;&ndash;numeric-version</option></entry>
70 <entry>display GHC version (numeric only)</entry>
71 <entry>mode</entry>
72 <entry>-</entry>
73 </row>
74 <row>
75 <entry><option>&ndash;&ndash;print-libdir</option></entry>
76 <entry>display GHC library directory</entry>
77 <entry>mode</entry>
78 <entry>-</entry>
79 </row>
80 <row>
81 <entry><option>-ferror-spans</option></entry>
82 <entry>output full span in error messages</entry>
83 <entry>static</entry>
84 <entry>-</entry>
85 </row>
86 <row>
87 <entry><option>-H</option><replaceable>size</replaceable></entry>
88 <entry>Set the minimum heap size to <replaceable>size</replaceable></entry>
89 <entry>static</entry>
90 <entry>-</entry>
91 </row>
92 <row>
93 <entry><option>-Rghc-timing</option></entry>
94 <entry>Summarise timing stats for GHC (same as <literal>+RTS -tstderr</literal>)</entry>
95 <entry>static</entry>
96 <entry>-</entry>
97 </row>
98 </tbody>
99 </tgroup>
100 </informaltable>
101
102 </sect2>
103 <sect2>
104 <title>Which phases to run</title>
105
106 <para><xref linkend="options-order"/></para>
107
108 <informaltable>
109 <tgroup cols="4" align="left" colsep="1" rowsep="1">
110 <thead>
111 <row>
112 <entry>Flag</entry>
113 <entry>Description</entry>
114 <entry>Static/Dynamic</entry>
115 <entry>Reverse</entry>
116 </row>
117 </thead>
118 <tbody>
119 <row>
120 <entry><option>-E</option></entry>
121 <entry>Stop after preprocessing (<literal>.hspp</literal> file)</entry>
122 <entry>mode</entry>
123 <entry>-</entry>
124 </row>
125 <row>
126 <entry><option>-C</option></entry>
127 <entry>Stop after generating C (<literal>.hc</literal> file)</entry>
128 <entry>mode</entry>
129 <entry>-</entry>
130 </row>
131 <row>
132 <entry><option>-S</option></entry>
133 <entry>Stop after generating assembly (<literal>.s</literal> file)</entry>
134 <entry>mode</entry>
135 <entry>-</entry>
136 </row>
137 <row>
138 <entry><option>-c</option></entry>
139 <entry>Do not link</entry>
140 <entry>dynamic</entry>
141 <entry>-</entry>
142 </row>
143 <row>
144 <entry><option>-x</option> <replaceable>suffix</replaceable></entry>
145 <entry>Override default behaviour for source files</entry>
146 <entry>static</entry>
147 <entry>-</entry>
148 </row>
149 </tbody>
150 </tgroup>
151 </informaltable>
152 </sect2>
153
154 <sect2>
155 <title>Alternative modes of operation</title>
156
157 <para><xref linkend="modes"/></para>
158
159 <informaltable>
160 <tgroup cols="4" align="left" colsep="1" rowsep="1">
161 <thead>
162 <row>
163 <entry>Flag</entry>
164 <entry>Description</entry>
165 <entry>Static/Dynamic</entry>
166 <entry>Reverse</entry>
167 </row>
168 </thead>
169 <tbody>
170 <row>
171 <entry><option>--interactive</option></entry>
172 <entry>Interactive mode - normally used by just running <command>ghci</command>;
173 see <xref linkend="ghci"/> for details.</entry>
174 <entry>mode</entry>
175 <entry>-</entry>
176 </row>
177 <row>
178 <entry><option>--make</option></entry>
179 <entry>Build a multi-module Haskell program, automatically figuring out dependencies. Likely to be much easier, and faster, than using <command>make</command>;
180 see <xref linkend="make-mode"/> for details..</entry>
181 <entry>mode</entry>
182 <entry>-</entry>
183 </row>
184 <row>
185 <entry><option>-e <replaceable>expr</replaceable></option></entry>
186 <entry>Evaluate <replaceable>expr</replaceable>;
187 see <xref linkend="eval-mode"/> for details.</entry>
188 <entry>mode</entry>
189 <entry>-</entry>
190 </row>
191 <row>
192 <entry><option>-M</option></entry>
193 <entry>Generate dependency information suitable for use in a <filename>Makefile</filename>;
194 see <xref linkend="makefile-dependencies"/> for details.</entry>
195 <entry>mode</entry>
196 <entry>-</entry>
197 </row>
198 </tbody>
199 </tgroup>
200 </informaltable>
201 </sect2>
202
203 <sect2>
204 <title>Redirecting output</title>
205
206 <para><xref linkend="options-output"/></para>
207
208 <informaltable>
209 <tgroup cols="4" align="left" colsep="1" rowsep="1">
210 <thead>
211 <row>
212 <entry>Flag</entry>
213 <entry>Description</entry>
214 <entry>Static/Dynamic</entry>
215 <entry>Reverse</entry>
216 </row>
217 </thead>
218 <tbody>
219 <row>
220 <entry><option>-hcsuf</option> <replaceable>suffix</replaceable></entry>
221 <entry>set the suffix to use for intermediate C files</entry>
222 <entry>dynamic</entry>
223 <entry>-</entry>
224 </row>
225 <row>
226 <entry><option>-hidir</option> <replaceable>dir</replaceable></entry>
227 <entry>set directory for interface files</entry>
228 <entry>dynamic</entry>
229 <entry>-</entry>
230 </row>
231 <row>
232 <entry><option>-hisuf</option> <replaceable>suffix</replaceable></entry>
233 <entry>set the suffix to use for interface files</entry>
234 <entry>dynamic</entry>
235 <entry>-</entry>
236 </row>
237 <row>
238 <entry><option>-o</option> <replaceable>filename</replaceable></entry>
239 <entry>set output filename</entry>
240 <entry>dynamic</entry>
241 <entry>-</entry>
242 </row>
243 <row>
244 <entry><option>-odir</option> <replaceable>dir</replaceable></entry>
245 <entry>set output directory</entry>
246 <entry>dynamic</entry>
247 <entry>-</entry>
248 </row>
249 <row>
250 <entry><option>-ohi</option> <replaceable>filename</replaceable></entry>
251 <entry>set the filename in which to put the interface</entry>
252 <entry>dynamic</entry>
253 <entry></entry>
254 </row>
255 <row>
256 <entry><option>-osuf</option> <replaceable>suffix</replaceable></entry>
257 <entry>set the output file suffix</entry>
258 <entry>dynamic</entry>
259 <entry>-</entry>
260 </row>
261 <row>
262 <entry><option>-stubdir</option> <replaceable>dir</replaceable></entry>
263 <entry>redirect FFi stub files</entry>
264 <entry>dynamic</entry>
265 <entry>-</entry>
266 </row>
267 </tbody>
268 </tgroup>
269 </informaltable>
270 </sect2>
271
272 <sect2>
273 <title>Keeping intermediate files</title>
274
275 <para><xref linkend="keeping-intermediates"/></para>
276
277 <informaltable>
278 <tgroup cols="4" align="left" colsep="1" rowsep="1">
279 <thead>
280 <row>
281 <entry>Flag</entry>
282 <entry>Description</entry>
283 <entry>Static/Dynamic</entry>
284 <entry>Reverse</entry>
285 </row>
286 </thead>
287 <tbody>
288 <row>
289 <entry><option>-keep-hc-file</option></entry>
290 <entry>retain intermediate <literal>.hc</literal> files</entry>
291 <entry>dynamic</entry>
292 <entry>-</entry>
293 </row>
294 <row>
295 <entry><option>-keep-s-file</option></entry>
296 <entry>retain intermediate <literal>.s</literal> files</entry>
297 <entry>dynamic</entry>
298 <entry>-</entry>
299 </row>
300 <row>
301 <entry><option>-keep-raw-s-file</option></entry>
302 <entry>retain intermediate <literal>.raw_s</literal> files</entry>
303 <entry>dynamic</entry>
304 <entry>-</entry>
305 </row>
306 <row>
307 <entry><option>-keep-tmp-files</option></entry>
308 <entry>retain all intermediate temporary files</entry>
309 <entry>dynamic</entry>
310 <entry>-</entry>
311 </row>
312 </tbody>
313 </tgroup>
314 </informaltable>
315 </sect2>
316
317 <sect2>
318 <title>Temporary files</title>
319
320 <para><xref linkend="temp-files"/></para>
321
322 <informaltable>
323 <tgroup cols="4" align="left" colsep="1" rowsep="1">
324 <thead>
325 <row>
326 <entry>Flag</entry>
327 <entry>Description</entry>
328 <entry>Static/Dynamic</entry>
329 <entry>Reverse</entry>
330 </row>
331 </thead>
332 <tbody>
333 <row>
334 <entry><option>-tmpdir</option></entry>
335 <entry>set the directory for temporary files</entry>
336 <entry>dynamic</entry>
337 <entry>-</entry>
338 </row>
339 </tbody>
340 </tgroup>
341 </informaltable>
342 </sect2>
343
344 <sect2>
345 <title>Finding imports</title>
346
347 <para><xref linkend="search-path"/></para>
348
349 <informaltable>
350 <tgroup cols="4" align="left" colsep="1" rowsep="1">
351 <thead>
352 <row>
353 <entry>Flag</entry>
354
355 <entry>Description</entry>
356 <entry>Static/Dynamic</entry>
357 <entry>Reverse</entry>
358 </row>
359 </thead>
360 <tbody>
361 <row>
362 <entry><option>-i</option><replaceable>dir1</replaceable>:<replaceable>dir2</replaceable>:...</entry>
363 <entry>add <replaceable>dir</replaceable>,
364 <replaceable>dir2</replaceable>, etc. to import path</entry>
365 <entry>static/<literal>:set</literal></entry>
366 <entry>-</entry>
367 </row>
368 <row>
369 <entry><option>-i</option></entry>
370 <entry>Empty the import directory list</entry>
371 <entry>static/<literal>:set</literal></entry>
372 <entry>-</entry>
373 </row>
374 </tbody>
375 </tgroup>
376 </informaltable>
377 </sect2>
378
379 <sect2>
380 <title>Interface file options</title>
381
382 <para><xref linkend="hi-options"/></para>
383
384 <informaltable>
385 <tgroup cols="4" align="left" colsep="1" rowsep="1">
386 <thead>
387 <row>
388 <entry>Flag</entry>
389
390 <entry>Description</entry>
391 <entry>Static/Dynamic</entry>
392 <entry>Reverse</entry>
393 </row>
394 </thead>
395 <tbody>
396 <row>
397 <entry><option>-ddump-hi</option></entry>
398 <entry>Dump the new interface to stdout</entry>
399 <entry>dynamic</entry>
400 <entry>-</entry>
401 </row>
402 <row>
403 <entry><option>-ddump-hi-diffs</option></entry>
404 <entry>Show the differences vs. the old interface</entry>
405 <entry>dynamic</entry>
406 <entry>-</entry>
407 </row>
408 <row>
409 <entry><option>-ddump-minimal-imports</option></entry>
410 <entry>Dump a minimal set of imports</entry>
411 <entry>dynamic</entry>
412 <entry>-</entry>
413 </row>
414 <row>
415 <entry><option>--show-iface</option> <replaceable>file</replaceable></entry>
416 <entry>Read the interface in
417 <replaceable>file</replaceable> and dump it as text to
418 <literal>stdout</literal>.</entry>
419 <entry>mode</entry>
420 <entry>-</entry>
421 </row>
422 </tbody>
423 </tgroup>
424 </informaltable>
425 </sect2>
426
427 <sect2>
428 <title>Recompilation checking</title>
429
430 <para><xref linkend="recomp"/></para>
431
432 <informaltable>
433 <tgroup cols="4" align="left" colsep="1" rowsep="1">
434 <thead>
435 <row>
436 <entry>Flag</entry>
437
438 <entry>Description</entry>
439 <entry>Static/Dynamic</entry>
440 <entry>Reverse</entry>
441 </row>
442 </thead>
443 <tbody>
444 <row>
445 <entry><option>-fforce-recomp</option></entry>
446 <entry>Turn off recompilation checking; implied by any
447 <option>-ddump-X</option> option</entry>
448 <entry>dynamic</entry>
449 <entry><option>-fno-force-recomp</option></entry>
450 </row>
451 </tbody>
452 </tgroup>
453 </informaltable>
454 </sect2>
455
456 <sect2>
457 <title>Interactive-mode options</title>
458
459 <para><xref linkend="ghci-dot-files"/></para>
460
461 <informaltable>
462 <tgroup cols="4" align="left" colsep="1" rowsep="1">
463 <thead>
464 <row>
465 <entry>Flag</entry>
466 <entry>Description</entry>
467 <entry>Static/Dynamic</entry>
468 <entry>Reverse</entry>
469 </row>
470 </thead>
471 <tbody>
472 <row>
473 <entry><option>-ignore-dot-ghci</option></entry>
474 <entry>Disable reading of <filename>.ghci</filename> files</entry>
475 <entry>static</entry>
476 <entry>-</entry>
477 </row>
478 <row>
479 <entry><option>-read-dot-ghci</option></entry>
480 <entry>Enable reading of <filename>.ghci</filename> files</entry>
481 <entry>static</entry>
482 <entry>-</entry>
483 </row>
484 <row>
485 <entry><option>-fdebugging</option></entry>
486 <entry>Generate bytecode enabled for debugging</entry>
487 <entry>dynamic</entry>
488 <entry>-</entry>
489 </row>
490 <row>
491 <entry><option>-fno-debugging</option></entry>
492 <entry>Do not include debugging information in bytecodes</entry>
493 <entry>dynamic</entry>
494 <entry>-</entry>
495 </row>
496 </tbody>
497 </tgroup>
498 </informaltable>
499 </sect2>
500
501 <sect2>
502 <title>Packages</title>
503
504 <para><xref linkend="packages"/></para>
505
506 <informaltable>
507 <tgroup cols="4" align="left" colsep="1" rowsep="1">
508 <thead>
509 <row>
510 <entry>Flag</entry>
511 <entry>Description</entry>
512 <entry>Static/Dynamic</entry>
513 <entry>Reverse</entry>
514 </row>
515 </thead>
516 <tbody>
517 <row>
518 <entry><option>-package-name</option> <replaceable>P</replaceable></entry>
519 <entry>Compile to be part of package <replaceable>P</replaceable></entry>
520 <entry>dynamic</entry>
521 <entry>-</entry>
522 </row>
523 <row>
524 <entry><option>-package</option> <replaceable>P</replaceable></entry>
525 <entry>Expose package <replaceable>P</replaceable></entry>
526 <entry>static/<literal>:set</literal></entry>
527 <entry>-</entry>
528 </row>
529 <row>
530 <entry><option>-hide-all-packages</option></entry>
531 <entry>Hide all packages by default</entry>
532 <entry>static</entry>
533 <entry>-</entry>
534 </row>
535 <row>
536 <entry><option>-hide-package</option> <replaceable>name</replaceable></entry>
537 <entry>Hide package <replaceable>P</replaceable></entry>
538 <entry>static/<literal>:set</literal></entry>
539 <entry>-</entry>
540 </row>
541 <row>
542 <entry><option>-ignore-package</option> <replaceable>name</replaceable></entry>
543 <entry>Ignore package <replaceable>P</replaceable></entry>
544 <entry>static/<literal>:set</literal></entry>
545 <entry>-</entry>
546 </row>
547 <row>
548 <entry><option>-package-conf</option> <replaceable>file</replaceable></entry>
549 <entry>Load more packages from <replaceable>file</replaceable></entry>
550 <entry>static</entry>
551 <entry>-</entry>
552 </row>
553 <row>
554 <entry><option>-no-user-package-conf</option></entry>
555 <entry>Don't load the user's package config file.</entry>
556 <entry>static</entry>
557 <entry>-</entry>
558 </row>
559 </tbody>
560 </tgroup>
561 </informaltable>
562 </sect2>
563
564 <sect2>
565 <title>Language options</title>
566
567 <para><xref linkend="options-language"/></para>
568
569 <informaltable>
570 <tgroup cols="4" align="left" colsep="1" rowsep="1">
571 <thead>
572 <row>
573 <entry>Flag</entry>
574 <entry>Description</entry>
575 <entry>Static/Dynamic</entry>
576 <entry>Reverse</entry>
577 </row>
578 </thead>
579 <tbody>
580 <row>
581 <entry><option>-fallow-overlapping-instances</option></entry>
582 <entry>Enable <link linkend="instance-overlap">overlapping instances</link></entry>
583 <entry>dynamic</entry>
584 <entry><option>-fno-allow-overlapping-instances</option></entry>
585 </row>
586 <row>
587 <entry><option>-fallow-incoherent-instances</option></entry>
588 <entry>Enable <link linkend="instance-overlap">incoherent instances</link>.
589 Implies <option>-fallow-overlapping-instances</option> </entry>
590 <entry>dynamic</entry>
591 <entry><option>-fno-allow-incoherent-instances</option></entry>
592 </row>
593 <row>
594 <entry><option>-fallow-undecidable-instances</option></entry>
595 <entry>Enable <link linkend="undecidable-instances">undecidable instances</link></entry>
596 <entry>dynamic</entry>
597 <entry><option>-fno-allow-undecidable-instances</option></entry>
598 </row>
599 <row>
600 <entry><option>-fcontext-stack=N</option><replaceable>n</replaceable></entry>
601 <entry>set the <link linkend="undecidable-instances">limit for context reduction</link></entry>
602 <entry>dynamic</entry>
603 <entry><option>20</option></entry>
604 </row>
605 <row>
606 <entry><option>-farrows</option></entry>
607 <entry>Enable <link linkend="arrow-notation">arrow
608 notation</link> extension</entry>
609 <entry>dynamic</entry>
610 <entry><option>-fno-arrows</option></entry>
611 </row>
612 <row>
613 <entry><option>-ffi</option> or <option>-fffi</option></entry>
614 <entry>Enable <link linkend="ffi">foreign function interface</link> (implied by
615 <option>-fglasgow-exts</option>)</entry>
616 <entry>dynamic</entry>
617 <entry><option>-fno-ffi</option></entry>
618 </row>
619 <row>
620 <entry><option>-fgenerics</option></entry>
621 <entry>Enable <link linkend="generic-classes">generic classes</link></entry>
622 <entry>dynamic</entry>
623 <entry><option>-fno-fgenerics</option></entry>
624 </row>
625 <row>
626 <entry><option>-fglasgow-exts</option></entry>
627 <entry>Enable most language extensions</entry>
628 <entry>dynamic</entry>
629 <entry><option>-fno-glasgow-exts</option></entry>
630 </row>
631 <row>
632 <entry><option>-fimplicit-params</option></entry>
633 <entry>Enable <link linkend="implicit-parameters">Implicit Parameters</link>.
634 Implied by <option>-fglasgow-exts</option>.</entry>
635 <entry>dynamic</entry>
636 <entry><option>-fno-implicit-params</option></entry>
637 </row>
638 <row>
639 <entry><option>-firrefutable-tuples</option></entry>
640 <entry>Make tuple pattern matching irrefutable</entry>
641 <entry>dynamic</entry>
642 <entry><option>-fno-irrefutable-tuples</option></entry>
643 </row>
644 <row>
645 <entry><option>-fno-implicit-prelude</option></entry>
646 <entry>Don't implicitly <literal>import Prelude</literal></entry>
647 <entry>dynamic</entry>
648 <entry><option>-fimplicit-prelude</option></entry>
649 </row>
650 <row>
651 <entry><option>-fno-monomorphism-restriction</option></entry>
652 <entry>Disable the <link linkend="monomorphism">monomorphism restriction</link></entry>
653 <entry>dynamic</entry>
654 <entry><option>-fmonomorphism-restriction</option></entry>
655 </row>
656 <row>
657 <entry><option>-fno-mono-pat-binds</option></entry>
658 <entry>Make <link linkend="monomorphism">pattern bindings polymorphic</link></entry>
659 <entry>dynamic</entry>
660 <entry><option>-fmono-pat-binds</option></entry>
661 </row>
662 <row>
663 <entry><option>-fextended-default-rules</option></entry>
664 <entry>Use GHCi's <link linkend="extended-default-rules">extended default rules</link> in a normal module</entry>
665 <entry>dynamic</entry>
666 <entry><option>-fno-extended-default-rules</option></entry>
667 </row>
668 <row>
669 <entry><option>-foverloaded-strings</option></entry>
670 <entry>Enable <link linkend="overloaded-strings">overloaded string literals</link>.
671 </entry>
672 <entry>dynamic</entry>
673 <entry><option>-fno-overloaded-strings</option></entry>
674 </row>
675 <row>
676 <entry><option>-fscoped-type-variables</option></entry>
677 <entry>Enable <link linkend="scoped-type-variables">lexically-scoped type variables</link>.
678 Implied by <option>-fglasgow-exts</option>.</entry>
679 <entry>dynamic</entry>
680 <entry><option>-fno-scoped-type-variables</option></entry>
681 </row>
682 <row>
683 <entry><option>-fth</option></entry>
684 <entry>Enable <link linkend="template-haskell">Template Haskell</link>.
685 No longer implied by <option>-fglasgow-exts</option>.</entry>
686 <entry>dynamic</entry>
687 <entry><option>-fno-th</option></entry>
688 </row>
689 <row>
690 <entry><option>-fbang-patterns</option></entry>
691 <entry>Enable <link linkend="bang-patterns">bang patterns</link>.</entry>
692 <entry>dynamic</entry>
693 <entry><option>-fno-bang-patterns</option></entry>
694 </row>
695 </tbody>
696 </tgroup>
697 </informaltable>
698 </sect2>
699
700 <sect2>
701 <title>Warnings</title>
702
703 <para><xref linkend="options-sanity"/></para>
704
705 <informaltable>
706 <tgroup cols="4" align="left" colsep="1" rowsep="1">
707 <thead>
708 <row>
709 <entry>Flag</entry>
710 <entry>Description</entry>
711 <entry>Static/Dynamic</entry>
712 <entry>Reverse</entry>
713 </row>
714 </thead>
715 <tbody>
716 <row>
717 <entry><option>-W</option></entry>
718 <entry>enable normal warnings</entry>
719 <entry>dynamic</entry>
720 <entry><option>-w</option></entry>
721 </row>
722 <row>
723 <entry><option>-w</option></entry>
724 <entry>disable all warnings</entry>
725 <entry>dynamic</entry>
726 <entry>-</entry>
727 </row>
728 <row>
729 <entry><option>-Wall</option></entry>
730 <entry>enable all warnings</entry>
731 <entry>dynamic</entry>
732 <entry><option>-w</option></entry>
733 </row>
734 <row>
735 <entry><option>-Werror</option></entry>
736 <entry>make warnings fatal</entry>
737 <entry>dynamic</entry>
738 <entry></entry>
739 </row>
740
741 <row>
742 <entry><option>-fwarn-deprecations</option></entry>
743 <entry>warn about uses of functions &amp; types that are deprecated</entry>
744 <entry>dynamic</entry>
745 <entry><option>-fno-warn-deprecations</option></entry>
746 </row>
747
748 <row>
749 <entry><option>-fwarn-duplicate-exports</option></entry>
750 <entry>warn when an entity is exported multiple times</entry>
751 <entry>dynamic</entry>
752 <entry><option>-fno-warn-duplicate-exports</option></entry>
753 </row>
754
755 <row>
756 <entry><option>-fwarn-hi-shadowing</option></entry>
757 <entry>warn when a <literal>.hi</literal> file in the
758 current directory shadows a library</entry>
759 <entry>dynamic</entry>
760 <entry><option>-fno-warn-hi-shadowing</option></entry>
761 </row>
762
763 <row>
764 <entry><option>-fwarn-incomplete-patterns</option></entry>
765 <entry>warn when a pattern match could fail</entry>
766 <entry>dynamic</entry>
767 <entry><option>-fno-warn-incomplete-patterns</option></entry>
768 </row>
769
770 <row>
771 <entry><option>-fwarn-incomplete-record-updates</option></entry>
772 <entry>warn when a record update could fail</entry>
773 <entry>dynamic</entry>
774 <entry><option>-fno-warn-incomplete-record-updates</option></entry>
775 </row>
776
777 <row>
778 <entry><option>-fwarn-missing-fields</option></entry>
779 <entry>warn when fields of a record are uninitialised</entry>
780 <entry>dynamic</entry>
781 <entry><option>-fno-warn-missing-fields</option></entry>
782 </row>
783
784 <row>
785 <entry><option>-fwarn-missing-methods</option></entry>
786 <entry>warn when class methods are undefined</entry>
787 <entry>dynamic</entry>
788 <entry><option>-fno-warn-missing-methods</option></entry>
789 </row>
790
791 <row>
792 <entry><option>-fwarn-missing-signatures</option></entry>
793 <entry>warn about top-level functions without signatures</entry>
794 <entry>dynamic</entry>
795 <entry><option>-fno-warn-missing-signatures</option></entry>
796 </row>
797
798 <row>
799 <entry><option>-fwarn-name-shadowing</option></entry>
800 <entry>warn when names are shadowed</entry>
801 <entry>dynamic</entry>
802 <entry><option>-fno-warn-name-shadowing</option></entry>
803 </row>
804
805 <row>
806 <entry><option>-fwarn-orphans</option></entry>
807 <entry>warn when the module contains "orphan" instance declarations
808 or rewrite rules</entry>
809 <entry>dynamic</entry>
810 <entry><option>-fno-warn-orphans</option></entry>
811 </row>
812
813 <row>
814 <entry><option>-fwarn-overlapping-patterns</option></entry>
815 <entry>warn about overlapping patterns</entry>
816 <entry>dynamic</entry>
817 <entry><option>-fno-warn-overlapping-patterns</option></entry>
818 </row>
819
820 <row>
821 <entry><option>-fwarn-simple-patterns</option></entry>
822 <entry>warn about lambda-patterns that can fail</entry>
823 <entry>dynamic</entry>
824 <entry><option>-fno-warn-simple-patterns</option></entry>
825 </row>
826
827 <row>
828 <entry><option>-fwarn-tabs</option></entry>
829 <entry>warn if there are tabs in the source file</entry>
830 <entry>dynamic</entry>
831 <entry><option>-fno-warn-tabs</option></entry>
832 </row>
833
834 <row>
835 <entry><option>-fwarn-type-defaults</option></entry>
836 <entry>warn when defaulting happens</entry>
837 <entry>dynamic</entry>
838 <entry><option>-fno-warn-type-defaults</option></entry>
839 </row>
840
841 <row>
842 <entry><option>-fwarn-unused-binds</option></entry>
843 <entry>warn about bindings that are unused</entry>
844 <entry>dynamic</entry>
845 <entry><option>-fno-warn-unused-binds</option></entry>
846 </row>
847
848 <row>
849 <entry><option>-fwarn-unused-imports</option></entry>
850 <entry>warn about unnecessary imports</entry>
851 <entry>dynamic</entry>
852 <entry><option>-fno-warn-unused-imports</option></entry>
853 </row>
854
855 <row>
856 <entry><option>-fwarn-unused-matches</option></entry>
857 <entry>warn about variables in patterns that aren't used</entry>
858 <entry>dynamic</entry>
859 <entry><option>-fno-warn-unused-matches</option></entry>
860 </row>
861
862 </tbody>
863 </tgroup>
864 </informaltable>
865
866 </sect2>
867 <sect2>
868 <title>Optimisation levels</title>
869
870 <para><xref linkend="options-optimise"/></para>
871
872 <informaltable>
873 <tgroup cols="4" align="left" colsep="1" rowsep="1">
874 <thead>
875 <row>
876 <entry>Flag</entry>
877 <entry>Description</entry>
878 <entry>Static/Dynamic</entry>
879 <entry>Reverse</entry>
880 </row>
881 </thead>
882 <tbody>
883 <row>
884 <entry><option>-O</option></entry>
885 <entry>Enable default optimisation (level 1)</entry>
886 <entry>dynamic</entry>
887 <entry><option>-O0</option></entry>
888 </row>
889 <row>
890 <entry><option>-O</option><replaceable>n</replaceable></entry>
891 <entry>Set optimisation level <replaceable>n</replaceable></entry>
892 <entry>dynamic</entry>
893 <entry><option>-O0</option></entry>
894 </row>
895 </tbody>
896 </tgroup>
897 </informaltable>
898
899 </sect2>
900 <sect2>
901 <title>Individual optimisations</title>
902
903 <para><xref linkend="options-f"/></para>
904
905 <informaltable>
906 <tgroup cols="4" align="left" colsep="1" rowsep="1">
907 <thead>
908 <row>
909 <entry>Flag</entry>
910 <entry>Description</entry>
911 <entry>Static/Dynamic</entry>
912 <entry>Reverse</entry>
913 </row>
914 </thead>
915 <tbody>
916 <row>
917 <entry><option>-fcase-merge</option></entry>
918 <entry>Enable case-merging</entry>
919 <entry>dynamic</entry>
920 <entry><option>-fno-case-merge</option></entry>
921 </row>
922
923 <row>
924 <entry><option>-fdicts-strict</option></entry>
925 <entry>Make dictionaries strict</entry>
926 <entry>static</entry>
927 <entry><option>-fno-dicts-strict</option></entry>
928 </row>
929
930 <row>
931 <entry><option>-fdo-eta-reduction</option></entry>
932 <entry>Enable eta-reduction</entry>
933 <entry>dynamic</entry>
934 <entry><option>-fno-do-eta-reduction</option></entry>
935 </row>
936
937 <row>
938 <entry><option>-fdo-lambda-eta-expansion</option></entry>
939 <entry>Enable lambda eta-reduction</entry>
940 <entry>dynamic</entry>
941 <entry><option>-fno-do-lambda-eta-expansion</option></entry>
942 </row>
943
944 <row>
945 <entry><option>-fexcess-precision</option></entry>
946 <entry>Enable excess intermediate precision</entry>
947 <entry>dynamic</entry>
948 <entry><option>-fno-excess-precision</option></entry>
949 </row>
950
951 <row>
952 <entry><option>-frules-off</option></entry>
953 <entry>Switch off all rewrite rules (including rules
954 generated by automatic specialisation of overloaded functions)</entry>
955 <entry>static</entry>
956 <entry><option>-frules-off</option></entry>
957 </row>
958
959 <row>
960 <entry><option>-fignore-asserts</option></entry>
961 <entry>Ignore assertions in the source</entry>
962 <entry>dynamic</entry>
963 <entry><option>-fno-ignore-asserts</option></entry>
964 </row>
965
966 <row>
967 <entry><option>-fignore-interface-pragmas</option></entry>
968 <entry>Ignore pragmas in interface files</entry>
969 <entry>dynamic</entry>
970 <entry><option>-fno-ignore-interface-pragmas</option></entry>
971 </row>
972
973 <row>
974 <entry><option>-fliberate-case-threshold</option></entry>
975 <entry>Tweak the liberate-case optimisation (default: 10)</entry>
976 <entry>static</entry>
977 <entry><option>-fno-liberate-case-threshold</option></entry>
978 </row>
979
980 <row>
981 <entry><option>-fomit-interface-pragmas</option></entry>
982 <entry>Don't generate interface pragmas</entry>
983 <entry>dynamic</entry>
984 <entry><option>-fno-omit-interface-pragmas</option></entry>
985 </row>
986
987 <row>
988 <entry><option>-fmax-worker-args</option></entry>
989 <entry>If a worker has that many arguments, none will be
990 unpacked anymore (default: 10)</entry>
991 <entry>static</entry>
992 <entry>-</entry>
993 </row>
994
995 <row>
996 <entry><option>-fmax-simplifier-iterations</option></entry>
997 <entry>Set the max iterations for the simplifier</entry>
998 <entry>dynamic</entry>
999 <entry>-</entry>
1000 </row>
1001
1002 <row>
1003 <entry><option>-fno-state-hack</option></entry>
1004 <entry>Turn off the "state hack" whereby any lambda with a real-world state token
1005 as argument is considered to be single-entry. Hence OK to inline things inside it.</entry>
1006 <entry>static</entry>
1007 <entry>-</entry>
1008 </row>
1009
1010 <row>
1011 <entry><option>-fno-cse</option></entry>
1012 <entry>Turn off common sub-expression</entry>
1013 <entry>dynamic</entry>
1014 <entry>-</entry>
1015 </row>
1016
1017 <row>
1018 <entry><option>-fno-full-laziness</option></entry>
1019 <entry>Turn off full laziness (floating bindings outwards).</entry>
1020 <entry>dynamic</entry>
1021 <entry>-ffull-laziness</entry>
1022 </row>
1023
1024 <row>
1025 <entry><option>-fno-pre-inlining</option></entry>
1026 <entry>Turn off pre-inlining</entry>
1027 <entry>static</entry>
1028 <entry>-</entry>
1029 </row>
1030
1031 <row>
1032 <entry><option>-fno-strictness</option></entry>
1033 <entry>Turn off strictness analysis</entry>
1034 <entry>dynamic</entry>
1035 <entry>-</entry>
1036 </row>
1037
1038 <row>
1039 <entry><option>-funbox-strict-fields</option></entry>
1040 <entry>Flatten strict constructor fields</entry>
1041 <entry>dynamic</entry>
1042 <entry><option>-fno-unbox-strict-fields</option></entry>
1043 </row>
1044
1045 <row>
1046 <entry><option>-funfolding-creation-threshold</option></entry>
1047 <entry>Tweak unfolding settings</entry>
1048 <entry>static</entry>
1049 <entry><option>-fno-unfolding-creation-threshold</option></entry>
1050 </row>
1051
1052 <row>
1053 <entry><option>-funfolding-fun-discount</option></entry>
1054 <entry>Tweak unfolding settings</entry>
1055 <entry>static</entry>
1056 <entry><option>-fno-unfolding-fun-discount</option></entry>
1057 </row>
1058
1059 <row>
1060 <entry><option>-funfolding-keeness-factor</option></entry>
1061 <entry>Tweak unfolding settings</entry>
1062 <entry>static</entry>
1063 <entry><option>-fno-unfolding-keeness-factor</option></entry>
1064 </row>
1065
1066 <row>
1067 <entry><option>-funfolding-update-in-place</option></entry>
1068 <entry>Tweak unfolding settings</entry>
1069 <entry>static</entry>
1070 <entry><option>-fno-unfolding-update-in-place</option></entry>
1071 </row>
1072
1073 <row>
1074 <entry><option>-funfolding-use-threshold</option></entry>
1075 <entry>Tweak unfolding settings</entry>
1076 <entry>static</entry>
1077 <entry><option>-fno-unfolding-use-threshold</option></entry>
1078 </row>
1079 </tbody>
1080 </tgroup>
1081 </informaltable>
1082 </sect2>
1083
1084 <sect2>
1085 <title>Profiling options</title>
1086
1087 <para><xref linkend="profiling"/></para>
1088
1089 <informaltable>
1090 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1091 <thead>
1092 <row>
1093 <entry>Flag</entry>
1094 <entry>Description</entry>
1095 <entry>Static/Dynamic</entry>
1096 <entry>Reverse</entry>
1097 </row>
1098 </thead>
1099 <tbody>
1100 <row>
1101 <entry><option>-auto</option></entry>
1102 <entry>Auto-add <literal>_scc_</literal>s to all
1103 exported functions</entry>
1104 <entry>static</entry>
1105 <entry><option>-no-auto</option></entry>
1106 </row>
1107 <row>
1108 <entry><option>-auto-all</option></entry>
1109 <entry>Auto-add <literal>_scc_</literal>s to all
1110 top-level functions</entry>
1111 <entry>static</entry>
1112 <entry><option>-no-auto-all</option></entry>
1113 </row>
1114 <row>
1115 <entry><option>-caf-all</option></entry>
1116 <entry>Auto-add <literal>_scc_</literal>s to all CAFs</entry>
1117 <entry>static</entry>
1118 <entry><option>-no-caf-all</option></entry>
1119 </row>
1120 <row>
1121 <entry><option>-prof</option></entry>
1122 <entry>Turn on profiling</entry>
1123 <entry>static</entry>
1124 <entry>-</entry>
1125 </row>
1126 <row>
1127 <entry><option>-ticky</option></entry>
1128 <entry>Turn on ticky-ticky profiling</entry>
1129 <entry>static</entry>
1130 <entry>-</entry>
1131 </row>
1132 </tbody>
1133 </tgroup>
1134 </informaltable>
1135 </sect2>
1136
1137 <sect2>
1138 <title>Haskell pre-processor options</title>
1139
1140 <para><xref linkend="pre-processor"/></para>
1141
1142 <informaltable>
1143 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1144 <thead>
1145 <row>
1146 <entry>Flag</entry>
1147 <entry>Description</entry>
1148 <entry>Static/Dynamic</entry>
1149 <entry>Reverse</entry>
1150 </row>
1151 </thead>
1152 <tbody>
1153 <row>
1154 <entry><option>-F</option></entry>
1155 <entry>
1156 Enable the use of a pre-processor
1157 (set with <option>-pgmF</option>)
1158 </entry>
1159 <entry>dynamic</entry>
1160 <entry>-</entry>
1161 </row>
1162 </tbody>
1163 </tgroup>
1164 </informaltable>
1165 </sect2>
1166
1167 <sect2>
1168 <title>C pre-processor options</title>
1169
1170 <para><xref linkend="c-pre-processor"/></para>
1171
1172 <informaltable>
1173 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1174 <thead>
1175 <row>
1176 <entry>Flag</entry>
1177 <entry>Description</entry>
1178 <entry>Static/Dynamic</entry>
1179 <entry>Reverse</entry>
1180 </row>
1181 </thead>
1182 <tbody>
1183 <row>
1184 <entry><option>-cpp</option></entry>
1185 <entry>Run the C pre-processor on Haskell source files</entry>
1186 <entry>dynamic</entry>
1187 <entry>-</entry>
1188 </row>
1189 <row>
1190 <entry><option>-D</option><replaceable>symbol</replaceable><optional>=<replaceable>value</replaceable></optional></entry>
1191 <entry>Define a symbol in the C pre-processor</entry>
1192 <entry>dynamic</entry>
1193 <entry><option>-U</option><replaceable>symbol</replaceable></entry>
1194 </row>
1195 <row>
1196 <entry><option>-U</option><replaceable>symbol</replaceable></entry>
1197 <entry>Undefine a symbol in the C pre-processor</entry>
1198 <entry>dynamic</entry>
1199 <entry>-</entry>
1200 </row>
1201 <row>
1202 <entry><option>-I</option><replaceable>dir</replaceable></entry>
1203 <entry>Add <replaceable>dir</replaceable> to the
1204 directory search list for <literal>#include</literal> files</entry>
1205 <entry>dynamic</entry>
1206 <entry>-</entry>
1207 </row>
1208 </tbody>
1209 </tgroup>
1210 </informaltable>
1211 </sect2>
1212
1213 <sect2>
1214 <title>C compiler options</title>
1215
1216 <para><xref linkend="options-C-compiler"/></para>
1217 <informaltable>
1218 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1219 <thead>
1220 <row>
1221 <entry>Flag</entry>
1222 <entry>Description</entry>
1223 <entry>Static/Dynamic</entry>
1224 <entry>Reverse</entry>
1225 </row>
1226 </thead>
1227 <tbody>
1228 <row>
1229 <entry><option>-#include</option> <replaceable>file</replaceable></entry>
1230 <entry>Include <replaceable>file</replaceable> when
1231 compiling the <filename>.hc</filename> file</entry>
1232 <entry>dynamic</entry>
1233 <entry>-</entry>
1234 </row>
1235 </tbody>
1236 </tgroup>
1237 </informaltable>
1238 </sect2>
1239
1240 <sect2>
1241 <title>Code generation options</title>
1242
1243 <para><xref linkend="options-codegen"/></para>
1244
1245 <informaltable>
1246 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1247 <thead>
1248 <row>
1249 <entry>Flag</entry>
1250 <entry>Description</entry>
1251 <entry>Static/Dynamic</entry>
1252 <entry>Reverse</entry>
1253 </row>
1254 </thead>
1255 <tbody>
1256 <row>
1257 <entry><option>-fasm</option></entry>
1258 <entry>Use the native code generator</entry>
1259 <entry>dynamic</entry>
1260 <entry>-fvia-C</entry>
1261 </row>
1262 <row>
1263 <entry><option>-fvia-C</option></entry>
1264 <entry>Compile via C</entry>
1265 <entry>dynamic</entry>
1266 <entry>-fasm</entry>
1267 </row>
1268 <row>
1269 <entry><option>-fno-code</option></entry>
1270 <entry>Omit code generation</entry>
1271 <entry>mode</entry>
1272 <entry>-</entry>
1273 </row>
1274 </tbody>
1275 </tgroup>
1276 </informaltable>
1277 </sect2>
1278
1279 <sect2>
1280 <title>Linking options</title>
1281
1282 <para><xref linkend="options-linker"/></para>
1283
1284 <informaltable>
1285 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1286 <thead>
1287 <row>
1288 <entry>Flag</entry>
1289 <entry>Description</entry>
1290 <entry>Static/Dynamic</entry>
1291 <entry>Reverse</entry>
1292 </row>
1293 </thead>
1294 <tbody>
1295 <row>
1296 <entry><option>-fPIC</option></entry>
1297 <entry>Generate position-independent code (where available)</entry>
1298 <entry>static</entry>
1299 <entry>-</entry>
1300 </row>
1301 <row>
1302 <entry><option>-dynamic</option></entry>
1303 <entry>Use dynamic Haskell libraries (if available)</entry>
1304 <entry>static</entry>
1305 <entry>-</entry>
1306 </row>
1307 <row>
1308 <entry><option>-framework</option> <replaceable>name</replaceable></entry>
1309 <entry>On Darwin/MacOS X only, link in the framework <replaceable>name</replaceable>.
1310 This option corresponds to the <option>-framework</option> option for Apple's Linker.</entry>
1311 <entry>dynamic</entry>
1312 <entry>-</entry>
1313 </row>
1314 <row>
1315 <entry><option>-framework-path</option> <replaceable>name</replaceable></entry>
1316 <entry>On Darwin/MacOS X only, add <replaceable>dir</replaceable> to the list of
1317 directories searched for frameworks.
1318 This option corresponds to the <option>-F</option> option for Apple's Linker.</entry>
1319 <entry>dynamic</entry>
1320 <entry>-</entry>
1321 </row>
1322 <row>
1323 <entry><option>-l</option><replaceable>lib</replaceable></entry>
1324 <entry>Link in library <replaceable>lib</replaceable></entry>
1325 <entry>dynamic</entry>
1326 <entry>-</entry>
1327 </row>
1328 <row>
1329 <entry><option>-L</option><replaceable>dir</replaceable></entry>
1330 <entry>Add <replaceable>dir</replaceable> to the list of
1331 directories searched for libraries</entry>
1332 <entry>dynamic</entry>
1333 <entry>-</entry>
1334 </row>
1335 <row>
1336 <entry><option>-main-is</option></entry>
1337 <entry>Set main module and function</entry>
1338 <entry>dynamic</entry>
1339 <entry>-</entry>
1340 </row>
1341 <row>
1342 <entry><option>--mk-dll</option></entry>
1343 <entry>DLL-creation mode (Windows only)</entry>
1344 <entry>dynamic</entry>
1345 <entry>-</entry>
1346 </row>
1347 <row>
1348 <entry><option>-no-hs-main</option></entry>
1349 <entry>Don't assume this program contains <literal>main</literal></entry>
1350 <entry>dynamic</entry>
1351 <entry>-</entry>
1352 </row>
1353 <row>
1354 <entry><option>-no-link</option></entry>
1355 <entry>Omit linking</entry>
1356 <entry>dynamic</entry>
1357 <entry>-</entry>
1358 </row>
1359 <row>
1360 <entry><option>-split-objs</option></entry>
1361 <entry>Split objects (for libraries)</entry>
1362 <entry>dynamic</entry>
1363 <entry>-</entry>
1364 </row>
1365 <row>
1366 <entry><option>-static</option></entry>
1367 <entry>Use static Haskell libraries</entry>
1368 <entry>static</entry>
1369 <entry>-</entry>
1370 </row>
1371 <row>
1372 <entry><option>-threaded</option></entry>
1373 <entry>Use the threaded runtime</entry>
1374 <entry>static</entry>
1375 <entry>-</entry>
1376 </row>
1377 <row>
1378 <entry><option>-debug</option></entry>
1379 <entry>Use the debugging runtime</entry>
1380 <entry>static</entry>
1381 <entry>-</entry>
1382 </row>
1383 </tbody>
1384 </tgroup>
1385 </informaltable>
1386 </sect2>
1387
1388 <sect2>
1389 <title>Replacing phases</title>
1390
1391 <para><xref linkend="replacing-phases"/></para>
1392
1393 <informaltable>
1394 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1395 <thead>
1396 <row>
1397 <entry>Flag</entry>
1398 <entry>Description</entry>
1399 <entry>Static/Dynamic</entry>
1400 <entry>Reverse</entry>
1401 </row>
1402 </thead>
1403 <tbody>
1404 <row>
1405 <entry><option>-pgmL</option> <replaceable>cmd</replaceable></entry>
1406 <entry>Use <replaceable>cmd</replaceable> as the literate pre-processor</entry>
1407 <entry>dynamic</entry>
1408 <entry>-</entry>
1409 </row>
1410 <row>
1411 <entry><option>-pgmP</option> <replaceable>cmd</replaceable></entry>
1412 <entry>Use <replaceable>cmd</replaceable> as the C
1413 pre-processor (with <option>-cpp</option> only)</entry>
1414 <entry>dynamic</entry>
1415 <entry>-</entry>
1416 </row>
1417 <row>
1418 <entry><option>-pgmc</option> <replaceable>cmd</replaceable></entry>
1419 <entry>Use <replaceable>cmd</replaceable> as the C compiler</entry>
1420 <entry>dynamic</entry>
1421 <entry>-</entry>
1422 </row>
1423 <row>
1424 <entry><option>-pgmm</option> <replaceable>cmd</replaceable></entry>
1425 <entry>Use <replaceable>cmd</replaceable> as the mangler</entry>
1426 <entry>dynamic</entry>
1427 <entry>-</entry>
1428 </row>
1429 <row>
1430 <entry><option>-pgms</option> <replaceable>cmd</replaceable></entry>
1431 <entry>Use <replaceable>cmd</replaceable> as the splitter</entry>
1432 <entry>dynamic</entry>
1433 <entry>-</entry>
1434 </row>
1435 <row>
1436 <entry><option>-pgma</option> <replaceable>cmd</replaceable></entry>
1437 <entry>Use <replaceable>cmd</replaceable> as the assembler</entry>
1438 <entry>dynamic</entry>
1439 <entry>-</entry>
1440 </row>
1441 <row>
1442 <entry><option>-pgml</option> <replaceable>cmd</replaceable></entry>
1443 <entry>Use <replaceable>cmd</replaceable> as the linker</entry>
1444 <entry>dynamic</entry>
1445 <entry>-</entry>
1446 </row>
1447 <row>
1448 <entry><option>-pgmdll</option> <replaceable>cmd</replaceable></entry>
1449 <entry>Use <replaceable>cmd</replaceable> as the DLL generator</entry>
1450 <entry>dynamic</entry>
1451 <entry>-</entry>
1452 </row>
1453 <row>
1454 <entry><option>-pgmF</option> <replaceable>cmd</replaceable></entry>
1455 <entry>Use <replaceable>cmd</replaceable> as the pre-processor
1456 (with <option>-F</option> only)</entry>
1457 <entry>dynamic</entry>
1458 <entry>-</entry>
1459 </row>
1460 </tbody>
1461 </tgroup>
1462 </informaltable>
1463 <indexterm><primary><option>-pgmL</option></primary></indexterm>
1464 <indexterm><primary><option>-pgmP</option></primary></indexterm>
1465 <indexterm><primary><option>-pgmc</option></primary></indexterm>
1466 <indexterm><primary><option>-pgma</option></primary></indexterm>
1467 <indexterm><primary><option>-pgml</option></primary></indexterm>
1468 <indexterm><primary><option>-pgmdll</option></primary></indexterm>
1469 <indexterm><primary><option>-pgmF</option></primary></indexterm>
1470
1471 </sect2>
1472
1473 <sect2>
1474 <title>Forcing options to particular phases</title>
1475
1476 <para><xref linkend="forcing-options-through"/></para>
1477
1478 <informaltable>
1479 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1480 <thead>
1481 <row>
1482 <entry>Flag</entry>
1483 <entry>Description</entry>
1484 <entry>Static/Dynamic</entry>
1485 <entry>Reverse</entry>
1486 </row>
1487 </thead>
1488 <tbody>
1489 <row>
1490 <entry><option>-optL</option> <replaceable>option</replaceable></entry>
1491 <entry>pass <replaceable>option</replaceable> to the literate pre-processor</entry>
1492 <entry>dynamic</entry>
1493 <entry>-</entry>
1494 </row>
1495 <row>
1496 <entry><option>-optP</option> <replaceable>option</replaceable></entry>
1497 <entry>pass <replaceable>option</replaceable> to cpp (with
1498 <option>-cpp</option> only)</entry>
1499 <entry>dynamic</entry>
1500 <entry>-</entry>
1501 </row>
1502 <row>
1503 <entry><option>-optF</option> <replaceable>option</replaceable></entry>
1504 <entry>pass <replaceable>option</replaceable> to the
1505 custom pre-processor</entry>
1506 <entry>dynamic</entry>
1507 <entry>-</entry>
1508 </row>
1509 <row>
1510 <entry><option>-optc</option> <replaceable>option</replaceable></entry>
1511 <entry>pass <replaceable>option</replaceable> to the C compiler</entry>
1512 <entry>dynamic</entry>
1513 <entry>-</entry>
1514 </row>
1515 <row>
1516 <entry><option>-optm</option> <replaceable>option</replaceable></entry>
1517 <entry>pass <replaceable>option</replaceable> to the mangler</entry>
1518 <entry>dynamic</entry>
1519 <entry>-</entry>
1520 </row>
1521 <row>
1522 <entry><option>-opta</option> <replaceable>option</replaceable></entry>
1523 <entry>pass <replaceable>option</replaceable> to the assembler</entry>
1524 <entry>dynamic</entry>
1525 <entry>-</entry>
1526 </row>
1527 <row>
1528 <entry><option>-optl</option> <replaceable>option</replaceable></entry>
1529 <entry>pass <replaceable>option</replaceable> to the linker</entry>
1530 <entry>dynamic</entry>
1531 <entry>-</entry>
1532 </row>
1533 <row>
1534 <entry><option>-optdll</option> <replaceable>option</replaceable></entry>
1535 <entry>pass <replaceable>option</replaceable> to the DLL generator</entry>
1536 <entry>dynamic</entry>
1537 <entry>-</entry>
1538 </row>
1539 <row>
1540 <entry><option>-optdep</option> <replaceable>option</replaceable></entry>
1541 <entry>pass <replaceable>option</replaceable> to the dependency generator</entry>
1542 <entry>dynamic</entry>
1543 <entry>-</entry>
1544 </row>
1545 </tbody>
1546 </tgroup>
1547 </informaltable>
1548 </sect2>
1549
1550 <sect2>
1551 <title>Platform-specific options</title>
1552
1553 <para><xref linkend="options-platform"/></para>
1554
1555 <informaltable>
1556 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1557 <thead>
1558 <row>
1559 <entry>Flag</entry>
1560 <entry>Description</entry>
1561 <entry>Static/Dynamic</entry>
1562 <entry>Reverse</entry>
1563 </row>
1564 </thead>
1565 <tbody>
1566 <row>
1567 <entry><option>-monly-[432]-regs</option></entry>
1568 <entry>(x86 only) give some registers back to the C compiler</entry>
1569 <entry>dynamic</entry>
1570 <entry>-</entry>
1571 </row>
1572 </tbody>
1573 </tgroup>
1574 </informaltable>
1575 </sect2>
1576
1577
1578 <sect2>
1579 <title>External core file options</title>
1580
1581 <para><xref linkend="ext-core"/></para>
1582
1583 <informaltable>
1584 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1585 <thead>
1586 <row>
1587 <entry>Flag</entry>
1588 <entry>Description</entry>
1589 <entry>Static/Dynamic</entry>
1590 <entry>Reverse</entry>
1591 </row>
1592 </thead>
1593 <tbody>
1594 <row>
1595 <entry><option>-fext-core</option></entry>
1596 <entry>Generate <filename>.hcr</filename> external Core files</entry>
1597 <entry>static</entry>
1598 <entry>-</entry>
1599 </row>
1600 </tbody>
1601 </tgroup>
1602 </informaltable>
1603 </sect2>
1604
1605
1606 <sect2>
1607 <title>Compiler debugging options</title>
1608
1609 <para><xref linkend="options-debugging"/></para>
1610
1611 <informaltable>
1612 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1613 <thead>
1614 <row>
1615 <entry>Flag</entry>
1616 <entry>Description</entry>
1617 <entry>Static/Dynamic</entry>
1618 <entry>Reverse</entry>
1619 </row>
1620 </thead>
1621 <tbody>
1622 <row>
1623 <entry><option>-dcore-lint</option></entry>
1624 <entry>Turn on internal sanity checking</entry>
1625 <entry>dynamic</entry>
1626 <entry>-</entry>
1627 </row>
1628 <row>
1629 <entry><option>-ddump-asm</option></entry>
1630 <entry>Dump assembly</entry>
1631 <entry>dynamic</entry>
1632 <entry>-</entry>
1633 </row>
1634 <row>
1635 <entry><option>-ddump-bcos</option></entry>
1636 <entry>Dump interpreter byte code</entry>
1637 <entry>dynamic</entry>
1638 <entry>-</entry>
1639 </row>
1640 <row>
1641 <entry><option>-ddump-cmm</option></entry>
1642 <entry>Dump C-- output</entry>
1643 <entry>dynamic</entry>
1644 <entry>-</entry>
1645 </row>
1646 <row>
1647 <entry><option>-ddump-cpranal</option></entry>
1648 <entry>Dump output from CPR analysis</entry>
1649 <entry>dynamic</entry>
1650 <entry>-</entry>
1651 </row>
1652 <row>
1653 <entry><option>-ddump-cse</option></entry>
1654 <entry>Dump CSE output</entry>
1655 <entry>dynamic</entry>
1656 <entry>-</entry>
1657 </row>
1658 <row>
1659 <entry><option>-ddump-deriv</option></entry>
1660 <entry>Dump deriving output</entry>
1661 <entry>dynamic</entry>
1662 <entry>-</entry>
1663 </row>
1664 <row>
1665 <entry><option>-ddump-ds</option></entry>
1666 <entry>Dump desugarer output</entry>
1667 <entry>dynamic</entry>
1668 <entry>-</entry>
1669 </row>
1670 <row>
1671 <entry><option>-ddump-flatC</option></entry>
1672 <entry>Dump &ldquo;flat&rdquo; C</entry>
1673 <entry>dynamic</entry>
1674 <entry>-</entry>
1675 </row>
1676 <row>
1677 <entry><option>-ddump-foreign</option></entry>
1678 <entry>Dump <literal>foreign export</literal> stubs</entry>
1679 <entry>dynamic</entry>
1680 <entry>-</entry>
1681 </row>
1682 <row>
1683 <entry><option>-ddump-inlinings</option></entry>
1684 <entry>Dump inlining info</entry>
1685 <entry>dynamic</entry>
1686 <entry>-</entry>
1687 </row>
1688 <row>
1689 <entry><option>-ddump-occur-anal</option></entry>
1690 <entry>Dump occurrence analysis output</entry>
1691 <entry>dynamic</entry>
1692 <entry>-</entry>
1693 </row>
1694 <row>
1695 <entry><option>-ddump-opt-cmm</option></entry>
1696 <entry>Dump the results of C-- to C-- optimising passes</entry>
1697 <entry>dynamic</entry>
1698 <entry>-</entry>
1699 </row>
1700 <row>
1701 <entry><option>-ddump-parsed</option></entry>
1702 <entry>Dump parse tree</entry>
1703 <entry>dynamic</entry>
1704 <entry>-</entry>
1705 </row>
1706 <row>
1707 <entry><option>-ddump-prep</option></entry>
1708 <entry>Dump prepared core</entry>
1709 <entry>dynamic</entry>
1710 <entry>-</entry>
1711 </row>
1712 <row>
1713 <entry><option>-ddump-rn</option></entry>
1714 <entry>Dump renamer output</entry>
1715 <entry>dynamic</entry>
1716 <entry>-</entry>
1717 </row>
1718 <row>
1719 <entry><option>-ddump-rules</option></entry>
1720 <entry>Dump rules</entry>
1721 <entry>dynamic</entry>
1722 <entry>-</entry>
1723 </row>
1724 <row>
1725 <entry><option>-ddump-simpl</option></entry>
1726 <entry>Dump final simplifier output</entry>
1727 <entry>dynamic</entry>
1728 <entry>-</entry>
1729 </row>
1730 <row>
1731 <entry><option>-ddump-simpl-iterations</option></entry>
1732 <entry>Dump output from each simplifier iteration</entry>
1733 <entry>dynamic</entry>
1734 <entry>-</entry>
1735 </row>
1736 <row>
1737 <entry><option>-ddump-spec</option></entry>
1738 <entry>Dump specialiser output</entry>
1739 <entry>dynamic</entry>
1740 <entry>-</entry>
1741 </row>
1742 <row>
1743 <entry><option>-ddump-splices</option></entry>
1744 <entry>Dump TH splided expressions, and what they evaluate to</entry>
1745 <entry>dynamic</entry>
1746 <entry>-</entry>
1747 </row>
1748 <row>
1749 <entry><option>-ddump-stg</option></entry>
1750 <entry>Dump final STG</entry>
1751 <entry>dynamic</entry>
1752 <entry>-</entry>
1753 </row>
1754 <row>
1755 <entry><option>-ddump-stranal</option></entry>
1756 <entry>Dump strictness analyser output</entry>
1757 <entry>dynamic</entry>
1758 <entry>-</entry>
1759 </row>
1760 <row>
1761 <entry><option>-ddump-tc</option></entry>
1762 <entry>Dump typechecker output</entry>
1763 <entry>dynamic</entry>
1764 <entry>-</entry>
1765 </row>
1766 <row>
1767 <entry><option>-ddump-types</option></entry>
1768 <entry>Dump type signatures</entry>
1769 <entry>dynamic</entry>
1770 <entry>-</entry>
1771 </row>
1772 <row>
1773 <entry><option>-ddump-worker-wrapper</option></entry>
1774 <entry>Dump worker-wrapper output</entry>
1775 <entry>dynamic</entry>
1776 <entry>-</entry>
1777 </row>
1778 <row>
1779 <entry><option>-ddump-if-trace</option></entry>
1780 <entry>Trace interface files</entry>
1781 <entry>dynamic</entry>
1782 <entry>-</entry>
1783 </row>
1784 <row>
1785 <entry><option>-ddump-tc-trace</option></entry>
1786 <entry>Trace typechecker</entry>
1787 <entry>dynamic</entry>
1788 <entry>-</entry>
1789 </row>
1790 <row>
1791 <entry><option>-ddump-rn-trace</option></entry>
1792 <entry>Trace renamer</entry>
1793 <entry>dynamic</entry>
1794 <entry>-</entry>
1795 </row>
1796 <row>
1797 <entry><option>-ddump-rn-stats</option></entry>
1798 <entry>Renamer stats</entry>
1799 <entry>dynamic</entry>
1800 <entry>-</entry>
1801 </row>
1802 <row>
1803 <entry><option>-ddump-simpl-stats</option></entry>
1804 <entry>Dump simplifier stats</entry>
1805 <entry>dynamic</entry>
1806 <entry>-</entry>
1807 </row>
1808 <row>
1809 <entry><option>-dppr-debug</option></entry>
1810 <entry>Turn on debug printing (more verbose)</entry>
1811 <entry>static</entry>
1812 <entry>-</entry>
1813 </row>
1814 <row>
1815 <entry><option>-dppr-noprags</option></entry>
1816 <entry>Don't output pragma info in dumps</entry>
1817 <entry>static</entry>
1818 <entry>-</entry>
1819 </row>
1820 <row>
1821 <entry><option>-dppr-user-length</option></entry>
1822 <entry>Set the depth for printing expressions in error msgs</entry>
1823 <entry>static</entry>
1824 <entry>-</entry>
1825 </row>
1826 <row>
1827 <entry><option>-dsource-stats</option></entry>
1828 <entry>Dump haskell source stats</entry>
1829 <entry>dynamic</entry>
1830 <entry>-</entry>
1831 </row>
1832 <row>
1833 <entry><option>-dcmm-lint</option></entry>
1834 <entry>C-- pass sanity checking</entry>
1835 <entry>dynamic</entry>
1836 <entry>-</entry>
1837 </row>
1838 <row>
1839 <entry><option>-dstg-lint</option></entry>
1840 <entry>STG pass sanity checking</entry>
1841 <entry>dynamic</entry>
1842 <entry>-</entry>
1843 </row>
1844 <row>
1845 <entry><option>-dstg-stats</option></entry>
1846 <entry>Dump STG stats</entry>
1847 <entry>dynamic</entry>
1848 <entry>-</entry>
1849 </row>
1850 <row>
1851 <entry><option>-dverbose-core2core</option></entry>
1852 <entry>Show output from each core-to-core pass</entry>
1853 <entry>dynamic</entry>
1854 <entry>-</entry>
1855 </row>
1856 <row>
1857 <entry><option>-dverbose-stg2stg</option></entry>
1858 <entry>Show output from each STG-to-STG pass</entry>
1859 <entry>dynamic</entry>
1860 <entry>-</entry>
1861 </row>
1862 <row>
1863 <entry><option>-dshow-passes</option></entry>
1864 <entry>Print out each pass name as it happens</entry>
1865 <entry>dynamic</entry>
1866 <entry>-</entry>
1867 </row>
1868 <row>
1869 <entry><option>-dfaststring-stats</option></entry>
1870 <entry>Show statistics for fast string usage when finished</entry>
1871 <entry>dynamic</entry>
1872 <entry>-</entry>
1873 </row>
1874 <row>
1875 <entry><option>-unreg</option></entry>
1876 <entry>Enable unregisterised compilation</entry>
1877 <entry>static</entry>
1878 <entry>-</entry>
1879 </row>
1880 </tbody>
1881 </tgroup>
1882 </informaltable>
1883 </sect2>
1884
1885 <sect2>
1886 <title>Misc compiler options</title>
1887
1888 <informaltable>
1889 <tgroup cols="4" align="left" colsep="1" rowsep="1">
1890 <thead>
1891 <row>
1892 <entry>Flag</entry>
1893 <entry>Description</entry>
1894 <entry>Static/Dynamic</entry>
1895 <entry>Reverse</entry>
1896 </row>
1897 </thead>
1898 <tbody>
1899 <row>
1900 <entry><option>-fno-hi-version-check</option></entry>
1901 <entry>Don't complain about <literal>.hi</literal> file mismatches</entry>
1902 <entry>static</entry>
1903 <entry>-</entry>
1904 </row>
1905 <row>
1906 <entry><option>-dno-black-holing</option></entry>
1907 <entry>Turn off black holing (probably doesn't work)</entry>
1908 <entry>static</entry>
1909 <entry>-</entry>
1910 </row>
1911 <row>
1912 <entry><option>-fno-method-sharing</option></entry>
1913 <entry>Don't share specialisations of overloaded functions</entry>
1914 <entry>static</entry>
1915 <entry>-</entry>
1916 </row>
1917 <row>
1918 <entry><option>-fhistory-size</option></entry>
1919 <entry>Set simplification history size</entry>
1920 <entry>static</entry>
1921 <entry>-</entry>
1922 </row>
1923 <row>
1924 <entry><option>-funregisterised</option></entry>
1925 <entry>Unregisterised compilation (use <option>-unreg</option> instead)</entry>
1926 <entry>static</entry>
1927 <entry>-</entry>
1928 </row>
1929 <row>
1930 <entry><option>-fno-asm-mangling</option></entry>
1931 <entry>Turn off assembly mangling (use <option>-unreg</option> instead)</entry>
1932 <entry>dynamic</entry>
1933 <entry>-</entry>
1934 </row>
1935 <row>
1936 <entry><option>-fno-print-bind-result</option></entry>
1937 <entry><link linkend="ghci-stmts">Turn off printing of binding results in GHCi</link></entry>
1938 <entry>dynamic</entry>
1939 <entry>-</entry>
1940 </row>
1941 </tbody>
1942 </tgroup>
1943 </informaltable>
1944 </sect2>
1945 </sect1>
1946
1947
1948 <!--
1949 Still to document:
1950
1951 Misc:
1952 , ( "H" , HasArg (setHeapSize . fromIntegral . decodeSize) )
1953
1954 -Bdir
1955 -->
1956
1957 <!-- Emacs stuff:
1958 ;;; Local Variables: ***
1959 ;;; mode: xml ***
1960 ;;; sgml-parent-document: ("users_guide.xml" "book" "chapter") ***
1961 ;;; End: ***
1962 -->