NAME

       cabal-install - manual page for cabal-install version 3.8.1.0

SYNOPSIS

       cabal [GLOBAL FLAGS] [COMMAND [FLAGS]]

DESCRIPTION

       Command line interface to the Haskell Cabal infrastructure.

       See http://www.haskell.org/cabal/ for more information.

   Commands:
              [global]

       update Updates list of known packages.

       install
              Install packages.

       help   Help about commands.

       info   Display detailed information about a particular package.

       list   List packages matching a search string.

       fetch  Downloads packages for later installation.

       user-config
              Display and update the user's global cabal configuration.

              [package]

       get    Download/Extract a package's source code (repository).

       unpack Deprecated alias for 'get'.

       init   Create a new cabal package.

       configure
              Add extra project configuration.

       build  Compile targets within the project.

       clean  Clean the package store and remove temporary files.

       run    Run an executable.

       repl   Open an interactive session for the given component.

       test   Run test-suites.

       bench  Run benchmarks.

       check  Check the package for common mistakes.

       sdist  Generate a source distribution file (.tar.gz).

       upload Uploads source packages or documentation to Hackage.

       report Upload build reports to a remote server.

       freeze Freeze dependencies.

       gen-bounds
              Generate dependency bounds.

       outdated
              Check for outdated dependencies.

       haddock
              Build Haddock documentation.

       hscolour
              Generate HsColour colourised code, in HTML format.

       exec   Give a command access to the store.

       list-bin
              List the path to a single executable.

              [new-style projects (forwards-compatible aliases)]

       v2-build
              Compile targets within the project.

       v2-configure
              Add extra project configuration.

       v2-repl
              Open an interactive session for the given component.

       v2-run Run an executable.

       v2-test
              Run test-suites.

       v2-bench
              Run benchmarks.

       v2-freeze
              Freeze dependencies.

       v2-haddock
              Build Haddock documentation.

       v2-exec
              Give a command access to the store.

       v2-update
              Updates list of known packages.

       v2-install
              Install packages.

       v2-clean
              Clean the package store and remove temporary files.

       v2-sdist
              Generate a source distribution file (.tar.gz).

              [legacy command aliases]

       v1-build
              Compile all/specific components.

       v1-configure
              Prepare to build the package.

       v1-repl
              Open an interpreter session for the given component.

       v1-run Builds and runs an executable.

       v1-test
              Run all/specific tests in the test suite.

       v1-bench
              Run all/specific benchmarks.

       v1-freeze
              Freeze dependencies.

       v1-haddock
              Generate Haddock HTML documentation.

       v1-install
              Install packages.

       v1-clean
              Clean up after a build.

       v1-copy
              Copy the files of all/specific components to install locations.

       v1-register
              Register this package with the compiler.

       v1-reconfigure
              Reconfigure the package if necessary.

   For more information about a command use:
              cabal COMMAND --help

       or cabal help COMMAND

   To install Cabal packages from hackage use:
              cabal install foo [--dry-run]

   Occasionally you need to update the list of available packages:
              cabal update

   Global flags:
       -h, --help
              Show this help text

       -V, --version
              Print version information

       --numeric-version
              Print just the version number

       --config-file=FILE
              Set an alternate location for the config file

       --ignore-expiry
              Ignore expiry dates on signed metadata (use only in exceptional circumstances)

       --http-transport=HttpTransport
              Set  a  transport  for  http(s) requests. Accepts 'curl', 'wget', 'powershell', and
              'plain-http'. (default: 'curl')

       --enable-nix
              Enable Nix integration: run commands through nix-shell if a 'shell.nix' file exists

       --disable-nix
              Disable Nix integration

       --store-dir=DIR
              The location of the build store

       --active-repositories=REPOS
              The active package repositories (set to ':none' to disable all repositories)

   You can edit the cabal configuration file to set defaults:
              /homedoesnotexistatbuildtime/.cabal/config

       This file will be generated with sensible defaults if you run 'cabal update'.

       compiled using version 3.8.1.0 of the Cabal library