如何使Ant Javadoc类排除两个文件?
我正在记录一些Java Web服务和支持数据类型。 我不想记录两种服务。 从Ant javadoc任务中排除少量文件的正确方法是什么?
我已尝试使用嵌套在sourcepath或sourcefiles下的文件或文件集进行多次迭代,并使用include和exclude的各种组合。
我已正确定义的基本目标记录了我的所有Web服务:
<![CDATA[company project Webservices
]]> <![CDATA[Copyright © 2011 company Corp. All Rights Reserved.]]>
我尝试过的一些变化包括:
此错误与javadoc.exe CreateProcess error=87, The parameter is incorrect
与sourcefiles相同的错误,但有很多消息说skipping since it is no directory
。
我使用而不是
尝试了类似的变体。
我想我错过了一些关于如何包含/排除作品的基本理解。 感谢您的帮助!
AlexR并没有得到它,但接近了。 我删除了并添加了
只有一个文件集导致javadoc抱怨它找不到任何包。 Packageset的行为类似于dirset,因此它不能排除单个文件,只能排除目录。 在这种情况下,我能够为一组doco定义一个包集,并为限制集定义一个文件集并绕过它。
………………
我认为你的错误是“sourcefiles”和“sourcepath”标签。 尝试删除它们。 有关详细信息,请查看此处: http : //ant.apache.org/manual/Tasks/javadoc.html
祝你好运!
刚刚遇到同样的问题,并在man javadoc
挖掘了一点,得出的结论是没有解决方案,除了碰巧在OPs情况下工作的解决方法。 但我想记录我从文档中读到的内容。
Ant的javadoc
任务只是Java的javadoc
的包装器,所以后者的文档适用。 特别是, javadoc
似乎有两个完全分离的生成文档的概念:
- 文件包
- 记录个别课程
对于(1),我们指定包名称,如my.nice.package和-sourcepath
以帮助javadoc
找到这些包。 使用ant,名称可以作为packageset
名提供,也可以作为packageset
,后者将路径名转换为包名(斜杠到点)。
对于(2),我们指定文件路径,可能使用通配符。 然后记录每个单独的文件。 使用ant,这是通过嵌套fileset
,它允许我们排除文件。
现在似乎有两件事在javadoc
不能很好地结合在一起。
a)记录包时,无法排除单个文件。
b)在记录单个文件时,不会记录包,这会导致在使用{@link my.package}
时出现有关包名称错误引用的错误消息。
在man javadoc
搜索记录包和类 ,以查看我在哪里阅读这篇文章。
这是十年之久的问题 ,似乎:-(
- 配置ant以运行unit testing。 图书馆应该在哪里? 应该如何配置classpath? 避免ZipException
- 有没有办法从build.xml中指定本地jsch.jar的位置?
- 使用ant / ivy从nexus中检索依赖关系之间的http身份validation?
- 如何在jenkins ant构建工具中使用`Java Options`来设置ANT_OPTS
- 使用ant删除重复文件?
- Ant build.xml需要用户输入,但Eclipse没有tty
- 如何在我的Ant构建脚本中运行JUnit测试,同时从生成的jar中省略测试类?
- Eclipse中的java.lang.NoClassDefFoundError,但不包含Ant
- 用Java删除注释的脚本