Added note about @deprecated annotation format
fix issue in cakephp/cakephp #4462

Double code highlight box in cakephp documention, acl, chapter
assigning permissions
Updated links to the latest phpdoc manual
Update spelling error
Removed link to @tutorial, which does not exist in the new phpdoc manual
Updated links to phpdoc manual in all other languages
Fixed a previous accidental error
Line missing

Sorry about this. In the hast to fix the first grammar error, and insert text on a line, which I subsequently removed, but also the line. This is returning that part of the code to what it was originally.
Merge pull request #1683 from cakephp/deprecated-annotation-format

Added note about @deprecated annotation format
Merge pull request #1684 from lordg/patch-4

Update spelling error