X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=docs%2Fusers_guide%2Fflags.xml;h=8e185701c38e98adb48d9d26c7c40867ab877f73;hb=536852b1348fde6ec0ba13859cc5ddf8480a1653;hp=6d6ef8654a9f006242b279ee58b3a594d420f6d9;hpb=bec18cb3a1dcbc70b0257a367091c9a5948da6f6;p=ghc-hetmet.git diff --git a/docs/users_guide/flags.xml b/docs/users_guide/flags.xml index 6d6ef86..8e18570 100644 --- a/docs/users_guide/flags.xml +++ b/docs/users_guide/flags.xml @@ -36,6 +36,12 @@ - + + do a dry run + dynamic + - + + verbose mode (equivalent to ) dynamic @@ -78,6 +84,12 @@ - + size + Set the minimum heap size to size + static + - + + Summarise timing stats for GHC (same as +RTS -tstderr) static @@ -157,25 +169,29 @@ - Interactive mode - normally used by just running ghci + Interactive mode - normally used by just running ghci; + see for details. mode - - Build a multi-module Haskell program, automatically figuring out dependencies. Likely to be much easier, and faster, than using make. + Build a multi-module Haskell program, automatically figuring out dependencies. Likely to be much easier, and faster, than using make; + see for details.. mode - - Evaluate expr + Evaluate expr; + see for details. mode - - Generate dependency information suitable for use in a Makefile. + Generate dependency information suitable for use in a Makefile; + see for details. mode - @@ -346,13 +362,13 @@ dir1:dir2:... add dir, dir2, etc. to import path - dynamic + static/:set - Empty the import directory list - dynamic + static/:set - @@ -426,11 +442,11 @@ - + Turn off recompilation checking; implied by any option dynamic - + @@ -465,6 +481,24 @@ static - + + + Generate bytecode enabled for debugging + dynamic + - + + + + Do not include debugging information in bytecodes + dynamic + - + + + + Turn off printing of binding results in GHCi + dynamic + - + @@ -487,9 +521,15 @@ + P + Compile to be part of package P + dynamic + - + + P Expose package P - dynamic + static/:set - @@ -501,25 +541,25 @@ name Hide package P - dynamic + static/:set - name Ignore package P - dynamic + static/:set - file Load more packages from file - dynamic + static - Don't load the user's package config file. - dynamic + static - @@ -545,45 +585,46 @@ - Enable overlapping instances + Enable overlapping instances dynamic - - Enable undecidable instances - dynamic - - - - Enable incoherent instances. + Enable incoherent instances. Implies dynamic - - Enable arrow notation extension + + Enable undecidable instances dynamic - + n - set the limit for context reduction + set the limit for context reduction dynamic + + Enable arrow + notation extension + dynamic + + + or - Enable foreign function interface (implied by + Enable foreign function interface (implied by ) dynamic - Enable generics + Enable generic classes dynamic @@ -595,7 +636,7 @@ - Enable Implicit Parameters. + Enable Implicit Parameters. Implied by . dynamic @@ -614,24 +655,49 @@ - Disable the monomorphism restriction + Disable the monomorphism restriction dynamic + + Make pattern bindings polymorphic + dynamic + + + + + Use GHCi's extended default rules in a normal module + dynamic + + + + + Enable overloaded string literals. + + dynamic + + + - Enable lexically-scoped type variables. + Enable lexically-scoped type variables. Implied by . dynamic - Enable Template Haskell. + Enable Template Haskell. No longer implied by . dynamic + + + Enable bang patterns. + dynamic + + @@ -640,7 +706,7 @@ Warnings - ( + @@ -667,7 +733,7 @@ - enable all warnings + enable almost all warnings (details in ) dynamic @@ -700,6 +766,13 @@ + + + warn when the Prelude is implicitly imported + dynamic + + + warn when a pattern match could fail @@ -715,13 +788,6 @@ - - enable miscellaneous warnings - dynamic - - - - warn when fields of a record are uninitialised dynamic @@ -750,7 +816,7 @@ - + warn when the module contains "orphan" instance declarations or rewrite rules dynamic @@ -772,6 +838,13 @@ + + warn if there are tabs in the source file + dynamic + + + + warn when defaulting happens dynamic @@ -779,6 +852,13 @@ + + warn when the Monomorphism Restriction is applied + dynamic + + + + warn about bindings that are unused dynamic @@ -855,7 +935,7 @@ - Enable case-merging + Enable case-merging. Implied by . dynamic @@ -869,7 +949,7 @@ - Enable eta-reduction + Enable eta-reduction. Implied by . dynamic @@ -889,14 +969,6 @@ - - Switch off all rewrite rules (including rules - generated by automatic specialisation of overloaded functions) - static - - - - Ignore assertions in the source dynamic @@ -911,13 +983,6 @@ - - Tweak the liberate-case optimisation (default: 10) - static - - - - Don't generate interface pragmas dynamic @@ -948,31 +1013,55 @@ - - Turn off common sub-expression + + Turn on common sub-expression elimination. Implied by . dynamic - - + -fno-cse - - Turn off full laziness (floating bindings outwards). + + Turn on full laziness (floating bindings outwards). Implied by . dynamic - -ffull-laziness + -fno-full-laziness - - Turn off pre-inlining - static - - + + Switch on all rewrite rules (including rules + generated by automatic specialisation of overloaded functions). + Implied by . + dynamic + - - Turn off strictness analysis + + Turn on strictness analysis. Implied by . dynamic - - + -fno-strictness + + + + + Turn on the SpecConstr transformation. Implied by . + dynamic + -fno-spec-constr + + + + + Turn on the liberate-case transformation. Implied by . + dynamic + -fno-liberate-case + + + + =n + Set the size threshold for function specialisation to n, for both + the liberate-case and SpecConstr transformations (default: 200) + static + @@ -1016,6 +1105,13 @@ static + + + + Turn off pre-inlining + static + - + @@ -1052,12 +1148,6 @@ - - Auto-add _scc_s to all dictionaries - static - - - Auto-add _scc_s to all CAFs static @@ -1081,9 +1171,9 @@ - Parallelism options + Haskell pre-processor options - + @@ -1097,21 +1187,12 @@ - - Enable GRANSIM - static - - - - - - Enable Parallel Haskell - static - - - - - - Enable SMP support - static + + + Enable the use of a pre-processor + (set with ) + + dynamic - @@ -1223,7 +1304,19 @@ Omit code generation - mode + dynamic + - + + + + Generate byte-code + dynamic + - + + + + Generate object code + dynamic - @@ -1248,6 +1341,12 @@ + + Generate position-independent code (where available) + static + - + + Use dynamic Haskell libraries (if available) static @@ -1283,7 +1382,7 @@ - Set main function + Set main module and function dynamic - @@ -1306,12 +1405,6 @@ - - name - Link in package name - dynamic - - - - Split objects (for libraries) dynamic @@ -1376,6 +1469,18 @@ - + cmd + Use cmd as the mangler + dynamic + - + + + cmd + Use cmd as the splitter + dynamic + - + + cmd Use cmd as the assembler dynamic @@ -1394,12 +1499,6 @@ - - cmd - Use cmd as the dependency generator - dyanmic - - - - cmd Use cmd as the pre-processor (with only) @@ -1415,7 +1514,6 @@ - @@ -1463,6 +1561,12 @@ - + option + pass option to the mangler + dynamic + - + + option pass option to the assembler dynamic @@ -1508,13 +1612,7 @@ - - (SPARC only) enable version 8 support - static - - - - - + (x86 only) give some registers back to the C compiler dynamic - @@ -1576,12 +1674,6 @@ - - - Dump abstract C - dynamic - - - - Dump assembly dynamic @@ -1594,6 +1686,12 @@ - + + Dump C-- output + dynamic + - + + Dump output from CPR analysis dynamic @@ -1642,14 +1740,20 @@ - + + Dump the results of C-- to C-- optimising passes + dynamic + - + + Dump parse tree dynamic - - - Dump “real” C + + Dump prepared core dynamic - @@ -1666,12 +1770,6 @@ - - - Dump saturated output - dynamic - - - - Dump final simplifier output dynamic @@ -1690,6 +1788,12 @@ - + + Dump TH splided expressions, and what they evaluate to + dynamic + - + + Dump final STG dynamic @@ -1714,32 +1818,32 @@ - - - Dump UsageSP analysis output + + Dump worker-wrapper output dynamic - - - Dump worker-wrapper output + + Trace interface files dynamic - - - Trace renamer + + Trace typechecker dynamic - - - Renamer stats + + Trace renamer dynamic - - - Native code generator intermediate form + + Renamer stats dynamic - @@ -1774,20 +1878,20 @@ - - - STG pass sanity checking + + C-- pass sanity checking dynamic - - - Dump STG stats + + STG pass sanity checking dynamic - - - UsageSP sanity checker + + Dump STG stats dynamic - @@ -1804,6 +1908,18 @@ - + + Print out each pass name as it happens + dynamic + - + + + + Show statistics for fast string usage when finished + dynamic + - + + Enable unregisterised compilation static @@ -1829,12 +1945,6 @@ - - ??? - static - - - - Don't complain about .hi file mismatches static