Как связать @ Enabled с использованием Javadoc

Question

Использование Javadoc 1.5, мне не удалось создать @link для значения Enumeration.

То, что я хотел бы сделать, это создать Enum так:

public enum Planet { 

/** 
* MERCURY is a fun place. 
*/ 
MERCURY, 

/** 
* VENUS is more fun. 
*/ 
VENUS, 

/** 
* But nothing beats the Earth. 
*/ 
EARTH, 

/** 
* Others we know nothing about. 
*/ 
OTHERS 
} 

А затем обратитесь к Javadoc для Земли, используя ссылку, как это:

{@link Planet.EARTH} 

Я попытался {@link Planet#EARTH} стиль тоже, но безрезультатно.

Кто-нибудь знает, возможно ли это вообще?

Answer 1

# стиль работает для меня:

{@link Planet#EARTH} 

Ключ в том, что пакет Planet должен быть импортирован, или планета должна быть полностью квалифицирован - то есть:

{@link com.something.somethingelse.Planet#EARTH} 

Answer 2

Я использую Eclipse, чтобы проверить это, но

{@link Planet#EARTH} 

стиль, кажется, работает. Тем не менее, я обычно предпочитаю

@see Planet#EARTH 

в любом случае. Не уверен, что Eclipse использует для генерации Javadoc, но я использую JDK6. Тем не менее, может быть @see делает трюк для вас.

Answer 3

До тех пор, как он импортируется вы можете связать его (но когда вы это сделаете, IMO делает импорт грязным - какие используются в коде и какие в javadoc? Мне нравится просто использовать полное имя).

Но да, Eclipse может взять на себя все это и стандартный

{@link Planet#EARTH} 

работает отлично.

Если вы используете Eclipse, Ctrl + Shift + O (на ПК) или Cmd + Shift + O (на Mac), автоматически настраивайте импорт (это означает, что если у вас есть дополнительный импорт, который не используется, они удаляются, а также добавление необходимых им импортных данных).