[commit: ghc] master: Fix documentation for `-dth-dec-file` (69954a1)
git at git.haskell.org
git at git.haskell.org
Fri Jun 15 16:09:29 UTC 2018
Repository : ssh://git@git.haskell.org/ghc
On branch : master
Link : http://ghc.haskell.org/trac/ghc/changeset/69954a125d12a1ffffcc9ce2d66bc211e3607a9a/ghc
>---------------------------------------------------------------
commit 69954a125d12a1ffffcc9ce2d66bc211e3607a9a
Author: Nathan Collins <conathan at galois.com>
Date: Thu Jun 14 16:36:23 2018 -0700
Fix documentation for `-dth-dec-file`
The docs said that it took a file argument, as in
`-dth-dec-file=<file>`, but it does not take a file argument!
>---------------------------------------------------------------
69954a125d12a1ffffcc9ce2d66bc211e3607a9a
docs/users_guide/debugging.rst | 7 ++++---
docs/users_guide/glasgow_exts.rst | 6 +++---
2 files changed, 7 insertions(+), 6 deletions(-)
diff --git a/docs/users_guide/debugging.rst b/docs/users_guide/debugging.rst
index a3f0be7..de69db8 100644
--- a/docs/users_guide/debugging.rst
+++ b/docs/users_guide/debugging.rst
@@ -173,11 +173,12 @@ These flags dump various information from GHC's typechecker and renamer.
Dump Template Haskell expressions that we splice in, and what
Haskell code the expression evaluates to.
-.. ghc-flag:: -dth-dec-file=⟨file⟩
- :shortdesc: Show evaluated TH declarations in a .th.hs file
+.. ghc-flag:: -dth-dec-file
+ :shortdesc: Dump evaluated TH declarations into `*.th.hs` files
:type: dynamic
- Dump expansions of all top-level Template Haskell splices into ⟨file⟩.
+ Dump expansions of all top-level Template Haskell splices into
+ :file:`{module}.th.hs` for each file :file:`{module}.hs`.
.. ghc-flag:: -ddump-types
:shortdesc: Dump type signatures
diff --git a/docs/users_guide/glasgow_exts.rst b/docs/users_guide/glasgow_exts.rst
index 9212eed..952b16c 100644
--- a/docs/users_guide/glasgow_exts.rst
+++ b/docs/users_guide/glasgow_exts.rst
@@ -12681,9 +12681,9 @@ non-trivial program, you may be interested in combining this with the
:ghc-flag:`-ddump-to-file` flag (see :ref:`dumping-output`. For each file using
Template Haskell, this will show the output in a ``.dump-splices`` file.
-The flag :ghc-flag:`-dth-dec-file=⟨file⟩` shows the expansions of all top-level
+The flag :ghc-flag:`-dth-dec-file` dumps the expansions of all top-level
TH declaration splices, both typed and untyped, in the file :file:`M.th.hs`
-where M is the name of the module being compiled. Note that other types of
+for each module `M` being compiled. Note that other types of
splices (expressions, types, and patterns) are not shown. Application
developers can check this into their repository so that they can grep for
identifiers that were defined in Template Haskell. This is similar to using
@@ -12702,7 +12702,7 @@ Below is a sample output of :ghc-flag:`-ddump-splices` ::
foo :: Int -> Int
foo x = (x + 1)
-Below is the output of the same sample using :ghc-flag:`-dth-dec-file=⟨file⟩` ::
+Below is the output of the same sample using :ghc-flag:`-dth-dec-file` ::
-- TH_pragma.hs:(6,4)-(8,26): Splicing declarations
foo :: Int -> Int
More information about the ghc-commits
mailing list