Patch 命名规范 V1.1
发布时间:2004 年 5 月 12 日
发布人:王仲俊
为便于代码的管理,在原码上做的所有修改代码最终统一以Patch方式提交,以Patch方式追加到原有代码中。
现下的通用惯例命名方式如下:
Name-Version-Function.patch
Name项标明软件包名,Version软件包主版本,Function是Patch所修改提供的功能,用简单的英文或英文缩写表示,能表达出对应意思即可。在遵循通用惯例的基础上,本规范规定了Patch控制用的新内容。
增加公司标志号、Patch维护小组标号、本软件本功能Patch的Patch Release号。整体命名方式如下:
Name-Version-Function-ThisFunctionPatchRelease-GroupNum-cocreate.patch
ThisFunctionPatchRelease取1以上的自然数,取向为自然递增,新版本Num号自然的比旧版本Num号要大。GroupNum是Patch维护小组标号,提供是为了方便查询Patch提供和维护者,GroupNum号生成规则看附录1。 cocreate是公司标记号。举例:薛胜瑶对gnome -panel做了修改,在menu中增加了文档项,对应的代码生成的Patch为gnome-panel-2.4.0-MenuDocument-1- C001-cocreate.patch,下一次对同样功能因为不稳定等问题作修改后生成的Patch名为gnome-panel-2.4.0- MenuDocument-2-C001-cocreate.patch。
附录1
GroupNum生成规定
工作小组 |
组长 |
GroupNum |
|
Nautilus组 |
刘执远 |
A000 |
|
发行版组 |
王仲俊 |
B000 |
|
Gnome图形环境组 |
薛胜瑶 |
C000 |
|
OpenOffice组 |
黄海军 |
D000 |
|
输入法组 |
张 倩 |
E000 |
|
控制面板组 |
李 晋 |
F000 |
|
浏览器组 |
张 昀 |
G000 |
|
邮件组 |
贾记春 |
H000 |
|
高可靠系统组 |
安 泱 |
I000 |
|
UI设计组 |
高 超 |
J000 |
|
翻译教程手册开发组 |
张衍顺 |
K000 |
GroupNum号的后3位各组可以在0到999中使用一个唯一的号码对应到唯一的组员,方便Patch和人员的对应。