Следует ли использовать устаревание JavaDoc или аннотацию в Java?

На данный момент есть, два способа пометить код как устаревший в java.

Через JavaDoc

/**
 * @deprecated
 */

Или в виде аннотации:

@Deprecated

Это моя проблема - я нахожу слишком много объявлять оба, когда помечаю метод как устаревший при использовании Затмение. Я действительно просто хочу использовать один из них.

Однако дает ли использование аннотации фактическую полезную дополнительную информацию компилятору?

Но только используя аннотацию, я не могу сказать, почему этот метод устарел - я могу сделать это только с JavaDoc и отказ от метода без указания причин, почему это плохо.

Итак, могу я использовать только один из них? Или мне действительно стоит научиться указывать и то, и другое?

74
задан Langusten Gustel 19 April 2016 в 09:19
поделиться