我正在使用Eclipse3.4.1。
虽然这听起来可能很奇怪,但我希望能够将多个JavaDoc位置附加到Eclipse项目中的同一个JAR。这个特定的JAR有来自两组JavaDoc的类。之所以这样做是因为它是一个OSGi包,它由一个第三方JAR和该JAR之上的一些其他第三方代码组成,以使其在OSGi中工作。
如果我对这两个包都有源代码,并且在Eclipse项目中有该源代码,那么它可以正常工作。但是我想让它在我只有JAR和JavaDoc的情况下起作用。
发布于 2009-02-11 16:43:41
这并不容易,因为有关javadocs的信息存储在项目的classpathentry
文件中,并且由一个值(目录或存档)组成。
解决方案是构建一个包含当前javadocs的单个javadoc,并将该存档附加到jar。
另一个解决方案(可能没有被eclipse正确解释:待测试)是指向外部文档的链接。
使用与外部文档的相对链接的示例
假设您有两个包,它们的文档是在Javadoc工具的不同运行中生成的,这些文档由一个相对路径分隔。 在本例中,包是
com.apipackage
( API )和com.spipackage
(服务提供接口)。 您希望文档驻留在docs/api/com/apipackage
和docs/spi/com/spipackage
中。 假设已经生成了API包文档,并且docs是当前目录,则可以通过运行以下命令来记录SPI包中指向API文档的链接:
C:> javadoc -d ./spi -link ../api com.spipackage
注意,-link参数相对于目标目录(docs/spi)。
因此,如果您只将第二个javadoc附加到jar,它可能会选择第一个javadoc中记录的类.但我怀疑。http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/javadoc.html#linkrelativeexample
https://stackoverflow.com/questions/537614
复制相似问题