Skip to content

Hide Language.Haskell.TH.Lib.Internal from hoogle/haddocks

On this mailing list thread: https://mail.haskell.org/pipermail/ghc-devs/2024-March/021569.html @yav mentions that it's confusing that identifiers from Language.Haskell.TH.Lib.Internal come up when searching on Hoogle and in Haddocks, especially since they have the same names as identifiers from the user-facing Language.Haskell.TH.Lib module.

Perhaps we could hide this module from Hoogle/Haddock to avoid this confusion as this module isn't meant to be user-facing anyway? I think the right way to do this is to add a hide hadddock options pragma to the file. Alternatively we could just remove the module from exposed-modules but that seems like an unnecessary breaking change.

Hackage search1 reveals only HList depends on this module in an example. The other references are from ghc, ghc-lib and ghc-lib-parser, so I don't think users depend on it in practice either.

  1. https://hackage-search.serokell.io/?q=Language.Haskell.TH.Lib.Internal

To upload designs, you'll need to enable LFS and have an admin enable hashed storage. More information