We propose to add a marker annotation java.lang.Deprecated to supplant and
eventually replace the javadoc tag @deprecated. This is exactly the sort
of thing metadata is best at expression. This may improve the performance
of compilers, as eventually they will no longer have to scan doc comments
for @deprecated tags.

As a transitional feature, in -source 1.5 javac will give a warning if
a program element is deprecated in the javadoc tag but not with an annotation.
In 1.6 we might either make this a hard error or simply stop recognizing the
tag in doc comments altogether.