PHPDoc corrections

[braders]

Overview

Fixes another collection of cases where the PHPDoc comments didn't match reality.

No code has changed, just the comments which drive e.g. the autocompletion offered by IDEs.

[civibot]

(Standard links)

• If you are reviewing this pull-request, you may wish to consult the test sites and the Review Standards (long template, short template).

[eileenmcnaughton]

Thanks - this all looks good!