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

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

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

Ответы на вопрос(5)

Решение Вопроса

Это создает & quot; см. Также & quot; заголовок, содержащий ссылку, т.е.

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

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

See Also:
           http://google.com


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

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

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

See http://google.com

Трудно найти четкий ответ с сайта 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";

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>

Взято изJavadoc Spec

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

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

Ваш ответ на вопрос