summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBen Gamari <ben@smart-cactus.org>2020-05-20 12:26:05 -0400
committerBen Gamari <ben@smart-cactus.org>2020-05-20 12:26:24 -0400
commit81b93db0e9b3cb8b5780ff1ec8dd773e1f839938 (patch)
tree535a3e6cb7ab777573015b3af5707bcee2d96733
parent568d7279a80cf945271f0659f11a94eea3f1433d (diff)
downloadhaskell-wip/T18206.tar.gz
users-guide: Clarify meaning of -haddock flagwip/T18206
Fixes #18206.
-rw-r--r--docs/users_guide/using.rst5
1 files changed, 3 insertions, 2 deletions
diff --git a/docs/users_guide/using.rst b/docs/users_guide/using.rst
index 7bdd421fac..5b8425fc9e 100644
--- a/docs/users_guide/using.rst
+++ b/docs/users_guide/using.rst
@@ -1136,10 +1136,11 @@ Haddock
single: haddock
.. ghc-flag:: -haddock
- :shortdesc: Make the parser more strict about Haddock comments.
+ :shortdesc: With this flag GHC will parse Haddock comments and include them
+ in the interface file it produces.
:type: dynamic
:reverse: -no-haddock
- :category: misc
+ :category: haddock
By default, GHC ignores Haddock comments (``-- | ...`` and ``-- ^ ...``)
and does not check that they're associated with a valid term, such as a