Various documentation fixes

Fixes various warnings reported by doxygen, by far not all but it's a start.

Especially all wrong references and section warnings should be addressed by this.