2009-05-30 85 views
2

我已經用javadoc使用{@see myPackage.MyClass}標籤評論了我的java源代碼。使用標籤創建javadoc使用螞蟻

我必須從終端生成javadoc的螞蟻,但我有這樣的警告:

[javadoc] src/calendar/annotation/DataType.java:11: warning - Tag @see cannot be used in inline documentation. It can only be used in the following types of documentation: overview, package, class/interface, constructor, field, method. 

在build.xml文件是這一行:

<javadoc sourcepath="${sourceDir}" destdir="${docDir}" windowtitle="MyProject" /> 

任何人可以幫助我,好嗎?

編輯:

我正確使用它。例如,我有

/** 
* <p>Metoda provede požadovaný dotaz do databáze za použití předaných parametrů. 
* Pokud jsou parametry nedostatečně nedefinované, SQL dotaz neexistuje nebo nastane 
* problém s komunikací, dojde k vygenerování {@see calendar.exception.LoadException}. 
* Pokud žádné entity neodpovídají požadavku, dochází k vrácení prázdného seznamu. 
* V případě, že nějaké entity odpovídají požadovanému pravidlu, jsou načteny především ty, 
* které již jsou definovány v persistenční vrstvě. Pokud tam entity nejsou zavedeny, dochází 
* k jejich načtení z databáze.</p> 
* @param entityClass 
* @param query 
* @param params 
* @return 
* @throws calendar.exception.LoadException 
*/ 
<EntityClass extends AbstractEntity> Collection<EntityClass> find(Class<EntityClass> entityClass, String query, Map<String, Object> params) throws LoadException; 
+0

彈出提示接受我的javadoc和沒有問題顯示它。 – Gaim 2009-05-30 14:37:44

回答

1

在Datatype.java中,您在代碼中的註釋中使用了@see Javadoc不允許的地方。具體來說,它看起來像你有這樣的:

/** 
    *[email protected] 
    */ 
void foo() { 
} 

,它應該是

/** 
    * ... 
    * @see bla 
/* 
void foo() { 
    ... 
} 
+0

我正在使用它,我想。我編輯了我的問題。 – Gaim 2009-05-30 14:34:00

+0

@see需要在評論末尾,而不是在中間 – 2009-05-30 14:41:28