X-Git-Url: http://git.megacz.com/?p=ghc-hetmet.git;a=blobdiff_plain;f=docs%2Fusers_guide%2Fflags.xml;h=f13d34ca2045b1310238f450359069f640a2711a;hp=4ebcc965a391bf6a88bab6a5b705aa48d41efcbb;hb=cae75f82226638691cfa1e85fc168f4b65ddce4d;hpb=75dc1d81dcba9c392853ac8162b3bb35249b7e74 diff --git a/docs/users_guide/flags.xml b/docs/users_guide/flags.xml index 4ebcc96..f13d34c 100644 --- a/docs/users_guide/flags.xml +++ b/docs/users_guide/flags.xml @@ -60,6 +60,18 @@ - + + display the supported language extensions + mode + - + + + + display information about the compiler + mode + - + + display GHC version mode @@ -416,11 +428,7 @@ file - Read the interface in - file and dump it as text to - stdout. - mode - - + See . @@ -456,7 +464,7 @@ - + Interactive-mode options @@ -485,23 +493,36 @@ - - - Generate bytecode enabled for debugging + + Break on any exception thrown dynamic - - + - - Do not include debugging information in bytecodes + + Break on uncaught exceptions and errors dynamic - - + + + Enable usage of Show instances in :print + dynamic + + + + + Turn on printing of binding results in GHCi + dynamic - Turn off printing of binding results in GHCi + + + + Turn off printing of binding contents in GHCi dynamic - + @@ -593,23 +614,23 @@ - + Enable overlapping instances dynamic - + - + Enable incoherent instances. - Implies + Implies dynamic - + - + Enable undecidable instances dynamic - + n @@ -618,11 +639,11 @@ - + Enable arrow notation extension dynamic - + @@ -632,24 +653,24 @@ - or + Enable foreign function interface (implied by ) dynamic - + - + Enable generic classes dynamic - + - + Enable Implicit Parameters. Implied by . dynamic - + @@ -658,254 +679,278 @@ - + Don't implicitly import Prelude dynamic - + - + Disable the monomorphism restriction dynamic - + - + Make pattern bindings polymorphic dynamic - + - + Relaxed checking for mutually-recursive polymorphic functions dynamic - + - + Use GHCi's extended default rules in a normal module dynamic - + - + Enable overloaded string literals. dynamic - + - - Enable generalised algebraic data types. + + Enable generalised algebraic data types. dynamic - + - + Enable type families. dynamic - + - + Enable lexically-scoped type variables. Implied by . dynamic - + - or + Enable Template Haskell. No longer implied by . dynamic - + + + + + Enable quasiquotation. + dynamic + - + Enable bang patterns. dynamic - + - + Enable the C preprocessor. dynamic - + - + Enable pattern guards. dynamic - + - + + Enable view patterns. + dynamic + + + + Enable unicode syntax. dynamic - + - + Enable the “magic hash”. dynamic - + + + + + Enable polymorphic components for data constructors. + dynamic + + + + + Enable rank-2 types. + dynamic + + + + + Enable rank-N types. + dynamic + - - Enable polymorphic components. + + Enable impredicative types. dynamic - + - + Enable existential quantification. dynamic - + - - Enable kind signatures. + + Enable kind signatures. dynamic - + - + Enable pattern type signatures. dynamic - + - + Enable empty data declarations. dynamic - + - + Enable parallel list comprehensions. dynamic - + - - Enable unlifted FFI types. + + Enable transform list comprehensions. dynamic - + - - Enable partially applied type synonyms. - dynamic - - - - - Enable rank-2 types. + + Enable unlifted FFI types. dynamic - + - - Enable rank-N types. + + Enable liberalised type synonyms. dynamic - + - + Enable type operators. dynamic - + - + Enable recursive do (mdo) notation. dynamic - + - + Enable parallel arrays. dynamic - + - - Enable record wildcards. + + Enable record wildcards. dynamic - + - - Enable record puns. + + Enable record puns. dynamic - + - - Enable the disambiguate fields. exception + + Enable record field disambiguation. dynamic - + - + Enable unboxed tuples. dynamic - + - - Enable standalone deriving. + + Enable standalone deriving. dynamic - + - - Enable deriving for the Data and Typeable classes. + + Enable deriving for the Data and Typeable classes. dynamic - + - - Enable type synonyms. + + Enable newtype deriving. dynamic - + - - Enable flexible contexts. + + Enable type synonyms. dynamic - + - - Enable flexible instances. + + Enable flexible contexts. dynamic - + - - Enable constrained class methods. + + Enable flexible instances. dynamic - + - - Enable multi parameter type classes. + + Enable constrained class methods. dynamic - + - - Enable functional dependencies. + + Enable multi parameter type classes. dynamic - + - - Enable newtype deriving. + + Enable functional dependencies. dynamic - + @@ -950,14 +995,27 @@ make warnings fatal dynamic - + -Wwarn + + + + make warnings non-fatal + dynamic + -Werror + + + + + warn about uses of functions & types that have warnings or deprecated pragmas + dynamic + - - warn about uses of functions & types that are deprecated + + warn about uses of commandline flags that are deprecated dynamic - + @@ -1026,8 +1084,8 @@ - warn when the module contains "orphan" instance declarations - or rewrite rules + warn when the module contains orphan instance declarations + or rewrite rules dynamic @@ -1157,6 +1215,13 @@ + + Share specialisations of overloaded functions (default) + dynamic + + + + Enable eta-reduction. Implied by . dynamic @@ -1207,6 +1272,14 @@ + + Set the number of phases for the simplifier (default 2). + Ignored with . + dynamic + - + + + Set the max iterations for the simplifier dynamic @@ -1259,6 +1332,22 @@ + =n + Set the size threshold for the SpecConstr transformation to n (default: 200) + static + + + + + =n + Set to n (default: 3) the maximum number of + specialisations that will be created for any one function + by the SpecConstr transformation + static + + + + Turn on the liberate-case transformation. Implied by . dynamic @@ -1266,11 +1355,17 @@ - =n - Set the size threshold for function specialisation to n, for both - the liberate-case and SpecConstr transformations (default: 200) + + Turn on the static argument transformation. Implied by . + dynamic + -fno-static-argument-transformation + + + + =n + Set the size threshold for the liberate-case transformation to n (default: 200) static - + @@ -1302,13 +1397,6 @@ - - Tweak unfolding settings - static - - - - Tweak unfolding settings static @@ -1403,7 +1491,7 @@ - Directory to deposit .mix files during compilation + Directory to deposit .mix files during compilation (default is .hpc) dynamic @@ -1670,6 +1758,18 @@ static - + + + Do not generate a manifest file (Windows only) + dynamic + - + + + + Do not embed the manifest in the executable (Windows only) + dynamic + - + @@ -1747,6 +1847,13 @@ dynamic - + + cmd + Use cmd as the program for + embedding manifests on Windows. + dynamic + - + @@ -1832,6 +1939,12 @@ dynamic - + + option + pass option to windres. + dynamic + - + @@ -1971,7 +2084,7 @@ - Dump after intrumentation for program coverage + Dump after instrumentation for program coverage dynamic - @@ -2024,6 +2137,12 @@ - + + Dump output from each simplifier phase + dynamic + - + + Dump output from each simplifier iteration dynamic @@ -2037,7 +2156,7 @@ - Dump TH splided expressions, and what they evaluate to + Dump TH spliced expressions, and what they evaluate to dynamic - @@ -2102,6 +2221,12 @@ - + + Suppress unsolicited debugging output + static + - + + Turn on debug printing (more verbose) static @@ -2167,12 +2292,6 @@ dynamic - - - - Enable unregisterised compilation - static - - - @@ -2205,12 +2324,6 @@ - - - Don't share specialisations of overloaded functions - static - - - - Set simplification history size static