多人修改同一个java文件时,一般是如何注释的?
javadoc 规范中标准有以下的field /**
 * 功能说明
 * 
 * @param 参数说明
 * @throws Exception
 * @author 作者
 * @since  生效的版本
 * @return 返回值
           ......
规范中还有一些其它field名,但找不到 修改人,修改时间 等相关的列. jdk 中java 的源码也从来没看到过,"修改人"等信息,我相信很多开源项目中一定有一些java文件是两个人以上修改过的,但始终没看到过"修改人" 的说明信息,想问一下,是不是java的项目一般不注明修改人?  如果多个人修改一个java或者修改java内的一个函数,请问大家是如何注释的? 

解决方案 »

  1.   

    可以加这个呀,然后在后面加算定义的格式
    @update:[日期YYYY-MM-DD] [作者]在代码中修改的前后加上注释
    //************** update by updater begin **********************/
       ...
       ...被修改的代码~~
       ...
    //************** update by updater end **********************/
      

  2.   


    我用eclipse在注释中输入@后弹出来field中没找到"update"这个名字,说明这个不是标准的关键字, 不知道在编译成html文档的时候,@update会变成什么样子? 
      

  3.   

    我说明一下吧,如果是
    * @param 参数说明
    * @throws Exception
    * @author 作者
    * @since  生效的版本
    * @return 返回值 
    这些标准的field名,在编译成java doc 时,会自动生成相应的格式. 如果是自己定义一个如:@udpate 不知编译后会怎样
      

  4.   

    我就觉得奇怪,看过这么多开源项目,还从没见过修改者信息的情况,难道java开源项目为了代码的整洁,对外都不注明修改者的信息?