--- /srv/reproducible-results/rbuild-debian/r-b-build.JBscJPQN/b1/haskell-cabal-install_3.0.0.0-3_armhf.changes +++ /srv/reproducible-results/rbuild-debian/r-b-build.JBscJPQN/b2/haskell-cabal-install_3.0.0.0-3_armhf.changes ├── Files │ @@ -1,2 +1,2 @@ │ │ - 3e77706ef62e27460234e315f5e1b4cd 4496452 haskell optional cabal-install_3.0.0.0-3_armhf.deb │ + ef3720e57775cba7a7f5c9de503240fe 4509144 haskell optional cabal-install_3.0.0.0-3_armhf.deb ├── cabal-install_3.0.0.0-3_armhf.deb │ ├── file list │ │ @@ -1,3 +1,3 @@ │ │ -rw-r--r-- 0 0 0 4 2020-06-07 17:22:35.000000 debian-binary │ │ -rw-r--r-- 0 0 0 932 2020-06-07 17:22:35.000000 control.tar.xz │ │ --rw-r--r-- 0 0 0 4495328 2020-06-07 17:22:35.000000 data.tar.xz │ │ +-rw-r--r-- 0 0 0 4508020 2020-06-07 17:22:35.000000 data.tar.xz │ ├── control.tar.xz │ │ ├── control.tar │ │ │ ├── ./control │ │ │ │ @@ -1,13 +1,13 @@ │ │ │ │ Package: cabal-install │ │ │ │ Source: haskell-cabal-install │ │ │ │ Version: 3.0.0.0-3 │ │ │ │ Architecture: armhf │ │ │ │ Maintainer: Debian Haskell Group │ │ │ │ -Installed-Size: 27468 │ │ │ │ +Installed-Size: 27483 │ │ │ │ Depends: ghc (>= 8.4.3), libc6 (>= 2.29), libffi7 (>= 3.3~20180313), libgmp10, zlib1g (>= 1:1.1.4) │ │ │ │ Recommends: curl | wget │ │ │ │ Section: haskell │ │ │ │ Priority: optional │ │ │ │ Homepage: https://www.haskell.org/cabal/ │ │ │ │ Description: command-line interface for Cabal and Hackage │ │ │ │ The 'cabal' command-line program simplifies the process of managing │ │ │ ├── ./md5sums │ │ │ │ ├── ./md5sums │ │ │ │ │┄ Files differ │ ├── data.tar.xz │ │ ├── data.tar │ │ │ ├── file list │ │ │ │ @@ -13,8 +13,8 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 10615 2001-09-09 01:46:40.000000 ./usr/share/doc/cabal-install/changelog.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 4473 2020-06-06 20:13:54.000000 ./usr/share/doc/cabal-install/copyright │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2020-06-07 17:22:35.000000 ./usr/share/lintian/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2020-06-07 17:22:35.000000 ./usr/share/lintian/overrides/ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 30 2020-02-08 01:58:08.000000 ./usr/share/lintian/overrides/cabal-install │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2020-06-07 17:22:35.000000 ./usr/share/man/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2020-06-07 17:22:35.000000 ./usr/share/man/man1/ │ │ │ │ --rw-r--r-- 0 root (0) root (0) 19293 2020-06-07 17:22:35.000000 ./usr/share/man/man1/cabal.1.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 33865 2020-06-07 17:22:35.000000 ./usr/share/man/man1/cabal.1.gz │ │ │ ├── ./usr/share/man/man1/cabal.1.gz │ │ │ │ ├── cabal.1 │ │ │ │ │ @@ -33480,7 +33480,18177 @@ │ │ │ │ │ \-\-c2hs-option │ │ │ │ │ .I OPT │ │ │ │ │ .RS │ │ │ │ │ give an extra option to c2hs (no need to quote options containing spaces) │ │ │ │ │ .RE │ │ │ │ │ │ │ │ │ │ \-\-cpphs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to cpphs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to doctest (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to gcc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to greencard (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haddock (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to happy (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hmake (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hpc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hsc2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hscolour (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to jhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ld (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to pkg-config (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to runghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to strip (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to tar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to uhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-lib-version │ │ │ │ │ +.I VERSION │ │ │ │ │ +.RS │ │ │ │ │ +Select which version of the Cabal lib to use to build packages (useful for testing). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-constraint │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify constraints on a package (version, installed/source, flags) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-preference │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify preferences (soft constraints) on the version of a package │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-solver │ │ │ │ │ +.I SOLVER │ │ │ │ │ +.RS │ │ │ │ │ +Select dependency solver to use (default: modular). Choices: modular. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-older │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore lower bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-newer │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore upper bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-write-ghc-environment-files │ │ │ │ │ +.I always|never|ghc8.4.4+ │ │ │ │ │ +.RS │ │ │ │ │ +Whether to create a .ghc.environment file after a successful build (v2-build only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-documentation │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-documentation │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +building of documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doc-index-file │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +A central index of haddock API documentation (template cannot use $pkgid) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dry-run │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not install anything, only print what would be installed. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-max-backjumps │ │ │ │ │ +.I NUM │ │ │ │ │ +.RS │ │ │ │ │ +Maximum number of backjumps allowed while solving (default: 4000). Use a negative number to enable unlimited backtracking. Use 0 to disable backtracking completely. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to reorder goals according to certain heuristics. Slows things down on average, but may make backtracking faster for some packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to speed up solving by preferring goals that are involved in a lot of conflicts (default). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +When there is no solution, try to improve the error message by finding a minimal conflict set (default: false). May increase run time significantly. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Treat several goals on the command line as independent. If several goals depend on the same package, different versions can be chosen. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +If multiple package instances of the same version are installed, treat all but one as shadowed. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not defer flag choices (this used to be the default in cabal-install <= 1.20). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow cabal to install base, ghc-prim, integer-simple, integer-gmp, and template-haskell. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reject-unconstrained-dependencies │ │ │ │ │ +.I none|all │ │ │ │ │ +.RS │ │ │ │ │ +Require these packages to have constraints on them if they are to be selected (default: none). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reinstall │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-reinstall │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Install even if it means installing the same version again. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-avoid-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-avoid-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not select versions that would destructively overwrite installed packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-force-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-force-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Reinstall packages even if they will most likely break other installed packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-upgrade-dependencies │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-upgrade-dependencies │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Pick the latest version for all dependencies, rather than trying to pick an installed version. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only-dependencies │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-only-dependencies │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Install only the dependencies necessary to build the given packages │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dependencies-only │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-dependencies-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +A synonym for --only-dependencies │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-index-state │ │ │ │ │ +.I STATE │ │ │ │ │ +.RS │ │ │ │ │ +Use source package index state as it existed at a previous time. Accepts unix-timestamps (e.g. '@1474732068'), ISO8601 UTC timestamps (e.g. '2016-09-24T17:47:48Z'), or 'HEAD' (default: 'HEAD'). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-root-cmd │ │ │ │ │ +.I COMMAND │ │ │ │ │ +.RS │ │ │ │ │ +(No longer supported, do not use.) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-symlink-bindir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +Add symlinks to installed executables into this directory. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-build-summary │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Save build summaries to file (name template can use $pkgid, $compiler, $os, $arch) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-build-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Log all builds to file (name template can use $pkgid, $compiler, $os, $arch) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-remote-build-reporting │ │ │ │ │ +.I LEVEL │ │ │ │ │ +.RS │ │ │ │ │ +Generate build reports to send to a remote server (none, anonymous or detailed). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-report-planning-failure │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate build reports when the dependency solver fails. This is used by the Hackage build bot. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-per-component │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-per-component │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Per-component builds when possible │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-one-shot │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-one-shot │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not record the packages in the world file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-run-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run package test suites during installation. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-j, \-\-jobs │ │ │ │ │ +.RI [ NUM ] │ │ │ │ │ +.RS │ │ │ │ │ +Run NUM jobs simultaneously (or '$ncpus' if no NUM is given). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-keep-going │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +After a build failure, continue to build other unaffected packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-offline │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-offline │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Don't download packages from the Internet. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-project-file │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Set the name of the cabal.project file to search for in parent directories │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Only installs the package in the current directory. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hoogle │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate a hoogle database │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-html │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate HTML documentation (the default) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-html-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Location of HTML documentation for pre-requisite packages │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-for-hackage │ │ │ │ │ +.RS │ │ │ │ │ +Collection of flags to generate documentation suitable for upload to hackage │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-executables │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Executables targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Test Suite targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Benchmark targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-all │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for all targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-internal │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for internal modules and include all symbols │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the haddock stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hyperlink-source, \-\-haddock-hyperlink-sources, \-\-haddock-hyperlinked-source │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Hyperlink the documentation to the source code │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-quickjump │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate an index for interactive documentation navigation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hscolour-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the HsColour stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-contents-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Bake URL in as the location for the contents page │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Log all test suite results to file (name template can use $pkgid, $compiler, $os, $arch, $test-suite, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-machine-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Produce a machine-readable log file (name template can use $pkgid, $compiler, $os, $arch, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-show-details │ │ │ │ │ +.I FILTER │ │ │ │ │ +.RS │ │ │ │ │ +'always': always show results of individual test cases. 'never': never show results of individual test cases. 'failures': show results of failing test cases. 'streaming': show results of test cases in real time.'direct': send results of test cases in real time; no log file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-keep-tix-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +keep .tix files for HPC between test runs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-wrapper │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Run test through a wrapper. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-fail-when-no-test-suites │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Exit with failure when no test suites are found. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-options │ │ │ │ │ +.I TEMPLATES │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to test executables (name templates can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-option │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +give extra option to test executables (no need to quote options containing spaces, name template can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal new-test │ │ │ │ │ + │ │ │ │ │ +Usage: cabal new-test [TARGETS] [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Runs the specified test-suites, first ensuring they are up to date. │ │ │ │ │ + │ │ │ │ │ +Any test-suite in any package in the project can be specified. A package can │ │ │ │ │ +be specified in which case all the test-suites in the package are run. The │ │ │ │ │ +default is to run all the test-suites in the package in the current directory. │ │ │ │ │ + │ │ │ │ │ +Dependencies are built or rebuilt as necessary. Additional configuration flags │ │ │ │ │ +can be specified on the command line and these extend the project │ │ │ │ │ +configuration from the 'cabal.project', 'cabal.project.local' and other files. │ │ │ │ │ + │ │ │ │ │ +To pass command-line arguments to a test suite, see the new-run command. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Runs the specified test-suites, first ensuring they are up to date. │ │ │ │ │ + │ │ │ │ │ +Any test-suite in any package in the project can be specified. A package can │ │ │ │ │ +be specified in which case all the test-suites in the package are run. The │ │ │ │ │ +default is to run all the test-suites in the package in the current directory. │ │ │ │ │ + │ │ │ │ │ +Dependencies are built or rebuilt as necessary. Additional configuration flags │ │ │ │ │ +can be specified on the command line and these extend the project │ │ │ │ │ +configuration from the 'cabal.project', 'cabal.project.local' and other files. │ │ │ │ │ + │ │ │ │ │ +To pass command-line arguments to a test suite, see the new-run command. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-g, \-\-ghc │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHCJS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc │ │ │ │ │ +.RS │ │ │ │ │ +compile with UHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite │ │ │ │ │ +.RS │ │ │ │ │ +compile with a haskell-suite compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-file │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +use this Cabal file │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-w, \-\-with-compiler │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to a particular compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to the package tool │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-prefix │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +bake this prefix in preparation of installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-bindir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libdir in which libs are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dynlibdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for dynamic libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for program executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libexecdir in which private executables are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datadir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for read-only data │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datasubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of datadir in which data files are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-docdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-htmldir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for HTML documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddockdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for haddock interfaces │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-sysconfdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for configuration files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-prefix │ │ │ │ │ +.I PREFIX │ │ │ │ │ +.RS │ │ │ │ │ +prefix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-suffix │ │ │ │ │ +.I SUFFIX │ │ │ │ │ +.RS │ │ │ │ │ +suffix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Vanilla libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-p, \-\-enable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-shared │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-shared │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Shared library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Static library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable dynamic linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable fully static linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable and library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable profiling (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for executable and library (default, none, exported-functions, toplevel-functions, all-functions). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-library-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for libraries only. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-O, \-\-enable-optimization, \-\-enable-optimisation │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Build with optimization (n is 0--2, default is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-optimization, \-\-disable-optimisation │ │ │ │ │ +.RS │ │ │ │ │ +Build without optimization │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-debug-info │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Emit debug info (n is 0--3, default is 0) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-debug-info │ │ │ │ │ +.RS │ │ │ │ │ +Don't emit debug info │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library for use with GHCi │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library code such that unneeded definitions can be dropped from the final executable (GHC 7.8+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +split library into smaller objects to reduce binary sizes (GHC 6.6+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip executables upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip libraries upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-configure-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +Extra option for configure │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-user │ │ │ │ │ +.br │ │ │ │ │ +\-\-global │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +doing a per-user installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-package-db │ │ │ │ │ +.I DB │ │ │ │ │ +.RS │ │ │ │ │ +Append the given package database to the list of package databases used (to satisfy dependencies and register into). May be a specific file, 'global' or 'user'. The initial list is ['global'], ['global', 'user'], or ['global', $sandbox], depending on context. Use 'clear' to reset the list to empty. See the user guide for details. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-f, \-\-flags │ │ │ │ │ +.I FLAGS │ │ │ │ │ +.RS │ │ │ │ │ +Force values for the given flags in Cabal conditionals in the .cabal file. E.g., --flags="debug -usebytestrings" forces the flag "debug" to true and "usebytestrings" to false. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-include-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for header files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to be as deterministic as possible (used by the test suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ipid │ │ │ │ │ +.I IPID │ │ │ │ │ +.RS │ │ │ │ │ +Installed package ID to compile this package as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cid │ │ │ │ │ +.I CID │ │ │ │ │ +.RS │ │ │ │ │ +Installed component ID to compile this component as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-lib-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-framework-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external frameworks (OS X only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-prog-path │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for required programs (in addition to the normal search locations) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-instantiate-with │ │ │ │ │ +.I NAME=MOD │ │ │ │ │ +.RS │ │ │ │ │ +A mapping of signature names to concrete module instantiations. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-tests │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for test suites listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for benchmarks listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +building a package that is relocatable. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-response-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +enable workaround for old versions of programs like "ar" that do not support @file arguments │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-depending-on-private-libs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow depending on private libraries. If set, the library visibility check MUST be done externally. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-alex │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-c2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-cpphs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-doctest │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-gcc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-greencard │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haddock │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-happy │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hmake │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hpc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hsc2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hscolour │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-jhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ld │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-pkg-config │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-runghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-strip │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-tar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-uhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to alex (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to c2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to cpphs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to doctest (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to gcc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to greencard (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haddock (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to happy (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hmake (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hpc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hsc2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hscolour (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to jhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ld (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to pkg-config (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to runghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to strip (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to tar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to uhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-lib-version │ │ │ │ │ +.I VERSION │ │ │ │ │ +.RS │ │ │ │ │ +Select which version of the Cabal lib to use to build packages (useful for testing). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-constraint │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify constraints on a package (version, installed/source, flags) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-preference │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify preferences (soft constraints) on the version of a package │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-solver │ │ │ │ │ +.I SOLVER │ │ │ │ │ +.RS │ │ │ │ │ +Select dependency solver to use (default: modular). Choices: modular. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-older │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore lower bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-newer │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore upper bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-write-ghc-environment-files │ │ │ │ │ +.I always|never|ghc8.4.4+ │ │ │ │ │ +.RS │ │ │ │ │ +Whether to create a .ghc.environment file after a successful build (v2-build only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-documentation │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-documentation │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +building of documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doc-index-file │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +A central index of haddock API documentation (template cannot use $pkgid) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dry-run │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not install anything, only print what would be installed. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-max-backjumps │ │ │ │ │ +.I NUM │ │ │ │ │ +.RS │ │ │ │ │ +Maximum number of backjumps allowed while solving (default: 4000). Use a negative number to enable unlimited backtracking. Use 0 to disable backtracking completely. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to reorder goals according to certain heuristics. Slows things down on average, but may make backtracking faster for some packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to speed up solving by preferring goals that are involved in a lot of conflicts (default). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +When there is no solution, try to improve the error message by finding a minimal conflict set (default: false). May increase run time significantly. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Treat several goals on the command line as independent. If several goals depend on the same package, different versions can be chosen. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +If multiple package instances of the same version are installed, treat all but one as shadowed. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not defer flag choices (this used to be the default in cabal-install <= 1.20). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow cabal to install base, ghc-prim, integer-simple, integer-gmp, and template-haskell. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reject-unconstrained-dependencies │ │ │ │ │ +.I none|all │ │ │ │ │ +.RS │ │ │ │ │ +Require these packages to have constraints on them if they are to be selected (default: none). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reinstall │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-reinstall │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Install even if it means installing the same version again. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-avoid-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-avoid-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not select versions that would destructively overwrite installed packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-force-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-force-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Reinstall packages even if they will most likely break other installed packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-upgrade-dependencies │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-upgrade-dependencies │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Pick the latest version for all dependencies, rather than trying to pick an installed version. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only-dependencies │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-only-dependencies │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Install only the dependencies necessary to build the given packages │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dependencies-only │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-dependencies-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +A synonym for --only-dependencies │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-index-state │ │ │ │ │ +.I STATE │ │ │ │ │ +.RS │ │ │ │ │ +Use source package index state as it existed at a previous time. Accepts unix-timestamps (e.g. '@1474732068'), ISO8601 UTC timestamps (e.g. '2016-09-24T17:47:48Z'), or 'HEAD' (default: 'HEAD'). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-root-cmd │ │ │ │ │ +.I COMMAND │ │ │ │ │ +.RS │ │ │ │ │ +(No longer supported, do not use.) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-symlink-bindir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +Add symlinks to installed executables into this directory. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-build-summary │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Save build summaries to file (name template can use $pkgid, $compiler, $os, $arch) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-build-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Log all builds to file (name template can use $pkgid, $compiler, $os, $arch) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-remote-build-reporting │ │ │ │ │ +.I LEVEL │ │ │ │ │ +.RS │ │ │ │ │ +Generate build reports to send to a remote server (none, anonymous or detailed). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-report-planning-failure │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate build reports when the dependency solver fails. This is used by the Hackage build bot. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-per-component │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-per-component │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Per-component builds when possible │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-one-shot │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-one-shot │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not record the packages in the world file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-run-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run package test suites during installation. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-j, \-\-jobs │ │ │ │ │ +.RI [ NUM ] │ │ │ │ │ +.RS │ │ │ │ │ +Run NUM jobs simultaneously (or '$ncpus' if no NUM is given). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-keep-going │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +After a build failure, continue to build other unaffected packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-offline │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-offline │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Don't download packages from the Internet. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-project-file │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Set the name of the cabal.project file to search for in parent directories │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Only installs the package in the current directory. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hoogle │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate a hoogle database │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-html │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate HTML documentation (the default) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-html-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Location of HTML documentation for pre-requisite packages │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-for-hackage │ │ │ │ │ +.RS │ │ │ │ │ +Collection of flags to generate documentation suitable for upload to hackage │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-executables │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Executables targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Test Suite targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Benchmark targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-all │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for all targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-internal │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for internal modules and include all symbols │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the haddock stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hyperlink-source, \-\-haddock-hyperlink-sources, \-\-haddock-hyperlinked-source │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Hyperlink the documentation to the source code │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-quickjump │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate an index for interactive documentation navigation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hscolour-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the HsColour stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-contents-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Bake URL in as the location for the contents page │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Log all test suite results to file (name template can use $pkgid, $compiler, $os, $arch, $test-suite, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-machine-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Produce a machine-readable log file (name template can use $pkgid, $compiler, $os, $arch, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-show-details │ │ │ │ │ +.I FILTER │ │ │ │ │ +.RS │ │ │ │ │ +'always': always show results of individual test cases. 'never': never show results of individual test cases. 'failures': show results of failing test cases. 'streaming': show results of test cases in real time.'direct': send results of test cases in real time; no log file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-keep-tix-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +keep .tix files for HPC between test runs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-wrapper │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Run test through a wrapper. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-fail-when-no-test-suites │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Exit with failure when no test suites are found. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-options │ │ │ │ │ +.I TEMPLATES │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to test executables (name templates can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-option │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +give extra option to test executables (no need to quote options containing spaces, name template can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v2-test │ │ │ │ │ + │ │ │ │ │ +Usage: cabal v2-test [TARGETS] [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Runs the specified test-suites, first ensuring they are up to date. │ │ │ │ │ + │ │ │ │ │ +Any test-suite in any package in the project can be specified. A package can │ │ │ │ │ +be specified in which case all the test-suites in the package are run. The │ │ │ │ │ +default is to run all the test-suites in the package in the current directory. │ │ │ │ │ + │ │ │ │ │ +Dependencies are built or rebuilt as necessary. Additional configuration flags │ │ │ │ │ +can be specified on the command line and these extend the project │ │ │ │ │ +configuration from the 'cabal.project', 'cabal.project.local' and other files. │ │ │ │ │ + │ │ │ │ │ +To pass command-line arguments to a test suite, see the v2-run command. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Examples: │ │ │ │ │ + cabal v2-test │ │ │ │ │ + Run all the test-suites in the package in the current directory │ │ │ │ │ + cabal v2-test pkgname │ │ │ │ │ + Run all the test-suites in the package named pkgname │ │ │ │ │ + cabal v2-test cname │ │ │ │ │ + Run the test-suite named cname │ │ │ │ │ + cabal v2-test cname --enable-coverage │ │ │ │ │ + Run the test-suite built with code coverage (including local libs used) │ │ │ │ │ + │ │ │ │ │ +Note: this command is part of the new project-based system (aka nix-style │ │ │ │ │ +local builds). These features are currently in beta. Please see │ │ │ │ │ +http://cabal.readthedocs.io/en/latest/nix-local-build-overview.html for │ │ │ │ │ +details and advice on what you can expect to work. If you encounter problems │ │ │ │ │ +please file issues at https://github.com/haskell/cabal/issues and if you │ │ │ │ │ +have any time to get involved and help with testing, fixing bugs etc then │ │ │ │ │ +that is very much appreciated. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-g, \-\-ghc │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHCJS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc │ │ │ │ │ +.RS │ │ │ │ │ +compile with UHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite │ │ │ │ │ +.RS │ │ │ │ │ +compile with a haskell-suite compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-file │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +use this Cabal file │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-w, \-\-with-compiler │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to a particular compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to the package tool │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-prefix │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +bake this prefix in preparation of installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-bindir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libdir in which libs are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dynlibdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for dynamic libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for program executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libexecdir in which private executables are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datadir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for read-only data │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datasubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of datadir in which data files are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-docdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-htmldir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for HTML documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddockdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for haddock interfaces │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-sysconfdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for configuration files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-prefix │ │ │ │ │ +.I PREFIX │ │ │ │ │ +.RS │ │ │ │ │ +prefix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-suffix │ │ │ │ │ +.I SUFFIX │ │ │ │ │ +.RS │ │ │ │ │ +suffix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Vanilla libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-p, \-\-enable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-shared │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-shared │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Shared library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Static library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable dynamic linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable fully static linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable and library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable profiling (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for executable and library (default, none, exported-functions, toplevel-functions, all-functions). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-library-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for libraries only. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-O, \-\-enable-optimization, \-\-enable-optimisation │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Build with optimization (n is 0--2, default is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-optimization, \-\-disable-optimisation │ │ │ │ │ +.RS │ │ │ │ │ +Build without optimization │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-debug-info │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Emit debug info (n is 0--3, default is 0) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-debug-info │ │ │ │ │ +.RS │ │ │ │ │ +Don't emit debug info │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library for use with GHCi │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library code such that unneeded definitions can be dropped from the final executable (GHC 7.8+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +split library into smaller objects to reduce binary sizes (GHC 6.6+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip executables upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip libraries upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-configure-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +Extra option for configure │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-user │ │ │ │ │ +.br │ │ │ │ │ +\-\-global │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +doing a per-user installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-package-db │ │ │ │ │ +.I DB │ │ │ │ │ +.RS │ │ │ │ │ +Append the given package database to the list of package databases used (to satisfy dependencies and register into). May be a specific file, 'global' or 'user'. The initial list is ['global'], ['global', 'user'], or ['global', $sandbox], depending on context. Use 'clear' to reset the list to empty. See the user guide for details. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-f, \-\-flags │ │ │ │ │ +.I FLAGS │ │ │ │ │ +.RS │ │ │ │ │ +Force values for the given flags in Cabal conditionals in the .cabal file. E.g., --flags="debug -usebytestrings" forces the flag "debug" to true and "usebytestrings" to false. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-include-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for header files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to be as deterministic as possible (used by the test suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ipid │ │ │ │ │ +.I IPID │ │ │ │ │ +.RS │ │ │ │ │ +Installed package ID to compile this package as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cid │ │ │ │ │ +.I CID │ │ │ │ │ +.RS │ │ │ │ │ +Installed component ID to compile this component as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-lib-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-framework-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external frameworks (OS X only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-prog-path │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for required programs (in addition to the normal search locations) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-instantiate-with │ │ │ │ │ +.I NAME=MOD │ │ │ │ │ +.RS │ │ │ │ │ +A mapping of signature names to concrete module instantiations. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-tests │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for test suites listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for benchmarks listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +building a package that is relocatable. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-response-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +enable workaround for old versions of programs like "ar" that do not support @file arguments │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-depending-on-private-libs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow depending on private libraries. If set, the library visibility check MUST be done externally. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-alex │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-c2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-cpphs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-doctest │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-gcc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-greencard │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haddock │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-happy │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hmake │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hpc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hsc2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hscolour │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-jhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ld │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-pkg-config │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-runghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-strip │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-tar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-uhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to alex (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to c2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to cpphs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to doctest (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to gcc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to greencard (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haddock (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to happy (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hmake (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hpc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hsc2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hscolour (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to jhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ld (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to pkg-config (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to runghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to strip (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to tar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to uhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-lib-version │ │ │ │ │ +.I VERSION │ │ │ │ │ +.RS │ │ │ │ │ +Select which version of the Cabal lib to use to build packages (useful for testing). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-constraint │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify constraints on a package (version, installed/source, flags) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-preference │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify preferences (soft constraints) on the version of a package │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-solver │ │ │ │ │ +.I SOLVER │ │ │ │ │ +.RS │ │ │ │ │ +Select dependency solver to use (default: modular). Choices: modular. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-older │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore lower bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-newer │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore upper bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-write-ghc-environment-files │ │ │ │ │ +.I always|never|ghc8.4.4+ │ │ │ │ │ +.RS │ │ │ │ │ +Whether to create a .ghc.environment file after a successful build (v2-build only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-documentation │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-documentation │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +building of documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doc-index-file │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +A central index of haddock API documentation (template cannot use $pkgid) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dry-run │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not install anything, only print what would be installed. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-max-backjumps │ │ │ │ │ +.I NUM │ │ │ │ │ +.RS │ │ │ │ │ +Maximum number of backjumps allowed while solving (default: 4000). Use a negative number to enable unlimited backtracking. Use 0 to disable backtracking completely. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to reorder goals according to certain heuristics. Slows things down on average, but may make backtracking faster for some packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to speed up solving by preferring goals that are involved in a lot of conflicts (default). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +When there is no solution, try to improve the error message by finding a minimal conflict set (default: false). May increase run time significantly. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Treat several goals on the command line as independent. If several goals depend on the same package, different versions can be chosen. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +If multiple package instances of the same version are installed, treat all but one as shadowed. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not defer flag choices (this used to be the default in cabal-install <= 1.20). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow cabal to install base, ghc-prim, integer-simple, integer-gmp, and template-haskell. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reject-unconstrained-dependencies │ │ │ │ │ +.I none|all │ │ │ │ │ +.RS │ │ │ │ │ +Require these packages to have constraints on them if they are to be selected (default: none). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reinstall │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-reinstall │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Install even if it means installing the same version again. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-avoid-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-avoid-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not select versions that would destructively overwrite installed packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-force-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-force-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Reinstall packages even if they will most likely break other installed packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-upgrade-dependencies │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-upgrade-dependencies │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Pick the latest version for all dependencies, rather than trying to pick an installed version. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only-dependencies │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-only-dependencies │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Install only the dependencies necessary to build the given packages │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dependencies-only │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-dependencies-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +A synonym for --only-dependencies │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-index-state │ │ │ │ │ +.I STATE │ │ │ │ │ +.RS │ │ │ │ │ +Use source package index state as it existed at a previous time. Accepts unix-timestamps (e.g. '@1474732068'), ISO8601 UTC timestamps (e.g. '2016-09-24T17:47:48Z'), or 'HEAD' (default: 'HEAD'). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-root-cmd │ │ │ │ │ +.I COMMAND │ │ │ │ │ +.RS │ │ │ │ │ +(No longer supported, do not use.) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-symlink-bindir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +Add symlinks to installed executables into this directory. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-build-summary │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Save build summaries to file (name template can use $pkgid, $compiler, $os, $arch) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-build-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Log all builds to file (name template can use $pkgid, $compiler, $os, $arch) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-remote-build-reporting │ │ │ │ │ +.I LEVEL │ │ │ │ │ +.RS │ │ │ │ │ +Generate build reports to send to a remote server (none, anonymous or detailed). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-report-planning-failure │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate build reports when the dependency solver fails. This is used by the Hackage build bot. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-per-component │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-per-component │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Per-component builds when possible │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-one-shot │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-one-shot │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not record the packages in the world file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-run-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run package test suites during installation. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-j, \-\-jobs │ │ │ │ │ +.RI [ NUM ] │ │ │ │ │ +.RS │ │ │ │ │ +Run NUM jobs simultaneously (or '$ncpus' if no NUM is given). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-keep-going │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +After a build failure, continue to build other unaffected packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-offline │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-offline │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Don't download packages from the Internet. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-project-file │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Set the name of the cabal.project file to search for in parent directories │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Only installs the package in the current directory. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hoogle │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate a hoogle database │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-html │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate HTML documentation (the default) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-html-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Location of HTML documentation for pre-requisite packages │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-for-hackage │ │ │ │ │ +.RS │ │ │ │ │ +Collection of flags to generate documentation suitable for upload to hackage │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-executables │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Executables targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Test Suite targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Benchmark targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-all │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for all targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-internal │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for internal modules and include all symbols │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the haddock stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hyperlink-source, \-\-haddock-hyperlink-sources, \-\-haddock-hyperlinked-source │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Hyperlink the documentation to the source code │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-quickjump │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate an index for interactive documentation navigation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hscolour-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the HsColour stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-contents-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Bake URL in as the location for the contents page │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Log all test suite results to file (name template can use $pkgid, $compiler, $os, $arch, $test-suite, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-machine-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Produce a machine-readable log file (name template can use $pkgid, $compiler, $os, $arch, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-show-details │ │ │ │ │ +.I FILTER │ │ │ │ │ +.RS │ │ │ │ │ +'always': always show results of individual test cases. 'never': never show results of individual test cases. 'failures': show results of failing test cases. 'streaming': show results of test cases in real time.'direct': send results of test cases in real time; no log file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-keep-tix-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +keep .tix files for HPC between test runs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-wrapper │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Run test through a wrapper. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-fail-when-no-test-suites │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Exit with failure when no test suites are found. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-options │ │ │ │ │ +.I TEMPLATES │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to test executables (name templates can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-option │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +give extra option to test executables (no need to quote options containing spaces, name template can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal bench │ │ │ │ │ + │ │ │ │ │ +Usage: cabal bench [TARGETS] [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Runs the specified benchmarks, first ensuring they are up to date. │ │ │ │ │ + │ │ │ │ │ +Any benchmark in any package in the project can be specified. A package can be │ │ │ │ │ +specified in which case all the benchmarks in the package are run. The default │ │ │ │ │ +is to run all the benchmarks in the package in the current directory. │ │ │ │ │ + │ │ │ │ │ +Dependencies are built or rebuilt as necessary. Additional configuration flags │ │ │ │ │ +can be specified on the command line and these extend the project │ │ │ │ │ +configuration from the 'cabal.project', 'cabal.project.local' and other files. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Runs the specified benchmarks, first ensuring they are up to date. │ │ │ │ │ + │ │ │ │ │ +Any benchmark in any package in the project can be specified. A package can be │ │ │ │ │ +specified in which case all the benchmarks in the package are run. The default │ │ │ │ │ +is to run all the benchmarks in the package in the current directory. │ │ │ │ │ + │ │ │ │ │ +Dependencies are built or rebuilt as necessary. Additional configuration flags │ │ │ │ │ +can be specified on the command line and these extend the project │ │ │ │ │ +configuration from the 'cabal.project', 'cabal.project.local' and other files. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-g, \-\-ghc │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHCJS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc │ │ │ │ │ +.RS │ │ │ │ │ +compile with UHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite │ │ │ │ │ +.RS │ │ │ │ │ +compile with a haskell-suite compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-file │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +use this Cabal file │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-w, \-\-with-compiler │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to a particular compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to the package tool │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-prefix │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +bake this prefix in preparation of installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-bindir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libdir in which libs are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dynlibdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for dynamic libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for program executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libexecdir in which private executables are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datadir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for read-only data │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datasubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of datadir in which data files are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-docdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-htmldir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for HTML documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddockdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for haddock interfaces │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-sysconfdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for configuration files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-prefix │ │ │ │ │ +.I PREFIX │ │ │ │ │ +.RS │ │ │ │ │ +prefix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-suffix │ │ │ │ │ +.I SUFFIX │ │ │ │ │ +.RS │ │ │ │ │ +suffix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Vanilla libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-p, \-\-enable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-shared │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-shared │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Shared library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Static library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable dynamic linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable fully static linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable and library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable profiling (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for executable and library (default, none, exported-functions, toplevel-functions, all-functions). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-library-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for libraries only. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-O, \-\-enable-optimization, \-\-enable-optimisation │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Build with optimization (n is 0--2, default is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-optimization, \-\-disable-optimisation │ │ │ │ │ +.RS │ │ │ │ │ +Build without optimization │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-debug-info │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Emit debug info (n is 0--3, default is 0) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-debug-info │ │ │ │ │ +.RS │ │ │ │ │ +Don't emit debug info │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library for use with GHCi │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library code such that unneeded definitions can be dropped from the final executable (GHC 7.8+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +split library into smaller objects to reduce binary sizes (GHC 6.6+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip executables upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip libraries upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-configure-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +Extra option for configure │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-user │ │ │ │ │ +.br │ │ │ │ │ +\-\-global │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +doing a per-user installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-package-db │ │ │ │ │ +.I DB │ │ │ │ │ +.RS │ │ │ │ │ +Append the given package database to the list of package databases used (to satisfy dependencies and register into). May be a specific file, 'global' or 'user'. The initial list is ['global'], ['global', 'user'], or ['global', $sandbox], depending on context. Use 'clear' to reset the list to empty. See the user guide for details. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-f, \-\-flags │ │ │ │ │ +.I FLAGS │ │ │ │ │ +.RS │ │ │ │ │ +Force values for the given flags in Cabal conditionals in the .cabal file. E.g., --flags="debug -usebytestrings" forces the flag "debug" to true and "usebytestrings" to false. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-include-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for header files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to be as deterministic as possible (used by the test suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ipid │ │ │ │ │ +.I IPID │ │ │ │ │ +.RS │ │ │ │ │ +Installed package ID to compile this package as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cid │ │ │ │ │ +.I CID │ │ │ │ │ +.RS │ │ │ │ │ +Installed component ID to compile this component as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-lib-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-framework-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external frameworks (OS X only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-prog-path │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for required programs (in addition to the normal search locations) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-instantiate-with │ │ │ │ │ +.I NAME=MOD │ │ │ │ │ +.RS │ │ │ │ │ +A mapping of signature names to concrete module instantiations. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-tests │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for test suites listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for benchmarks listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +building a package that is relocatable. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-response-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +enable workaround for old versions of programs like "ar" that do not support @file arguments │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-depending-on-private-libs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow depending on private libraries. If set, the library visibility check MUST be done externally. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-alex │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-c2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-cpphs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-doctest │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-gcc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-greencard │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haddock │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-happy │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hmake │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hpc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hsc2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hscolour │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-jhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ld │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-pkg-config │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-runghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-strip │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-tar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-uhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to alex (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to c2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to cpphs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to doctest (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to gcc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to greencard (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haddock (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to happy (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hmake (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hpc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hsc2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hscolour (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to jhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ld (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to pkg-config (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to runghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to strip (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to tar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to uhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-lib-version │ │ │ │ │ +.I VERSION │ │ │ │ │ +.RS │ │ │ │ │ +Select which version of the Cabal lib to use to build packages (useful for testing). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-constraint │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify constraints on a package (version, installed/source, flags) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-preference │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify preferences (soft constraints) on the version of a package │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-solver │ │ │ │ │ +.I SOLVER │ │ │ │ │ +.RS │ │ │ │ │ +Select dependency solver to use (default: modular). Choices: modular. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-older │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore lower bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-newer │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore upper bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-write-ghc-environment-files │ │ │ │ │ +.I always|never|ghc8.4.4+ │ │ │ │ │ +.RS │ │ │ │ │ +Whether to create a .ghc.environment file after a successful build (v2-build only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-documentation │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-documentation │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +building of documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doc-index-file │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +A central index of haddock API documentation (template cannot use $pkgid) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dry-run │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not install anything, only print what would be installed. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-max-backjumps │ │ │ │ │ +.I NUM │ │ │ │ │ +.RS │ │ │ │ │ +Maximum number of backjumps allowed while solving (default: 4000). Use a negative number to enable unlimited backtracking. Use 0 to disable backtracking completely. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to reorder goals according to certain heuristics. Slows things down on average, but may make backtracking faster for some packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to speed up solving by preferring goals that are involved in a lot of conflicts (default). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +When there is no solution, try to improve the error message by finding a minimal conflict set (default: false). May increase run time significantly. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Treat several goals on the command line as independent. If several goals depend on the same package, different versions can be chosen. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +If multiple package instances of the same version are installed, treat all but one as shadowed. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not defer flag choices (this used to be the default in cabal-install <= 1.20). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow cabal to install base, ghc-prim, integer-simple, integer-gmp, and template-haskell. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reject-unconstrained-dependencies │ │ │ │ │ +.I none|all │ │ │ │ │ +.RS │ │ │ │ │ +Require these packages to have constraints on them if they are to be selected (default: none). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reinstall │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-reinstall │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Install even if it means installing the same version again. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-avoid-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-avoid-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not select versions that would destructively overwrite installed packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-force-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-force-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Reinstall packages even if they will most likely break other installed packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-upgrade-dependencies │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-upgrade-dependencies │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Pick the latest version for all dependencies, rather than trying to pick an installed version. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only-dependencies │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-only-dependencies │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Install only the dependencies necessary to build the given packages │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dependencies-only │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-dependencies-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +A synonym for --only-dependencies │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-index-state │ │ │ │ │ +.I STATE │ │ │ │ │ +.RS │ │ │ │ │ +Use source package index state as it existed at a previous time. Accepts unix-timestamps (e.g. '@1474732068'), ISO8601 UTC timestamps (e.g. '2016-09-24T17:47:48Z'), or 'HEAD' (default: 'HEAD'). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-root-cmd │ │ │ │ │ +.I COMMAND │ │ │ │ │ +.RS │ │ │ │ │ +(No longer supported, do not use.) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-symlink-bindir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +Add symlinks to installed executables into this directory. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-build-summary │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Save build summaries to file (name template can use $pkgid, $compiler, $os, $arch) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-build-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Log all builds to file (name template can use $pkgid, $compiler, $os, $arch) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-remote-build-reporting │ │ │ │ │ +.I LEVEL │ │ │ │ │ +.RS │ │ │ │ │ +Generate build reports to send to a remote server (none, anonymous or detailed). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-report-planning-failure │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate build reports when the dependency solver fails. This is used by the Hackage build bot. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-per-component │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-per-component │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Per-component builds when possible │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-one-shot │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-one-shot │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not record the packages in the world file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-run-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run package test suites during installation. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-j, \-\-jobs │ │ │ │ │ +.RI [ NUM ] │ │ │ │ │ +.RS │ │ │ │ │ +Run NUM jobs simultaneously (or '$ncpus' if no NUM is given). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-keep-going │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +After a build failure, continue to build other unaffected packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-offline │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-offline │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Don't download packages from the Internet. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-project-file │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Set the name of the cabal.project file to search for in parent directories │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Only installs the package in the current directory. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hoogle │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate a hoogle database │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-html │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate HTML documentation (the default) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-html-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Location of HTML documentation for pre-requisite packages │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-for-hackage │ │ │ │ │ +.RS │ │ │ │ │ +Collection of flags to generate documentation suitable for upload to hackage │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-executables │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Executables targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Test Suite targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Benchmark targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-all │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for all targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-internal │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for internal modules and include all symbols │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the haddock stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hyperlink-source, \-\-haddock-hyperlink-sources, \-\-haddock-hyperlinked-source │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Hyperlink the documentation to the source code │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-quickjump │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate an index for interactive documentation navigation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hscolour-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the HsColour stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-contents-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Bake URL in as the location for the contents page │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Log all test suite results to file (name template can use $pkgid, $compiler, $os, $arch, $test-suite, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-machine-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Produce a machine-readable log file (name template can use $pkgid, $compiler, $os, $arch, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-show-details │ │ │ │ │ +.I FILTER │ │ │ │ │ +.RS │ │ │ │ │ +'always': always show results of individual test cases. 'never': never show results of individual test cases. 'failures': show results of failing test cases. 'streaming': show results of test cases in real time.'direct': send results of test cases in real time; no log file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-keep-tix-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +keep .tix files for HPC between test runs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-wrapper │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Run test through a wrapper. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-fail-when-no-test-suites │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Exit with failure when no test suites are found. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-options │ │ │ │ │ +.I TEMPLATES │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to test executables (name templates can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-option │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +give extra option to test executables (no need to quote options containing spaces, name template can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal new-bench │ │ │ │ │ + │ │ │ │ │ +Usage: cabal new-bench [TARGETS] [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Runs the specified benchmarks, first ensuring they are up to date. │ │ │ │ │ + │ │ │ │ │ +Any benchmark in any package in the project can be specified. A package can be │ │ │ │ │ +specified in which case all the benchmarks in the package are run. The default │ │ │ │ │ +is to run all the benchmarks in the package in the current directory. │ │ │ │ │ + │ │ │ │ │ +Dependencies are built or rebuilt as necessary. Additional configuration flags │ │ │ │ │ +can be specified on the command line and these extend the project │ │ │ │ │ +configuration from the 'cabal.project', 'cabal.project.local' and other files. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Runs the specified benchmarks, first ensuring they are up to date. │ │ │ │ │ + │ │ │ │ │ +Any benchmark in any package in the project can be specified. A package can be │ │ │ │ │ +specified in which case all the benchmarks in the package are run. The default │ │ │ │ │ +is to run all the benchmarks in the package in the current directory. │ │ │ │ │ + │ │ │ │ │ +Dependencies are built or rebuilt as necessary. Additional configuration flags │ │ │ │ │ +can be specified on the command line and these extend the project │ │ │ │ │ +configuration from the 'cabal.project', 'cabal.project.local' and other files. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-g, \-\-ghc │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHCJS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc │ │ │ │ │ +.RS │ │ │ │ │ +compile with UHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite │ │ │ │ │ +.RS │ │ │ │ │ +compile with a haskell-suite compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-file │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +use this Cabal file │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-w, \-\-with-compiler │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to a particular compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to the package tool │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-prefix │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +bake this prefix in preparation of installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-bindir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libdir in which libs are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dynlibdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for dynamic libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for program executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libexecdir in which private executables are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datadir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for read-only data │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datasubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of datadir in which data files are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-docdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-htmldir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for HTML documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddockdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for haddock interfaces │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-sysconfdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for configuration files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-prefix │ │ │ │ │ +.I PREFIX │ │ │ │ │ +.RS │ │ │ │ │ +prefix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-suffix │ │ │ │ │ +.I SUFFIX │ │ │ │ │ +.RS │ │ │ │ │ +suffix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Vanilla libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-p, \-\-enable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-shared │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-shared │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Shared library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Static library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable dynamic linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable fully static linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable and library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable profiling (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for executable and library (default, none, exported-functions, toplevel-functions, all-functions). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-library-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for libraries only. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-O, \-\-enable-optimization, \-\-enable-optimisation │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Build with optimization (n is 0--2, default is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-optimization, \-\-disable-optimisation │ │ │ │ │ +.RS │ │ │ │ │ +Build without optimization │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-debug-info │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Emit debug info (n is 0--3, default is 0) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-debug-info │ │ │ │ │ +.RS │ │ │ │ │ +Don't emit debug info │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library for use with GHCi │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library code such that unneeded definitions can be dropped from the final executable (GHC 7.8+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +split library into smaller objects to reduce binary sizes (GHC 6.6+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip executables upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip libraries upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-configure-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +Extra option for configure │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-user │ │ │ │ │ +.br │ │ │ │ │ +\-\-global │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +doing a per-user installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-package-db │ │ │ │ │ +.I DB │ │ │ │ │ +.RS │ │ │ │ │ +Append the given package database to the list of package databases used (to satisfy dependencies and register into). May be a specific file, 'global' or 'user'. The initial list is ['global'], ['global', 'user'], or ['global', $sandbox], depending on context. Use 'clear' to reset the list to empty. See the user guide for details. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-f, \-\-flags │ │ │ │ │ +.I FLAGS │ │ │ │ │ +.RS │ │ │ │ │ +Force values for the given flags in Cabal conditionals in the .cabal file. E.g., --flags="debug -usebytestrings" forces the flag "debug" to true and "usebytestrings" to false. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-include-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for header files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to be as deterministic as possible (used by the test suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ipid │ │ │ │ │ +.I IPID │ │ │ │ │ +.RS │ │ │ │ │ +Installed package ID to compile this package as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cid │ │ │ │ │ +.I CID │ │ │ │ │ +.RS │ │ │ │ │ +Installed component ID to compile this component as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-lib-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-framework-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external frameworks (OS X only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-prog-path │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for required programs (in addition to the normal search locations) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-instantiate-with │ │ │ │ │ +.I NAME=MOD │ │ │ │ │ +.RS │ │ │ │ │ +A mapping of signature names to concrete module instantiations. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-tests │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for test suites listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for benchmarks listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +building a package that is relocatable. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-response-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +enable workaround for old versions of programs like "ar" that do not support @file arguments │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-depending-on-private-libs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow depending on private libraries. If set, the library visibility check MUST be done externally. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-alex │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-c2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-cpphs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-doctest │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-gcc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-greencard │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haddock │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-happy │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hmake │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hpc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hsc2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hscolour │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-jhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ld │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-pkg-config │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-runghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-strip │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-tar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-uhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to alex (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to c2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to cpphs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to doctest (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to gcc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to greencard (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haddock (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to happy (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hmake (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hpc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hsc2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hscolour (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to jhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ld (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to pkg-config (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to runghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to strip (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to tar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to uhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-lib-version │ │ │ │ │ +.I VERSION │ │ │ │ │ +.RS │ │ │ │ │ +Select which version of the Cabal lib to use to build packages (useful for testing). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-constraint │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify constraints on a package (version, installed/source, flags) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-preference │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify preferences (soft constraints) on the version of a package │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-solver │ │ │ │ │ +.I SOLVER │ │ │ │ │ +.RS │ │ │ │ │ +Select dependency solver to use (default: modular). Choices: modular. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-older │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore lower bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-newer │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore upper bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-write-ghc-environment-files │ │ │ │ │ +.I always|never|ghc8.4.4+ │ │ │ │ │ +.RS │ │ │ │ │ +Whether to create a .ghc.environment file after a successful build (v2-build only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-documentation │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-documentation │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +building of documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doc-index-file │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +A central index of haddock API documentation (template cannot use $pkgid) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dry-run │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not install anything, only print what would be installed. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-max-backjumps │ │ │ │ │ +.I NUM │ │ │ │ │ +.RS │ │ │ │ │ +Maximum number of backjumps allowed while solving (default: 4000). Use a negative number to enable unlimited backtracking. Use 0 to disable backtracking completely. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to reorder goals according to certain heuristics. Slows things down on average, but may make backtracking faster for some packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to speed up solving by preferring goals that are involved in a lot of conflicts (default). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +When there is no solution, try to improve the error message by finding a minimal conflict set (default: false). May increase run time significantly. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Treat several goals on the command line as independent. If several goals depend on the same package, different versions can be chosen. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +If multiple package instances of the same version are installed, treat all but one as shadowed. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not defer flag choices (this used to be the default in cabal-install <= 1.20). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow cabal to install base, ghc-prim, integer-simple, integer-gmp, and template-haskell. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reject-unconstrained-dependencies │ │ │ │ │ +.I none|all │ │ │ │ │ +.RS │ │ │ │ │ +Require these packages to have constraints on them if they are to be selected (default: none). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reinstall │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-reinstall │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Install even if it means installing the same version again. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-avoid-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-avoid-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not select versions that would destructively overwrite installed packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-force-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-force-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Reinstall packages even if they will most likely break other installed packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-upgrade-dependencies │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-upgrade-dependencies │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Pick the latest version for all dependencies, rather than trying to pick an installed version. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only-dependencies │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-only-dependencies │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Install only the dependencies necessary to build the given packages │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dependencies-only │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-dependencies-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +A synonym for --only-dependencies │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-index-state │ │ │ │ │ +.I STATE │ │ │ │ │ +.RS │ │ │ │ │ +Use source package index state as it existed at a previous time. Accepts unix-timestamps (e.g. '@1474732068'), ISO8601 UTC timestamps (e.g. '2016-09-24T17:47:48Z'), or 'HEAD' (default: 'HEAD'). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-root-cmd │ │ │ │ │ +.I COMMAND │ │ │ │ │ +.RS │ │ │ │ │ +(No longer supported, do not use.) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-symlink-bindir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +Add symlinks to installed executables into this directory. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-build-summary │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Save build summaries to file (name template can use $pkgid, $compiler, $os, $arch) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-build-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Log all builds to file (name template can use $pkgid, $compiler, $os, $arch) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-remote-build-reporting │ │ │ │ │ +.I LEVEL │ │ │ │ │ +.RS │ │ │ │ │ +Generate build reports to send to a remote server (none, anonymous or detailed). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-report-planning-failure │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate build reports when the dependency solver fails. This is used by the Hackage build bot. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-per-component │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-per-component │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Per-component builds when possible │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-one-shot │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-one-shot │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not record the packages in the world file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-run-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run package test suites during installation. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-j, \-\-jobs │ │ │ │ │ +.RI [ NUM ] │ │ │ │ │ +.RS │ │ │ │ │ +Run NUM jobs simultaneously (or '$ncpus' if no NUM is given). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-keep-going │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +After a build failure, continue to build other unaffected packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-offline │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-offline │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Don't download packages from the Internet. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-project-file │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Set the name of the cabal.project file to search for in parent directories │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Only installs the package in the current directory. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hoogle │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate a hoogle database │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-html │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate HTML documentation (the default) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-html-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Location of HTML documentation for pre-requisite packages │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-for-hackage │ │ │ │ │ +.RS │ │ │ │ │ +Collection of flags to generate documentation suitable for upload to hackage │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-executables │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Executables targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Test Suite targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Benchmark targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-all │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for all targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-internal │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for internal modules and include all symbols │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the haddock stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hyperlink-source, \-\-haddock-hyperlink-sources, \-\-haddock-hyperlinked-source │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Hyperlink the documentation to the source code │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-quickjump │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate an index for interactive documentation navigation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hscolour-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the HsColour stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-contents-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Bake URL in as the location for the contents page │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Log all test suite results to file (name template can use $pkgid, $compiler, $os, $arch, $test-suite, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-machine-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Produce a machine-readable log file (name template can use $pkgid, $compiler, $os, $arch, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-show-details │ │ │ │ │ +.I FILTER │ │ │ │ │ +.RS │ │ │ │ │ +'always': always show results of individual test cases. 'never': never show results of individual test cases. 'failures': show results of failing test cases. 'streaming': show results of test cases in real time.'direct': send results of test cases in real time; no log file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-keep-tix-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +keep .tix files for HPC between test runs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-wrapper │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Run test through a wrapper. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-fail-when-no-test-suites │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Exit with failure when no test suites are found. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-options │ │ │ │ │ +.I TEMPLATES │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to test executables (name templates can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-option │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +give extra option to test executables (no need to quote options containing spaces, name template can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v2-bench │ │ │ │ │ + │ │ │ │ │ +Usage: cabal v2-bench [TARGETS] [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Runs the specified benchmarks, first ensuring they are up to date. │ │ │ │ │ + │ │ │ │ │ +Any benchmark in any package in the project can be specified. A package can be │ │ │ │ │ +specified in which case all the benchmarks in the package are run. The default │ │ │ │ │ +is to run all the benchmarks in the package in the current directory. │ │ │ │ │ + │ │ │ │ │ +Dependencies are built or rebuilt as necessary. Additional configuration flags │ │ │ │ │ +can be specified on the command line and these extend the project │ │ │ │ │ +configuration from the 'cabal.project', 'cabal.project.local' and other files. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Examples: │ │ │ │ │ + cabal v2-bench │ │ │ │ │ + Run all the benchmarks in the package in the current directory │ │ │ │ │ + cabal v2-bench pkgname │ │ │ │ │ + Run all the benchmarks in the package named pkgname │ │ │ │ │ + cabal v2-bench cname │ │ │ │ │ + Run the benchmark named cname │ │ │ │ │ + cabal v2-bench cname -O2 │ │ │ │ │ + Run the benchmark built with '-O2' (including local libs used) │ │ │ │ │ + │ │ │ │ │ +Note: this command is part of the new project-based system (aka nix-style │ │ │ │ │ +local builds). These features are currently in beta. Please see │ │ │ │ │ +http://cabal.readthedocs.io/en/latest/nix-local-build-overview.html for │ │ │ │ │ +details and advice on what you can expect to work. If you encounter problems │ │ │ │ │ +please file issues at https://github.com/haskell/cabal/issues and if you │ │ │ │ │ +have any time to get involved and help with testing, fixing bugs etc then │ │ │ │ │ +that is very much appreciated. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-g, \-\-ghc │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHCJS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc │ │ │ │ │ +.RS │ │ │ │ │ +compile with UHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite │ │ │ │ │ +.RS │ │ │ │ │ +compile with a haskell-suite compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-file │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +use this Cabal file │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-w, \-\-with-compiler │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to a particular compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to the package tool │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-prefix │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +bake this prefix in preparation of installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-bindir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libdir in which libs are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dynlibdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for dynamic libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for program executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libexecdir in which private executables are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datadir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for read-only data │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datasubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of datadir in which data files are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-docdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-htmldir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for HTML documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddockdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for haddock interfaces │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-sysconfdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for configuration files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-prefix │ │ │ │ │ +.I PREFIX │ │ │ │ │ +.RS │ │ │ │ │ +prefix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-suffix │ │ │ │ │ +.I SUFFIX │ │ │ │ │ +.RS │ │ │ │ │ +suffix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Vanilla libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-p, \-\-enable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-shared │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-shared │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Shared library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Static library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable dynamic linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable fully static linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable and library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable profiling (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for executable and library (default, none, exported-functions, toplevel-functions, all-functions). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-library-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for libraries only. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-O, \-\-enable-optimization, \-\-enable-optimisation │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Build with optimization (n is 0--2, default is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-optimization, \-\-disable-optimisation │ │ │ │ │ +.RS │ │ │ │ │ +Build without optimization │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-debug-info │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Emit debug info (n is 0--3, default is 0) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-debug-info │ │ │ │ │ +.RS │ │ │ │ │ +Don't emit debug info │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library for use with GHCi │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library code such that unneeded definitions can be dropped from the final executable (GHC 7.8+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +split library into smaller objects to reduce binary sizes (GHC 6.6+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip executables upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip libraries upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-configure-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +Extra option for configure │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-user │ │ │ │ │ +.br │ │ │ │ │ +\-\-global │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +doing a per-user installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-package-db │ │ │ │ │ +.I DB │ │ │ │ │ +.RS │ │ │ │ │ +Append the given package database to the list of package databases used (to satisfy dependencies and register into). May be a specific file, 'global' or 'user'. The initial list is ['global'], ['global', 'user'], or ['global', $sandbox], depending on context. Use 'clear' to reset the list to empty. See the user guide for details. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-f, \-\-flags │ │ │ │ │ +.I FLAGS │ │ │ │ │ +.RS │ │ │ │ │ +Force values for the given flags in Cabal conditionals in the .cabal file. E.g., --flags="debug -usebytestrings" forces the flag "debug" to true and "usebytestrings" to false. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-include-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for header files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to be as deterministic as possible (used by the test suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ipid │ │ │ │ │ +.I IPID │ │ │ │ │ +.RS │ │ │ │ │ +Installed package ID to compile this package as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cid │ │ │ │ │ +.I CID │ │ │ │ │ +.RS │ │ │ │ │ +Installed component ID to compile this component as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-lib-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-framework-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external frameworks (OS X only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-prog-path │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for required programs (in addition to the normal search locations) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-instantiate-with │ │ │ │ │ +.I NAME=MOD │ │ │ │ │ +.RS │ │ │ │ │ +A mapping of signature names to concrete module instantiations. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-tests │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for test suites listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for benchmarks listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +building a package that is relocatable. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-response-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +enable workaround for old versions of programs like "ar" that do not support @file arguments │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-depending-on-private-libs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow depending on private libraries. If set, the library visibility check MUST be done externally. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-alex │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-c2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-cpphs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-doctest │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-gcc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-greencard │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haddock │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-happy │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hmake │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hpc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hsc2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hscolour │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-jhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ld │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-pkg-config │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-runghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-strip │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-tar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-uhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to alex (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to c2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to cpphs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to doctest (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to gcc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to greencard (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haddock (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to happy (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hmake (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hpc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hsc2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hscolour (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to jhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ld (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to pkg-config (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to runghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to strip (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to tar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to uhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-lib-version │ │ │ │ │ +.I VERSION │ │ │ │ │ +.RS │ │ │ │ │ +Select which version of the Cabal lib to use to build packages (useful for testing). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-constraint │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify constraints on a package (version, installed/source, flags) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-preference │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify preferences (soft constraints) on the version of a package │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-solver │ │ │ │ │ +.I SOLVER │ │ │ │ │ +.RS │ │ │ │ │ +Select dependency solver to use (default: modular). Choices: modular. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-older │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore lower bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-newer │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore upper bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-write-ghc-environment-files │ │ │ │ │ +.I always|never|ghc8.4.4+ │ │ │ │ │ +.RS │ │ │ │ │ +Whether to create a .ghc.environment file after a successful build (v2-build only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-documentation │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-documentation │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +building of documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doc-index-file │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +A central index of haddock API documentation (template cannot use $pkgid) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dry-run │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not install anything, only print what would be installed. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-max-backjumps │ │ │ │ │ +.I NUM │ │ │ │ │ +.RS │ │ │ │ │ +Maximum number of backjumps allowed while solving (default: 4000). Use a negative number to enable unlimited backtracking. Use 0 to disable backtracking completely. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to reorder goals according to certain heuristics. Slows things down on average, but may make backtracking faster for some packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to speed up solving by preferring goals that are involved in a lot of conflicts (default). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +When there is no solution, try to improve the error message by finding a minimal conflict set (default: false). May increase run time significantly. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Treat several goals on the command line as independent. If several goals depend on the same package, different versions can be chosen. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +If multiple package instances of the same version are installed, treat all but one as shadowed. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not defer flag choices (this used to be the default in cabal-install <= 1.20). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow cabal to install base, ghc-prim, integer-simple, integer-gmp, and template-haskell. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reject-unconstrained-dependencies │ │ │ │ │ +.I none|all │ │ │ │ │ +.RS │ │ │ │ │ +Require these packages to have constraints on them if they are to be selected (default: none). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reinstall │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-reinstall │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Install even if it means installing the same version again. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-avoid-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-avoid-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not select versions that would destructively overwrite installed packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-force-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-force-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Reinstall packages even if they will most likely break other installed packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-upgrade-dependencies │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-upgrade-dependencies │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Pick the latest version for all dependencies, rather than trying to pick an installed version. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only-dependencies │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-only-dependencies │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Install only the dependencies necessary to build the given packages │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dependencies-only │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-dependencies-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +A synonym for --only-dependencies │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-index-state │ │ │ │ │ +.I STATE │ │ │ │ │ +.RS │ │ │ │ │ +Use source package index state as it existed at a previous time. Accepts unix-timestamps (e.g. '@1474732068'), ISO8601 UTC timestamps (e.g. '2016-09-24T17:47:48Z'), or 'HEAD' (default: 'HEAD'). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-root-cmd │ │ │ │ │ +.I COMMAND │ │ │ │ │ +.RS │ │ │ │ │ +(No longer supported, do not use.) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-symlink-bindir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +Add symlinks to installed executables into this directory. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-build-summary │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Save build summaries to file (name template can use $pkgid, $compiler, $os, $arch) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-build-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Log all builds to file (name template can use $pkgid, $compiler, $os, $arch) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-remote-build-reporting │ │ │ │ │ +.I LEVEL │ │ │ │ │ +.RS │ │ │ │ │ +Generate build reports to send to a remote server (none, anonymous or detailed). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-report-planning-failure │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate build reports when the dependency solver fails. This is used by the Hackage build bot. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-per-component │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-per-component │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Per-component builds when possible │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-one-shot │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-one-shot │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not record the packages in the world file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-run-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run package test suites during installation. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-j, \-\-jobs │ │ │ │ │ +.RI [ NUM ] │ │ │ │ │ +.RS │ │ │ │ │ +Run NUM jobs simultaneously (or '$ncpus' if no NUM is given). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-keep-going │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +After a build failure, continue to build other unaffected packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-offline │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-offline │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Don't download packages from the Internet. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-project-file │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Set the name of the cabal.project file to search for in parent directories │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Only installs the package in the current directory. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hoogle │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate a hoogle database │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-html │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate HTML documentation (the default) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-html-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Location of HTML documentation for pre-requisite packages │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-for-hackage │ │ │ │ │ +.RS │ │ │ │ │ +Collection of flags to generate documentation suitable for upload to hackage │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-executables │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Executables targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Test Suite targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Benchmark targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-all │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for all targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-internal │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for internal modules and include all symbols │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the haddock stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hyperlink-source, \-\-haddock-hyperlink-sources, \-\-haddock-hyperlinked-source │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Hyperlink the documentation to the source code │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-quickjump │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate an index for interactive documentation navigation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hscolour-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the HsColour stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-contents-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Bake URL in as the location for the contents page │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Log all test suite results to file (name template can use $pkgid, $compiler, $os, $arch, $test-suite, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-machine-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Produce a machine-readable log file (name template can use $pkgid, $compiler, $os, $arch, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-show-details │ │ │ │ │ +.I FILTER │ │ │ │ │ +.RS │ │ │ │ │ +'always': always show results of individual test cases. 'never': never show results of individual test cases. 'failures': show results of failing test cases. 'streaming': show results of test cases in real time.'direct': send results of test cases in real time; no log file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-keep-tix-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +keep .tix files for HPC between test runs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-wrapper │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Run test through a wrapper. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-fail-when-no-test-suites │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Exit with failure when no test suites are found. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-options │ │ │ │ │ +.I TEMPLATES │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to test executables (name templates can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-option │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +give extra option to test executables (no need to quote options containing spaces, name template can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal exec │ │ │ │ │ + │ │ │ │ │ +Usage: cabal exec [FLAGS] [--] COMMAND [--] [ARGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +During development it is often useful to run build tasks and perform one-off │ │ │ │ │ +program executions to experiment with the behavior of build tools. It is │ │ │ │ │ +convenient to run these tools in the same way cabal itself would. The `cabal │ │ │ │ │ +exec` command provides a way to do so. │ │ │ │ │ + │ │ │ │ │ +Compiler tools will be configured to see the same subset of the store that │ │ │ │ │ +builds would see. The PATH is modified to make all executables in the │ │ │ │ │ +dependency tree available (provided they have been built already). Commands │ │ │ │ │ +are also rewritten in the way cabal itself would. For example, `cabal exec │ │ │ │ │ +ghc` will consult the configuration to choose an appropriate version of ghc │ │ │ │ │ +and to include any ghc-specific flags requested. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +During development it is often useful to run build tasks and perform one-off │ │ │ │ │ +program executions to experiment with the behavior of build tools. It is │ │ │ │ │ +convenient to run these tools in the same way cabal itself would. The `cabal │ │ │ │ │ +exec` command provides a way to do so. │ │ │ │ │ + │ │ │ │ │ +Compiler tools will be configured to see the same subset of the store that │ │ │ │ │ +builds would see. The PATH is modified to make all executables in the │ │ │ │ │ +dependency tree available (provided they have been built already). Commands │ │ │ │ │ +are also rewritten in the way cabal itself would. For example, `cabal exec │ │ │ │ │ +ghc` will consult the configuration to choose an appropriate version of ghc │ │ │ │ │ +and to include any ghc-specific flags requested. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-g, \-\-ghc │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHCJS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc │ │ │ │ │ +.RS │ │ │ │ │ +compile with UHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite │ │ │ │ │ +.RS │ │ │ │ │ +compile with a haskell-suite compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-file │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +use this Cabal file │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-w, \-\-with-compiler │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to a particular compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to the package tool │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-prefix │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +bake this prefix in preparation of installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-bindir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libdir in which libs are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dynlibdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for dynamic libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for program executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libexecdir in which private executables are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datadir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for read-only data │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datasubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of datadir in which data files are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-docdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-htmldir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for HTML documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddockdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for haddock interfaces │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-sysconfdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for configuration files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-prefix │ │ │ │ │ +.I PREFIX │ │ │ │ │ +.RS │ │ │ │ │ +prefix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-suffix │ │ │ │ │ +.I SUFFIX │ │ │ │ │ +.RS │ │ │ │ │ +suffix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Vanilla libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-p, \-\-enable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-shared │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-shared │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Shared library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Static library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable dynamic linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable fully static linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable and library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable profiling (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for executable and library (default, none, exported-functions, toplevel-functions, all-functions). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-library-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for libraries only. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-O, \-\-enable-optimization, \-\-enable-optimisation │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Build with optimization (n is 0--2, default is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-optimization, \-\-disable-optimisation │ │ │ │ │ +.RS │ │ │ │ │ +Build without optimization │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-debug-info │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Emit debug info (n is 0--3, default is 0) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-debug-info │ │ │ │ │ +.RS │ │ │ │ │ +Don't emit debug info │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library for use with GHCi │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library code such that unneeded definitions can be dropped from the final executable (GHC 7.8+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +split library into smaller objects to reduce binary sizes (GHC 6.6+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip executables upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip libraries upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-configure-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +Extra option for configure │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-user │ │ │ │ │ +.br │ │ │ │ │ +\-\-global │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +doing a per-user installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-package-db │ │ │ │ │ +.I DB │ │ │ │ │ +.RS │ │ │ │ │ +Append the given package database to the list of package databases used (to satisfy dependencies and register into). May be a specific file, 'global' or 'user'. The initial list is ['global'], ['global', 'user'], or ['global', $sandbox], depending on context. Use 'clear' to reset the list to empty. See the user guide for details. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-f, \-\-flags │ │ │ │ │ +.I FLAGS │ │ │ │ │ +.RS │ │ │ │ │ +Force values for the given flags in Cabal conditionals in the .cabal file. E.g., --flags="debug -usebytestrings" forces the flag "debug" to true and "usebytestrings" to false. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-include-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for header files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to be as deterministic as possible (used by the test suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ipid │ │ │ │ │ +.I IPID │ │ │ │ │ +.RS │ │ │ │ │ +Installed package ID to compile this package as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cid │ │ │ │ │ +.I CID │ │ │ │ │ +.RS │ │ │ │ │ +Installed component ID to compile this component as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-lib-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-framework-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external frameworks (OS X only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-prog-path │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for required programs (in addition to the normal search locations) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-instantiate-with │ │ │ │ │ +.I NAME=MOD │ │ │ │ │ +.RS │ │ │ │ │ +A mapping of signature names to concrete module instantiations. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-tests │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for test suites listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for benchmarks listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +building a package that is relocatable. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-response-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +enable workaround for old versions of programs like "ar" that do not support @file arguments │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-depending-on-private-libs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow depending on private libraries. If set, the library visibility check MUST be done externally. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-alex │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-c2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-cpphs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-doctest │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-gcc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-greencard │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haddock │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-happy │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hmake │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hpc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hsc2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hscolour │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-jhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ld │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-pkg-config │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-runghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-strip │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-tar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-uhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to alex (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to c2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to cpphs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to doctest (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to gcc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to greencard (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haddock (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to happy (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hmake (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hpc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hsc2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hscolour (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to jhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ld (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to pkg-config (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to runghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to strip (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to tar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to uhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-lib-version │ │ │ │ │ +.I VERSION │ │ │ │ │ +.RS │ │ │ │ │ +Select which version of the Cabal lib to use to build packages (useful for testing). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-constraint │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify constraints on a package (version, installed/source, flags) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-preference │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify preferences (soft constraints) on the version of a package │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-solver │ │ │ │ │ +.I SOLVER │ │ │ │ │ +.RS │ │ │ │ │ +Select dependency solver to use (default: modular). Choices: modular. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-older │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore lower bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-newer │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore upper bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-write-ghc-environment-files │ │ │ │ │ +.I always|never|ghc8.4.4+ │ │ │ │ │ +.RS │ │ │ │ │ +Whether to create a .ghc.environment file after a successful build (v2-build only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-documentation │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-documentation │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +building of documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doc-index-file │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +A central index of haddock API documentation (template cannot use $pkgid) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dry-run │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not install anything, only print what would be installed. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-max-backjumps │ │ │ │ │ +.I NUM │ │ │ │ │ +.RS │ │ │ │ │ +Maximum number of backjumps allowed while solving (default: 4000). Use a negative number to enable unlimited backtracking. Use 0 to disable backtracking completely. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to reorder goals according to certain heuristics. Slows things down on average, but may make backtracking faster for some packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to speed up solving by preferring goals that are involved in a lot of conflicts (default). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +When there is no solution, try to improve the error message by finding a minimal conflict set (default: false). May increase run time significantly. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Treat several goals on the command line as independent. If several goals depend on the same package, different versions can be chosen. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +If multiple package instances of the same version are installed, treat all but one as shadowed. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not defer flag choices (this used to be the default in cabal-install <= 1.20). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow cabal to install base, ghc-prim, integer-simple, integer-gmp, and template-haskell. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reject-unconstrained-dependencies │ │ │ │ │ +.I none|all │ │ │ │ │ +.RS │ │ │ │ │ +Require these packages to have constraints on them if they are to be selected (default: none). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reinstall │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-reinstall │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Install even if it means installing the same version again. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-avoid-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-avoid-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not select versions that would destructively overwrite installed packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-force-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-force-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Reinstall packages even if they will most likely break other installed packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-upgrade-dependencies │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-upgrade-dependencies │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Pick the latest version for all dependencies, rather than trying to pick an installed version. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only-dependencies │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-only-dependencies │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Install only the dependencies necessary to build the given packages │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dependencies-only │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-dependencies-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +A synonym for --only-dependencies │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-index-state │ │ │ │ │ +.I STATE │ │ │ │ │ +.RS │ │ │ │ │ +Use source package index state as it existed at a previous time. Accepts unix-timestamps (e.g. '@1474732068'), ISO8601 UTC timestamps (e.g. '2016-09-24T17:47:48Z'), or 'HEAD' (default: 'HEAD'). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-root-cmd │ │ │ │ │ +.I COMMAND │ │ │ │ │ +.RS │ │ │ │ │ +(No longer supported, do not use.) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-symlink-bindir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +Add symlinks to installed executables into this directory. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-build-summary │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Save build summaries to file (name template can use $pkgid, $compiler, $os, $arch) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-build-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Log all builds to file (name template can use $pkgid, $compiler, $os, $arch) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-remote-build-reporting │ │ │ │ │ +.I LEVEL │ │ │ │ │ +.RS │ │ │ │ │ +Generate build reports to send to a remote server (none, anonymous or detailed). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-report-planning-failure │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate build reports when the dependency solver fails. This is used by the Hackage build bot. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-per-component │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-per-component │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Per-component builds when possible │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-one-shot │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-one-shot │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not record the packages in the world file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-run-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run package test suites during installation. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-j, \-\-jobs │ │ │ │ │ +.RI [ NUM ] │ │ │ │ │ +.RS │ │ │ │ │ +Run NUM jobs simultaneously (or '$ncpus' if no NUM is given). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-keep-going │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +After a build failure, continue to build other unaffected packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-offline │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-offline │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Don't download packages from the Internet. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-project-file │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Set the name of the cabal.project file to search for in parent directories │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Only installs the package in the current directory. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hoogle │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate a hoogle database │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-html │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate HTML documentation (the default) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-html-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Location of HTML documentation for pre-requisite packages │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-for-hackage │ │ │ │ │ +.RS │ │ │ │ │ +Collection of flags to generate documentation suitable for upload to hackage │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-executables │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Executables targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Test Suite targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Benchmark targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-all │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for all targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-internal │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for internal modules and include all symbols │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the haddock stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hyperlink-source, \-\-haddock-hyperlink-sources, \-\-haddock-hyperlinked-source │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Hyperlink the documentation to the source code │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-quickjump │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate an index for interactive documentation navigation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hscolour-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the HsColour stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-contents-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Bake URL in as the location for the contents page │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Log all test suite results to file (name template can use $pkgid, $compiler, $os, $arch, $test-suite, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-machine-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Produce a machine-readable log file (name template can use $pkgid, $compiler, $os, $arch, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-show-details │ │ │ │ │ +.I FILTER │ │ │ │ │ +.RS │ │ │ │ │ +'always': always show results of individual test cases. 'never': never show results of individual test cases. 'failures': show results of failing test cases. 'streaming': show results of test cases in real time.'direct': send results of test cases in real time; no log file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-keep-tix-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +keep .tix files for HPC between test runs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-wrapper │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Run test through a wrapper. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-fail-when-no-test-suites │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Exit with failure when no test suites are found. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-options │ │ │ │ │ +.I TEMPLATES │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to test executables (name templates can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-option │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +give extra option to test executables (no need to quote options containing spaces, name template can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal new-exec │ │ │ │ │ + │ │ │ │ │ +Usage: cabal new-exec [FLAGS] [--] COMMAND [--] [ARGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +During development it is often useful to run build tasks and perform one-off │ │ │ │ │ +program executions to experiment with the behavior of build tools. It is │ │ │ │ │ +convenient to run these tools in the same way cabal itself would. The `cabal │ │ │ │ │ +new-exec` command provides a way to do so. │ │ │ │ │ + │ │ │ │ │ +Compiler tools will be configured to see the same subset of the store that │ │ │ │ │ +builds would see. The PATH is modified to make all executables in the │ │ │ │ │ +dependency tree available (provided they have been built already). Commands │ │ │ │ │ +are also rewritten in the way cabal itself would. For example, `cabal new-exec │ │ │ │ │ +ghc` will consult the configuration to choose an appropriate version of ghc │ │ │ │ │ +and to include any ghc-specific flags requested. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +During development it is often useful to run build tasks and perform one-off │ │ │ │ │ +program executions to experiment with the behavior of build tools. It is │ │ │ │ │ +convenient to run these tools in the same way cabal itself would. The `cabal │ │ │ │ │ +new-exec` command provides a way to do so. │ │ │ │ │ + │ │ │ │ │ +Compiler tools will be configured to see the same subset of the store that │ │ │ │ │ +builds would see. The PATH is modified to make all executables in the │ │ │ │ │ +dependency tree available (provided they have been built already). Commands │ │ │ │ │ +are also rewritten in the way cabal itself would. For example, `cabal new-exec │ │ │ │ │ +ghc` will consult the configuration to choose an appropriate version of ghc │ │ │ │ │ +and to include any ghc-specific flags requested. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-g, \-\-ghc │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHCJS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc │ │ │ │ │ +.RS │ │ │ │ │ +compile with UHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite │ │ │ │ │ +.RS │ │ │ │ │ +compile with a haskell-suite compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-file │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +use this Cabal file │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-w, \-\-with-compiler │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to a particular compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to the package tool │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-prefix │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +bake this prefix in preparation of installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-bindir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libdir in which libs are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dynlibdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for dynamic libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for program executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libexecdir in which private executables are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datadir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for read-only data │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datasubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of datadir in which data files are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-docdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-htmldir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for HTML documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddockdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for haddock interfaces │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-sysconfdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for configuration files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-prefix │ │ │ │ │ +.I PREFIX │ │ │ │ │ +.RS │ │ │ │ │ +prefix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-suffix │ │ │ │ │ +.I SUFFIX │ │ │ │ │ +.RS │ │ │ │ │ +suffix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Vanilla libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-p, \-\-enable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-shared │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-shared │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Shared library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Static library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable dynamic linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable fully static linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable and library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable profiling (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for executable and library (default, none, exported-functions, toplevel-functions, all-functions). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-library-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for libraries only. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-O, \-\-enable-optimization, \-\-enable-optimisation │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Build with optimization (n is 0--2, default is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-optimization, \-\-disable-optimisation │ │ │ │ │ +.RS │ │ │ │ │ +Build without optimization │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-debug-info │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Emit debug info (n is 0--3, default is 0) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-debug-info │ │ │ │ │ +.RS │ │ │ │ │ +Don't emit debug info │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library for use with GHCi │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library code such that unneeded definitions can be dropped from the final executable (GHC 7.8+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +split library into smaller objects to reduce binary sizes (GHC 6.6+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip executables upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip libraries upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-configure-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +Extra option for configure │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-user │ │ │ │ │ +.br │ │ │ │ │ +\-\-global │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +doing a per-user installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-package-db │ │ │ │ │ +.I DB │ │ │ │ │ +.RS │ │ │ │ │ +Append the given package database to the list of package databases used (to satisfy dependencies and register into). May be a specific file, 'global' or 'user'. The initial list is ['global'], ['global', 'user'], or ['global', $sandbox], depending on context. Use 'clear' to reset the list to empty. See the user guide for details. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-f, \-\-flags │ │ │ │ │ +.I FLAGS │ │ │ │ │ +.RS │ │ │ │ │ +Force values for the given flags in Cabal conditionals in the .cabal file. E.g., --flags="debug -usebytestrings" forces the flag "debug" to true and "usebytestrings" to false. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-include-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for header files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to be as deterministic as possible (used by the test suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ipid │ │ │ │ │ +.I IPID │ │ │ │ │ +.RS │ │ │ │ │ +Installed package ID to compile this package as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cid │ │ │ │ │ +.I CID │ │ │ │ │ +.RS │ │ │ │ │ +Installed component ID to compile this component as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-lib-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-framework-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external frameworks (OS X only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-prog-path │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for required programs (in addition to the normal search locations) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-instantiate-with │ │ │ │ │ +.I NAME=MOD │ │ │ │ │ +.RS │ │ │ │ │ +A mapping of signature names to concrete module instantiations. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-tests │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for test suites listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for benchmarks listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +building a package that is relocatable. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-response-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +enable workaround for old versions of programs like "ar" that do not support @file arguments │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-depending-on-private-libs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow depending on private libraries. If set, the library visibility check MUST be done externally. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-alex │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-c2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-cpphs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-doctest │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-gcc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-greencard │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haddock │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-happy │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hmake │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hpc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hsc2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hscolour │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-jhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ld │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-pkg-config │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-runghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-strip │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-tar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-uhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to alex (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to c2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to cpphs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to doctest (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to gcc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to greencard (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haddock (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to happy (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hmake (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hpc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hsc2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hscolour (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to jhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ld (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to pkg-config (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to runghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to strip (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to tar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to uhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-lib-version │ │ │ │ │ +.I VERSION │ │ │ │ │ +.RS │ │ │ │ │ +Select which version of the Cabal lib to use to build packages (useful for testing). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-constraint │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify constraints on a package (version, installed/source, flags) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-preference │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify preferences (soft constraints) on the version of a package │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-solver │ │ │ │ │ +.I SOLVER │ │ │ │ │ +.RS │ │ │ │ │ +Select dependency solver to use (default: modular). Choices: modular. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-older │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore lower bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-newer │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore upper bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-write-ghc-environment-files │ │ │ │ │ +.I always|never|ghc8.4.4+ │ │ │ │ │ +.RS │ │ │ │ │ +Whether to create a .ghc.environment file after a successful build (v2-build only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-documentation │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-documentation │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +building of documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doc-index-file │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +A central index of haddock API documentation (template cannot use $pkgid) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dry-run │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not install anything, only print what would be installed. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-max-backjumps │ │ │ │ │ +.I NUM │ │ │ │ │ +.RS │ │ │ │ │ +Maximum number of backjumps allowed while solving (default: 4000). Use a negative number to enable unlimited backtracking. Use 0 to disable backtracking completely. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to reorder goals according to certain heuristics. Slows things down on average, but may make backtracking faster for some packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to speed up solving by preferring goals that are involved in a lot of conflicts (default). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +When there is no solution, try to improve the error message by finding a minimal conflict set (default: false). May increase run time significantly. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Treat several goals on the command line as independent. If several goals depend on the same package, different versions can be chosen. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +If multiple package instances of the same version are installed, treat all but one as shadowed. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not defer flag choices (this used to be the default in cabal-install <= 1.20). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow cabal to install base, ghc-prim, integer-simple, integer-gmp, and template-haskell. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reject-unconstrained-dependencies │ │ │ │ │ +.I none|all │ │ │ │ │ +.RS │ │ │ │ │ +Require these packages to have constraints on them if they are to be selected (default: none). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reinstall │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-reinstall │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Install even if it means installing the same version again. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-avoid-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-avoid-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not select versions that would destructively overwrite installed packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-force-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-force-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Reinstall packages even if they will most likely break other installed packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-upgrade-dependencies │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-upgrade-dependencies │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Pick the latest version for all dependencies, rather than trying to pick an installed version. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only-dependencies │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-only-dependencies │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Install only the dependencies necessary to build the given packages │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dependencies-only │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-dependencies-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +A synonym for --only-dependencies │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-index-state │ │ │ │ │ +.I STATE │ │ │ │ │ +.RS │ │ │ │ │ +Use source package index state as it existed at a previous time. Accepts unix-timestamps (e.g. '@1474732068'), ISO8601 UTC timestamps (e.g. '2016-09-24T17:47:48Z'), or 'HEAD' (default: 'HEAD'). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-root-cmd │ │ │ │ │ +.I COMMAND │ │ │ │ │ +.RS │ │ │ │ │ +(No longer supported, do not use.) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-symlink-bindir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +Add symlinks to installed executables into this directory. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-build-summary │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Save build summaries to file (name template can use $pkgid, $compiler, $os, $arch) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-build-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Log all builds to file (name template can use $pkgid, $compiler, $os, $arch) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-remote-build-reporting │ │ │ │ │ +.I LEVEL │ │ │ │ │ +.RS │ │ │ │ │ +Generate build reports to send to a remote server (none, anonymous or detailed). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-report-planning-failure │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate build reports when the dependency solver fails. This is used by the Hackage build bot. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-per-component │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-per-component │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Per-component builds when possible │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-one-shot │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-one-shot │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not record the packages in the world file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-run-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run package test suites during installation. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-j, \-\-jobs │ │ │ │ │ +.RI [ NUM ] │ │ │ │ │ +.RS │ │ │ │ │ +Run NUM jobs simultaneously (or '$ncpus' if no NUM is given). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-keep-going │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +After a build failure, continue to build other unaffected packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-offline │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-offline │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Don't download packages from the Internet. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-project-file │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Set the name of the cabal.project file to search for in parent directories │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Only installs the package in the current directory. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hoogle │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate a hoogle database │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-html │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate HTML documentation (the default) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-html-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Location of HTML documentation for pre-requisite packages │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-for-hackage │ │ │ │ │ +.RS │ │ │ │ │ +Collection of flags to generate documentation suitable for upload to hackage │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-executables │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Executables targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Test Suite targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Benchmark targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-all │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for all targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-internal │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for internal modules and include all symbols │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the haddock stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hyperlink-source, \-\-haddock-hyperlink-sources, \-\-haddock-hyperlinked-source │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Hyperlink the documentation to the source code │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-quickjump │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate an index for interactive documentation navigation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hscolour-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the HsColour stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-contents-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Bake URL in as the location for the contents page │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Log all test suite results to file (name template can use $pkgid, $compiler, $os, $arch, $test-suite, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-machine-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Produce a machine-readable log file (name template can use $pkgid, $compiler, $os, $arch, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-show-details │ │ │ │ │ +.I FILTER │ │ │ │ │ +.RS │ │ │ │ │ +'always': always show results of individual test cases. 'never': never show results of individual test cases. 'failures': show results of failing test cases. 'streaming': show results of test cases in real time.'direct': send results of test cases in real time; no log file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-keep-tix-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +keep .tix files for HPC between test runs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-wrapper │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Run test through a wrapper. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-fail-when-no-test-suites │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Exit with failure when no test suites are found. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-options │ │ │ │ │ +.I TEMPLATES │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to test executables (name templates can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-option │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +give extra option to test executables (no need to quote options containing spaces, name template can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v2-exec │ │ │ │ │ + │ │ │ │ │ +Usage: cabal v2-exec [FLAGS] [--] COMMAND [--] [ARGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +During development it is often useful to run build tasks and perform one-off │ │ │ │ │ +program executions to experiment with the behavior of build tools. It is │ │ │ │ │ +convenient to run these tools in the same way cabal itself would. The `cabal │ │ │ │ │ +v2-exec` command provides a way to do so. │ │ │ │ │ + │ │ │ │ │ +Compiler tools will be configured to see the same subset of the store that │ │ │ │ │ +builds would see. The PATH is modified to make all executables in the │ │ │ │ │ +dependency tree available (provided they have been built already). Commands │ │ │ │ │ +are also rewritten in the way cabal itself would. For example, `cabal v2-exec │ │ │ │ │ +ghc` will consult the configuration to choose an appropriate version of ghc │ │ │ │ │ +and to include any ghc-specific flags requested. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-g, \-\-ghc │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHCJS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc │ │ │ │ │ +.RS │ │ │ │ │ +compile with UHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite │ │ │ │ │ +.RS │ │ │ │ │ +compile with a haskell-suite compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-file │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +use this Cabal file │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-w, \-\-with-compiler │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to a particular compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to the package tool │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-prefix │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +bake this prefix in preparation of installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-bindir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libdir in which libs are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dynlibdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for dynamic libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for program executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libexecdir in which private executables are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datadir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for read-only data │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datasubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of datadir in which data files are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-docdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-htmldir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for HTML documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddockdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for haddock interfaces │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-sysconfdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for configuration files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-prefix │ │ │ │ │ +.I PREFIX │ │ │ │ │ +.RS │ │ │ │ │ +prefix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-suffix │ │ │ │ │ +.I SUFFIX │ │ │ │ │ +.RS │ │ │ │ │ +suffix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Vanilla libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-p, \-\-enable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-shared │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-shared │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Shared library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Static library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable dynamic linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable fully static linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable and library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable profiling (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for executable and library (default, none, exported-functions, toplevel-functions, all-functions). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-library-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for libraries only. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-O, \-\-enable-optimization, \-\-enable-optimisation │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Build with optimization (n is 0--2, default is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-optimization, \-\-disable-optimisation │ │ │ │ │ +.RS │ │ │ │ │ +Build without optimization │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-debug-info │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Emit debug info (n is 0--3, default is 0) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-debug-info │ │ │ │ │ +.RS │ │ │ │ │ +Don't emit debug info │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library for use with GHCi │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library code such that unneeded definitions can be dropped from the final executable (GHC 7.8+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +split library into smaller objects to reduce binary sizes (GHC 6.6+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip executables upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip libraries upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-configure-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +Extra option for configure │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-user │ │ │ │ │ +.br │ │ │ │ │ +\-\-global │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +doing a per-user installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-package-db │ │ │ │ │ +.I DB │ │ │ │ │ +.RS │ │ │ │ │ +Append the given package database to the list of package databases used (to satisfy dependencies and register into). May be a specific file, 'global' or 'user'. The initial list is ['global'], ['global', 'user'], or ['global', $sandbox], depending on context. Use 'clear' to reset the list to empty. See the user guide for details. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-f, \-\-flags │ │ │ │ │ +.I FLAGS │ │ │ │ │ +.RS │ │ │ │ │ +Force values for the given flags in Cabal conditionals in the .cabal file. E.g., --flags="debug -usebytestrings" forces the flag "debug" to true and "usebytestrings" to false. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-include-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for header files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to be as deterministic as possible (used by the test suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ipid │ │ │ │ │ +.I IPID │ │ │ │ │ +.RS │ │ │ │ │ +Installed package ID to compile this package as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cid │ │ │ │ │ +.I CID │ │ │ │ │ +.RS │ │ │ │ │ +Installed component ID to compile this component as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-lib-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-framework-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external frameworks (OS X only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-prog-path │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for required programs (in addition to the normal search locations) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-instantiate-with │ │ │ │ │ +.I NAME=MOD │ │ │ │ │ +.RS │ │ │ │ │ +A mapping of signature names to concrete module instantiations. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-tests │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for test suites listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for benchmarks listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +building a package that is relocatable. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-response-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +enable workaround for old versions of programs like "ar" that do not support @file arguments │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-depending-on-private-libs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow depending on private libraries. If set, the library visibility check MUST be done externally. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-alex │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-c2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-cpphs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-doctest │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-gcc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-greencard │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haddock │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-happy │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hmake │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hpc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hsc2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hscolour │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-jhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ld │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-pkg-config │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-runghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-strip │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-tar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-uhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to alex (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to c2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to cpphs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to doctest (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to gcc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to greencard (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haddock (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to happy (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hmake (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hpc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hsc2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hscolour (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to jhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ld (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to pkg-config (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to runghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to strip (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to tar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to uhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-lib-version │ │ │ │ │ +.I VERSION │ │ │ │ │ +.RS │ │ │ │ │ +Select which version of the Cabal lib to use to build packages (useful for testing). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-constraint │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify constraints on a package (version, installed/source, flags) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-preference │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify preferences (soft constraints) on the version of a package │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-solver │ │ │ │ │ +.I SOLVER │ │ │ │ │ +.RS │ │ │ │ │ +Select dependency solver to use (default: modular). Choices: modular. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-older │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore lower bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-newer │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore upper bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-write-ghc-environment-files │ │ │ │ │ +.I always|never|ghc8.4.4+ │ │ │ │ │ +.RS │ │ │ │ │ +Whether to create a .ghc.environment file after a successful build (v2-build only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-documentation │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-documentation │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +building of documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doc-index-file │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +A central index of haddock API documentation (template cannot use $pkgid) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dry-run │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not install anything, only print what would be installed. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-max-backjumps │ │ │ │ │ +.I NUM │ │ │ │ │ +.RS │ │ │ │ │ +Maximum number of backjumps allowed while solving (default: 4000). Use a negative number to enable unlimited backtracking. Use 0 to disable backtracking completely. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to reorder goals according to certain heuristics. Slows things down on average, but may make backtracking faster for some packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to speed up solving by preferring goals that are involved in a lot of conflicts (default). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +When there is no solution, try to improve the error message by finding a minimal conflict set (default: false). May increase run time significantly. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Treat several goals on the command line as independent. If several goals depend on the same package, different versions can be chosen. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +If multiple package instances of the same version are installed, treat all but one as shadowed. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not defer flag choices (this used to be the default in cabal-install <= 1.20). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow cabal to install base, ghc-prim, integer-simple, integer-gmp, and template-haskell. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reject-unconstrained-dependencies │ │ │ │ │ +.I none|all │ │ │ │ │ +.RS │ │ │ │ │ +Require these packages to have constraints on them if they are to be selected (default: none). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reinstall │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-reinstall │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Install even if it means installing the same version again. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-avoid-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-avoid-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not select versions that would destructively overwrite installed packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-force-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-force-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Reinstall packages even if they will most likely break other installed packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-upgrade-dependencies │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-upgrade-dependencies │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Pick the latest version for all dependencies, rather than trying to pick an installed version. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only-dependencies │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-only-dependencies │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Install only the dependencies necessary to build the given packages │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dependencies-only │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-dependencies-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +A synonym for --only-dependencies │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-index-state │ │ │ │ │ +.I STATE │ │ │ │ │ +.RS │ │ │ │ │ +Use source package index state as it existed at a previous time. Accepts unix-timestamps (e.g. '@1474732068'), ISO8601 UTC timestamps (e.g. '2016-09-24T17:47:48Z'), or 'HEAD' (default: 'HEAD'). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-root-cmd │ │ │ │ │ +.I COMMAND │ │ │ │ │ +.RS │ │ │ │ │ +(No longer supported, do not use.) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-symlink-bindir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +Add symlinks to installed executables into this directory. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-build-summary │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Save build summaries to file (name template can use $pkgid, $compiler, $os, $arch) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-build-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Log all builds to file (name template can use $pkgid, $compiler, $os, $arch) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-remote-build-reporting │ │ │ │ │ +.I LEVEL │ │ │ │ │ +.RS │ │ │ │ │ +Generate build reports to send to a remote server (none, anonymous or detailed). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-report-planning-failure │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate build reports when the dependency solver fails. This is used by the Hackage build bot. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-per-component │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-per-component │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Per-component builds when possible │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-one-shot │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-one-shot │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not record the packages in the world file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-run-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run package test suites during installation. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-j, \-\-jobs │ │ │ │ │ +.RI [ NUM ] │ │ │ │ │ +.RS │ │ │ │ │ +Run NUM jobs simultaneously (or '$ncpus' if no NUM is given). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-keep-going │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +After a build failure, continue to build other unaffected packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-offline │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-offline │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Don't download packages from the Internet. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-project-file │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Set the name of the cabal.project file to search for in parent directories │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Only installs the package in the current directory. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hoogle │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate a hoogle database │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-html │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate HTML documentation (the default) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-html-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Location of HTML documentation for pre-requisite packages │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-for-hackage │ │ │ │ │ +.RS │ │ │ │ │ +Collection of flags to generate documentation suitable for upload to hackage │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-executables │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Executables targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Test Suite targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Benchmark targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-all │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for all targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-internal │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for internal modules and include all symbols │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the haddock stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hyperlink-source, \-\-haddock-hyperlink-sources, \-\-haddock-hyperlinked-source │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Hyperlink the documentation to the source code │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-quickjump │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate an index for interactive documentation navigation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hscolour-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the HsColour stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-contents-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Bake URL in as the location for the contents page │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Log all test suite results to file (name template can use $pkgid, $compiler, $os, $arch, $test-suite, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-machine-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Produce a machine-readable log file (name template can use $pkgid, $compiler, $os, $arch, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-show-details │ │ │ │ │ +.I FILTER │ │ │ │ │ +.RS │ │ │ │ │ +'always': always show results of individual test cases. 'never': never show results of individual test cases. 'failures': show results of failing test cases. 'streaming': show results of test cases in real time.'direct': send results of test cases in real time; no log file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-keep-tix-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +keep .tix files for HPC between test runs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-wrapper │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Run test through a wrapper. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-fail-when-no-test-suites │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Exit with failure when no test suites are found. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-options │ │ │ │ │ +.I TEMPLATES │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to test executables (name templates can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-option │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +give extra option to test executables (no need to quote options containing spaces, name template can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal clean │ │ │ │ │ + │ │ │ │ │ +Usage: cabal new-clean [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Removes all temporary files created during the building process (.hi, .o, │ │ │ │ │ +preprocessed sources, etc.) and also empties out the local caches (by │ │ │ │ │ +default). │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Removes all temporary files created during the building process (.hi, .o, │ │ │ │ │ +preprocessed sources, etc.) and also empties out the local caches (by │ │ │ │ │ +default). │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-project-file │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Set the name of the cabal.project file to search for in parent directories │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-s, \-\-save-config │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Save configuration, only remove build artifacts │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal new-clean │ │ │ │ │ + │ │ │ │ │ +Usage: cabal new-clean [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Removes all temporary files created during the building process (.hi, .o, │ │ │ │ │ +preprocessed sources, etc.) and also empties out the local caches (by │ │ │ │ │ +default). │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Removes all temporary files created during the building process (.hi, .o, │ │ │ │ │ +preprocessed sources, etc.) and also empties out the local caches (by │ │ │ │ │ +default). │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-project-file │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Set the name of the cabal.project file to search for in parent directories │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-s, \-\-save-config │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Save configuration, only remove build artifacts │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v2-clean │ │ │ │ │ + │ │ │ │ │ +Usage: cabal new-clean [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Removes all temporary files created during the building process (.hi, .o, │ │ │ │ │ +preprocessed sources, etc.) and also empties out the local caches (by │ │ │ │ │ +default). │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-project-file │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Set the name of the cabal.project file to search for in parent directories │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-s, \-\-save-config │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Save configuration, only remove build artifacts │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal sdist │ │ │ │ │ + │ │ │ │ │ +Usage: cabal sdist [FLAGS] [PACKAGES] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Generates tarballs of project packages suitable for upload to Hackage. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Generates tarballs of project packages suitable for upload to Hackage. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-project-file │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Set the name of the cabal.project file to search for in parent directories │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-l, \-\-list-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Just list the sources, do not make a tarball │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-z, \-\-null-sep │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Separate the source files with NUL bytes rather than newlines. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-o, \-\-output-dir, \-\-outputdir │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Choose the output directory of this command. '-' sends all output to stdout │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal new-sdist │ │ │ │ │ + │ │ │ │ │ +Usage: cabal new-sdist [FLAGS] [PACKAGES] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Generates tarballs of project packages suitable for upload to Hackage. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Generates tarballs of project packages suitable for upload to Hackage. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-project-file │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Set the name of the cabal.project file to search for in parent directories │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-l, \-\-list-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Just list the sources, do not make a tarball │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-z, \-\-null-sep │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Separate the source files with NUL bytes rather than newlines. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-o, \-\-output-dir, \-\-outputdir │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Choose the output directory of this command. '-' sends all output to stdout │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v2-sdist │ │ │ │ │ + │ │ │ │ │ +Usage: cabal v2-sdist [FLAGS] [PACKAGES] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Generates tarballs of project packages suitable for upload to Hackage. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-project-file │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Set the name of the cabal.project file to search for in parent directories │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-l, \-\-list-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Just list the sources, do not make a tarball │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-z, \-\-null-sep │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Separate the source files with NUL bytes rather than newlines. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-o, \-\-output-dir, \-\-outputdir │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Choose the output directory of this command. '-' sends all output to stdout │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v1-configure │ │ │ │ │ + │ │ │ │ │ +Usage: cabal v1-configure [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Configure how the package is built by setting package (and other) flags. │ │ │ │ │ + │ │ │ │ │ +The configuration affects several other commands, including v1-build, v1-test, │ │ │ │ │ +v1-bench, v1-run, v1-repl. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +The flags --with-PROG and --PROG-option(s) can be used with the following programs: │ │ │ │ │ + alex ar c2hs cpphs doctest gcc ghc ghc-pkg ghcjs ghcjs-pkg greencard haddock │ │ │ │ │ + happy haskell-suite haskell-suite-pkg hmake hpc hsc2hs hscolour jhc ld │ │ │ │ │ + pkg-config runghc strip tar uhc │ │ │ │ │ + │ │ │ │ │ +Examples: │ │ │ │ │ + cabal v1-configure │ │ │ │ │ + Configure with defaults; │ │ │ │ │ + cabal v1-configure --enable-tests -fcustomflag │ │ │ │ │ + Configure building package including tests, │ │ │ │ │ + with some package-specific flag. │ │ │ │ │ + │ │ │ │ │ +The v1-configure command is a part of the legacy v1 style of cabal usage. │ │ │ │ │ + │ │ │ │ │ +It is a legacy feature and will be removed in a future release of │ │ │ │ │ +cabal-install. Please file a bug if you cannot replicate a working v1- use │ │ │ │ │ +case with the new-style commands. │ │ │ │ │ + │ │ │ │ │ +For more information, see: https://wiki.haskell.org/Cabal/NewBuild │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-g, \-\-ghc │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHCJS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc │ │ │ │ │ +.RS │ │ │ │ │ +compile with UHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite │ │ │ │ │ +.RS │ │ │ │ │ +compile with a haskell-suite compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-file │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +use this Cabal file │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-w, \-\-with-compiler │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to a particular compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to the package tool │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-prefix │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +bake this prefix in preparation of installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-bindir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libdir in which libs are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dynlibdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for dynamic libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for program executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libexecdir in which private executables are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datadir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for read-only data │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datasubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of datadir in which data files are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-docdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-htmldir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for HTML documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddockdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for haddock interfaces │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-sysconfdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for configuration files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-prefix │ │ │ │ │ +.I PREFIX │ │ │ │ │ +.RS │ │ │ │ │ +prefix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-suffix │ │ │ │ │ +.I SUFFIX │ │ │ │ │ +.RS │ │ │ │ │ +suffix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Vanilla libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-p, \-\-enable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-shared │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-shared │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Shared library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Static library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable dynamic linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable fully static linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable and library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable profiling (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for executable and library (default, none, exported-functions, toplevel-functions, all-functions). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-library-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for libraries only. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-O, \-\-enable-optimization, \-\-enable-optimisation │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Build with optimization (n is 0--2, default is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-optimization, \-\-disable-optimisation │ │ │ │ │ +.RS │ │ │ │ │ +Build without optimization │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-debug-info │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Emit debug info (n is 0--3, default is 0) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-debug-info │ │ │ │ │ +.RS │ │ │ │ │ +Don't emit debug info │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library for use with GHCi │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library code such that unneeded definitions can be dropped from the final executable (GHC 7.8+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +split library into smaller objects to reduce binary sizes (GHC 6.6+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip executables upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip libraries upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-configure-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +Extra option for configure │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-user │ │ │ │ │ +.br │ │ │ │ │ +\-\-global │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +doing a per-user installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-package-db │ │ │ │ │ +.I DB │ │ │ │ │ +.RS │ │ │ │ │ +Append the given package database to the list of package databases used (to satisfy dependencies and register into). May be a specific file, 'global' or 'user'. The initial list is ['global'], ['global', 'user'], or ['global', $sandbox], depending on context. Use 'clear' to reset the list to empty. See the user guide for details. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-f, \-\-flags │ │ │ │ │ +.I FLAGS │ │ │ │ │ +.RS │ │ │ │ │ +Force values for the given flags in Cabal conditionals in the .cabal file. E.g., --flags="debug -usebytestrings" forces the flag "debug" to true and "usebytestrings" to false. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-include-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for header files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to be as deterministic as possible (used by the test suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ipid │ │ │ │ │ +.I IPID │ │ │ │ │ +.RS │ │ │ │ │ +Installed package ID to compile this package as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cid │ │ │ │ │ +.I CID │ │ │ │ │ +.RS │ │ │ │ │ +Installed component ID to compile this component as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-lib-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-framework-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external frameworks (OS X only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-prog-path │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for required programs (in addition to the normal search locations) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-instantiate-with │ │ │ │ │ +.I NAME=MOD │ │ │ │ │ +.RS │ │ │ │ │ +A mapping of signature names to concrete module instantiations. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-tests │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for test suites listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for benchmarks listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +building a package that is relocatable. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-response-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +enable workaround for old versions of programs like "ar" that do not support @file arguments │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-depending-on-private-libs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow depending on private libraries. If set, the library visibility check MUST be done externally. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-alex │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-c2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-cpphs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-doctest │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-gcc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-greencard │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haddock │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-happy │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hmake │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hpc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hsc2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hscolour │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-jhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ld │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-pkg-config │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-runghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-strip │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-tar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-uhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to alex (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to c2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to cpphs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to doctest (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to gcc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to greencard (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haddock (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to happy (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hmake (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hpc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hsc2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hscolour (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to jhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ld (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to pkg-config (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to runghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to strip (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to tar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to uhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-lib-version │ │ │ │ │ +.I VERSION │ │ │ │ │ +.RS │ │ │ │ │ +Select which version of the Cabal lib to use to build packages (useful for testing). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-constraint │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify constraints on a package (version, installed/source, flags) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-preference │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify preferences (soft constraints) on the version of a package │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-solver │ │ │ │ │ +.I SOLVER │ │ │ │ │ +.RS │ │ │ │ │ +Select dependency solver to use (default: modular). Choices: modular. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-older │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore lower bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-newer │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore upper bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-write-ghc-environment-files │ │ │ │ │ +.I always|never|ghc8.4.4+ │ │ │ │ │ +.RS │ │ │ │ │ +Whether to create a .ghc.environment file after a successful build (v2-build only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v1-update │ │ │ │ │ + │ │ │ │ │ +Usage: cabal v1-update [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +For all known remote repositories, download the package list. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Relevant global configuration keys: │ │ │ │ │ + remote-repo │ │ │ │ │ + remote-repo-cache │ │ │ │ │ + local-repo │ │ │ │ │ + │ │ │ │ │ +The v1-update command is a part of the legacy v1 style of cabal usage. │ │ │ │ │ + │ │ │ │ │ +It is a legacy feature and will be removed in a future release of │ │ │ │ │ +cabal-install. Please file a bug if you cannot replicate a working v1- use │ │ │ │ │ +case with the new-style commands. │ │ │ │ │ + │ │ │ │ │ +For more information, see: https://wiki.haskell.org/Cabal/NewBuild │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-index-state │ │ │ │ │ +.I STATE │ │ │ │ │ +.RS │ │ │ │ │ +Update the source package index to its state as it existed at a previous time. Accepts unix-timestamps (e.g. '@1474732068'), ISO8601 UTC timestamps (e.g. '2016-09-24T17:47:48Z'), or 'HEAD' (default: 'HEAD'). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v1-build │ │ │ │ │ + │ │ │ │ │ +Usage: cabal v1-build [FLAGS] │ │ │ │ │ + or: cabal v1-build COMPONENTS [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Components encompass executables, tests, and benchmarks. │ │ │ │ │ + │ │ │ │ │ +Affected by configuration options, see `v1-configure`. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Examples: │ │ │ │ │ + cabal v1-build All the components in the package │ │ │ │ │ + cabal v1-build foo A component (i.e. lib, exe, test suite) │ │ │ │ │ + │ │ │ │ │ +The flags --with-PROG and --PROG-option(s) can be used with the following programs: │ │ │ │ │ + alex ar c2hs cpphs doctest gcc ghc ghc-pkg ghcjs ghcjs-pkg greencard haddock │ │ │ │ │ + happy haskell-suite haskell-suite-pkg hmake hpc hsc2hs hscolour jhc ld │ │ │ │ │ + pkg-config runghc strip tar uhc │ │ │ │ │ + │ │ │ │ │ +The v1-build command is a part of the legacy v1 style of cabal usage. │ │ │ │ │ + │ │ │ │ │ +It is a legacy feature and will be removed in a future release of │ │ │ │ │ +cabal-install. Please file a bug if you cannot replicate a working v1- use │ │ │ │ │ +case with the new-style commands. │ │ │ │ │ + │ │ │ │ │ +For more information, see: https://wiki.haskell.org/Cabal/NewBuild │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-j, \-\-jobs │ │ │ │ │ +.RI [ NUM ] │ │ │ │ │ +.RS │ │ │ │ │ +Run NUM jobs simultaneously (or '$ncpus' if no NUM is given). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-alex │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-c2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-cpphs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-doctest │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-gcc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-greencard │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haddock │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-happy │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hmake │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hpc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hsc2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hscolour │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-jhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ld │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-pkg-config │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-runghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-strip │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-tar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-uhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to alex (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to c2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to cpphs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to doctest (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to gcc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to greencard (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haddock (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to happy (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hmake (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hpc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hsc2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hscolour (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to jhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ld (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to pkg-config (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to runghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to strip (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to tar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to uhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only │ │ │ │ │ +.RS │ │ │ │ │ +Don't reinstall add-source dependencies (sandbox-only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v1-repl │ │ │ │ │ + │ │ │ │ │ +Usage: cabal v1-repl [COMPONENT] [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +If the current directory contains no package, ignores COMPONENT parameters and │ │ │ │ │ +opens an interactive interpreter session; if a sandbox is present, its package │ │ │ │ │ +database will be used. │ │ │ │ │ + │ │ │ │ │ +Otherwise, (re)configures with the given or default flags, and loads the │ │ │ │ │ +interpreter with the relevant modules. For executables, tests and benchmarks, │ │ │ │ │ +loads the main module (and its dependencies); for libraries all exposed/other │ │ │ │ │ +modules. │ │ │ │ │ + │ │ │ │ │ +The default component is the library itself, or the executable if that is the │ │ │ │ │ +only component. │ │ │ │ │ + │ │ │ │ │ +Support for loading specific modules is planned but not implemented yet. For │ │ │ │ │ +certain scenarios, `cabal v1-exec -- ghci :l Foo` may be used instead. Note │ │ │ │ │ +that `v1-exec` will not (re)configure and you will have to specify the │ │ │ │ │ +location of other modules, if required. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Examples: │ │ │ │ │ + cabal v1-repl The first component in the package │ │ │ │ │ + cabal v1-repl foo A named component (i.e. lib, exe, test suite) │ │ │ │ │ + cabal v1-repl --ghc-options="-lstdc++" Specifying flags for interpreter │ │ │ │ │ + │ │ │ │ │ +The v1-repl command is a part of the legacy v1 style of cabal usage. │ │ │ │ │ + │ │ │ │ │ +It is a legacy feature and will be removed in a future release of │ │ │ │ │ +cabal-install. Please file a bug if you cannot replicate a working v1- use │ │ │ │ │ +case with the new-style commands. │ │ │ │ │ + │ │ │ │ │ +For more information, see: https://wiki.haskell.org/Cabal/NewBuild │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-alex │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-c2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-cpphs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-doctest │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-gcc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-greencard │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haddock │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-happy │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hmake │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hpc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hsc2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hscolour │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-jhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ld │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-pkg-config │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-runghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-strip │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-tar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-uhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to alex (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to c2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to cpphs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to doctest (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to gcc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to greencard (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haddock (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to happy (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hmake (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hpc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hsc2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hscolour (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to jhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ld (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to pkg-config (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to runghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to strip (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to tar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to uhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reload │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Used from within an interpreter to update files. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-repl-options │ │ │ │ │ +.I FLAG │ │ │ │ │ +.RS │ │ │ │ │ +use this option for the repl │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only │ │ │ │ │ +.RS │ │ │ │ │ +Don't reinstall add-source dependencies (sandbox-only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v1-freeze │ │ │ │ │ + │ │ │ │ │ +Usage: cabal freeze [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Calculates a valid set of dependencies and their exact versions. If │ │ │ │ │ +successful, saves the result to the file `cabal.config`. │ │ │ │ │ + │ │ │ │ │ +The package versions specified in `cabal.config` will be used for any future │ │ │ │ │ +installs. │ │ │ │ │ + │ │ │ │ │ +An existing `cabal.config` is ignored and overwritten. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +The v1-freeze command is a part of the legacy v1 style of cabal usage. │ │ │ │ │ + │ │ │ │ │ +It is a legacy feature and will be removed in a future release of │ │ │ │ │ +cabal-install. Please file a bug if you cannot replicate a working v1- use │ │ │ │ │ +case with the new-style commands. │ │ │ │ │ + │ │ │ │ │ +For more information, see: https://wiki.haskell.org/Cabal/NewBuild │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dry-run │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not freeze anything, only print what would be frozen │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-tests │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +freezing of the dependencies of any tests suites in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +freezing of the dependencies of any benchmarks suites in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-solver │ │ │ │ │ +.I SOLVER │ │ │ │ │ +.RS │ │ │ │ │ +Select dependency solver to use (default: modular). Choices: modular. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-max-backjumps │ │ │ │ │ +.I NUM │ │ │ │ │ +.RS │ │ │ │ │ +Maximum number of backjumps allowed while solving (default: 4000). Use a negative number to enable unlimited backtracking. Use 0 to disable backtracking completely. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to reorder goals according to certain heuristics. Slows things down on average, but may make backtracking faster for some packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to speed up solving by preferring goals that are involved in a lot of conflicts (default). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +When there is no solution, try to improve the error message by finding a minimal conflict set (default: false). May increase run time significantly. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Treat several goals on the command line as independent. If several goals depend on the same package, different versions can be chosen. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +If multiple package instances of the same version are installed, treat all but one as shadowed. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not defer flag choices (this used to be the default in cabal-install <= 1.20). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow cabal to install base, ghc-prim, integer-simple, integer-gmp, and template-haskell. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reject-unconstrained-dependencies │ │ │ │ │ +.I none|all │ │ │ │ │ +.RS │ │ │ │ │ +Require these packages to have constraints on them if they are to be selected (default: none). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v1-haddock │ │ │ │ │ + │ │ │ │ │ +Usage: cabal v1-haddock [FLAGS] │ │ │ │ │ + or: cabal v1-haddock COMPONENTS [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Requires the program haddock, version 2.x. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +The v1-haddock command is a part of the legacy v1 style of cabal usage. │ │ │ │ │ + │ │ │ │ │ +It is a legacy feature and will be removed in a future release of │ │ │ │ │ +cabal-install. Please file a bug if you cannot replicate a working v1- use │ │ │ │ │ +case with the new-style commands. │ │ │ │ │ + │ │ │ │ │ +For more information, see: https://wiki.haskell.org/Cabal/NewBuild │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-keep-temp-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Keep temporary files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hoogle │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate a hoogle database │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-html │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate HTML documentation (the default) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-html-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Location of HTML documentation for pre-requisite packages │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-for-hackage │ │ │ │ │ +.RS │ │ │ │ │ +Collection of flags to generate documentation suitable for upload to hackage │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-executables │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Executables targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Test Suite targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Benchmark targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-foreign-libraries │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Foreign Library targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-all │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for all targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-internal │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for internal modules and include all symbols │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the haddock stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hyperlink-source, \-\-hyperlink-sources, \-\-hyperlinked-source │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Hyperlink the documentation to the source code │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-quickjump │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate an index for interactive documentation navigation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the HsColour stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-contents-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Bake URL in as the location for the contents page │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haddock │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haddock (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v1-install │ │ │ │ │ + │ │ │ │ │ +Usage: cabal v1-install [FLAGS] │ │ │ │ │ + or: cabal v1-install [FLAGS] PACKAGES │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Installs one or more packages. By default, the installed package will be │ │ │ │ │ +registered in the user's package database or, if a sandbox is present in the │ │ │ │ │ +current directory, inside the sandbox. │ │ │ │ │ + │ │ │ │ │ +If PACKAGES are specified, downloads and installs those packages. Otherwise, │ │ │ │ │ +install the package in the current directory (and/or its dependencies) (there │ │ │ │ │ +must be exactly one .cabal file in the current directory). │ │ │ │ │ + │ │ │ │ │ +When using a sandbox, the flags for `v1-install` only affect the current │ │ │ │ │ +command and have no effect on future commands. (To achieve that, │ │ │ │ │ +`v1-configure` must be used.) │ │ │ │ │ +In contrast, without a sandbox, the flags to `v1-install` are saved and affect │ │ │ │ │ +future commands such as `v1-build` and `v1-repl`. See the help for │ │ │ │ │ +`v1-configure` for a list of commands being affected. │ │ │ │ │ + │ │ │ │ │ +Installed executables will by default (and without a sandbox) be put into │ │ │ │ │ +`~/.cabal/bin/`. If you want installed executable to be available globally, │ │ │ │ │ +make sure that the PATH environment variable contains that directory. │ │ │ │ │ +When using a sandbox, executables will be put into `$SANDBOX/bin/` (by │ │ │ │ │ +default: `./.cabal-sandbox/bin/`). │ │ │ │ │ + │ │ │ │ │ +When specifying --bindir, consider also specifying --datadir; this way the │ │ │ │ │ +sandbox can be deleted and the executable should continue working as long as │ │ │ │ │ +bindir and datadir are left untouched. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +The flags --with-PROG and --PROG-option(s) can be used with the following programs: │ │ │ │ │ + alex ar c2hs cpphs doctest gcc ghc ghc-pkg ghcjs ghcjs-pkg greencard haddock │ │ │ │ │ + happy haskell-suite haskell-suite-pkg hmake hpc hsc2hs hscolour jhc ld │ │ │ │ │ + pkg-config runghc strip tar uhc │ │ │ │ │ + │ │ │ │ │ +Examples: │ │ │ │ │ + cabal v1-install Package in the current directory │ │ │ │ │ + cabal v1-install foo Package from the hackage server │ │ │ │ │ + cabal v1-install foo-1.0 Specific version of a package │ │ │ │ │ + cabal v1-install 'foo < 2' Constrained package version │ │ │ │ │ + cabal v1-install haddock --bindir=$HOME/hask-bin/ --datadir=$HOME/hask-data/ │ │ │ │ │ + Change installation destination │ │ │ │ │ + │ │ │ │ │ +The v1-install command is a part of the legacy v1 style of cabal usage. │ │ │ │ │ + │ │ │ │ │ +It is a legacy feature and will be removed in a future release of │ │ │ │ │ +cabal-install. Please file a bug if you cannot replicate a working v1- use │ │ │ │ │ +case with the new-style commands. │ │ │ │ │ + │ │ │ │ │ +For more information, see: https://wiki.haskell.org/Cabal/NewBuild │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-g, \-\-ghc │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHCJS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc │ │ │ │ │ +.RS │ │ │ │ │ +compile with UHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite │ │ │ │ │ +.RS │ │ │ │ │ +compile with a haskell-suite compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-file │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +use this Cabal file │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-w, \-\-with-compiler │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to a particular compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to the package tool │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-prefix │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +bake this prefix in preparation of installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-bindir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libdir in which libs are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dynlibdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for dynamic libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for program executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libexecdir in which private executables are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datadir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for read-only data │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datasubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of datadir in which data files are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-docdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-htmldir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for HTML documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddockdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for haddock interfaces │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-sysconfdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for configuration files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-prefix │ │ │ │ │ +.I PREFIX │ │ │ │ │ +.RS │ │ │ │ │ +prefix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-suffix │ │ │ │ │ +.I SUFFIX │ │ │ │ │ +.RS │ │ │ │ │ +suffix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Vanilla libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-p, \-\-enable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-shared │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-shared │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Shared library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Static library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable dynamic linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable fully static linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable and library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable profiling (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for executable and library (default, none, exported-functions, toplevel-functions, all-functions). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-library-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for libraries only. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-O, \-\-enable-optimization, \-\-enable-optimisation │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Build with optimization (n is 0--2, default is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-optimization, \-\-disable-optimisation │ │ │ │ │ +.RS │ │ │ │ │ +Build without optimization │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-debug-info │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Emit debug info (n is 0--3, default is 0) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-debug-info │ │ │ │ │ +.RS │ │ │ │ │ +Don't emit debug info │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library for use with GHCi │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library code such that unneeded definitions can be dropped from the final executable (GHC 7.8+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +split library into smaller objects to reduce binary sizes (GHC 6.6+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip executables upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip libraries upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-configure-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +Extra option for configure │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-user │ │ │ │ │ +.br │ │ │ │ │ +\-\-global │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +doing a per-user installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-package-db │ │ │ │ │ +.I DB │ │ │ │ │ +.RS │ │ │ │ │ +Append the given package database to the list of package databases used (to satisfy dependencies and register into). May be a specific file, 'global' or 'user'. The initial list is ['global'], ['global', 'user'], or ['global', $sandbox], depending on context. Use 'clear' to reset the list to empty. See the user guide for details. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-f, \-\-flags │ │ │ │ │ +.I FLAGS │ │ │ │ │ +.RS │ │ │ │ │ +Force values for the given flags in Cabal conditionals in the .cabal file. E.g., --flags="debug -usebytestrings" forces the flag "debug" to true and "usebytestrings" to false. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-include-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for header files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to be as deterministic as possible (used by the test suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ipid │ │ │ │ │ +.I IPID │ │ │ │ │ +.RS │ │ │ │ │ +Installed package ID to compile this package as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cid │ │ │ │ │ +.I CID │ │ │ │ │ +.RS │ │ │ │ │ +Installed component ID to compile this component as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-lib-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-framework-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external frameworks (OS X only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-prog-path │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for required programs (in addition to the normal search locations) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-instantiate-with │ │ │ │ │ +.I NAME=MOD │ │ │ │ │ +.RS │ │ │ │ │ +A mapping of signature names to concrete module instantiations. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-tests │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for test suites listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for benchmarks listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +building a package that is relocatable. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-response-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +enable workaround for old versions of programs like "ar" that do not support @file arguments │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-depending-on-private-libs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow depending on private libraries. If set, the library visibility check MUST be done externally. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-alex │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-c2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-cpphs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-doctest │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-gcc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-greencard │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haddock │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-happy │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hmake │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hpc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hsc2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hscolour │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-jhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ld │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-pkg-config │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-runghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-strip │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-tar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-uhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to alex (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to c2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to cpphs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to doctest (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to gcc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to greencard (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haddock (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to happy (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hmake (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hpc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hsc2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hscolour (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to jhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ld (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to pkg-config (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to runghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to strip (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to tar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to uhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-lib-version │ │ │ │ │ +.I VERSION │ │ │ │ │ +.RS │ │ │ │ │ +Select which version of the Cabal lib to use to build packages (useful for testing). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-constraint │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify constraints on a package (version, installed/source, flags) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-preference │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify preferences (soft constraints) on the version of a package │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-solver │ │ │ │ │ +.I SOLVER │ │ │ │ │ +.RS │ │ │ │ │ +Select dependency solver to use (default: modular). Choices: modular. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-older │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore lower bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-newer │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore upper bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-write-ghc-environment-files │ │ │ │ │ +.I always|never|ghc8.4.4+ │ │ │ │ │ +.RS │ │ │ │ │ +Whether to create a .ghc.environment file after a successful build (v2-build only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-documentation │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-documentation │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +building of documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doc-index-file │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +A central index of haddock API documentation (template cannot use $pkgid) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dry-run │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not install anything, only print what would be installed. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-max-backjumps │ │ │ │ │ +.I NUM │ │ │ │ │ +.RS │ │ │ │ │ +Maximum number of backjumps allowed while solving (default: 4000). Use a negative number to enable unlimited backtracking. Use 0 to disable backtracking completely. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-reorder-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to reorder goals according to certain heuristics. Slows things down on average, but may make backtracking faster for some packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-count-conflicts │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to speed up solving by preferring goals that are involved in a lot of conflicts (default). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-minimize-conflict-set │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +When there is no solution, try to improve the error message by finding a minimal conflict set (default: false). May increase run time significantly. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-independent-goals │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Treat several goals on the command line as independent. If several goals depend on the same package, different versions can be chosen. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-shadow-installed-packages │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +If multiple package instances of the same version are installed, treat all but one as shadowed. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-strong-flags │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not defer flag choices (this used to be the default in cabal-install <= 1.20). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-allow-boot-library-installs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow cabal to install base, ghc-prim, integer-simple, integer-gmp, and template-haskell. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reject-unconstrained-dependencies │ │ │ │ │ +.I none|all │ │ │ │ │ +.RS │ │ │ │ │ +Require these packages to have constraints on them if they are to be selected (default: none). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-reinstall │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-reinstall │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Install even if it means installing the same version again. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-avoid-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-avoid-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not select versions that would destructively overwrite installed packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-force-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-force-reinstalls │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Reinstall packages even if they will most likely break other installed packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-upgrade-dependencies │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-upgrade-dependencies │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Pick the latest version for all dependencies, rather than trying to pick an installed version. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only-dependencies │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-only-dependencies │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Install only the dependencies necessary to build the given packages │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dependencies-only │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-dependencies-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +A synonym for --only-dependencies │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-index-state │ │ │ │ │ +.I STATE │ │ │ │ │ +.RS │ │ │ │ │ +Use source package index state as it existed at a previous time. Accepts unix-timestamps (e.g. '@1474732068'), ISO8601 UTC timestamps (e.g. '2016-09-24T17:47:48Z'), or 'HEAD' (default: 'HEAD'). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-root-cmd │ │ │ │ │ +.I COMMAND │ │ │ │ │ +.RS │ │ │ │ │ +(No longer supported, do not use.) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-symlink-bindir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +Add symlinks to installed executables into this directory. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-build-summary │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Save build summaries to file (name template can use $pkgid, $compiler, $os, $arch) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-build-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Log all builds to file (name template can use $pkgid, $compiler, $os, $arch) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-remote-build-reporting │ │ │ │ │ +.I LEVEL │ │ │ │ │ +.RS │ │ │ │ │ +Generate build reports to send to a remote server (none, anonymous or detailed). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-report-planning-failure │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate build reports when the dependency solver fails. This is used by the Hackage build bot. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-per-component │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-per-component │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Per-component builds when possible │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-one-shot │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-one-shot │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not record the packages in the world file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-run-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run package test suites during installation. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-j, \-\-jobs │ │ │ │ │ +.RI [ NUM ] │ │ │ │ │ +.RS │ │ │ │ │ +Run NUM jobs simultaneously (or '$ncpus' if no NUM is given). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-keep-going │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +After a build failure, continue to build other unaffected packages. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-offline │ │ │ │ │ +.br │ │ │ │ │ +\-\-no-offline │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Don't download packages from the Internet. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-project-file │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Set the name of the cabal.project file to search for in parent directories │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Only installs the package in the current directory. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hoogle │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate a hoogle database │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-html │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate HTML documentation (the default) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-html-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Location of HTML documentation for pre-requisite packages │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-for-hackage │ │ │ │ │ +.RS │ │ │ │ │ +Collection of flags to generate documentation suitable for upload to hackage │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-executables │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Executables targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Test Suite targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for Benchmark targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-all │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for all targets │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-internal │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Run haddock for internal modules and include all symbols │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the haddock stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hyperlink-source, \-\-haddock-hyperlink-sources, \-\-haddock-hyperlinked-source │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Hyperlink the documentation to the source code │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-quickjump │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Generate an index for interactive documentation navigation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-hscolour-css │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +Use PATH as the HsColour stylesheet │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-contents-location │ │ │ │ │ +.I URL │ │ │ │ │ +.RS │ │ │ │ │ +Bake URL in as the location for the contents page │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Log all test suite results to file (name template can use $pkgid, $compiler, $os, $arch, $test-suite, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-machine-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Produce a machine-readable log file (name template can use $pkgid, $compiler, $os, $arch, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-show-details │ │ │ │ │ +.I FILTER │ │ │ │ │ +.RS │ │ │ │ │ +'always': always show results of individual test cases. 'never': never show results of individual test cases. 'failures': show results of failing test cases. 'streaming': show results of test cases in real time.'direct': send results of test cases in real time; no log file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-keep-tix-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +keep .tix files for HPC between test runs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-wrapper │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Run test through a wrapper. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-fail-when-no-test-suites │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Exit with failure when no test suites are found. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-options │ │ │ │ │ +.I TEMPLATES │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to test executables (name templates can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-option │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +give extra option to test executables (no need to quote options containing spaces, name template can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v1-run │ │ │ │ │ + │ │ │ │ │ +Usage: cabal v1-run [FLAGS] [EXECUTABLE] [-- EXECUTABLE_FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Builds and then runs the specified executable. If no executable is specified, │ │ │ │ │ +but the package contains just one executable, that one is built and executed. │ │ │ │ │ + │ │ │ │ │ +Use `cabal v1-test --show-details=streaming` to run a test-suite and get its │ │ │ │ │ +full output. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Examples: │ │ │ │ │ + cabal v1-run │ │ │ │ │ + Run the only executable in the current package; │ │ │ │ │ + cabal v1-run foo -- --fooflag │ │ │ │ │ + Works similar to `./foo --fooflag`. │ │ │ │ │ + │ │ │ │ │ +The v1-run command is a part of the legacy v1 style of cabal usage. │ │ │ │ │ + │ │ │ │ │ +It is a legacy feature and will be removed in a future release of │ │ │ │ │ +cabal-install. Please file a bug if you cannot replicate a working v1- use │ │ │ │ │ +case with the new-style commands. │ │ │ │ │ + │ │ │ │ │ +For more information, see: https://wiki.haskell.org/Cabal/NewBuild │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-j, \-\-jobs │ │ │ │ │ +.RI [ NUM ] │ │ │ │ │ +.RS │ │ │ │ │ +Run NUM jobs simultaneously (or '$ncpus' if no NUM is given). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-alex │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-c2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-cpphs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-doctest │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-gcc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-greencard │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haddock │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-happy │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hmake │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hpc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hsc2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hscolour │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-jhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ld │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-pkg-config │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-runghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-strip │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-tar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-uhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to alex (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to c2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to cpphs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to doctest (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to gcc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to greencard (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haddock (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to happy (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hmake (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hpc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hsc2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hscolour (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to jhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ld (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to pkg-config (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to runghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to strip (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to tar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to uhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only │ │ │ │ │ +.RS │ │ │ │ │ +Don't reinstall add-source dependencies (sandbox-only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v1-test │ │ │ │ │ + │ │ │ │ │ +Usage: cabal v1-test [FLAGS] │ │ │ │ │ + or: cabal v1-test TESTCOMPONENTS [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +If necessary (re)configures with `--enable-tests` flag and builds the test │ │ │ │ │ +suite. │ │ │ │ │ + │ │ │ │ │ +Remember that the tests' dependencies must be installed if there are │ │ │ │ │ +additional ones; e.g. with `cabal v1-install --only-dependencies │ │ │ │ │ +--enable-tests`. │ │ │ │ │ + │ │ │ │ │ +By defining UserHooks in a custom Setup.hs, the package can define actions to │ │ │ │ │ +be executed before and after running tests. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +The v1-test command is a part of the legacy v1 style of cabal usage. │ │ │ │ │ + │ │ │ │ │ +It is a legacy feature and will be removed in a future release of │ │ │ │ │ +cabal-install. Please file a bug if you cannot replicate a working v1- use │ │ │ │ │ +case with the new-style commands. │ │ │ │ │ + │ │ │ │ │ +For more information, see: https://wiki.haskell.org/Cabal/NewBuild │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Log all test suite results to file (name template can use $pkgid, $compiler, $os, $arch, $test-suite, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-machine-log │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +Produce a machine-readable log file (name template can use $pkgid, $compiler, $os, $arch, $result) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-show-details │ │ │ │ │ +.I FILTER │ │ │ │ │ +.RS │ │ │ │ │ +'always': always show results of individual test cases. 'never': never show results of individual test cases. 'failures': show results of failing test cases. 'streaming': show results of test cases in real time.'direct': send results of test cases in real time; no log file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-keep-tix-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +keep .tix files for HPC between test runs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-wrapper │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Run test through a wrapper. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-fail-when-no-test-suites │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Exit with failure when no test suites are found. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-options │ │ │ │ │ +.I TEMPLATES │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to test executables (name templates can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-test-option │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +give extra option to test executables (no need to quote options containing spaces, name template can use $pkgid, $compiler, $os, $arch, $test-suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-j, \-\-jobs │ │ │ │ │ +.RI [ NUM ] │ │ │ │ │ +.RS │ │ │ │ │ +Run NUM jobs simultaneously (or '$ncpus' if no NUM is given). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-alex │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-c2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-cpphs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-doctest │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-gcc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-greencard │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haddock │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-happy │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hmake │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hpc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hsc2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hscolour │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-jhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ld │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-pkg-config │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-runghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-strip │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-tar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-uhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to alex (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to c2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to cpphs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to doctest (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to gcc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to greencard (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haddock (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to happy (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hmake (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hpc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hsc2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hscolour (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to jhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ld (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to pkg-config (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to runghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to strip (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to tar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to uhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only │ │ │ │ │ +.RS │ │ │ │ │ +Don't reinstall add-source dependencies (sandbox-only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v1-bench │ │ │ │ │ + │ │ │ │ │ +Usage: cabal v1-bench [FLAGS] │ │ │ │ │ + or: cabal v1-bench BENCHCOMPONENTS [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +If necessary (re)configures with `--enable-benchmarks` flag and builds the │ │ │ │ │ +benchmarks. │ │ │ │ │ + │ │ │ │ │ +Remember that the benchmarks' dependencies must be installed if there are │ │ │ │ │ +additional ones; e.g. with `cabal v1-install --only-dependencies │ │ │ │ │ +--enable-benchmarks`. │ │ │ │ │ + │ │ │ │ │ +By defining UserHooks in a custom Setup.hs, the package can define actions to │ │ │ │ │ +be executed before and after running benchmarks. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +The v1-bench command is a part of the legacy v1 style of cabal usage. │ │ │ │ │ + │ │ │ │ │ +It is a legacy feature and will be removed in a future release of │ │ │ │ │ +cabal-install. Please file a bug if you cannot replicate a working v1- use │ │ │ │ │ +case with the new-style commands. │ │ │ │ │ + │ │ │ │ │ +For more information, see: https://wiki.haskell.org/Cabal/NewBuild │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-benchmark-options │ │ │ │ │ +.I TEMPLATES │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to benchmark executables (name templates can use $pkgid, $compiler, $os, $arch, $benchmark) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-benchmark-option │ │ │ │ │ +.I TEMPLATE │ │ │ │ │ +.RS │ │ │ │ │ +give extra option to benchmark executables (no need to quote options containing spaces, name template can use $pkgid, $compiler, $os, $arch, $benchmark) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-j, \-\-jobs │ │ │ │ │ +.RI [ NUM ] │ │ │ │ │ +.RS │ │ │ │ │ +Run NUM jobs simultaneously (or '$ncpus' if no NUM is given). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-alex │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-c2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-cpphs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-doctest │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-gcc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-greencard │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haddock │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-happy │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hmake │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hpc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hsc2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hscolour │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-jhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ld │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-pkg-config │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-runghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-strip │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-tar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-uhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to alex (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to c2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to cpphs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to doctest (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to gcc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to greencard (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haddock (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to happy (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hmake (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hpc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hsc2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hscolour (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to jhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ld (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to pkg-config (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to runghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to strip (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to tar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to uhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-only │ │ │ │ │ +.RS │ │ │ │ │ +Don't reinstall add-source dependencies (sandbox-only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v1-exec │ │ │ │ │ + │ │ │ │ │ +Usage: cabal v1-exec [FLAGS] [--] COMMAND [--] [ARGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +A directly invoked GHC will not automatically be aware of any sandboxes: the │ │ │ │ │ +GHC_PACKAGE_PATH environment variable controls what GHC uses. `cabal v1-exec` │ │ │ │ │ +can be used to modify this variable: COMMAND will be executed in a modified │ │ │ │ │ +environment and thereby uses the sandbox package database. │ │ │ │ │ + │ │ │ │ │ +If there is no sandbox, behaves as identity (executing COMMAND). │ │ │ │ │ + │ │ │ │ │ +Note that other cabal commands change the environment variable appropriately │ │ │ │ │ +already, so there is no need to wrap those in `cabal v1-exec`. But with `cabal │ │ │ │ │ +v1-exec`, the user has more control and can, for example, execute custom │ │ │ │ │ +scripts which indirectly execute GHC. │ │ │ │ │ + │ │ │ │ │ +Note that `cabal v1-repl` is different from `cabal v1-exec -- ghci` as the │ │ │ │ │ +latter will not forward any additional flags being defined in the local │ │ │ │ │ +package to ghci. │ │ │ │ │ + │ │ │ │ │ +See `cabal sandbox`. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Examples: │ │ │ │ │ + cabal v1-exec -- ghci -Wall │ │ │ │ │ + Start a repl session with sandbox packages and all warnings; │ │ │ │ │ + cabal v1-exec gitit -- -f gitit.cnf │ │ │ │ │ + Give gitit access to the sandbox packages, and pass it a flag; │ │ │ │ │ + cabal v1-exec runghc Foo.hs │ │ │ │ │ + Execute runghc on Foo.hs with runghc configured to use the │ │ │ │ │ + sandbox package database (if a sandbox is being used). │ │ │ │ │ + │ │ │ │ │ +The v1-exec command is a part of the legacy v1 style of cabal usage. │ │ │ │ │ + │ │ │ │ │ +It is a legacy feature and will be removed in a future release of │ │ │ │ │ +cabal-install. Please file a bug if you cannot replicate a working v1- use │ │ │ │ │ +case with the new-style commands. │ │ │ │ │ + │ │ │ │ │ +For more information, see: https://wiki.haskell.org/Cabal/NewBuild │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v1-clean │ │ │ │ │ + │ │ │ │ │ +Usage: cabal v1-clean [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Removes .hi, .o, preprocessed sources, etc. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +The v1-clean command is a part of the legacy v1 style of cabal usage. │ │ │ │ │ + │ │ │ │ │ +It is a legacy feature and will be removed in a future release of │ │ │ │ │ +cabal-install. Please file a bug if you cannot replicate a working v1- use │ │ │ │ │ +case with the new-style commands. │ │ │ │ │ + │ │ │ │ │ +For more information, see: https://wiki.haskell.org/Cabal/NewBuild │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-s, \-\-save-configure │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Do not remove the configuration file (dist/setup-config) during cleaning. Saves need to reconfigure. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v1-sdist │ │ │ │ │ + │ │ │ │ │ +Usage: cabal v1-sdist [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +The v1-sdist command is a part of the legacy v1 style of cabal usage. │ │ │ │ │ + │ │ │ │ │ +It is a legacy feature and will be removed in a future release of │ │ │ │ │ +cabal-install. Please file a bug if you cannot replicate a working v1- use │ │ │ │ │ +case with the new-style commands. │ │ │ │ │ + │ │ │ │ │ +For more information, see: https://wiki.haskell.org/Cabal/NewBuild │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-list-sources │ │ │ │ │ +.I FILE │ │ │ │ │ +.RS │ │ │ │ │ +Just write a list of the package's sources to a file │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-snapshot │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Produce a snapshot source distribution │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-output-directory │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +Generate a source distribution in the given directory, without creating a tarball │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v1-doctest │ │ │ │ │ + │ │ │ │ │ +Usage: cabal v1-doctest [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Requires the program doctest, version 0.12. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +The v1-doctest command is a part of the legacy v1 style of cabal usage. │ │ │ │ │ + │ │ │ │ │ +It is a legacy feature and will be removed in a future release of │ │ │ │ │ +cabal-install. Please file a bug if you cannot replicate a working v1- use │ │ │ │ │ +case with the new-style commands. │ │ │ │ │ + │ │ │ │ │ +For more information, see: https://wiki.haskell.org/Cabal/NewBuild │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-doctest │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to doctest (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v1-copy │ │ │ │ │ + │ │ │ │ │ +Usage: cabal v1-copy [FLAGS] │ │ │ │ │ + or: cabal v1-copy COMPONENTS [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Components encompass executables and libraries. Does not call register, and │ │ │ │ │ +allows a prefix at install time. Without the --destdir flag, configure │ │ │ │ │ +determines location. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Examples: │ │ │ │ │ + cabal v1-copy All the components in the package │ │ │ │ │ + cabal v1-copy foo A component (i.e. lib, exe, test suite) │ │ │ │ │ +The v1-copy command is a part of the legacy v1 style of cabal usage. │ │ │ │ │ + │ │ │ │ │ +It is a legacy feature and will be removed in a future release of │ │ │ │ │ +cabal-install. Please file a bug if you cannot replicate a working v1- use │ │ │ │ │ +case with the new-style commands. │ │ │ │ │ + │ │ │ │ │ +For more information, see: https://wiki.haskell.org/Cabal/NewBuild │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-destdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +directory to copy files to, prepended to installation directories │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-target-package-db │ │ │ │ │ +.I DATABASE │ │ │ │ │ +.RS │ │ │ │ │ +package database to copy files into. Required when using ${pkgroot} prefix. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v1-register │ │ │ │ │ + │ │ │ │ │ +Usage: cabal v1-register [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +The v1-register command is a part of the legacy v1 style of cabal usage. │ │ │ │ │ + │ │ │ │ │ +It is a legacy feature and will be removed in a future release of │ │ │ │ │ +cabal-install. Please file a bug if you cannot replicate a working v1- use │ │ │ │ │ +case with the new-style commands. │ │ │ │ │ + │ │ │ │ │ +For more information, see: https://wiki.haskell.org/Cabal/NewBuild │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-user │ │ │ │ │ +.RS │ │ │ │ │ +upon registration, register this package in the user's local package database │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-global │ │ │ │ │ +.RS │ │ │ │ │ +(default)upon registration, register this package in the system-wide package database │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-inplace │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +register the package in the build location, so it can be used without being installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gen-script │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +instead of registering, generate a script to register later │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gen-pkg-config │ │ │ │ │ +.RI [ PKG ] │ │ │ │ │ +.RS │ │ │ │ │ +instead of registering, generate a package registration file/directory │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-print-ipid │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +print the installed package ID calculated for this package │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v1-reconfigure │ │ │ │ │ + │ │ │ │ │ +Usage: cabal v1-reconfigure [FLAGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Run `configure` with the most recently used flags, or append FLAGS to the most │ │ │ │ │ +recently used configuration. Accepts the same flags as `cabal v1-configure'. │ │ │ │ │ +If the package has never been configured, the default flags are used. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Examples: │ │ │ │ │ + cabal v1-reconfigure │ │ │ │ │ + Configure with the most recently used flags. │ │ │ │ │ + cabal v1-reconfigure -w PATH │ │ │ │ │ + Reconfigure with the most recently used flags, │ │ │ │ │ + but use the compiler at PATH. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +The v1-reconfigure command is a part of the legacy v1 style of cabal usage. │ │ │ │ │ + │ │ │ │ │ +It is a legacy feature and will be removed in a future release of │ │ │ │ │ +cabal-install. Please file a bug if you cannot replicate a working v1- use │ │ │ │ │ +case with the new-style commands. │ │ │ │ │ + │ │ │ │ │ +For more information, see: https://wiki.haskell.org/Cabal/NewBuild │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-builddir, \-\-distdir, \-\-distpref │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +The directory where Cabal puts generated build files (default dist) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-g, \-\-ghc │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs │ │ │ │ │ +.RS │ │ │ │ │ +compile with GHCJS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc │ │ │ │ │ +.RS │ │ │ │ │ +compile with UHC │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite │ │ │ │ │ +.RS │ │ │ │ │ +compile with a haskell-suite compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-file │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +use this Cabal file │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-w, \-\-with-compiler │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to a particular compiler │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to the package tool │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-prefix │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +bake this prefix in preparation of installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-bindir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libdir in which libs are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-dynlibdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for dynamic libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for program executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-libexecsubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of libexecdir in which private executables are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datadir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for read-only data │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-datasubdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +subdirectory of datadir in which data files are installed │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-docdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-htmldir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for HTML documentation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddockdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for haddock interfaces │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-sysconfdir │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +installation directory for configuration files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-prefix │ │ │ │ │ +.I PREFIX │ │ │ │ │ +.RS │ │ │ │ │ +prefix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-program-suffix │ │ │ │ │ +.I SUFFIX │ │ │ │ │ +.RS │ │ │ │ │ +suffix to be applied to installed executables │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-vanilla │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Vanilla libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-p, \-\-enable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-shared │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-shared │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Shared library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Static library │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-dynamic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable dynamic linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-static │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable fully static linking │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable and library profiling │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-profiling │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Executable profiling (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for executable and library (default, none, exported-functions, toplevel-functions, all-functions). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-library-profiling-detail │ │ │ │ │ +.I level │ │ │ │ │ +.RS │ │ │ │ │ +Profiling detail level for libraries only. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-O, \-\-enable-optimization, \-\-enable-optimisation │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Build with optimization (n is 0--2, default is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-optimization, \-\-disable-optimisation │ │ │ │ │ +.RS │ │ │ │ │ +Build without optimization │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-debug-info │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Emit debug info (n is 0--3, default is 0) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-debug-info │ │ │ │ │ +.RS │ │ │ │ │ +Don't emit debug info │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-for-ghci │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library for use with GHCi │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-sections │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +compile library code such that unneeded definitions can be dropped from the final executable (GHC 7.8+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-split-objs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +split library into smaller objects to reduce binary sizes (GHC 6.6+) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-executable-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip executables upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-stripping │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +strip libraries upon installation to reduce binary sizes │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-configure-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +Extra option for configure │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-user │ │ │ │ │ +.br │ │ │ │ │ +\-\-global │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +doing a per-user installation │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-package-db │ │ │ │ │ +.I DB │ │ │ │ │ +.RS │ │ │ │ │ +Append the given package database to the list of package databases used (to satisfy dependencies and register into). May be a specific file, 'global' or 'user'. The initial list is ['global'], ['global', 'user'], or ['global', $sandbox], depending on context. Use 'clear' to reset the list to empty. See the user guide for details. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-f, \-\-flags │ │ │ │ │ +.I FLAGS │ │ │ │ │ +.RS │ │ │ │ │ +Force values for the given flags in Cabal conditionals in the .cabal file. E.g., --flags="debug -usebytestrings" forces the flag "debug" to true and "usebytestrings" to false. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-include-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for header files │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-deterministic │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Try to be as deterministic as possible (used by the test suite) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ipid │ │ │ │ │ +.I IPID │ │ │ │ │ +.RS │ │ │ │ │ +Installed package ID to compile this package as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cid │ │ │ │ │ +.I CID │ │ │ │ │ +.RS │ │ │ │ │ +Installed component ID to compile this component as │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-lib-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external libraries │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-framework-dirs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for external frameworks (OS X only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-extra-prog-path │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +A list of directories to search for required programs (in addition to the normal search locations) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-instantiate-with │ │ │ │ │ +.I NAME=MOD │ │ │ │ │ +.RS │ │ │ │ │ +A mapping of signature names to concrete module instantiations. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-tests │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-tests │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for test suites listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-library-coverage │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +build package with Haskell Program Coverage. (GHC only) (DEPRECATED) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-benchmarks │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +dependency checking and compilation for benchmarks listed in the package description file. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-enable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +\-\-disable-relocatable │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +building a package that is relocatable. (GHC only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-disable-response-files │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +enable workaround for old versions of programs like "ar" that do not support @file arguments │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-depending-on-private-libs │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Allow depending on private libraries. If set, the library visibility check MUST be done externally. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-alex │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-c2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-cpphs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-doctest │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-gcc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghc-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ghcjs-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-greencard │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haddock │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-happy │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-haskell-suite-pkg │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hmake │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hpc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hsc2hs │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-hscolour │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-jhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-ld │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-pkg-config │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-runghc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-strip │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-tar │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-with-uhc │ │ │ │ │ +.I PATH │ │ │ │ │ +.RS │ │ │ │ │ +give the path to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to alex (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to c2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to cpphs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to doctest (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to gcc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghc-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ghcjs-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to greencard (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haddock (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to happy (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to haskell-suite-pkg (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hmake (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hpc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hsc2hs (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to hscolour (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to jhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to ld (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to pkg-config (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to runghc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to strip (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to tar (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-option │ │ │ │ │ +.I OPT │ │ │ │ │ +.RS │ │ │ │ │ +give an extra option to uhc (no need to quote options containing spaces) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-alex-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to alex │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-c2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to c2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cpphs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to cpphs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-doctest-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to doctest │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-gcc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to gcc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghc-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghc-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ghcjs-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ghcjs-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-greencard-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to greencard │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haddock-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haddock │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-happy-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to happy │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-haskell-suite-pkg-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to haskell-suite-pkg │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hmake-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hmake │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hpc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hpc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hsc2hs-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hsc2hs │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-hscolour-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to hscolour │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-jhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to jhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-ld-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to ld │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-pkg-config-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to pkg-config │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-runghc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to runghc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-strip-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to strip │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-tar-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to tar │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-uhc-options │ │ │ │ │ +.I OPTS │ │ │ │ │ +.RS │ │ │ │ │ +give extra options to uhc │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-cabal-lib-version │ │ │ │ │ +.I VERSION │ │ │ │ │ +.RS │ │ │ │ │ +Select which version of the Cabal lib to use to build packages (useful for testing). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-constraint │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify constraints on a package (version, installed/source, flags) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-preference │ │ │ │ │ +.I CONSTRAINT │ │ │ │ │ +.RS │ │ │ │ │ +Specify preferences (soft constraints) on the version of a package │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-solver │ │ │ │ │ +.I SOLVER │ │ │ │ │ +.RS │ │ │ │ │ +Select dependency solver to use (default: modular). Choices: modular. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-older │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore lower bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-allow-newer │ │ │ │ │ +.RI [ DEPS ] │ │ │ │ │ +.RS │ │ │ │ │ +Ignore upper bounds in all dependencies or DEPS │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-write-ghc-environment-files │ │ │ │ │ +.I always|never|ghc8.4.4+ │ │ │ │ │ +.RS │ │ │ │ │ +Whether to create a .ghc.environment file after a successful build (v2-build only) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.B cabal v1-sandbox │ │ │ │ │ + │ │ │ │ │ +Usage: cabal v1-sandbox init [FLAGS] │ │ │ │ │ + or: cabal v1-sandbox delete [FLAGS] │ │ │ │ │ + or: cabal v1-sandbox add-source [FLAGS] PATHS │ │ │ │ │ + or: cabal v1-sandbox delete-source [FLAGS] PATHS │ │ │ │ │ + or: cabal v1-sandbox list-sources [FLAGS] │ │ │ │ │ + or: cabal v1-sandbox hc-pkg [FLAGS] [--] COMMAND [--] [ARGS] │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Sandboxes are isolated package databases that can be used to prevent │ │ │ │ │ +dependency conflicts that arise when many different packages are installed in │ │ │ │ │ +the same database (i.e. the user's database in the home directory). │ │ │ │ │ + │ │ │ │ │ +A sandbox in the current directory (created by `v1-sandbox init`) will be used │ │ │ │ │ +instead of the user's database for commands such as `v1-install` and │ │ │ │ │ +`v1-build`. Note that (a directly invoked) GHC will not automatically be aware │ │ │ │ │ +of sandboxes; only if called via appropriate cabal commands, e.g. `v1-repl`, │ │ │ │ │ +`v1-build`, `v1-exec`. │ │ │ │ │ + │ │ │ │ │ +Currently, cabal will not search for a sandbox in folders above the current │ │ │ │ │ +one, so cabal will not see the sandbox if you are in a subfolder of a sandbox. │ │ │ │ │ + │ │ │ │ │ +Subcommands: │ │ │ │ │ + │ │ │ │ │ +init: │ │ │ │ │ + Initialize a sandbox in the current directory. An existing package database │ │ │ │ │ + will not be modified, but settings (such as the location of the database) │ │ │ │ │ + can be modified this way. │ │ │ │ │ + │ │ │ │ │ +delete: │ │ │ │ │ + Remove the sandbox; deleting all the packages installed inside. │ │ │ │ │ + │ │ │ │ │ +add-source: │ │ │ │ │ + Make one or more local packages available in the sandbox. PATHS may be │ │ │ │ │ + relative or absolute. Typical usecase is when you need to make a (temporary) │ │ │ │ │ + modification to a dependency: You download the package into a different │ │ │ │ │ + directory, make the modification, and add that directory to the sandbox with │ │ │ │ │ + `add-source`. │ │ │ │ │ + │ │ │ │ │ + Unless given `--snapshot`, any add-source'd dependency that was modified │ │ │ │ │ + since the last build will be re-installed automatically. │ │ │ │ │ + │ │ │ │ │ +delete-source: │ │ │ │ │ + Remove an add-source dependency; however, this will not delete the │ │ │ │ │ + package(s) that have been installed in the sandbox from this dependency. You │ │ │ │ │ + can either unregister the package(s) via `cabal v1-sandbox hc-pkg │ │ │ │ │ + unregister` or re-create the sandbox (`v1-sandbox delete; v1-sandbox init`). │ │ │ │ │ + │ │ │ │ │ +list-sources: │ │ │ │ │ + List the directories of local packages made available via `cabal v1-sandbox │ │ │ │ │ + add-source`. │ │ │ │ │ + │ │ │ │ │ +hc-pkg: │ │ │ │ │ + Similar to `ghc-pkg`, but for the sandbox package database. Can be used to │ │ │ │ │ + list specific/all packages that are installed in the sandbox. For │ │ │ │ │ + subcommands, see the help for ghc-pkg. Affected by the compiler version │ │ │ │ │ + specified by `v1-configure`. │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Relevant global configuration keys: │ │ │ │ │ + require-sandbox │ │ │ │ │ + ignore-sandbox │ │ │ │ │ + │ │ │ │ │ +Examples: │ │ │ │ │ + Set up a sandbox with one local dependency, located at ../foo: │ │ │ │ │ + cabal v1-sandbox init │ │ │ │ │ + cabal v1-sandbox add-source ../foo │ │ │ │ │ + cabal v1-install --only-dependencies │ │ │ │ │ + Reset the sandbox: │ │ │ │ │ + cabal v1-sandbox delete │ │ │ │ │ + cabal v1-sandbox init │ │ │ │ │ + cabal v1-install --only-dependencies │ │ │ │ │ + List the packages in the sandbox: │ │ │ │ │ + cabal v1-sandbox hc-pkg list │ │ │ │ │ + Unregister the `broken` package from the sandbox: │ │ │ │ │ + cabal v1-sandbox hc-pkg -- --force unregister broken │ │ │ │ │ + │ │ │ │ │ +The v1-sandbox command is a part of the legacy v1 style of cabal usage. │ │ │ │ │ + │ │ │ │ │ +It is a legacy feature and will be removed in a future release of │ │ │ │ │ +cabal-install. Please file a bug if you cannot replicate a working v1- use │ │ │ │ │ +case with the new-style commands. │ │ │ │ │ + │ │ │ │ │ +For more information, see: https://wiki.haskell.org/Cabal/NewBuild │ │ │ │ │ + │ │ │ │ │ + │ │ │ │ │ +Flags: │ │ │ │ │ +.RS │ │ │ │ │ +\-v, \-\-verbose │ │ │ │ │ +.RI [ n ] │ │ │ │ │ +.RS │ │ │ │ │ +Control verbosity (n is 0--3, default verbosity level is 1) │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-snapshot │ │ │ │ │ +.br │ │ │ │ │ +.RS │ │ │ │ │ +Take a snapshot instead of creating a link (only applies to 'add-source') │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +\-\-sandbox │ │ │ │ │ +.I DIR │ │ │ │ │ +.RS │ │ │ │ │ +Sandbox location (default: './.cabal-sandbox'). │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.SH FILES │ │ │ │ │ +~/.cabal/config │ │ │ │ │ +.RS │ │ │ │ │ +The defaults that can be overridden with command-line options. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +~/.cabal/world │ │ │ │ │ +.RS │ │ │ │ │ +A list of all packages whose installation has been explicitly requested. │ │ │ │ │ +.RE │ │ │ │ │ + │ │ │ │ │ +.SH BUGS │ │ │ │ │ +To browse the list of known issues or report a new one please see │ │ │ │ │ +https://github.com/haskell/cabal/labels/cabal-install. │ │ │ │ │ +