- Remove the .plan.json files, since they're just intermediate files.
- Remove the Linux check since e.g. macOS works just fine.

There is a new make file,

    doc/Makefile

that defines these goals:

  - `check-requirements`:
    Check `requirements.txt` for security problems (CVEs) using `skjold`.
    This goal is intended for the "Users guide" CI.
    SKJOLD_GITHUB_API_TOKEN might have to be set if GITHUB_TOKEN is
    not in the environment, in order to access the GitHub GraphQL API.

  - `build-and-check-requirements`:
    Rebuild `requirements.txt` from `requirements.in` using `pip-compile`,
    and check with `check-requirements`.
    This goal is intended for manual invocation.

    It is invoked from the top Makefile via goal
    `users-guide-requirements`.

Alternatively, these goals could be coupled with the doc build
`make users-guide`.
However, since these goals require a couple of seconds to run, I think
it is annoying to call them on every build of the documentation.

This way they won't remake caches on each run,
allowing to compare vastly different cabals.

- The old code is preserved for now in VersionInterval.Legacy module
- Add normaliseVersionRange bench, comparing new and old
- We drop intersectVersionIntervals, which is complicated function for acceptable performance loss, but gained simplicity
- Remove Ord instances (can be added back, removed to make sure we don't use them)

A script essentially runs `v2-install cabal-install:exe:cabal`,
but does some simple setup, so the result is less luckily
to be influences by environment.

Also improve bootstrap to do out-of-tree builds.
- Use http, https tricky in some environments

It's used by hasktags

Signed-off-by: Edward Z. Yang <ezyang@cs.stanford.edu>

Signed-off-by: Edward Z. Yang <ezyang@cs.stanford.edu>

[ci skip]

Signed-off-by: Edward Z. Yang <ezyang@cs.stanford.edu>

It features simple `pkg-section` directive for marking sections for
which subsequent `pkg-field` fields are defined. Needed to disambiguate
fields such as `type` or `main-is`.

Converted most of `developing-packages.rst` to use new directives

Future work:

* Add directives for describing project.local, make it reference
  relevant cabal arguments

* Add more meta, like since or deprecated which can be rendered in link
  titles and index.

* Add "quick reference" indices for cabal args, package.cabal and
 project.local fields. Reference these from sidebar.

* Using "since" and "deprectated field it is possible to create "what's
  new" index

[ci skip]

Additionally, ABI computation no longer requires successful
registration, so you can generate scripts in any order.

Signed-off-by: Edward Z. Yang <ezyang@cs.stanford.edu>

Signed-off-by: Edward Z. Yang <ezyang@cs.stanford.edu>

Signed-off-by: Edward Z. Yang <ezyang@cs.stanford.edu>

Signed-off-by: Edward Z. Yang <ezyang@cs.stanford.edu>

Signed-off-by: Edward Z. Yang <ezyang@cs.stanford.edu>

I've rewritten the test suite to be more concise and "correct by
construction".  The primary method that this is achieved by
is introducing the 'TestM' monad, which carries around the
important state for the tests so that (1) we don't have to
pass it as an argument all around, and (2) we can automatically
make the correct decisions about how to do things.  This new
method emphasises "configuration by convention": we assume
that a test-case named "Foo" has its test packages in the
directory "tests/PackageTests/Foo".

A secondary change is that all command functions automatically fail if
they have a non-zero exit code (unless you use the 'shouldFail'
combinator which inverts the sense.)  This saves a lot of typing
on test-cases.  (In fact, I've reorganized all of the commands
related here.)

In the process, I've tightened up the logic for how to find the
LocalBuildInfo of the Cabal we've testing, so we should now
reliably be testing the inplace Cabal library, and not the
system library (as was often the case.)

Because things are a lot shorter, there is no good reason to
make Check modules except for the biggest test cases.  Most
test-cases have been folded into PackageTests.Tests; if you
have a small test-case you should just put it there.

Signed-off-by: Edward Z. Yang <ezyang@cs.stanford.edu>

I needed this when building cabal.exe for MinGHC (see:
https://github.com/fpco/minghc/issues/69). I thought others might find
this useful, especially for the use case of bootstrapping cabal
development.

I went the direction of no curation and explicit packages in the
extra-deps, as I thought that would make more sense for a project low on
the dependency chain, but this could certainly be tweaked to use LTS
Haskell or Stackage Nightly instead.

- make some paths non-global via / prefix
- remove redundancies
- add /Cabal/Setup and /cabal-install/Setup

Signed-off-by: Edward Z. Yang <ezyang@cs.stanford.edu>

Signed-off-by: Edward Z. Yang <ezyang@cs.stanford.edu>