* Move towards using XDG directories.

* Install binaries in $HOME/.local/bin.

* Fix tests.

* Ensure config file is where it should be.

* Require newer directory for XdgState.

* Put world file in XDG_STATE_HOME.

* Oops, forgot to import.

* Remove uses of getCabalDir.

* These all need directory-1.3.7.0 now.

* Oh right, not a builtin anymore.

If this works I will also change the other .json files.

* Try it by hand.

* Haskell is better than JSON.

* Bump directory in all jsons.

* Put directory first.

* Let us assume that getConfigFilePath gets this right.

* Implement backwards compatibility.

* This is now elsewhere.

* We need to create parents as well because ~/.local might not exist.

* Put scripts-build in distinct cache directory.

* Document XDG behaviour.

* Remove help text references to ~/.cabal.

* Remove references to .cabla/bin.

* Backwards compatible install paths.

* Remove more references to ~/.cabal.

* Fix typo.

* Fix ~/.cabal paths making their way into default config.

* Reduce duplication.

* Add changelog entry.

* Also note install dir change.

* It is the cabal-install config file.

* Avoid dependending on cabal-install in Hackage-tests.

* ALso respect CABAL_DIR here.

* Try leaving InstallDirs alone.

* Also need duplication here.

* Add missing newline.

* Fix doc typos.

* Make this a Haddock comment.

* Revision field must not be null.

* Link directories.

* Update doc/config.rst

Co-authored-by: Artem Pelenitsyn <a.pelenitsyn@gmail.com>

* No need for this.

* We install foreign libraries here now.

* Clarify Nothing case.

* Avoid using ~/.config/cabal in manual.

Co-authored-by: Mikolaj Konarski <mikolaj@well-typed.com>
Co-authored-by: Artem Pelenitsyn <a.pelenitsyn@gmail.com>

* only check for compiler when project file has conditionals

* fix sdist options a bit plus test

* whitespace

* poke tests around

* Update cabal.out

* Update cabal.test.hs

* changelog/docs

Co-authored-by: Gershom Bazerman <gershom@arista.com>

* Give an example for `--enable-nix` flag

* fixup! Give an example for `--enable-nix` flag

* fixup! Give an example for `--enable-nix` flag

* Add `cabal get` documentation

* Add `cabal upload` documentation

* Add `cabal info` documentation

* Add `cabal fetch` documentation

* Add `cabal init` documentation stub

* Add `cabal list` documentation

* Add `cabal report` documentation

* Add `cabal user-config` documentation

* Add changelog for #8309

* Document alternatives to `cabal fetch`

* Warn about packages default value

* Use double backquotes

* Syntax correction

Co-authored-by: mergify[bot] <37929162+mergify[bot]@users.noreply.github.com>

* Implement --prefer-oldest

* Test --prefer-oldest

* Add changelog for --prefer-oldest

* Add documentation for --prefer-oldest

* Review suggestions

Co-authored-by: mergify[bot] <37929162+mergify[bot]@users.noreply.github.com>

With this option, 'cabal get' writes to the destination directory only the
package description already available locally in one of the repository
indices.

The basename of the file name written to inside the target directory is
the package-id rather than only the package name.

This is mostly based on #1977

Co-authored-by: Miëtek Bak <mietek@bak.io>
Co-authored-by: Artem Pelenitsyn <a.pelenitsyn@gmail.com>

Co-authored-by: Herbert Valerio Riedel <hvr@gnu.org>
Co-authored-by: Miëtek Bak <mietek@bak.io>

fix warnings: update extlinks format to Sphinx 5

There was nothing about installing packages in this file for a while now.

Use proper option formatting instead of bullet points.

Vilius Panevėžys authored 2 years ago and Mikolaj Konarski committed 2 years ago

The package counts have grown to 15353 and 43351 respectively as of this
writing, hence the ratio has dropped from 5.6 to 2.8. Given the growth
of Hackage, the comparison does not seem as important anymore (does it
matter if you have 3 or 8 alternative libraries for the same purpose?).
Dropping package counts to avoid the need for continuous updates.

It was a bit surprising to me that `cabal list-bin foo` prints a path
to an executable `foo` that may not actually exist.

+ Update file-format-changelog.rst

The original Cabal proposal https://www.haskell.org/cabal/proposal/ explained that `runhaskell`, in the proposal, was to refer to a symlink to `runhugs`, `runghc`, or `runnhc`. That explanation has been lost from the Cabal guide. Since the date of the original proposal, HUGS and NHC have fallen by the wayside. This pull request proposes two minor additions to restore the explanation:

1. A sentence "GHC provides the commands `runhaskell` and `runghc` (they are equivalent) to allow you to run Haskell programs without first having to compile them (scripts)." This wording closely follows that in the GHC user guide.

2. A clarification that `--help` provides information about the `Setup.hs` script (not the `runhaskell` command).

Document only v2-haddock option syntax.

The command-line syntax given was for `cabal v1-haddock`.
Now, there is both the command-line syntax for `cabal haddock` and
`cabal v1-haddock`.

Furhter, add missing field: `haddock-quickjump`.

Resolves #7459

This commit adds entries for the 'gen-bounds' and 'outdated'
commands to the "cabal-install Commands" section of the user manual.

Formerly, those commands were only described in the "Package
description" section. Some, but not all, of the information in that
section has been moved to the entires in the list of commands.

This commit changes two other things:

- The descriptions in the "Package description" were incorrectly placed
  as sub-sections of "Opening an interpreter session". They have been
  moved one level up.

- changed the gen-bounds example, because it used dependencies which
  *already* had bounds as the starting point.

Co-authored-by: Daniel Díaz <diaz_carrete@yahoo.com>
Co-authored-by: Emily Pillmore <emilypi@cohomolo.gy>
Co-authored-by: gbaz <gershomb@gmail.com>

* allow glob matches of the form dir/**/FileNoExtension

* allow glob matches of the form dir/**/FileNoExtension

* tests, docs, changelong

Co-authored-by: Gershom Bazerman <gershom@arista.com>
Co-authored-by: mergify[bot] <37929162+mergify[bot]@users.noreply.github.com>