Подробная информация о разнице между @see и @inheritDoc

Я просмотрел ссылку на JavaDoc , и, хотя я понимаю основную разницу между @see(различными ссылками) и {@inheritDoc}(экспортом комментария JavaDoc суперкласса), мне нужно пояснить, как это реализовано на самом деле.

В Eclipse IDE, когда я выбираю «Создать комментарии к элементам» для унаследованного метода (из интерфейса или переопределения toString () и т. Д.), Создается следующий комментарий

/* (non-Javadoc)
 * @see SomeClass#someMethod()
 */

Если я обязан плодоовощного JavaDoc я должен оставить его в этом, замените @seeс {@inheritDoc}, или превратить его в добросовестном JavaDoc как таковой:

/**
 * {@inheritDoc}
 */

И когда я это сделаю, должен ли я сохранить флаг метода class #?

Прежде всего, вы должны удалить исходный шаблон eclipse, потому что это просто шумный мусор. Либо вставляйте содержательные документы, либо вообще ничего не вставляйте. Но бесполезное повторение очевидного с помощью шаблонов IDE просто загромождает код.

Во-вторых, если вам необходимо создать javadoc, вам нужно, чтобы комментарий начинался с /**. В противном случае это не javadoc.

Наконец, если вы переопределяете, вы должны использовать @inheritDoc(при условии, что вы хотите добавить к исходным документам, как @seh отметил в комментарии, если вы просто хотите дублировать исходные документы, тогда вам ничего не нужно). @seeдействительно следует использовать только для ссылки на другие связанные методы.