get haddock working

[hsenag]

Apologies for the slightly vague bug report, but after spending a little while investigating already, I'd like to get an idea of what's actually supposed to work before digging in more depth.

There's code in Documentation.hs and AtPoint.hs that appears to be intended to include haddock docs in the hover information.

However I never see any, even with really trivial test cases. Is this something that is expected to work or is working for others?

One thing I noticed is that there are references in Documentation.hs to things happening when Opt_Haddock or Opt_KeepRawTokenStream are enabled, but I don't see them enabled anywhere.

[cocreature]

There is some rudamentary support but it’s quite rough. https://github.com/digital-asset/daml/blob/master/compiler/damlc/tests/src/DA/Test/ShakeIdeClient.hs#L676 tests that it works at least for DAML. My guess is that we probably only set Opt_KeepRawTokenStream for DAML but not for Haskell which is why it doesn’t work there.

[hsenag]

A quick update - I tried setting both Opt_KeepRawTokenStream and Opt_Haddock in runGhcEnv and it made no difference. I didn't debug it further, I'll update this ticket if I come back to it and learn more.

[jneira]

@hsenag afaik haddock comments are shown on hover now, feel free to reopen if it is not the case