タグ付けされた質問 「javadoc」

Javadocは、Javaソースコード内の特別にフォーマットされたコメントを読み取り、コンパイルされたドキュメントを生成する拡張可能なドキュメント生成システムです。通常、HTML Webページの形式でAPIドキュメントを生成するために使用されます。

3
javadocでメソッドを参照する方法は?
@linkタグを使用してメソッドにリンクするにはどうすればよいですか? 変わりたい: /** * Returns the Baz object owned by the Bar object owned by Foo owned by this. * A convenience method, equivalent to getFoo().getBar().getBaz() * @return baz */ public Baz fooBarBaz() に: /** * Returns the Baz object owned by the Bar object owned by Foo owned by …
864 java  hyperlink  javadoc 


15
Javadocコメントの複数行のコード例
メソッドのJavadocコメントに含めたい小さなコード例があります。 /** * -- ex: looping through List of Map objects -- * <code> * for (int i = 0; i < list.size(); i++) { * Map map = (Map)list.get(i); * System.out.println(map.get("wordID")); * System.out.println(map.get("word")); * } * </code> * * @param query - select statement * @return List of Map …
531 java  html  javadoc 

4
javadocのメソッドパラメータへの参照を追加する方法
メソッドのドキュメント本文からメソッドの1つ以上のパラメーターへの参照を追加する方法はありますか?何かのようなもの: /** * When {@paramref a} is null, we rely on b for the discombobulation. * * @param a this is one of the parameters * @param b another param */ void foo(String a, int b) {...}
313 java  arguments  javadoc 

17
Javadocタグが不完全な場合、MavenがJava 8で機能しない
私はMavenを使用しているので、不完全なJavadocタグ(たとえば、欠落しているパラメーター)があるローカルリポジトリプロジェクトにビルドしてインストールすることができました。 ただし、Java 8(1.8.0-ea-b90)に移行したので、Mavenはドキュメントタグの欠落に厳格であり、Javadocがないプロジェクトをビルドまたはインストールしようとすると、Javadocの問題に関連する多くのJavadocエラーが表示されます「完璧」。ローカルリポジトリにコンパイルしてインストールしようとしているプロジェクトの一部は、私が制御できないサードパーティのプロジェクトです。したがって、これらのすべてのプロジェクトですべてのJavadocを修正するという回避策は、私のシナリオでは実行可能ではないようです。 これはmvn clean package install、プロジェクトで実行したときに表示される出力の一部です。 [INFO] ------------------------------------------------------------------------ [INFO] BUILD FAILURE [INFO] ------------------------------------------------------------------------ [INFO] Total time: 9.026s [INFO] Finished at: Mon Apr 08 21:06:17 CEST 2013 [INFO] Final Memory: 27M/437M [INFO] ------------------------------------------------------------------------ [ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.9:jar (attach-javadocs) on project jpc: MavenReportException: Error while creating archive: [ERROR] Exit …

12
libsフォルダーのjarにjavadocまたはソースを添付する方法は?
Eclipse用の新しいバージョンのADT r17プラグインには、JAR依存関係を自動的にセットアップする機能が追加されました。/ libsフォルダー内のすべての.jarファイルがビルド構成に追加されます。残念ながら、Android Dependenciesクラスパスコンテナーは変更できません。 自動的に挿入された.jar(/ libsフォルダーから)にjavadocとソースを添付するにはどうすればよいですか?
254 android  eclipse  adt  javadoc 

3
他のクラスのメソッドへのJavadocリンク
現在、私はこのJavadoc構文で他のクラスのメソッドを参照しています: @see {@link com.my.package.Class#method()} そして、私がドキュメントから理解していることでは、これはこれを行う正しい方法です。しかし、今面白い部分、またはイライラします。このjavadocを生成すると、まず次のエラーが発生します。 warning - Tag @see:illegal character: "123" in "{@link com.my.package.Class#method()}" warning - Tag @see:illegal character: "64" in "{@link com.my.package.Class#method()}" warning - Tag @see: reference not found: {@link com.my.package.Class#method()} これの生成されたHTMLコードは次のとおりです。 "," <code>com.my.package.Class#method()}</code> "," そしてもちろん私にはリンクがありません。誰が何が起こっているのか、そしてこれを修正する方法についてのヒントはありますか? ASCIIテーブルによれば、woldの文字123および64は{および@を表すので、ドキュメントに従ってこの構文が正しい場合、これらの文字はなぜ有効ではないのでしょうか。
238 java  javadoc 

1
Javadoc:package.htmlまたはpackage-info.java
パッケージレベルのJavadocコメントを作成する場合、推奨される方法は何ですか。職業はなんですか? package-info.java 長所 新しい 短所 クラスの乱用-クラスはコメント用ではなくコード用です package.html 長所 HTML拡張はそのコードではないことを意味します IDE /テキストエディターでの構文の強調表示 短所 なし? 私は常にPackage.htmlを使用してきました。しかし、私はそれが正しい選択かどうか疑問に思っています。
230 java  javadoc 




5
コードスタイル; アノテーションの前または後にjavadocを置きますか?
私はそれが最も重要な問題ではないことを知っていますが、アノテーションの前後にjavadocコメントブロックを配置できることに気づきました。コーディング標準として何を採用したいですか? /** * This is a javadoc comment before the annotation */ @Component public class MyClass { @Autowired /** * This is a javadoc comment after the annotation */ private MyOtherClass other; }



17
Maven管理の依存関係のためにEclipseに添付されたソースjarファイルを取得する
私はMaven(およびMaven Eclipse Integration)を使用して、EclipseでJavaプロジェクトの依存関係を管理しています。MavenリポジトリからのJARファイルの自動ダウンロード機能は、リアルタイムセーバーです。残念ながら、APIドキュメントとソースコードは含まれていません。 ソースとjavadocの添付ファイルを自動的に取得してEclipseに正しく登録するようにMavenを設定するにはどうすればよいですか?
176 eclipse  maven-2  javadoc 

弊社のサイトを使用することにより、あなたは弊社のクッキーポリシーおよびプライバシーポリシーを読み、理解したものとみなされます。
Licensed under cc by-sa 3.0 with attribution required.