DOC: update apiref stub files

Paul McCarthyrequested to merge
doc/apiref into master

And some other small tweaks

Edited by Paul McCarthy

Merge request reports