Linking to local haddocks

Learn
1

I was in a position where I had to do some work with a spotty connection and I was wondering if this is something I can configure to better leverage the locally installed haddocks.

Right now I have a cabal.project containing
haddock-html-location: http://hackage.haskell.org/packages/archive/$pkg/latest/doc/html

I was hoping to have this instead link to the html files located in my ghcup installation ...\Debian\home\deepak\.ghcup\ghc\9.12.2\share\doc\ghc-9.12.2\html\libraries using something like -- haddock-html-location: /Debian/home/deepak/.ghcup/ghc/9.12.2/share/doc/ghc-9.12.2/html/libraries/$pkgid but the problem is the local files have an abi tag appended to each package (base-4.21.0.0-2257 instead of base-4.21.0.0)

Is there a built-in option I’m missing that would make this work? The $abiTag from 6. Setup.hs Commands — Cabal 3.16.0.0 User's Guide is specific to the compiler, and I wasn’t able to track down anything more granular than $pkgid

1 Like
2

Some non-solutions that have helped me in the past:

  • cabal haddock --open, and then finding the packages I need by chasing links, once I get a sense of the filesystem layout; and
  • ls -d /nix/store/*-$pkg-*-doc, if you’re using Nix (sounds like you aren’t, but other readers might be)
3

This might be what you are looking for.