From: Ian Lynagh Date: Tue, 3 Oct 2006 22:03:54 +0000 (+0000) Subject: Improve the correlation betweens documented and existent options X-Git-Url: http://git.megacz.com/?p=ghc-hetmet.git;a=commitdiff_plain;h=ba5729e5b8d80b3fcc8a477cb36d6a03800ac0dd Improve the correlation betweens documented and existent options --- diff --git a/docs/users_guide/6.6-notes.xml b/docs/users_guide/6.6-notes.xml index 1e2dd68..a161b54 100644 --- a/docs/users_guide/6.6-notes.xml +++ b/docs/users_guide/6.6-notes.xml @@ -171,7 +171,6 @@ , , , - , , , , diff --git a/docs/users_guide/debugging.xml b/docs/users_guide/debugging.xml index b445627..2a88767 100644 --- a/docs/users_guide/debugging.xml +++ b/docs/users_guide/debugging.xml @@ -60,6 +60,27 @@ + : + + + + typechecker output + + + + + + : + + + + Dump Template Haskell expressions that we splice in, + and what Haskell code the expression evaluates to. + + + + + : @@ -186,6 +207,16 @@ + : + + + + output of core preparation pass + + + + + : @@ -206,6 +237,26 @@ + : + + + + Print the C-- code out. + + + + + + : + + + + Dump the results of C-- to C-- optimising passes. + + + + + : @@ -265,6 +316,28 @@ + + + + + Make the interface loader be *real* chatty about what it is + upto. + + + + + + + + + + Make the type checker be *real* chatty about what it is + upto. + + + + + @@ -308,12 +381,22 @@ + + + + + Print out each pass name as it happens. + + + + + Show statistics for the usage of fast strings by the - compiler + compiler. @@ -392,6 +475,16 @@ + + + : + + + + Ditto for C-- level. + + + diff --git a/docs/users_guide/flags.xml b/docs/users_guide/flags.xml index 6a18ca5..cc5d6d3 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 @@ -487,6 +499,12 @@ + P + Compile to be part of package P + dynamic + - + + P Expose package P dynamic @@ -1245,6 +1263,12 @@ + + Generate position-independent code (where available) + static + - + + Use dynamic Haskell libraries (if available) static @@ -1367,6 +1391,18 @@ - + cmd + Use cmd as the mangler + dynamic + - + + + cmd + Use cmd as the splitter + dynamic + - + + cmd Use cmd as the assembler dynamic @@ -1385,12 +1421,6 @@ - - cmd - Use cmd as the dependency generator - dyanmic - - - - cmd Use cmd as the pre-processor (with only) @@ -1406,7 +1436,6 @@ - @@ -1454,6 +1483,12 @@ - + option + pass option to the mangler + dynamic + - + + option pass option to the assembler dynamic @@ -1573,6 +1608,12 @@ - + + Dump C-- output + dynamic + - + + Dump output from CPR analysis dynamic @@ -1621,12 +1662,24 @@ - + + Dump the results of C-- to C-- optimising passes + dynamic + - + + Dump parse tree dynamic - + + Dump prepared core + dynamic + - + + Dump renamer output dynamic @@ -1657,6 +1710,12 @@ - + + Dump TH splided expressions, and what they evaluate to + dynamic + - + + Dump final STG dynamic @@ -1687,6 +1746,18 @@ - + + Trace interface files + dynamic + - + + + + Trace typechecker + dynamic + - + + Trace renamer dynamic @@ -1729,6 +1800,12 @@ - + + C-- pass sanity checking + dynamic + - + + STG pass sanity checking dynamic @@ -1753,6 +1830,12 @@ - + + Print out each pass name as it happens + dynamic + - + + Show statistics for fast string usage when finished dynamic diff --git a/docs/users_guide/phases.xml b/docs/users_guide/phases.xml index 9058177..cd18469 100644 --- a/docs/users_guide/phases.xml +++ b/docs/users_guide/phases.xml @@ -49,6 +49,28 @@ + cmd + + + + Use cmd as the + mangler. + + + + + + cmd + + + + Use cmd as the + splitter. + + + + + cmd @@ -82,17 +104,6 @@ - cmd - - - - Use cmd as the dependency - generator. - - - - - cmd @@ -155,6 +166,15 @@ + option + + + + Pass option to the mangler. + + + + option diff --git a/docs/users_guide/using.xml b/docs/users_guide/using.xml index 14665af..aa133ee 100644 --- a/docs/users_guide/using.xml +++ b/docs/users_guide/using.xml @@ -592,6 +592,18 @@ ghc -c Foo.hs + + + + + Does a dry-run, i.e. GHC goes through all the motions + of compiling as normal, but does not actually run any + external commands. + + + + + @@ -748,6 +760,20 @@ ghc -c Foo.hs + size + + + + Set the minimum size of the heap to + size. + This option is equivalent to + +RTS -Hsize, + see . + + + + +