X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=docs%2Fusers_guide%2Fdebugging.xml;h=b84134ad13eadef668f9414043a9ee7a65c8d040;hb=4a1e7a0e4c64460187b63669e6d00258cbe3b137;hp=0132b42c0b9b766a13afdd07ed4c41ea83b0bb54;hpb=f61baf76c9fa20aa972938384887bcb52151e76f;p=ghc-hetmet.git
diff --git a/docs/users_guide/debugging.xml b/docs/users_guide/debugging.xml
index 0132b42..b84134a 100644
--- a/docs/users_guide/debugging.xml
+++ b/docs/users_guide/debugging.xml
@@ -128,6 +128,39 @@
+ :
+
+
+
+ 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.
+
+
+
+
+
+
:
@@ -328,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.
+
@@ -393,6 +437,17 @@
+
+
+
+
+ Print a one-line summary of the size of the Core program
+ at the end of the optimisation pipeline.
+
+
+
+
+
@@ -421,42 +476,47 @@
style.
+
+
+
+ Formatting dumps
+
+ formatting dumps
+
+
-
-
+
+
- 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
+ In error messages, expressions are printed to a
+ certain “depth”, with subexpressions beyond the
+ depth replaced by ellipses. This flag sets the
+ depth. Its default value is 5.
-
-
+
+
- Suppress the printing of coercions in Core dumps to make them
-shorter.
+ Set the width of debugging output. Use this if your code is wrapping too much.
+ For example: .
-
-
+
+
- In error messages, expressions are printed to a
- certain “depth”, with subexpressions beyond the
- depth replaced by ellipses. This flag sets the
- depth. Its default value is 5.
+ Print single alternative case expressions as though they were strict
+ let expressions. This is helpful when your code does a lot of unboxing.
@@ -474,6 +534,97 @@ shorter.
turn it off.
+
+
+
+
+
+ Suppressing unwanted information
+
+ suppression
+
+ Core dumps contain a large amount of information. Depending on what you are doing, not all of it will be useful.
+ Use these flags to suppress the parts that you are not interested in.
+
+
+
+
+
+
+
+
+ Suppress everything that can be suppressed, except for unique ids as this often
+ makes the printout ambiguous. If you just want to see the overall structure of
+ the code, then start here.
+
+
+
+
+
+
+
+
+
+ Suppress the printing of uniques. 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 extended information about identifiers where they are bound. This includes
+ strictness information and inliner templates. Using this flag can cut the size
+ of the core dump in half, due to the lack of inliner templates
+
+
+
+
+
+
+
+
+
+ Suppress the printing of module qualification prefixes.
+ This is the Data.List in Data.List.length.
+
+
+
+
+
+
+
+
+
+ Suppress the printing of type signatures.
+
+
+
+
+
+
+
+
+
+ Suppress the printing of type applications.
+
+
+
+
+
+
+
+
+
+ Suppress the printing of type coercions.
+
+