X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=ghc%2Fdocs%2Fusers_guide%2Fflags.xml;h=e288da2fb24ff3ac5c621bfed00713ae1c2505b7;hb=206710baa90ffb7ff3541f76ec2d5daf5e3a47e5;hp=bd4d831dd4cad29ebf1f1f6fdc6d03605842fe54;hpb=e29e49947a1b09ba7a3d1de6c58e7d8ef33674cb;p=ghc-hetmet.git diff --git a/ghc/docs/users_guide/flags.xml b/ghc/docs/users_guide/flags.xml index bd4d831..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,25 +50,25 @@ display GHC version - static + mode - display GHC version - static + mode - display GHC version (numeric only) - static + mode - display GHC library directory - static + mode - @@ -75,16 +77,24 @@ static - + + + Summarise timing stats for GHC (same as +RTS -tstderr) + static + - + - Which phases to run (<xref linkend="options-order"/>) + Which phases to run + + - + Flag @@ -97,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 - @@ -124,10 +140,12 @@ - Alternative modes of operation (<xref linkend="modes"/>) + Alternative modes of operation + + - + Flag @@ -140,31 +158,25 @@ Interactive mode - normally used by just running ghci - static + mode - Build a multi-module Haskell program, automatically figuring out dependencies. Likely to be much easier, and faster, than using make. - static + mode - Evaluate expr - static + mode - Generate dependency information suitable for use in a Makefile. - static - - - - - - DLL-creation mode (Windows only) - static + mode - @@ -173,10 +185,12 @@ - Redirecting output (<xref linkend="options-output"/>) + Redirecting output + + - + Flag @@ -189,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 - @@ -234,10 +254,12 @@ - Keeping intermediate files (<xref linkend="keeping-intermediates"/>) + Keeping intermediate files + + - + Flag @@ -250,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 - @@ -277,10 +299,12 @@ - Temporary files (<xref linkend="temp-files"/>) + Temporary files + + - + Flag @@ -293,7 +317,7 @@ set the directory for temporary files - static + dynamic - @@ -302,10 +326,12 @@ - Finding imports (<xref linkend="search-path"/>) + Finding imports + + - + Flag @@ -320,13 +346,13 @@ dir1:dir2:... add dir, dir2, etc. to import path - static + dynamic - Empty the import directory list - static + dynamic - @@ -335,10 +361,12 @@ - Interface file options (<xref linkend="hi-options"/>) + Interface file options + + - + Flag @@ -372,7 +400,7 @@ Read the interface in file and dump it as text to stdout. - static + mode - @@ -381,10 +409,12 @@ - Recompilation checking (<xref linkend="recomp"/>) + Recompilation checking + + - + Flag @@ -397,8 +427,9 @@ - Turn off recompilation checking - static + Turn off recompilation checking; implied by any + option + dynamic @@ -407,10 +438,12 @@ - Interactive-mode options (<xref linkend="ghci-dot-files"/>) + Interactive-mode options + + - + Flag @@ -438,9 +471,12 @@ - Packages (<xref linkend="packages"/>) + Packages + + + - + Flag @@ -451,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 - @@ -474,10 +528,12 @@ - Language options (<xref linkend="options-language"/>) + Language options + + - + Flag @@ -501,7 +557,8 @@ - Enable incoherent instances + Enable incoherent instances. + Implies dynamic @@ -537,12 +594,6 @@ - - Ignore assertions - dynamic - - - Enable Implicit Parameters. Implied by . @@ -587,10 +638,12 @@ - Warnings (<xref linkend="options-sanity"/>) + Warnings + ( + - + Flag @@ -752,10 +805,12 @@ - Optimisation levels (<xref linkend="options-optimise"/>) + Optimisation levels + + - + Flag @@ -783,10 +838,12 @@ - Individual optimisations (<xref linkend="options-f"/>) + Individual optimisations + + - + Flag @@ -827,7 +884,7 @@ Enable excess intermediate precision - static + dynamic @@ -842,14 +899,14 @@ Ignore assertions in the source - static + dynamic Ignore pragmas in interface files - static + dynamic @@ -891,13 +948,6 @@ - - Turn off CPR analysis - static - -fcpr - - - Turn off common sub-expression dynamic @@ -906,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 @@ -926,13 +976,6 @@ - - Make numbers strict - dynamic - - - - Flatten strict constructor fields dynamic @@ -979,10 +1022,12 @@ - Profiling options (<xref linkend="profiling"/>) + Profiling options + + - + Flag @@ -1036,10 +1081,12 @@ - Parallelism options (<xref linkend="sec-using-parallel"/>) + Parallelism options + + - + Flag @@ -1073,10 +1120,12 @@ - C pre-processor options (<xref linkend="c-pre-processor"/>) + C pre-processor options + + - + Flag @@ -1108,7 +1157,7 @@ dir Add dir to the directory search list for #include files - static + dynamic - @@ -1117,9 +1166,11 @@ - C compiler options (<xref linkend="options-C-compiler"/>) + C compiler options + + - + Flag @@ -1142,10 +1193,12 @@ - Code generation options (<xref linkend="options-codegen"/>) + Code generation options + + - + Flag @@ -1170,7 +1223,7 @@ Omit code generation - static + mode - @@ -1179,10 +1232,12 @@ - Linking options (<xref linkend="options-linker"/>) + Linking options + + - + Flag @@ -1202,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 - @@ -1210,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 assume this program contains main - static + dynamic - Omit linking - static + dynamic - name Link in package name - static + dynamic - Split objects (for libraries) - static + dynamic - @@ -1280,10 +1341,12 @@ - Replacing phases (<xref linkend="replacing-phases"/>) + Replacing phases + + - + Flag @@ -1296,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 - @@ -1357,10 +1421,12 @@ - Forcing options to particular phases (<xref linkend="forcing-options-through"/>) + Forcing options to particular phases + + - + Flag @@ -1405,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 - @@ -1426,10 +1492,12 @@ - Platform-specific options (<xref linkend="options-platform"/>) + Platform-specific options + + - + Flag @@ -1458,10 +1526,12 @@ - External core file options (<xref linkend="ext-core"/>) + External core file options + + - + Flag @@ -1481,13 +1551,15 @@ - + - Compiler debugging options (<xref linkend="options-debugging"/>) + Compiler debugging options + + - + Flag @@ -1746,7 +1818,7 @@ Misc compiler options - + Flag @@ -1763,12 +1835,6 @@ - - - Make all top-level names global (for ) - static - - - - Don't complain about .hi file mismatches static @@ -1787,12 +1853,6 @@ - - - Renamer: don't prune declarations - static - - - - Set simplification history size static @@ -1807,7 +1867,7 @@ Turn off assembly mangling (use instead) - static + dynamic - @@ -1822,7 +1882,6 @@ Still to document: Misc: , ( "H" , HasArg (setHeapSize . fromIntegral . decodeSize) ) - , ( "Rghc-timing" , NoArg (enableTimingStats) ) -Bdir -->