#14920: Flag reference doesn't include `-haddock` and `-haddock-opts` -------------------------------------+------------------------------------- Reporter: sjakobi | Owner: sjakobi Type: bug | Status: new Priority: normal | Milestone: Component: Documentation | Version: 8.4.1 Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: | Unknown/Multiple Type of failure: None/Unknown | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Comment (by alexbiehl): A comment on `-haddock`: yes, with this flag GHC will take a closer look on comments and keep them in its syntax tree for haddock to pick them up (see `collectDocs` in haddock-api package). For "Hi Haddock", as as a first approximation I am in favour of only putting documentation in hi files when `-haddock` flag is given. If it turns out to be performant enough we could still enable `-haddock` by default later. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/14920#comment:3 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler