X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=docs%2Fusers_guide%2Fdebugging.xml;h=4ab43791274bfc982be2b999846a540f4d3735d8;hb=6e3538235f0b82c074874ddfaa4526e06901256d;hp=a325389d4681c5db89ae5ae42ddb6b276fbc156f;hpb=0065d5ab628975892cea1ec7303f968c3338cbe1;p=ghc-hetmet.git
diff --git a/docs/users_guide/debugging.xml b/docs/users_guide/debugging.xml
index a325389..4ab4379 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.
+
+
+
+
+
:
@@ -136,16 +147,6 @@
- :
-
-
-
- UsageSP inference pre-inf and output
-
-
-
-
-
:
@@ -196,11 +197,11 @@
- :
-
+ :
+
- output of “saturate” pass
+ output of core preparation pass
@@ -216,16 +217,6 @@
- :
-
-
-
- unflattened Abstract C
-
-
-
-
-
:
@@ -236,21 +227,21 @@
- :
-
+ :
+
- same as what goes to the C compiler
+ Print the C-- code out.
- :
-
+ :
+
- native-code generator intermediate form
+ Dump the results of C-- to C-- optimising passes.
@@ -289,6 +280,76 @@
+ :
+
+
+
+ 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.
+
+
+
+
+
+
+
+
+
+ Dump statistics about how many of each kind of
+ transformation too place. If you add
+ you get more detailed
+ information.
+
+
+
+
+
+
+
+
+
+ Make the interface loader be *real* chatty about what it is
+ upto.
+
+
+
+
+
+
+
+
+
+ Make the type checker be *real* chatty about what it is
+ upto.
+
+
+
+
+
+
+
+
+
+ Make the renamer be *real* chatty about what it is
+ upto.
+
+
+
+
+
+
+
+
+
+ Print out summary of what kind of information the renamer
+ had to bring in.
+
+
+
+
+
@@ -310,14 +371,22 @@
- :
-
+
+
- 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.
+ Print out each pass name as it happens.
+
+
+
+
+
+
+
+
+
+ Show statistics for the usage of fast strings by the
+ compiler.
@@ -350,42 +419,7 @@
In error messages, expressions are printed to a
certain “depth”, with subexpressions beyond the
depth replaced by ellipses. This flag sets the
- depth.
-
-
-
-
-
-
-
-
-
- Dump statistics about how many of each kind of
- transformation too place. If you add
- you get more detailed
- information.
-
-
-
-
-
-
-
-
-
- Make the renamer be *real* chatty about what it is
- upto.
-
-
-
-
-
-
-
-
-
- Print out summary of what kind of information the renamer
- had to bring in.
+ depth. Its default value is 5.
@@ -433,19 +467,14 @@
- :
-
+ :
+
- Turn on checks around UsageSP inference
- (). This verifies various simple
- properties of the results of the inference, and also warns
- if any identifier with a used-once annotation before the
- inference has a used-many annotation afterwards; this could
- indicate a non-worksafe transformation is being
- applied.
+ Ditto for C-- level.
+