Javadoc @see tags in package-info

Question

Мы работаем над проектом класса и с помощью Javadocs документируем наши пакеты. Файлы package-info.java используются для документации пакета верхнего уровня, но мы не можем использовать теги @see для ссылки на другие классы. Javadoc будет постоянно давать ошибки «ссылки не найдены» для всех из них. Есть ли что-то, что нужно сделать для того, чтобы ссылки работали? Мы уже пытались импортировать ссылочные классы, но это не сработало.

Answer 1

Вы должны использовать полное имя класса, включая спецификатор пакета.

@see com.stackoverflow.AwesomeClass 

См Javadoc spec