使用ant创建带有标记的javadoc
我已经使用类似{@see myPackage.MyClass}的标记用javadoc注释了我的java源代码 我必须从终端使用ant生成javadoc,但我得到了以下警告:使用ant创建带有标记的javadoc,ant,javadoc,Ant,Javadoc,我已经使用类似{@see myPackage.MyClass}的标记用javadoc注释了我的java源代码 我必须从终端使用ant生成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 docum
[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;
/**
*Metoda提供了一个数据集,它是一个参数。
*Pokud jsou Parametery nedostateěněnedefinované,SQL dotaz neexistuje nebo nastane
*问题是共青团,dojde k vygenerování{@see calendar.exception.LoadException}。
*Pokudždoné实体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诉persistenčnívrstvě。Pokud tam实体内苏·扎维德尼(dochází)
*k jejich načteníz databáze
*@param entityClass
*@param查询
*@param params
*@返回
*@抛出calendar.exception.LoadException
*/
集合查找(类entityClass、字符串查询、映射参数)抛出LoadException;
在Datatype.java中,您在代码中Javadoc不允许的地方使用@see作为注释。具体来说,它看起来像是:
/**
*...@see...
*/
void foo() {
}
它应该在哪里
/**
* ...
* @see bla
/*
void foo() {
...
}
那不是应该代替吗
< NETBeaseIDE中弹出提示可以接受我的JavaDoc并显示它没有问题。@ SEW需要在评论的末尾,而不是在中间。