2009-05-30 6 views
2

{@see myPackage.MyClass}のようなタグを使用してjavadocでJavaソースコードにコメントしました。antを使用したタグ付きjavadocの作成

私は端末からアリとのJavadocを生成する必要があるが、私はこの警告持っている:build.xmlのでは

[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. 

はこの行です:

<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

答えて

1

Datatype.javaでは、Javadocが許可しない場所でコードのコメントに@seeを使用しています。それは

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

私はそれを正しく使用していると思います。私は私の質問を編集しました。 – Gaim

+0

@seeはコメントの末尾にある必要があります。中間ではありません。 –

関連する問題