package-info.java からこのパッケージの外部 (同じプロジェクト内) の別のパッケージにリンクする方法はありますか?
Java 7でこれを行おうとすると、常に次のようになります。
warning - Tag @link: reference not found:
との両方がパッケージへのリンクをサポートしてい@linkます。@see
ファイルの 1 つに次のコードがpackage-info.javaあり、javadoc ツールがリンクを生成します。
/**
* <p>ただし、{@link gov.va.med.srcalc.domain} のクラスは
* JPA アノテーションを介して大部分のデータ マッピングを定義します。</p>
*/
パッケージ gov.va.med.srcalc.db;
ビルド ツールとして Gradle を使用していますが、Gradle ではリンクが生成されず、reference not found: gov.va.med.srcalc.domain警告が表示されることがわかりました。多分それはGradleのバグです。
@docroot標準の Java ドックレットで動作する単純なリンク:
/**
* See the
* <a href="{@docRoot}/com/mycorp/package-summary.html#package_description">
* package overview
* </a> for more information.
*/
これが package-info.java またはクラスで必要かどうかは問題ではありません{@link}。タグはパッケージへのリンクを処理できません。
これは回避策ですが、少なくともパッケージ内のファイルにリンクする場合、com.foo.BarEclipseでは、後でインライン プレビューなどでホバー/クリックすることで説明Barに移動できます。package-info.javafoo
javadoc が参照している名前空間を認識できるように、使用したパッケージをインポートする必要があります。
package-info.java は、次のリンクを参照してください。
import package.subpackage.ClassnameYouWantToLink;
/**
* {@link ClassnameYouWantToLink}
*/
パッケージをインポートしたくない場合は、ClassName の前に完全に修飾された package-Name が必要です。
/**
* {@link package.subpackage.ClassnameYouWantToLink}
*/