Move deprecation comment to annotation

Annotation scala.deprecated allows to set message and version in which the definition was deprecated.
Setting these fields will give much better compiler warnings.