Some PhpDoc corrections while working on MC-106

Bug fix: [no]
Feature addition: [no]
Backwards compatibility break: [no]
Phpspec specification passes: [no]
Checkstyle issues: [yes]
ChangeLog updated: [no]
Fixes the following issue: