Haddock generation fails for webkit2gtk3-javascriptcore

[sevanspowell]

Issue

Haddock fails to generate documentation for the webkit2gtk3-javascriptcore library.

This creates a difficult to debug error for projects using this dependency, especially when running haskell.nix projects that pull in this project:

Setup: Graphics/UI/Gtk/WebKit/JavaScriptCore/JSValueRef.chi not found in:
/nix/store/a2xpbp9v6qlkq9zh2bcsbfslb5nvc0rd-ghc-8.10.7/lib/ghc-8.10.7/base-4.14.3.0
dist/build
.

Reproduction

On master (b092a70 at the time of writing) reproduce with:

nix-shell --command "cabal haddock"

[sevanspowell]

Workaround

A workaround is to disable Haddock generation for the webkit2gtk3-javascriptcore library.

In a haskell.nix project this can be done with:

  pkgs.haskell-nix.project {

    modules = [
      { packages.webkit2gtk3-javascriptcore.doHaddock = false; }
    ];

    ...
  }

I still think this issue is worth resolving because it's difficult for those less-experienced with haskell.nix to debug.

See this IRC chat from 2021-05-22 that was never resolved: https://logs.nix.samueldr.com/haskell.nix/2021-05-22.