GitLab

Reference index shows fields and flags for project.cabal and fields for
pkgname.cabal

[ci skip]

[ci skip]

[ci skip]

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]

Also makes 'cabal' a default highlighter

While at it, I updated a few urls I noticed to be outdated.

This is somewhat related to #3791

[skip ci]

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