Fix typo
Clarify that @var is not as much an alias of @type
#2 describe @see in more detail and add deprecation of @link