Fix various documentation issues and man page issues with autotools

Builds on the discussion from !193 (closed), fixes various generic gtk-doc issues, and removes a load of generated files from the autotools tarball.