规范code提交日志

1 提交建议

  • 提交代码前要先更新(svn up),编译通过,功能测试正常。
  • 保持原子性的提交,建议一个功能或一个bug提交一次,不建议一次提交多个功能或bug,也不建议一个功能或bug分多次提交。
  • 提交代码的命令顺序:svn up,(svn add),svn diff,svn commit –m /-F。
  • 提交代码备注明确。可以参照第3章的日志格式。
  • 建议提交代码完成后,用另外一套代码更新刚才的提交,并编译,测试。
  • 为方便提交svn代码时的提交日志的编写,可以参考如下两种方式:

方法1:

#cd /home/xxxxx(user name)

#vi ~/.subversion/config

#修改或添加editor-cmd = vi

Note:

设置后提交代码不需要加 -m 参数,会自动打开vi。写完comment之后,保存退出vi(wq),代码自动提交。

如果中途放弃这次提交,可以强制退出vi(!q),此次svn commit终止。

方法2:

svn commit --editor-cmd=vi file1.txt fil2.txt

2 日志格式

<type><module>:<summary>
//空一行
Description:
    问题的现象描述。
    the phenomenon, lower case is recommended, especially the first character.
Reason:
    问题的根本原因。
    the reason
Solution:
    问题的解决方案。
    the solution
Code Review:
    帮忙检查代码的人员名单, 如果没有进行code review需注明为”no review”。
    RD1,RD2,RD3,…/ no review
Test Result:
    问题的测试情况,测试通过用pass, 未测试需要注明没有测试的原因。
    pass/no test for environment

2.1 type和summary说明

type代表某次提交的类型, 比如是修复一个bug(问题)还是增加一个feature(功能)。summary是某次提交的简要说明,type值只能是如下表格中列举的值。所有的type类型及对应的summary内容如下。

type

commend

summary

fix

修复bug

bug编号如alpha bug 56;如果没有编号,简要说明下该bug的来源,比如是由谁发现的discovered by RD XXX

feature

新增功能

如果是参考了其他项目组的,可以注明组名和项目名;另外写明需求来源

porting

同步相同项目组内不同产品的代码

porting的项目名和版本号

append

追加提交,用于上次提交有遗漏的情况

上次提交有遗漏的版本号

patch

同步三方如econet的patch

注明该patch的来源

revert

回滚到上一个版本

上一个版本的版本号

compile

与项目构建工具、编译有关的问题

待补充

refactor

代码重构,没有加新功能或者修复bug

待补充

perf

优化相关,比如提升性能、体验等

待补充

style

仅仅修改了空格、格式缩进等,不改变代码逻辑

待补充

docs

仅仅修改了文档

待补充

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

2.2 module说明

module代表此次提交涉及的模块类别,多个模块用逗号隔开。模块名只能是如下表格所列举的,请注意大小写。另外如果发现列表有遗漏的请提出。目前所有的module列举如下。

No

Name

Note

No

Name

Note

No

Name

Note

1

busybox

 

3

webserver

 

5

samba

 

2

dhcp

 

4

webpage

 

6

dlna

 

.

  

.

.

  

原文地址:https://www.cnblogs.com/aimmiao/p/12760849.html