2

我参与了一个项目，有人正在投入大量的好东西，但它带有英语和日语的 javadoc。例如，他在方法注释中这样做：

    /**
     * Return really great stuff.
     *
     * <span class="en">By the way, here are some details.</span>
     * <span class="ja">Here are the details in katakana...</span>
     */

在生成的 javadoc 的标题中放入了一段 js，它运行良好。它会感知您浏览器的语言并只向您显示正确的评论。

那么，如何在生成 javadoc 时摆脱这些该死的消息：

    OurUtils.java:139: warning - Parameter "delivery" is documented more than once.

有没有一种方法可以让我们这样做更符合犹太教规？还有其他可行的方法吗？

谢谢 - 射线

4

2 回答 2

1

只是不要提到@parameter delivery两次：

/**
 * @param delivery
 * <span class="en">By the way, here are some details.</span>
 * <span class="ja">Here are the details in katakana...</span>
 */
于 2012-07-06T05:24:27.700 回答
0

以前的答案不起作用，但回答者不知道。问题是我们大多数人都使用 eclipse，而人们喜欢使用鼠标悬停在方法、字段或类上看到的 javadoc。如果一个人做了上面的技巧，当一个人在网页中显示它时，一个人可以让 javadoc 显示正确的东西。但是当一个人在另一个应用程序中显示页面的片段时，没有办法应用 CSS 来获得所需的结果。

我想我要做的是创建一个预处理源的 doclet。它将挑选出没有语言标签或正确语言标签的元素，并创建一个特定于该语言的源副本。然后javadoc生成就可以正常进行了。

要么，要么这个 doclet 将生成 javadoc 本身而不产生中间源。我们会看到。

于 2013-09-14T20:33:07.203 回答