[ci skip]

Note all Described instances are implemented. This is just a start.

quasicomputational authored 6 years ago and Herbert Valerio Riedel committed 6 years ago

As suggested in #5401.

[skip ci]

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

Needed because cabal-install no longer compiles against Cabal-1.23.1 snapshot
that came with GHC 8.

While reading the docs, I saw a few typos, so I ran ispell through the
docs. Fixed:

- plain typos
- a few instances of 'ie'→'i.e.' and 'eg' → 'e.g.' for nicer style
- a few capitalisation issues (linux, unix)
- a few not-nice (IMHO) abbreviations (for a manual, that is):
  distro→distribution, repo→repository
- proper naming (RedHat→Red Hat)

Fixes #1686.

Currently we have a somewhat hard-to-maintain contents just in the
introduction. This cuts that initial contents down to just link to
the chapters (plus sections within the intro), and then use an
automatically generated table of contents in the other chapters.

Also tweak the CSS because pandoc's TOC feature turns all section
headings into links and that changes the visual appearance. Use the
CSS to make it look the same as before.

Introduce cabal-install much earlier. Give more of a basic intro.

Fixes #1113.

Makes things a little simpler in GHC's build system if libraries are in
the same directory as their name.

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