X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=docs%2Fusers_guide%2Fdebugging.xml;h=6fc1413bb1af5334931128f2a2f7037f096f16e0;hb=6cec61d14a324285dbb8ce73d4c7215f1f8d6766;hp=0f1fd1822b141f8f8eb9035eb48a57eeff7b45c4;hpb=dade8ab28360c8f5a9c82f9ac3429c808020e07f;p=ghc-hetmet.git
diff --git a/docs/users_guide/debugging.xml b/docs/users_guide/debugging.xml
index 0f1fd18..6fc1413 100644
--- a/docs/users_guide/debugging.xml
+++ b/docs/users_guide/debugging.xml
@@ -120,8 +120,42 @@
- dumps all rewrite rules (including those generated
- by the specialisation pass)
+ dumps all rewrite rules specified in this module;
+ see .
+
+
+
+
+
+
+ :
+
+
+
+ dumps the names of all rules that fired in this module
+
+
+
+
+
+ :
+
+
+
+ dumps detailed information about all rules that fired in
+ this module
+
+
+
+
+
+
+ :
+
+
+
+ dumps the output of the vectoriser.
+
@@ -177,8 +211,8 @@
- :
-
+ :
+ worker/wrapper split output
@@ -280,14 +314,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 .
@@ -316,14 +361,25 @@
-
+
-
- Make the type checker be *real* chatty about what it is
- upto.
-
+
+ Make the type checker be *real* chatty about what it is
+ upto.
+
+
+
+
+
+
+
+
+
+ Make the vectoriser be *real* chatty about what it is
+ upto.
+
@@ -363,7 +419,7 @@
of output!) So: when we're really desperate:
-% ghc -noC -O -ddump-simpl -dverbose-simpl -dcore-lint Foo.hs
+% ghc -noC -O -ddump-simpl -dverbose-core2core -dcore-lint Foo.hs
@@ -381,6 +437,17 @@
+
+
+
+
+ Print a one-line summary of the size of the Core program
+ at the end of the optimisation pipeline.
+
+
+
+
+
@@ -412,6 +479,41 @@
+
+
+
+
+ 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.
+
+
+
+
+
+
+
+
+
+ Suppress the printing of module qualification prefixes in Core dumps to make them easier to read.
+
+
+
+
+
@@ -424,14 +526,18 @@
-
-
-
+
+
+
-
- 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.
+
@@ -610,7 +716,6 @@ Main.skip2{-r1L6-} =