@since 用于显示创建函数的版本。如果我稍后修改该函数，我应该更改 @since 值还是做其他事情来表明发生了变化？
问问题
186 次
1 回答
0
“@since”的基本用例确实是仅在首次引入该方法时表示包版本。
但是，由于这个标签的内容实际上只是自由格式的文本，而且我不知道有任何文档软件用于特殊创建任何类型的其他文档元素（例如，按哪个版本介绍它们的方法组报告），那么我真的不关心以其他方式使用标签。
例如，将原始的“@since 2.0 foo() 引入”更改为“@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 回答