haddock
haddock copied to clipboard
haddock points to reexported symbol even if a symbol is imported through another module
In my module, I'm importing Data.Text.Text and using it in a function signature.
However, my library depends on text and foldl and foldl reexports Text in the Control.Foldl.Text module.
Even if I'm not importing Control.Foldl.Text in my module, haddock generates links documentation to this module instead of a link to the Data.Text.Text module.
For exemple:
I've created a new library with cabal init which contains this file:
module MyLib (someFunc, fiz) where
import Data.Text
fiz :: Text
fiz = undefined
someFunc :: IO ()
someFunc = putStrLn "someFunc"
Note: this is the default library generated by cabal init with the added (and exported) fiz symbol.
Note that it imports the Data.Text module.
If I only depend on text on my cabal file, the generated haddock correctly points to Data.Text.Text. However, if I'm adding foldl in my cabal file, the generated documentation points to Control.Foldl.Text, as you can see here:

Changing the order of the dependencies in the cabal file does not change the result.
Tried with haddock with ghc 9.0.2
Could it be that this bug affects re-exports in a more general way? I have something like:
import Data.Attoparsec.ByteString.Char8
fooP :: Parser a
...
and haddock reports
could not find link destinations for:
- Data.Attoparsec.ByteString.Internal.Parser
but Parser is re-exported by Data.Attoparsec.ByteString.Char8.