Fix a bunch of incorrect code examples in the Auth docs.
Inline API docs.

The 3.x style for docs does not have separate API sections. Instead
method anchors are added inline.
Fixed typo
Merge pull request #1497 from cakephp/authentication-tutorial

Update Authentication tutorial