X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=docs%2Fusers_guide%2Fdebugging.xml;h=d1e9e16e9ccb81959b1d6805fd6b54e26a59c380;hb=65277a1c9ff86c28c656849d6f6cbb392f1eb3e7;hp=b4456279fc62ef09c92abe74a53580aaedab2780;hpb=f83e51a5ff9689ddba608b92b325224f2e32ff82;p=ghc-hetmet.git
diff --git a/docs/users_guide/debugging.xml b/docs/users_guide/debugging.xml
index b445627..d1e9e16 100644
--- a/docs/users_guide/debugging.xml
+++ b/docs/users_guide/debugging.xml
@@ -60,6 +60,17 @@
+ :
+
+
+
+ Dump Template Haskell expressions that we splice in,
+ and what Haskell code the expression evaluates to.
+
+
+
+
+
:
@@ -186,6 +197,16 @@
+ :
+
+
+
+ output of core preparation pass
+
+
+
+
+
:
@@ -206,6 +227,26 @@
+ :
+
+
+
+ Print the C-- code out.
+
+
+
+
+
+ :
+
+
+
+ Dump the results of C-- to C-- optimising passes.
+
+
+
+
+
:
@@ -239,14 +280,25 @@
+ :
+
+
+
+ Show the output of each run of the simplifier. Used when even
+ doesn't cut it.
+
+
+
+
+
:
Show the output of each iteration
of the simplifier (each run of the simplifier has a maximum
- number of iterations, normally 4). Used when even
- doesn't cut it.
+ number of iterations, normally 4). This outputs even more information
+ than .
@@ -265,6 +317,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 +382,22 @@
+
+
+
+
+ Print out each pass name as it happens.
+
+
+
+
+ Show statistics for the usage of fast strings by the
- compiler
+ compiler.
@@ -339,6 +423,31 @@
+
+
+
+
+ Suppress the printing of uniques in debugging output. This may make
+ the printout ambiguous (e.g. unclear where an occurrence of 'x' is bound), but
+ it makes the output of two compiler runs have many fewer gratuitous differences,
+ so you can realistically apply diff. Once diff
+ has shown you where to look, you can try again without
+
+
+
+
+
+
+
+
+
+ Suppress the printing of coercions in Core dumps to make them
+shorter.
+
+
+
+
+
@@ -346,19 +455,23 @@
In error messages, expressions are printed to a
certain “depth”, with subexpressions beyond the
depth replaced by ellipses. This flag sets the
- depth.
+ depth. Its default value is 5.
-
-
-
+
+
+
-
- Have the renamer report what imports does not
- contribute.
-
+
+ Suppress any unsolicited debugging output. When GHC
+ has been built with the DEBUG option it
+ occasionally emits debug output of interest to developers.
+ The extra output can confuse the testing framework and
+ cause bogus test failures, so this flag is provided to
+ turn it off.
+
@@ -392,6 +505,16 @@
+
+
+ :
+
+
+
+ Ditto for C-- level.
+
+
+
@@ -518,21 +641,9 @@ Main.skip2{-r1L6-} =
of platform-specific code that needs to be written in order to get
unregisterised compilation going is usually fairly small.
-
-
-
- :
-
-
-
- Compile via vanilla ANSI C only, turning off
- platform-specific optimisations. NOTE: in order to use
- , you need to have a set of libraries
- (including the RTS) built for unregisterised compilation.
- This amounts to building GHC with way "u" enabled.
-
-
-
+ Unregisterised compilation cannot be selected at
+ compile-time; you have to build GHC with the appropriate options
+ set. Consult the GHC Building Guide for details.