JavaDoc - инструмент для извлечения комментариев(HTML файлы). Является частью пакета JDK. По умолчанию обрабатываются только public и protected элементы программы. Для некоторых тегов необходимо указать их при запуске создания HTML файла чтобы они были добавлены в файл.
Над классом или методом в блоке комментария /** */
@see - ссылка на другие классы и методы. HTML документ использует описание с другого класса.
@version - информация о версии класса/метода.
@author - информация о создателе класса/метода.
@since - указывает версию проекта с которой этот код начал работать. Также используеться в документации JDK для указания версии JDK.
@param - для описания параметров метода.
@return - описание возвращаемого значения.
@throw - описание возможное возвращаемое исключение.
@deprecated - заставляет компилятор выдать предупреждение при использовании этого метода.