apidocs: fix method description, fix wording.