More API docblock fixes.
Merge pull request #3612 from cakephp/api-doc-comments

More API docblock fixes.