[commit: ghc] ghc-8.0: user-guide: Use ghc-flag for dump formatting flags (84f1841)
git at git.haskell.org
git at git.haskell.org
Sat Jan 16 12:48:39 UTC 2016
Repository : ssh://git@git.haskell.org/ghc
On branch : ghc-8.0
Link : http://ghc.haskell.org/trac/ghc/changeset/84f1841bbd0946bf50f10fcbbe36e081bf0a817c/ghc
>---------------------------------------------------------------
commit 84f1841bbd0946bf50f10fcbbe36e081bf0a817c
Author: Ben Gamari <ben at smart-cactus.org>
Date: Thu Jan 14 13:49:17 2016 +0100
user-guide: Use ghc-flag for dump formatting flags
And document -dth-dec-file. Not sure how these were missed.
(cherry picked from commit 83c13c2a6b7d7424d0bbee31f4ef2e7ab44836b0)
>---------------------------------------------------------------
84f1841bbd0946bf50f10fcbbe36e081bf0a817c
docs/users_guide/debugging.rst | 22 +++++++++-------------
1 file changed, 9 insertions(+), 13 deletions(-)
diff --git a/docs/users_guide/debugging.rst b/docs/users_guide/debugging.rst
index f366d95..80c9f8d 100644
--- a/docs/users_guide/debugging.rst
+++ b/docs/users_guide/debugging.rst
@@ -51,6 +51,10 @@ Dumping out compiler intermediate structures
Dump Template Haskell expressions that we splice in, and what
Haskell code the expression evaluates to.
+ .. ghc-flag:: -dth-dec-file=<file>
+
+ Dump expansions of all top-level Template Haskell splices into ⟨file⟩.
+
.. ghc-flag:: -ddump-types
Dump a type signature for each value defined at the top level of
@@ -226,32 +230,24 @@ Formatting dumps
.. index::
single: formatting dumps
-``-dppr-user-length``
- .. index::
- single: -dppr-user-length
+.. ghc-flag:: -dppr-user-length
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.
-``-dppr-colsNNN``
- .. index::
- single: -dppr-colsNNN
+.. ghc-flag:: -dppr-cols=N
Set the width of debugging output. Use this if your code is wrapping
- too much. For example: ``-dppr-cols200``.
+ too much. For example: ``-dppr-cols=200``.
-``-dppr-case-as-let``
- .. index::
- single: -dppr-case-as-let
+.. ghc-flag:: -dppr-case-as-let
Print single alternative case expressions as though they were strict
let expressions. This is helpful when your code does a lot of
unboxing.
-``-dno-debug-output``
- .. index::
- single: -dno-debug-output
+.. ghc-flag:: -dno-debug-output
Suppress any unsolicited debugging output. When GHC has been built
with the ``DEBUG`` option it occasionally emits debug output of
More information about the ghc-commits
mailing list