X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=ghc%2Fdocs%2Fusers_guide%2Fflags.xml;h=e288da2fb24ff3ac5c621bfed00713ae1c2505b7;hb=206710baa90ffb7ff3541f76ec2d5daf5e3a47e5;hp=895e993a4a54be8fda6901babffac3d2ef8840f7;hpb=b9de29ac3fbf5192049a0bcaf1ab0c8bbbd57a83;p=ghc-hetmet.git diff --git a/ghc/docs/users_guide/flags.xml b/ghc/docs/users_guide/flags.xml index 895e993..e288da2 100644 --- a/ghc/docs/users_guide/flags.xml +++ b/ghc/docs/users_guide/flags.xml @@ -8,10 +8,12 @@ (if available). - Help and verbosity options (<xref linkend="options-help"/>) + Help and verbosity options + + - + Flag @@ -24,13 +26,13 @@ help - static + mode - help - static + mode - @@ -48,24 +50,36 @@ display GHC version - static + mode - display GHC version - static + mode - display GHC version (numeric only) - static + mode - display GHC library directory + mode + - + + + + output full span in error messages + static + - + + + + Summarise timing stats for GHC (same as +RTS -tstderr) static - @@ -75,10 +89,12 @@ - Which phases to run (<xref linkend="options-order"/>) + Which phases to run + + - + Flag @@ -91,24 +107,30 @@ Stop after preprocessing (.hspp file) - static + mode - Stop after generating C (.hc file) - static + mode - Stop after generating assembly (.s file) - static + mode - - Stop after compiling to object code (.o file) + Do not link + dynamic + - + + + suffix + Override default behaviour for source files static - @@ -117,11 +139,58 @@ + + Alternative modes of operation + + + + + + + + Flag + Description + Static/Dynamic + Reverse + + + + + + Interactive mode - normally used by just running ghci + mode + - + + + + Build a multi-module Haskell program, automatically figuring out dependencies. Likely to be much easier, and faster, than using make. + mode + - + + + + Evaluate expr + mode + - + + + + Generate dependency information suitable for use in a Makefile. + mode + - + + + + + + - Redirecting output (<xref linkend="options-output"/>) + Redirecting output + + - + Flag @@ -134,43 +203,49 @@ suffix set the suffix to use for intermediate C files - static + dynamic - dir set directory for interface files - static + dynamic - suffix set the suffix to use for interface files - static + dynamic - filename set output filename - static + dynamic - dir set output directory - static + dynamic - filename set the filename in which to put the interface - static + dynamic suffix set the output file suffix - static + dynamic + - + + + dir + redirect FFi stub files + dynamic - @@ -179,10 +254,12 @@ - Keeping intermediate files (<xref linkend="keeping-intermediates"/>) + Keeping intermediate files + + - + Flag @@ -195,25 +272,25 @@ retain intermediate .hc files - static + dynamic - retain intermediate .s files - static + dynamic - retain intermediate .raw_s files - static + dynamic - retain all intermediate temporary files - static + dynamic - @@ -222,10 +299,12 @@ - Temporary files (<xref linkend="temp-files"/>) + Temporary files + + - + Flag @@ -238,7 +317,7 @@ set the directory for temporary files - static + dynamic - @@ -247,10 +326,12 @@ - Finding imports (<xref linkend="search-path"/>) + Finding imports + + - + Flag @@ -265,13 +346,13 @@ dir1:dir2:... add dir, dir2, etc. to import path - static + dynamic - Empty the import directory list - static + dynamic - @@ -280,10 +361,12 @@ - Interface file options (<xref linkend="hi-options"/>) + Interface file options + + - + Flag @@ -317,7 +400,7 @@ Read the interface in file and dump it as text to stdout. - static + mode - @@ -326,10 +409,12 @@ - Recompilation checking (<xref linkend="recomp"/>) + Recompilation checking + + - + Flag @@ -342,8 +427,9 @@ - Turn off recompilation checking - static + Turn off recompilation checking; implied by any + option + dynamic @@ -352,10 +438,12 @@ - Interactive-mode options (<xref linkend="ghci-dot-files"/>) + Interactive-mode options + + - + Flag @@ -383,9 +471,12 @@ - Packages (<xref linkend="packages"/>) + Packages + + + - + Flag @@ -396,21 +487,39 @@ - name - Use package name + P + Expose package P + dynamic + - + + + + Hide all packages by default static - + name + Hide package P + dynamic + - + + + name + Ignore package P + dynamic + - + + file Load more packages from file - static + dynamic - - name - Compile code for package name - static + + Don't load the user's package config file. + dynamic - @@ -419,10 +528,12 @@ - Language options (<xref linkend="options-language"/>) + Language options + + - + Flag @@ -439,18 +550,25 @@ - - Enable arrow notation extension - dynamic - - - Enable undecidable instances dynamic + + Enable incoherent instances. + Implies + dynamic + + + + + Enable arrow notation extension + dynamic + + + n set the limit for context reduction static @@ -476,14 +594,9 @@ - - Ignore assertions - dynamic - - - - Enable Implicit Parameters + Enable Implicit Parameters. + Implied by . dynamic @@ -497,17 +610,25 @@ Don't implicitly import Prelude dynamic - - + Disable the monomorphism restriction dynamic - + + + + + Enable lexically-scoped type variables. + Implied by . + dynamic + - Enable Template Haskell + Enable Template Haskell. + Implied by . dynamic @@ -517,10 +638,12 @@ - Warnings (<xref linkend="options-sanity"/>) + Warnings + ( + - + Flag @@ -585,6 +708,13 @@ + + warn when a record update could fail + dynamic + + + + enable miscellaneous warnings dynamic @@ -620,6 +750,14 @@ + + warn when the module contains "orphan" instance declarations + or rewrite rules + dynamic + + + + warn about overlapping patterns dynamic @@ -667,10 +805,12 @@ - Optimisation levels (<xref linkend="options-optimise"/>) + Optimisation levels + + - + Flag @@ -698,10 +838,12 @@ - Individual optimisations (<xref linkend="options-f"/>) + Individual optimisations + + - + Flag @@ -742,7 +884,7 @@ Enable excess intermediate precision - static + dynamic @@ -757,14 +899,14 @@ Ignore assertions in the source - static + dynamic Ignore pragmas in interface files - static + dynamic @@ -806,13 +948,6 @@ - - Turn off CPR analysis - static - -fcpr - - - Turn off common sub-expression dynamic @@ -821,7 +956,7 @@ - Turn off full laziness (floating bindings outwards). It is on by default. + Turn off full laziness (floating bindings outwards). dynamic -ffull-laziness @@ -841,13 +976,6 @@ - - Make numbers strict - dynamic - - - - Flatten strict constructor fields dynamic @@ -894,10 +1022,12 @@ - Profiling options (<xref linkend="profiling"/>) + Profiling options + + - + Flag @@ -951,10 +1081,12 @@ - Parallelism options (<xref linkend="sec-using-parallel"/>) + Parallelism options + + - + Flag @@ -988,10 +1120,12 @@ - C pre-processor options (<xref linkend="c-pre-processor"/>) + C pre-processor options + + - + Flag @@ -1023,7 +1157,7 @@ dir Add dir to the directory search list for #include files - static + dynamic - @@ -1032,9 +1166,11 @@ - C compiler options (<xref linkend="options-C-compiler"/>) + C compiler options + + - + Flag @@ -1057,10 +1193,12 @@ - Code generation options (<xref linkend="options-codegen"/>) + Code generation options + + - + Flag @@ -1085,7 +1223,7 @@ Omit code generation - static + mode - @@ -1094,10 +1232,12 @@ - Linking options (<xref linkend="options-linker"/>) + Linking options + + - + Flag @@ -1117,7 +1257,7 @@ name On Darwin/MacOS X only, link in the framework name. This option corresponds to the option for Apple's Linker. - static + dynamic - @@ -1125,50 +1265,56 @@ On Darwin/MacOS X only, add dir to the list of directories searched for frameworks. This option corresponds to the option for Apple's Linker. - static + dynamic - lib Link in library lib - static + dynamic - dir Add dir to the list of directories searched for libraries - static + dynamic - Set main function - static + dynamic + - + + + + DLL-creation mode (Windows only) + dynamic - - Don't asssume this program contains main - static + Don't assume this program contains main + dynamic - Omit linking - static + dynamic - name Link in package name - static + dynamic - Split objects (for libraries) - static + dynamic - @@ -1195,10 +1341,12 @@ - Replacing phases (<xref linkend="replacing-phases"/>) + Replacing phases + + - + Flag @@ -1211,50 +1359,51 @@ cmd Use cmd as the literate pre-processor - static + dynamic - cmd Use cmd as the C pre-processor (with only) - static - + dynamic + - cmd Use cmd as the C compiler - static + dynamic - cmd Use cmd as the assembler - static + dynamic - cmd Use cmd as the linker - static + dynamic - cmd Use cmd as the DLL generator - static + dynamic - cmd Use cmd as the dependency generator - static + dyanmic - cmd Use cmd as the pre-processor (with only) - static + dynamic - @@ -1272,10 +1421,12 @@ - Forcing options to particular phases (<xref linkend="forcing-options-through"/>) + Forcing options to particular phases + + - + Flag @@ -1320,19 +1471,19 @@ option pass option to the linker - static + dynamic - option pass option to the DLL generator - static + dynamic - option pass option to the dependency generator - static + dynamic - @@ -1341,10 +1492,12 @@ - Platform-specific options (<xref linkend="options-platform"/>) + Platform-specific options + + - + Flag @@ -1373,10 +1526,12 @@ - External core file options (<xref linkend="ext-core"/>) + External core file options + + - + Flag @@ -1396,13 +1551,15 @@ - + - Compiler debugging options (<xref linkend="options-debugging"/>) + Compiler debugging options + + - + Flag @@ -1661,7 +1818,7 @@ Misc compiler options - + Flag @@ -1678,12 +1835,6 @@ - - - Make all top-level names global (for ) - static - - - - Don't complain about .hi file mismatches static @@ -1702,12 +1853,6 @@ - - - Renamer: don't prune declarations - static - - - - Set simplification history size static @@ -1722,7 +1867,7 @@ Turn off assembly mangling (use instead) - static + dynamic - @@ -1737,7 +1882,6 @@ Still to document: Misc: , ( "H" , HasArg (setHeapSize . fromIntegral . decodeSize) ) - , ( "Rghc-timing" , NoArg (enableTimingStats) ) -Bdir -->