javadoc：@versionおよび@since

Question

両方を含める理由はありますか@versionおよび@sinceクラスの一部として？

それらは相互に排他的なようです。

また、%I%および%G%意味、およびそれらを設定/使用する方法は？

 @version %I%, %G% 

ありがとう

Answer 1

@versionタグは、問題のリリースまたはファイルの現在のバージョンである必要があります。 %I%、%G%構文は、ソース管理ソフトウェアがファイルの現在のバージョンとファイルがチェックアウトされた日付で置き換えるマクロです。

@sinceタグを使用して、メソッド、クラスなどを追加したバージョンを定義する必要があります。これは、パッケージの特定のバージョンに対して実行する場合にのみメソッドを期待する他の開発者へのヒントです。コードを他の誰かが使用するためのライブラリとして出荷している場合、ドキュメントのこれらの非常に重要な部分を検討します。