@since は、関数が作成されたバージョンを示すために使用されます。後でその関数を変更した場合、@since 値を変更するか、変更があったことを示すために何か他のことを行う必要がありますか?
1 に答える
0
「@since」の基本的な使用例は、メソッドが最初に導入されたときのパッケージ バージョンのみを示すことです。
しかし、このタグの内容は実際には単なる自由形式のテキストであり、他の doc 要素を特別に作成するために使用するドキュメンテーション ソフトウェア (たとえば、導入されたバージョンによるメソッド グループのレポート) を私は知りません。タグを他の方法で使用することについてはまったく問題ありません。
たとえば、元の「@since 2.0 foo() Introduction」を「@since 2.7 foo($arg)」に変更して、API が変更されたことを示します。メソッドの API の履歴を表示するために、複数のタグを使用することさえあるかもしれません。
* @since 2.0 foo() introduced
* @since 2.7 foo($arg) added the $arg argument to the signature
* @since 2.9 foo($arg = 'default') set a default for $arg
于 2012-08-27T17:56:46.790 に答える