(cherry picked from commit 069bf7a)

Expands on some of the function comments and add some of the
special syntaxes recognised by nixdoc.

Updates documentation comments with extra information for nixdoc[1]
compatibility.

Some documentation strings have additionally been reworded for
clarity.

"Faux types" are added where applicable, but some functions do things
that are not trivially representable in the type notation used so they
were ignored for this purpose.

[1]: https://github.com/tazjin/nixdoc

Updates documentation comments with extra information for nixdoc[1]
compatibility.

[1]: https://github.com/tazjin/nixdoc

Documents functions in `lib.debug` for docs generation with nixdoc.

Note that type signatures and clearer descriptions are still missing
on some of these functions, but this is good enough for a first run.

Documents functions in `lib.options` for docs generation with nixdoc.

The formatting change in the `mkOption` arguments is due to the way
`nixdoc` parses documentation comments on pattern arguments. It's not
ideal, but it works.

(cherry picked from commit bf39304)

(cherry picked from commit 891277e)

(cherry picked from commit ab62fe9)

Semi-automatic update generated by
https://github.com/ryantm/nixpkgs-update tools. This update was made
based on information from
gtest

(cherry picked from commit 9cfbcc2)
Reason: Pre-Requisite to backport uriparser 0.9.0, which patches
security issues of the 0.8.x branch.

Clean up the expression and add pkgconfig support

(cherry picked from commit 9ac64e5)
Reason: Pre-Requisite to backport uriparser 0.9.0, which patches
security issues of the 0.8.x branch.

(cherry picked from commit 2783ca5)
Reason: Provides security fixes for the 0.8.x branch.

(cherry picked from commit fada4e8)

dbeaver: 5.2.2 -> 5.2.4 (18.09)

uriparser: 0.9.0 backport to 18.09

[18.09] lxd 3.0.0 -> 3.0.2

Backport documentation comment changes to release-18.09

[18.09] ghc: add new 8.4.4 version