Skip to content

Haddock regression with respect to links of qualified identifiers

Summary

Qualified identifiers in haddock comments are not represented the right way in haddock interface files, which leads to wrong documentation output.

If a haddock comment contains IO.newEmptyMVar where IO is qualification of an import statement, haddock-9.8.2 (ver haddock-api-2.30.0) the produced interface file contains the following section:

              "second": {
                "tag": "DocAppend",
                "first": {
                  "tag": "DocIdentifierUnchecked",
                  "modName": "IO"
                },

The DocIndetifierUnchecked is not the right constructor, it should be DocIdentifier. With haddock-9.6.4 (ver haddock-api-2.29.2):

              "second": {
                "tag": "DocAppend",
                "first": {
                  "tag": "DocIdentifier",
                  "name": "$base$GHC.MVar$newEmptyMVar"
                },

Optional:

  • Operating System: linux
  • System Architecture:
To upload designs, you'll need to enable LFS and have an admin enable hashed storage. More information