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 delivery2回言及しないでください：

/**
 * @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 が好きな人が多いことです。上記のトリックを行うと、Web ページに表示するときに javadoc に正しい内容を表示させることができます。しかし、別のアプリケーションでページのフラグメントを表示している場合、CSS を適用して目的の結果を得る方法はありません。

私がやろうと考えているのは、ソースを前処理するドックレットを作成することです。言語タグがないか正しい言語タグを持つ要素を選択し、その言語だけに固有のソースのコピーを作成します。その後、javadoc の生成を正常に続行できます。

それか、このドックレットは javadoc 自体を生成し、中間ソースを生成しません。様子を見よう。

于 2013-09-14T20:33:07.203 に答える