java - 在 Ant 脚本中记录 Java EE 组件

Question

我想记录我们创建的 Java EE 组件。我们的 Ant 脚本有构建它们的目标。我想知道 ant 脚本是否有类似“javadoc”的东西。换句话说，我可以注释 ant 目标:

<target name="some.war'>
  <antdoc>
      This war file provides the user interface for the foo application.
  </antdoc>
...
</target

这看起来是个好主意吗？也许我最好创建一个常规文档。

Answer 1

Ant 有一个描述标签:

 <target name="some.war">
    <description>
           This war file provides ...
    </description>
  </target>

我认为这已经是最好的了。我认为这是一个好主意并且一直使用它。大多数任务也有描述属性，这对于简短的描述很有用。