[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