DOC: update apiref stub files

Merged Paul McCarthy requested to merge doc/apiref into master

And some other small tweaks

Edited by Paul McCarthy

Merge request reports