Various minor documentation fixes

Philip Withnallrequested to merge
pwithnall/glib:docs-fixes into master

From trawling through the gtk-doc warning messages. This does not make us free of gtk-doc warnings, but gets us a bit closer.

More fixes coming when I get a bit more time between long-running tasks.

Merge request reports