summaryrefslogtreecommitdiff
path: root/docs/users_guide/debugging.rst
diff options
context:
space:
mode:
authorAlan Zimmerman <alan.zimm@gmail.com>2022-04-10 11:45:28 +0200
committerMarge Bot <ben+marge-bot@smart-cactus.org>2022-04-20 11:49:28 -0400
commit83c67f766be615d4db6f71f8af0cbb9b4c4917bb (patch)
tree4c673b59f5c1023bb2d36b4beeab7e5477ff129b /docs/users_guide/debugging.rst
parentd8392f6a714b5646d43ed54eee0d028f714da717 (diff)
downloadhaskell-83c67f766be615d4db6f71f8af0cbb9b4c4917bb.tar.gz
Add -dkeep-comments flag to keep comments in the parser
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/debugging.rst')
-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