Ссылка на внешний URL в Javadoc?

Что-то вроде:

/**
 * See {@linktourl http://google.com}
 */

Это создает заголовок «Смотрите также», содержащий ссылку, то есть:

/**
 * @see <a href="http://google.com">http://google.com</a>
 */

будет отображаться как:

Смотрите также:
           http://google.com

тогда как это:

/**
 * See <a href="http://google.com">http://google.com</a>
 */

создаст встроенную ссылку:

Смотрите http://google.com

Взято из спецификации Javadoc

@see <a href="URL#value">label</a>: Добавляет ссылку, как определено URL#value. Это URL#valueотносительный или абсолютный URL. Инструмент Javadoc отличает это от других случаев, ища символ меньше чем ( <) в качестве первого символа.

Например : @see <a href="http://www.google.com">Google</a>

Javadocs не предлагает никаких специальных инструментов для внешних ссылок, поэтому вы должны просто использовать стандартный HTML:

See <a href="http://groversmill.com/">Grover's Mill</a> for a history of the
Martian invasion.

или

@see <a href="http://groversmill.com/">Grover's Mill</a> for a history of 
the Martian invasion.

Не используйте {@link ...}или {@linkplain ...}потому что это для ссылок на javadocs других классов и методов.

Просто используйте HTML-ссылку с таким элементом, как

<a href="URL#value">label</a>

Трудно найти четкий ответ с сайта Oracle. Следующее от javax.ws.rs.core.HttpHeaders.java:

/**
 * See {@link <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.1">HTTP/1.1 documentation</a>}.
 */
public static final String ACCEPT = "Accept";

/**
 * See {@link <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.2">HTTP/1.1 documentation</a>}.
 */
public static final String ACCEPT_CHARSET = "Accept-Charset";