2

{@Code 注釈を使用して、Eclipse が不満を言っているオープン ソース コードをいくつか入手しました。気にしないので、コンパイラ オプションで Javadoc をオフにしましたが、それでも問題が発生し、コンパイルされません。

エラー: 「Javadoc: インライン タグの右中括弧がありません」

実際には閉じ中括弧が存在します。数行下にある場合もあれば、同じ行にある場合もあります。

さらに奇妙なことに、別のワークスペースにある小さなプロジェクトの同じコードでも問題なく動作します。2 つのプロジェクトの設定を数回比較しましたが、同じように見えます。多くの場合、オプションはプロジェクト固有の設定を許可しないように設定されています。

また、プロジェクトをクリーンアップしたり、Java 1.5 対 1.7 コンパイラ オプションを試したりするなど、他のことも行いました。

その他の詳細：

  • Mac 上の Java 7
  • エクリプス・ケプラー
  • コードは Guice 2.0 です (私はそれが古いことを知っており、通常は jar を使用する必要があります。長い話です)
  • 1 つの例は、Key.java の 107 行目です。以下を参照してください。

Guice コードの例 (ただし、コメントだけなので、通常は気にしません)

  /**
    ...
   * <p>{@code new Key<Foo>() {}}.
4

1 に答える 1

0

@code タグにはいくつかの注意点があります ( Javadoc コメントの複数行コードの例を参照)... そのうちの 1 つは、同じ行にタグのブレースと実際のコンテンツのブレースを混在させないようにする必要があることです。

それを念頭に置いて、Javadocを次のように書き直します。

 <p><pre><code>new Key{@literal<Foo>}(){}</code><pre>.</p>

HTML タグとして解釈され@codeないようにするために使用することもできます。<Foo>

コンテンツは既にタグでラップされているため、 @literalを使用しています。<code>タグは、<pre>スペースと改行を保持するために使用されます。

Javadoc 構成について、敷物の下の汚れを一掃したい場合は、次の場所に移動します。

Windows -> Preferences -> Java -> Compiler -> Javadoc

そして無視Malformed Javadoc commentsに設定します。適用して再構築すれば準備完了です (また、特定のプロジェクト設定がセットアップを混乱させていないことも確認してください)。Project -> Properties-> Java Compiler -> Javadoc

于 2013-08-24T02:18:51.743 に答える