TortoiseCVS1.8中文使用指南

TortoiseCvs V1.8中文操作指南
深圳华强信息产业有限公司
2007-01
注：本文档配合TortoiseCvs 自带的中文帮助文档使用；
目录
第一章TORTOISECVS客户端配置指南 (3)
1.1客户端的安装设置 (3)
1.2取出模块 (3)
第二章TORTOISECVS的操作指南 (5)
2.1T ORTOISE CVS日常操作 (5)
2.2T ORTOISE CVS高级操作 (6)
第三章TORTOISECVS客户端操作使用注意事项 (10)
第一章TortoiseCVS客户端配置指南
1.1客户端的安装设置
服务端安装程序：CVSNT 2.0.41；
客户端安装程序：TortoiseCvs 1.8.30版以及Python 2.2.3（版本比较器）；
运行环境：windowsXP/2003操作系统、
硬件条件（客户端最低配置：硬盘10G/内存256Mb/CPU1.0G；服务器端：硬盘20G/内存
512Mb/CPU1.5G）；
安装过程选择所有安装，对于所有人员只需安装客户端程序，所有操作都在客户端上进行，服务器端程序由配置管理员负责安装和维护，服务端安装和配置略。

客户端安装好后设置语言为中文：
选择“Prefererces”（属性）菜单后设置语言为中文。

1.2取出模块
取出模块就是第一次从CVS服务器上获得一个数据模块，从CVS仓库中取出模块，创建该模块的本地工作目录，使本地目录与服务器相关联。

执行“CVS取出”模块，首次使用需要检出服务器上的目录路径，因为项目组的目录路径按一定的规则存放在服务器上，做了权限控制，所以不允许私自创建项目/模块:
∙协议用来同CVS仓库通讯的协议.
∙服务器 CVS仓库所在地服务器名称（或IP地址）.
∙Port CVS仓库端口号通常不需要填写（默认2401）.
∙Repository Directory远端服务器定义的CVS仓库本地路径.
∙User name帐号用户名.
∙CVSROOT整个连接串，由以上字段组成，通常你将会直接获得，那样你就直接粘贴上来。

.
∙Module你想要取出的模块名称. 大小写敏感.
注：模块可通过获取列表获得服务器上有的模块名；TCVS将在你选择的那个文件夹下面会创建一个以该模块名称命名的文件夹，因此你可以保留你的所有取出的模块在同一个文件夹里面。

即使它们分属不同的项目。

第二章TortoiseCvs的操作指南
TortoiseCVS采用右键菜单式操作，结合windows操作系统视窗即可完成日常的更新、提交、添加、删除资料工作。

服务器端存储路径（结构）为：仓库→项目/模块→根据配置项设置的各级菜单目录。

2.1 TortoiseCVS日常操作
框内三个菜单为日常基本操作菜单：
更新：从服务器下载最新版本到本地，每次修改文件前都需执行该操作；
提交：把每次修改或添加文件、删除文件都上传到服务器上；
添加内容：添加内容到相应的目录下，服务器也对应存放添加的内容；
注：每次修改文件养成先更新文件后修改文件的习惯；
每次添加内容到服务器需先添加再提交的操作；
添加时TCVS会自动识别文本文件和二进制文件，不需手工调整；
TCVS支持文件的锁定，把某个文件选中编辑状态可把文件状态传达给其他组员；
2.2 TortoiseCVS高级操作
如上图选中某个文件右键菜单CVS下一级菜单操作：CVS差异比较、历史、版本分支图、批注、显示已编辑的文件、取消编辑状态、生成补丁文件、更新到指定版本、标签、分支、合并、删除等；
CVS差异比较：
绑定版本比较工具可对源代码各个版本进行差异比较；
历史：
选中某个文件可以查看某个文件的版本历史，查看版本线、更新日期、修订者、注释（提交日志）等。

版本分支图：
选中可查看文件的各个版本分支以及各个分支的版本演进情况，以及版本标签情况：
批注：
对于源代码或文本文件选择该菜单可查看相应文件每行所对应的最新版本号，以及修订者、日期，可方便的查看源代码的每行最新版本：
编辑、显示已编辑的文件、取消编辑状态、生成补丁文件等菜单：
更新到指定版本：
可对文件或目录按标签、分支、修订版本、日期更新到所需要的文件：
标签：
在开发过程中的某个阶段，给一个或多个文件打上一个公共标签，以指示修订情况，称之为标签。

