X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=ghc%2Fdocs%2Fusers_guide%2Fflags.xml;h=0dde52e317a358f24cc654b95a1fb057c97c740d;hb=2a2efb720c0fdc06fe749f96f284b00b30f8f3f7;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..0dde52e 100644 --- a/ghc/docs/users_guide/flags.xml +++ b/ghc/docs/users_guide/flags.xml @@ -8,7 +8,9 @@ (if available). - Help and verbosity options (<xref linkend="options-help"/>) + Help and verbosity options + + @@ -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,14 +77,22 @@ static - + + + Summarise timing stats for GHC (same as +RTS -tstderr) + static + - + - Which phases to run (<xref linkend="options-order"/>) + Which phases to run + + @@ -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,8 +140,10 @@ - Alternative modes of operation (<xref linkend="modes"/>) + Alternative modes of operation + + @@ -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,8 +185,10 @@ - Redirecting output (<xref linkend="options-output"/>) + Redirecting output + + @@ -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,7 +254,9 @@ - Keeping intermediate files (<xref linkend="keeping-intermediates"/>) + Keeping intermediate files + + @@ -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,8 +299,10 @@ - Temporary files (<xref linkend="temp-files"/>) + Temporary files + + @@ -293,7 +317,7 @@ set the directory for temporary files - static + dynamic - @@ -302,7 +326,9 @@ - Finding imports (<xref linkend="search-path"/>) + Finding imports + + @@ -320,13 +346,13 @@ dir1:dir2:... add dir, dir2, etc. to import path - static + dynamic - Empty the import directory list - static + dynamic - @@ -335,7 +361,9 @@ - Interface file options (<xref linkend="hi-options"/>) + Interface file options + + @@ -372,7 +400,7 @@ Read the interface in file and dump it as text to stdout. - static + mode - @@ -381,7 +409,9 @@ - Recompilation checking (<xref linkend="recomp"/>) + Recompilation checking + + @@ -397,8 +427,9 @@ - Turn off recompilation checking - static + Turn off recompilation checking; implied by any + option + dynamic @@ -407,8 +438,10 @@ - Interactive-mode options (<xref linkend="ghci-dot-files"/>) + Interactive-mode options + + @@ -438,7 +471,10 @@ - Packages (<xref linkend="packages"/>) + Packages + + + @@ -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,7 +528,9 @@ - Language options (<xref linkend="options-language"/>) + Language options + + @@ -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,8 +638,10 @@ - Warnings (<xref linkend="options-sanity"/>) + Warnings + ( + @@ -752,7 +805,9 @@ - Optimisation levels (<xref linkend="options-optimise"/>) + Optimisation levels + + @@ -783,7 +838,9 @@ - Individual optimisations (<xref linkend="options-f"/>) + Individual optimisations + + @@ -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,7 +1022,9 @@ - Profiling options (<xref linkend="profiling"/>) + Profiling options + + @@ -1036,7 +1081,9 @@ - Parallelism options (<xref linkend="sec-using-parallel"/>) + Parallelism options + + @@ -1073,7 +1120,9 @@ - C pre-processor options (<xref linkend="c-pre-processor"/>) + C pre-processor options + + @@ -1108,7 +1157,7 @@ dir Add dir to the directory search list for #include files - static + dynamic - @@ -1117,7 +1166,9 @@ - C compiler options (<xref linkend="options-C-compiler"/>) + C compiler options + + @@ -1142,7 +1193,9 @@ - Code generation options (<xref linkend="options-codegen"/>) + Code generation options + + @@ -1170,7 +1223,7 @@ Omit code generation - static + mode - @@ -1179,7 +1232,9 @@ - Linking options (<xref linkend="options-linker"/>) + Linking options + + @@ -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,7 +1341,9 @@ - Replacing phases (<xref linkend="replacing-phases"/>) + Replacing phases + + @@ -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,7 +1421,9 @@ - Forcing options to particular phases (<xref linkend="forcing-options-through"/>) + Forcing options to particular phases + + @@ -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,8 +1492,10 @@ - Platform-specific options (<xref linkend="options-platform"/>) + Platform-specific options + + @@ -1458,7 +1526,9 @@ - External core file options (<xref linkend="ext-core"/>) + External core file options + + @@ -1481,10 +1551,12 @@ - + - Compiler debugging options (<xref linkend="options-debugging"/>) + Compiler debugging options + + @@ -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 -->