summaryrefslogtreecommitdiff
path: root/docs/users_guide
diff options
context:
space:
mode:
authorAlan Zimmerman <alan.zimm@gmail.com>2022-04-10 11:45:28 +0200
committerAlan Zimmerman <alan.zimm@gmail.com>2022-04-11 22:34:41 +0200
commitf0203665525a079848d4dc01555e379307abce52 (patch)
tree4836f1b7b9eff1010d751035439444dbc94b3375 /docs/users_guide
parent20eca489df8c3dae80a584dede8fea40728bde3b (diff)
downloadhaskell-wip/az/T19706-dkeep-comments.tar.gz
Add -dkeep-comments flag to keep comments in the parserwip/az/T19706-dkeep-comments
This provides a way to set the Opt_KeepRawTokenStream from the command line, allowing exact print annotation users to see exactly what is produced for a given parsed file, when used in conjunction with -ddump-parsed-ast Discussed in #19706, but this commit does not close the issue.
Diffstat (limited to 'docs/users_guide')
-rw-r--r--docs/users_guide/debugging.rst7
1 files changed, 7 insertions, 0 deletions
diff --git a/docs/users_guide/debugging.rst b/docs/users_guide/debugging.rst
index 6802fa71fb..0d418b3dfd 100644
--- a/docs/users_guide/debugging.rst
+++ b/docs/users_guide/debugging.rst
@@ -124,6 +124,13 @@ parser and interface file reader.
Dump parser output as a syntax tree
+.. ghc-flag:: -dkeep-comments
+ :shortdesc: Include comments in the parser. Useful in combination with :ghc-flag:`-ddump-parsed-ast`.
+ :type: dynamic
+
+ Include comments in the parser. Useful in combination with :ghc-flag:`-ddump-parsed-ast`.
+
+
.. ghc-flag:: -ddump-if-trace
:shortdesc: Trace interface files
:type: dynamic