Added note about @deprecated annotation format

Refs https://github.com/cakephp/cakephp/pull/4463 and https://github.com/cakephp/cakephp/pull/4417#discussion_r16990677 respectively.