java since,javadoc:@version和@since
Is there a reason to include both @version and @since as part of a class?
They seem to be mutually exclusive.
Also, what does %I% and %G% mean, and how to set/use them?
@version %I%, %G%
thanks
解決方案
The @version tag should be the current version of the release or file in question. The %I%, %G% syntax are macros that the source control software would replace with the current version of the file and the date when the file is checked out.
The @since tag should be used to define which version you added the method, class, etc. This is your hint to other developers that they should only expect the method when they run against a particular version of the package. I would consider these uber-important parts of the documentation if you're shipping your code as a library intended for someone else to use.
總結
以上是生活随笔為你收集整理的java since,javadoc:@version和@since的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: nginx的access.log文件详解
- 下一篇: word双引号间距大_解决Word 20