- Resolve #6684:
- Resolve #6813: Update (and correct) source-repository-package documentation

Matt authored 4 years ago and Francesco Gazzetta committed 4 years ago

(cherry picked from commit 7dfe60e9)

This is the result of using `pandoc` with default settings
to convert the existing `.markdown` files to `.rst` files.

At the top level we now have cabal/ and cabal-install/

The chapter on installing packages still needs to be rewritten
to describe the cabal tool, rather than runhaskell Setup.hs

Not woth keeping it, none of it can sensibly be reused. The GHC
devs will need to add something new for the markdown user guide.

Ticket #215 (Overhaul support for packages' tests).

Plan is to switch over from docbook xml.

It is not default. Looks like it was a copy and paste error.

Now when using CPP you get 

   MIN_VERSION_<package>(A,B,C)

for each <package> in build-depends, which is true if the version of
<package> in use is >= A.B.C, using the normal ordering on version
numbers.

This is done by auto-generating a header file
dist/build/autogen/cabal_macros.h, and passing a -include flag when
running CPP.

Since it is shared between libs and exes. Extend the documentation
to describe the syntax of version constraints, including the new
version range syntax "build-depends: foo ==1.2.*".

Change to runhaskell Setup or cabal-install as appropriate.