0

プロジェクトのバージョン番号付けに少し問題があります。

たとえば、4 つのクラス One Two Three Four があるとします。

このソフトウェアを初めてリリースするときは、バージョン 1.0.0 というラベルが付けられます。

私のJavaドキュメントのコメントでは、すべてのクラスについて、@version 1.0.0として持っています

したがって、テストはクラス2のバグでそれを送り返します

クラス 2 を更新し、バージョン 1.0.1 をリリースする必要があります

すべてのクラスで @version タグを更新する必要がありますか?

それとも、最終的に javadoc コメントに異なるバージョン番号を持つ一連のクラスになってしまうのでしょうか?

4

2 に答える 2

1

バグを修正するときは、バージョン番号のリビジョン番号(3番目)のみを変更するため、バグ修正はこれにまったく影響しないと思います。また、javadocにリビジョン番号を入力する必要はありません。javadocはAPIの記述に使用され、APIはバグの修正によって変更されないため、そこでは役に立ちません。

つまり、@ version 1.2.6ではなく、たとえば@version1.2のみを配置する必要があります。

javadocは、APIを変更した場合にのみ変更されます。メジャー(1番目)またはマイナー(2番目)のバージョン番号を変更する必要があり、それをjavadocに投影する必要があります。

他のクラスは以前のバージョンから「継承」されているため、変更されたクラスのバージョン番号のみを変更する必要があると思います。したがって、変更されていないクラスのバージョン番号はそのままである必要があります。しかし、それについてはよくわかりません。

于 2009-06-03T07:02:33.300 に答える
1

正解は、バグの影響を受けるファイルを変更することだと思います。

バージョンまたはリビジョンは、コントロール バージョンに任せます。完璧な世界では、スクリプトがバージョンの同期を維持します。

もちろん、この質問は主観的なものです。バージョン タグをマーケティング ツールとして使用する場合は、すべてのコードで同じバージョンを使用する必要があります。

于 2009-06-03T06:44:54.007 に答える