Skip to content

Commit 451b914

Browse files
committed
Update Backwards Compatibility
1 parent 16f11ab commit 451b914

File tree

1 file changed

+10
-9
lines changed

1 file changed

+10
-9
lines changed

CONTRIBUTING.md

+10-9
Original file line numberDiff line numberDiff line change
@@ -348,20 +348,21 @@ compatibility with a range of versions of GHC that a library package (such as
348348
Stack aims to depend on well-known packages. The specific versions on which it
349349
depends at any time are specified by `package.yaml` and `stack.yaml`. It does
350350
not aim to be compatible with more than one version of the `Cabal` package at
351-
any time. At the time of writing (December 2024) the package versions are
352-
primarily ones in Stackage snapshot LTS Haskell 23.0 (for GHC 9.8.4).
351+
any time. At the time of writing (March 2025) the package versions are
352+
primarily ones in Stackage snapshot LTS Haskell 23.14 (for GHC 9.8.4) and
353+
`hpack-0.38.0`.
353354

354355
A Stack executable makes use of Cabal (the library) through a small 'Setup'
355356
executable that it compiles from Haskell source code. The executable compiles
356357
that code with a dependency on the version of Cabal that ships with the
357358
specified GHC compiler. Each release of Stack will normally aim to support all
358-
versions of GHC and the Cabal package in Stackage snapshots published within
359-
seven years of the release. For example, snapshot LTS Haskell 10.0, published on
360-
19 December 2017, was the first LTS Haskell snapshot to provide GHC 8.2.2 which
361-
comes with `base-4.10.1.0` and `Cabal-2.0.1.1`. Normally, until, at least,
362-
19 December 2024, Stack releases would aim to support the immediate
363-
predecessor, GHC 8.0.2 and `base-4.9.1.0`, `Cabal-1.24.2.0` and Haddock 2.17.4.
364-
However, the next version of Stack will drop support for versions of Cabal
359+
versions of GHC and the Cabal package in Stackage LTS Haskell snapshots
360+
published within seven years of the release. For example, snapshot LTS Haskell
361+
12.0, published on 9 July 2018, was the first LTS Haskell snapshot to
362+
provide GHC 8.4.3 which comes with `base-4.11.1.0` and `Cabal-2.2.0.1`.
363+
Normally, until, at least, 9 July 2025, Stack releases would aim to support the
364+
immediate predecessor, GHC 8.2.2 and `base-4.10.1.0`, `Cabal-2.0.1.1` and
365+
Haddock 2.18.1. However, Stack 3.1.1 dropped support for versions of Cabal
365366
before 2.2. `Cabal-2.2.0.0` was released with GHC 8.4.1 on 8 March 2018.
366367

367368
When a version of the Stack executable actually ceases to support a version of

0 commit comments

Comments
 (0)