继承javadoc，而不为继承的源生成文档

Question

我想class B从Javadoc实现的接口继承Javadoc interface A。我interface A在Javadoc命令中包含了源代码，并class B正确继承了文档。

现在，我想知道是否可以使它生成的链接指向interface AWeb上的文档，而不是在我的网站上复制它，即“ Specified
by：”链接将链接到外部页面。

这可能吗？

Answer 1

有可能，是的。为了能够包含继承的文档，必须在javadoc的sourcepath中找到接口A的源，但不应在传递给javadoc用于创建文档的软件包的列表中找到。要进行链接，请使用-link参数。我刚刚尝试了这个（使用ant
javadoc任务）：

<javadoc destdir="docs">
  <sourcepath>
    <!-- source of your class B -->
    <pathelement location="src" /> 
    <!-- source of external interface A -->
    <pathelement location="../example-src/src" />
  </sourcepath>

  <!-- your packages, to generate the docs for -->
  <package name="com.personal.myproject.*" />

  <!-- the location of the online documentation -->
  <link href="http://example.com/javadoc/"/>
</javadoc>

对于命令行javadoc，我认为这是这样翻译的（unix语法，一行）：

 javadoc -sourcepath ../example-src/src:src
         -d docs
         -link http://example.com/javadoc/
         -subpackages com.personal.myproject
         (other options...)

哪里

• class B在包装中com.personal.myproject，
• interface A在包装中com.example，
• 我自己的消息来源是src，
• 接口A的来源在中../example-src/src。

在为此创建的示例类中，javadoc将文档从复制A.methodName()到B.methodName()，但链接到的在线文档http://example.com/javadoc/com/example/A.html#methodName()。

感谢您提出这个问题，我一直想这样做:-)