多人修改同一个java文件时,一般是如何注释的?
javadoc 规范中标准有以下的field /**
* 功能说明
*
* @param 参数说明
* @throws Exception
* @author 作者
* @since 生效的版本
* @return 返回值
......
规范中还有一些其它field名,但找不到 修改人,修改时间 等相关的列. jdk 中java 的源码也从来没看到过,"修改人"等信息,我相信很多开源项目中一定有一些java文件是两个人以上修改过的,但始终没看到过"修改人" 的说明信息,想问一下,是不是java的项目一般不注明修改人? 如果多个人修改一个java或者修改java内的一个函数,请问大家是如何注释的?
javadoc 规范中标准有以下的field /**
* 功能说明
*
* @param 参数说明
* @throws Exception
* @author 作者
* @since 生效的版本
* @return 返回值
......
规范中还有一些其它field名,但找不到 修改人,修改时间 等相关的列. jdk 中java 的源码也从来没看到过,"修改人"等信息,我相信很多开源项目中一定有一些java文件是两个人以上修改过的,但始终没看到过"修改人" 的说明信息,想问一下,是不是java的项目一般不注明修改人? 如果多个人修改一个java或者修改java内的一个函数,请问大家是如何注释的?
解决方案 »
- 关于String的引用传递的问题,求指教!!!
- 兄弟们,为什么这个判断闰年的程序运行不了?
- JAVA中有没有类似VB 的GridData的控件啊,要实现填写数据,直接存入数据库中,而非像table那样直接显示数据库数据啊??
- 正则表达式截取字符串。
- 高分求解数据库连接问题!ClassNotFoundException(SQLServerDriver)
- 快播qvod协议的讨论,来者有分.相互学习的.
- java中可以根据线程名而不是id获得想要的线程吗?
- mysql 怎么设置用户名密码
- 类引用的问题,详情如下,
- 关于JAVA GUI应用程序的线程阻塞问题
- 没有为类型 BigInteger 定义方法 valueOf(int)
- 请问:C/S模式下,可以使用连接池吗?
@update:[日期YYYY-MM-DD] [作者]在代码中修改的前后加上注释
//************** update by updater begin **********************/
...
...被修改的代码~~
...
//************** update by updater end **********************/
我用eclipse在注释中输入@后弹出来field中没找到"update"这个名字,说明这个不是标准的关键字, 不知道在编译成html文档的时候,@update会变成什么样子?
* @param 参数说明
* @throws Exception
* @author 作者
* @since 生效的版本
* @return 返回值
这些标准的field名,在编译成java doc 时,会自动生成相应的格式. 如果是自己定义一个如:@udpate 不知编译后会怎样