标签一般都是用在整个模块，以便将来这个模块的当前状态可以回溯。

这种标签一般打在整个工程可以使用之后，但是正式发布之前。

源代码目录的标签规则：
1、在形成烧录文件或发布版本同时对整个源代码目录进行打标签；
2、标签名规则：系统软件类格式：V1_0_1_01代表V1.0.1.01版本，形式：主版本号.次版本号.辅版
本号.版本编译标识号（用于维护标识，可1~3位数字）；终端类版本号规则：V36_1_01_0代表V36-2.01.1版本,形式：终端型号-主版本号.次版本号.补丁号，补丁号首次默认可为无，如有该版本的修改版则贴上0～99的补丁号；最后面都可加分支；
3、维护阶段软件发布版本都需提交软件更改报告，并检查配置项和版本标签、版本记录；
注：更新列表可获得该目录的所有已有标签。

分支：
在一个软件项目周期中，分支是一个很有用的修改控制。

例如，如果你已经推出了你的软件的第一个版本1.0，现在你已经在下一个版本2.0增加新功能。

此时你的第一个版本发现了BUG，你的新版本的源代码正在开发阶段，推出稳定版本至少需要一个月的时间，因此无法基于最新版本推出一个修正原有BUG 的版本。

所以检出版本1.0所有文件，基于版本1.0建立分支再进行修改、提交。

例如上边的版本标签中，本身就是V36-2.10.0的版本分支：V36-2.10.0-FSQ，当我们发现发布后的FSQ 版本有bug需要修改，则按版本标签（V36-2_10_0-FSQ）检出V36-2.10.0-FSQ版本对应的所有源代码，然后对这些源代码进行创建分支：
创建后检出该分支文件，基于该分支进行修改，形成V36-2.10.1-FSQ版本，然后同样进行版本标签，提交服务器。

合并：
版本合并有两种情况：分支版本合并到主干版本上和主干版本合并到分支版本上。

一般为保持主干版本保持更新状态，一般进行分支版本合并到主干版本上，但有时分支版本由于采用客户的特殊需求等其他原因不能与主干版本保持一致，而分支版本也需要采用主干版本的最新开发成果则进行主干版本合并到分支版本上操作，操作：
上述选择意思是将1.3版本与1.2版本之间的差异补到当前1.3版本上，相当于从1.3版本上将1.2到1.3之间的变化又减去了，恢复到1.2版本的内容，同时保留了1.2和1.3的更改，如果有冲突就会如下对话框所提示标记有“C”，并需人工解决冲突，本地的修改以“＃”开头的文件进行保存，文件提交则演进到最新版本，具体实例可参看帮助文档。

删除：
删除文件也如同添加文件操作类似，必须先对文件或目录进行标识删除（TCVS支持目录递归），然后执行提交操作，只是说明下一版本文件被标识为删除状态，执行更新后最新版本没有对应文件，具体步骤略。

第三章TortoiseCVS客户端操作使用注意事项
1、提交文件注意本地备份数据，以免造成提交失败（客户端操作失误或服务器故障都可能造成提交失败）时丢失文件；
2、研发人员不允许在库中自己建立项目/模块，文件的读取和存放必须按照设定的规则进行提交和更新，导入模块提交时特别注意目录路径的正确性；
3、提交的文件名称不能大于16个汉字（32个字符），否则不能提交；
4、每个目录下的CVS目录不能删除，该目录是关联本地文件和服务器文件的必要文件目录；
5、客户端检出服务端的目录和文件后不能进行文件夹的移动删除操作，文件夹移动后cvs目录下的Entries文件对应的目录路径没有修改，所以更新、提交失败，提示为：“no such directory”；
6、CVS里的revsion和软件包的发布版本可以没有直接的关系，但所有文件使用和发布版本一致的版本号比较有助于维护；
本文档公司内部使用，有任何疑问Email：zwlue@。