Skip to content

Commit d35b03e

Browse files
committed
Clarify GHC support window
1 parent 48ced8d commit d35b03e

1 file changed

Lines changed: 19 additions & 12 deletions

File tree

CONTRIBUTING.md

Lines changed: 19 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -267,18 +267,25 @@ you push a fix of a whitespace violation, please do so in a _separate commit_. F
267267
support window, except Template Haskell, which would cause
268268
bootstrapping problems in the GHC compilation process.
269269
270-
* Our GHC support window is five years for the Cabal library and three
271-
years for cabal-install: that is, the Cabal library must be
272-
buildable out-of-the-box with the dependencies that shipped with GHC
273-
for at least five years. GitHub Actions checks this, so most
274-
developers submit a PR to see if their code works on all these
275-
versions of GHC. `cabal-install` must also be buildable on all
276-
supported GHCs, although it does not have to be buildable
277-
out-of-the-box. Instead, the `cabal-install/bootstrap.sh` script
278-
must be able to download and install all of the dependencies (this
279-
is also checked by CI). Also, self-upgrade to the latest version
280-
(i.e. `cabal install cabal-install`) must work with all versions of
281-
`cabal-install` released during the last three years.
270+
* Our GHC support window is five years for both the Cabal library and
271+
`cabal-install`. That is:
272+
273+
* for at least five years, the Cabal library must be buildable
274+
out-of-the-box with the dependencies that shipped with GHC;
275+
* for at least five years, `cabal-install` should be buildable with
276+
`cabal-install/bootstrap.sh` script;
277+
* `cabal-install` should work with the most recent version of any GHCs
278+
major version released in the past five years;
279+
280+
Self-upgrade to the latest version (i.e. `cabal install cabal-install`)
281+
must work with all versions of `cabal-install` released during the last
282+
three years.
283+
284+
GitHub Actions checks GHC-support, so most developers submit a PR
285+
to see if their code works on all these versions of GHC.
286+
287+
Cabal maintainers try to support GHC versions older than five years
288+
on best-effort basis.
282289
283290
* `Cabal` has its own Prelude, in `Distribution.Compat.Prelude`,
284291
that provides a compatibility layer and exports some commonly

0 commit comments

Comments
 (0)