我已经使用像 {@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 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;
最佳答案
关于ant - 使用 ant 创建带标签的 javadoc,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/929799/