Tracking ticket for GHC %9.6.1
This is the release checklist for the %9.6.1 milestone. See #16816 (closed) for the template that this was derived from.
Pre-fork checklist (major-only)
When forking a new release branch for a new major release series (e.g. ghc-9.0
), please check the following:
-
Verify that haddock
's development branch (namely the branch corresponding to GHC's previous major release, e.g.ghc-8.10
) has been merged intoghc-head
. -
Remove the release notes for the previous release (e.g. docs/users_guide/8.6.*-notes.rst
) -
In configure.ac
updateMinBootGhcVersion
to be the major version of the last supported bootstrap compiler. We currently guarantee bootstrapping with the last two major releases; therefore, when preparing, e.g., GHC 9.4 you should setMinBootGhcVersion
to9.0
. -
Create the new branch: git branch ghc-9.0
-
In the new branch bump the version number in configure.ac
to, e.g.,9.0
-
In master
bump the version number inconfigure.ac
to that of the next development series, e.g.,9.1
and ensure thatMinBootGhcVersion
is set correctly -
Tag this master
commit as, e.g.,ghc-9.1-start
-
Push all of the above tags and branches -
After forking remove release notes from master
and start a new set of release notes for the next release
base
Bump Bump bounds of core libraries when bumping base
version number:
-
libraries/directory
: https://github.com/haskell/directory/pull/151 -
libraries/array
-
libraries/deepseq
: https://github.com/haskell/deepseq/pull/91/ -
libraries/filepath
: https://github.com/haskell/filepath/pull/175 -
libraries/haskeline
: https://github.com/judah/haskeline/pull/174 -
libraries/hpc
: -
libraries/parsec
: https://github.com/haskell/parsec/pull/161 -
libraries/process
: https://github.com/haskell/process/pull/269 -
libraries/stm
-
libraries/terminfo
: https://github.com/judah/terminfo/pull/51 -
libraries/unix
: https://github.com/haskell/unix/pull/267 -
utils/haddock
-
utils/hsc2hs
: https://github.com/haskell/hsc2hs/pull/74
Pre-release checklist
-
Ensure that submodules are on released tags (the below is produced using this script): -
libraries/Cabal
: todo (on 3.10.0.0) -
libraries/Win32
: version 2.13.3.0 -
libraries/array
: 0.5.5.0 (onv0.5.5.0
) -
libraries/binary
: 0.8.9.1 (on0.8.9.1
) -
libraries/bytestring
: version 0.11.4.0 -
libraries/containers
: version 0.6.7 -
libraries/deepseq
: 1.4.8.1 (on1.8.0-6-g7e77698
, https://github.com/haskell/deepseq/issues/96) -
libraries/directory
: 1.3.8.1 (onv1.3.8.0-5-g7f90661
, https://github.com/haskell/directory/issues/152) -
libraries/exceptions
: 0.10.7 (onv0.10.7
) -
libraries/filepath
: todo (onv1.4.2.2-97-g7139cd3
, https://github.com/haskell/filepath/issues/180) -
libraries/haskeline
: 0.8.2.1 (on0.8.2-9-gad40faf
, https://github.com/judah/haskeline/issues/175) -
libraries/mtl
: version 2.3.1 -
libraries/parsec
: version 3.1.16.1 -
libraries/pretty
: version 1.1.3.6 -
libraries/process
: version 1.6.17.0 (onv1.6.16.0-14-gd9a8e6e
, https://github.com/haskell/process/issues/276) -
libraries/stm
: version 2.5.1.0r1 (onv2.5.1.0-1-g4ac6ead
) -
libraries/terminfo
: 0.4.1.6 (on0.4.1.5-5-g0a05f06
, https://github.com/judah/terminfo/issues/53, needs revision) -
libraries/text
: 2.0.2 (on2.0.1-26-g197bbcb
, https://github.com/haskell/text/issues/505) -
libraries/time
: version 1.12.2 -
libraries/transformers
: 0.6.1.0 (on0.6.0.4-11-gef4fa18
, #22898 (closed)) -
libraries/unix
: 2.8.1.0 -
libraries/xhtml
: version 3000.2.2.1 -
utils/haddock
: todo (onhaddock-2.26.0-release-153-g37e3c368
) -
utils/hsc2hs
: version 0.68.9 (onv0.68.9
)
-
-
Notify stakeholders of release progress: Julian Ospald <hasufell@posteo.de>, ghc-devs@haskell.org
-
Non-released submodules up-to-date: -
nofib
(upstream: ghc/nofib>) -
libffi-tarballs
(upstream: ghc/libffi-tarballs>) -
libraries/ghc-bignum/gmp/gmp-tarballs
(upstream: ghc/gmp-tarballs>)
-
-
Release notes ( docs/users_guide/x.y.z-notes.rst
) written -
Release notes linked in docs/users_guide/release-notes.rst
-
autoconf
scripts updated -
Update the Hadrian bootstrap metadata -
Check that Unicode database in base
(libraries/base/cbits/README.Unicode
) reflects current standard release (http://www.unicode.org/versions/latest/). -
LlvmVersion
inconfigure.ac
is targetting intended LLVM version -
Release notes mentions LLVM version requirement -
llvm-targets
file updated -
Changelogs updated (these can be checked using .gitlab/linters/check-changelogs.sh
):-
libraries/ghc-prim
-
libraries/ghc-bignum
-
libraries/hpc
(upstream: ghc/hpc>) -
libraries/base
-
-
Verify that the ~"backport needed" label has no more issues/merge requests needing backport -
Verify that all CI builds are green before moving to release checklist -
Update hadrian bootstrap plans for the latest compiler releases
Release checklist
-
Ensure that the Migration page is up-to-date -
Push a provision provisional release commit to trigger the release builds using git push -o ci.variable="RELEASE_JOB=yes"
-
Wait until builds finish; verify that they finished successfully -
Fetch release artifacts TODO: documentation -
Sign and push release artifacts to downloads.haskell.org
[TODO: documentation] -
Make a release tag -
Release/revise GHC-maintained libraries on Hackage using this script: -
libraries/base
-
libraries/ghc-prim
-
libraries/array
-
libraries/stm
-
libraries/ghc-heap
-
libraries/ghc-compact
-
libraries/ghc-boot
-
libraries/ghc-boot-th
-
libraries/hpc
-
libraries/libiserv
-
libraries/template-haskell
-
libraries/ghc-bignum
-
-
Update ghc/homepage>: -
Write download page (see ghc/homepage>) -
Add news item to index.html
-
Add link to download.shtml
. Be sure to link to the Migration guide. -
Look over changes locally -
Add release announcement to GHC blog. Be sure to link to the Migration guide. -
Push changes to master
-
-
Announce on: GHC developers <ghc-devs@haskell.org>, GHC Users <glasgow-haskell-users@haskell.org>, Haskell Cafe <haskell-cafe@haskell.org>
-
Announce on: Haskell Discourse, /r/haskell, Twitter -
Update latest
symlink ondownloads.haskell.org
Post-release checklist
-
Update the Wiki status page -
Update the language pragma history -
Mark milestone as closed -
Update /topic
in#ghc
-
Update the VersionHistory wiki page -
Set RELEASE=NO
-
Create a release tracking ticket for the next release using the template in #16816 (closed)