haddock icon indicating copy to clipboard operation
haddock copied to clipboard

ghc-head branch

Open coot opened this issue 1 year ago • 2 comments

I find it quite difficult to use ghc-head branch which requires ghc-9.7 (which one probably needs to install from ghc source repo, rather than with something like ghcup). The CONTRIBUTING file mentioned that PRs should be opened against that branch, is this correct? Why then we have the main branch? It is quite confusing which branch should be used when trying to do something which actually works (currently ghc-9.{4,6} works fine, bug ghc-{head,9.8} require ghc-9.7 for some reason, while the main branch has quite old version of haddock:

branch haddock-api version
main 2.27.0
ghc-9.6 2.28.0
ghc-9.8 2.28.0
ghc-head 2.28.0

This is also confusing when compared to which haddock versions are published with ghc:

ghc version haddock version
9.6.4 2.29.2
9.8.1 2.30.0

The CONTRIBUTING.md file should explain it better to make it much less confusing.

coot avatar Mar 16 '24 16:03 coot