如何从Javadoc中排除某些类/程序包/公共成员

Question

我创建了java api-从C＃移植到更具体-在公共接口之外，它包含许多我不希望用户知道的内部内容。 在C＃中，我使用了doxygen来生成文档。 我认为javadoc具有类似的功能，可以排除某些公共成员，类甚至程序包。

有人会建议如何做，也许通过日食吗？

谢谢

Answer 1

我相信，在Eclipse中，您可以指定的唯一排除类型是诸如“排除所有受保护成员”和基于包的排除（不是基于类的排除）。

如果要使用Ant生成它们，则可以使用嵌套的“ package”元素，也可以使用文件集nested元素，并将排除项添加到该文件集。

例如：

<javadoc >
    <sourcefiles>
          <fileset dir="${src}">
              <include name="**/*.java"/>
              <exclude name="**/ClassToExclude.java"/>
          </fileset>
    </sourcefiles>
    <packageset>
          <dirset dir="${src}">
              <include name="com.mydomain.*"/>
              <exclude name="com.mydomain.excludePackage"/>
          </dirset>
     </packageset>
</javadoc>

PS-我已经大量使用了<sourcefiles>元素，但从未使用过<packageset>元素。 后者可能不会在语法上出现。

Answer 2

当然，当您“ Generate Javadoc”时，您可以选择此过程涉及的软件包，并排除其他软件包

替代文字http://www.filigris.com/products/docflex_javadoc/images/eclipse_javadoc_1.png

（这里的图片显示了使用其他工具生成的javadoc，但这并没有改变总体思路）

Answer 3

您可以在Java中使用doxygen。 我不知道有什么工具可以用Javadoc来完成您想做的事情。

超级软件包应该出现在JDK 7中，我相信可以解决这个问题： http : //blogs.oracle.com/andreas/entry/superpackages_in_jsr_294