NAME

       cabal-install - manual page for cabal-install version 3.4.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).

       init   Create a new .cabal package file.

       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 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-exec
              Give a command access to the sandbox package repository.

       v1-update
              Updates list of known packages.

       v1-install
              Install packages.

       v1-clean
              Clean up after a build.

       v1-doctest
              Run doctest tests.

       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

       --default-user-config=FILE
              Set  a location for a cabal.config file for projects without their own cabal.config
              freeze 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: run commands  through  nix-shell  if  a  'shell.nix'  file
              exists

   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.4.1.0 of the Cabal library