Debian Codegraph @

cabal.project

raw
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: .