| 1 |
-- This file is a configuration file for Cabal (the tool). It is provided to |
| 2 |
-- assist some users of that tool to develop Stack. For information about |
| 3 |
-- `cabal.project` files, see: |
| 4 |
-- https://cabal.readthedocs.io/en/stable/cabal-project.html. |
| 5 |
-- |
| 6 |
-- For information about possible limitations of the `cabal.config` files |
| 7 |
-- corresponding to Stackage package sets that are made available by Stackage |
| 8 |
-- see: https://github.com/fpco/stackage-server/issues/232. |
| 9 |
-- |
| 10 |
-- `import:` is only available to users of Cabal (the tool) >= 3.8.1.0. |
| 11 |
-- |
| 12 |
-- The constraints in file `cabal.config` can be obtained by commanding: |
| 13 |
-- |
| 14 |
-- > stack ls dependencies cabal > cabal.config |
| 15 |
-- |
| 16 |
-- However, be aware that, in respect of the `unix` package or the `Win32` |
| 17 |
-- package (that may come with GHC, depending on the operating system): |
| 18 |
-- |
| 19 |
-- * on Windows, the Stack project does not depend on `unix` but depends on |
| 20 |
-- `Win32`; and |
| 21 |
-- |
| 22 |
-- * on non-Windows operating systems, the Stack project does not depend on |
| 23 |
-- `Win32` but depends on `unix`. |
| 24 |
-- |
| 25 |
-- The command above will add one of the two packages to `cabal.config` but omit |
| 26 |
-- the other. A comprehensive `cabal.config` will need to be created by editing |
| 27 |
-- the command's output. |
| 28 |
-- |
| 29 |
-- Also be aware that there may be other packages required only on non-Windows |
| 30 |
-- systems. For example, the `hinotify` package. |
| 31 |
-- |
| 32 |
-- Be sure to set `with-compiler: ghc-x.y.z` below to the version of GHC that is |
| 33 |
-- specified by the snapshot specifed in Stack's project-level YAML |
| 34 |
-- configuration file (`stack.yaml`). The relevant version of GHC can be |
| 35 |
-- confirmed by reviewing the snapshot on Stackage. For example, at: |
| 36 |
-- https://www.stackage.org/lts-23.24/cabal.config. |
| 37 |
-- |
| 38 |
with-compiler: ghc-9.8.4 |
| 39 |
import: cabal.config |
| 40 |
packages: . |