Javadoc无法在附带的Javadoc中找到 - 这是Eclipse + Doclava的一个缺陷

时间:2013-12-09 11:59:48

标签: eclipse javadoc

有很多类似标题的问题,但请继续阅读,因为这是微妙的不同,我还没有找到解决其他问题的许多答案。

情景:

我有一个带有单独的HTML树javadoc的外部JAR文件。我通过在构建路径对话框中完成JAR的“Javadoc位置”,将Eclipse指向javadoc。源是可供Eclipse使用。

起初它看起来很好用。如果我将鼠标悬停在名称上(例如,Wibble),则会弹出相应的javadoc文本。

但是,如果我将鼠标悬停在方法上(比如blah = Wibble.create();中的 create 这个词),我会弹出“ ..无法找到Javadoc ...... “这让我感到困惑,因为它只是向我展示了Wibble类的javadoc。

事实上,如果我点击弹出窗口中的图标“在浏览器中打开附加的Javadoc”,正确会打开HTML,并向我显示它刚刚说的方法的文本它找不到!

技术说明:

  • 我的Eclipse版本是Android Developer Tools,Build:v22.2.1,虽然这是在我更新到ADT版本之前在vanilla Eclipse上发生的。
  • 使用Doclava doclet命令行生成javadoc。

有关javadoc或eclipse设置中可能出错的任何建议,还是......?

EDIT在后​​续实验过程中,我发现这个问题只发生在Doclava生成的Eclipse和javadoc的组合中。我的实用解决方案是生成javadoc两次 - 一次是使用Doclava进行人类可读性,一次是使用vanilla Javadoc进行Eclipse可读性。

如果有人深入了解这些系统,我仍然很想知道原因。

1 个答案:

答案 0 :(得分:0)

(为了不让这个“未答复”现在我有一个解决方案)

在后续实验过程中,我发现这个问题只发生在Doclava生成的Eclipse和javadoc的组合中。我的实用解决方案是生成javadoc两次 - 一次是使用Doclava进行人类可读性,一次是使用vanilla Javadoc进行Eclipse可读性。

如果有人深入了解这些系统,我仍然想知道为什么