wincvs操作使用说明.doc

WINCVS用户操作手册WINCVS用 户 手 册编 写： 相 伟 版本号： 2008年4月18日黑龙江傲立信息产业有限公司目 录1.环境要求22.wincvs界面与基本设置23.登录CVS服务器44.导入文件（Import）与检出文件（Checkout）65.同步（Update）-将服务端文件更新到本地156.文件提交修改 (Commit)177.删除文件188.找回被删除的文件199.添加目录到模块中1910.删除模块中的目录2011.标签( Tag )操作2112.分支 ( Branch )版本操作2113.查看文件的状态2214.需求要特别注意的事项2415.创建分支的注意事项24CVS（Concurrent Version System）版本控制系统是一种GNU软件包，主要用于在多人开发环境下的源码的维护。实际上CVS可以维护任意文档的开发和使用，例如共享文件的编辑修改，而不仅仅局限于程序设计。CVS维护的文件类型可以是文本类型也可以是二进制类型。CVS用Copy-Modify-Merge（拷贝、修改、合并）变化表支持对文件的同时访问和修改。它明确地将源文件的存储和用户的工作空间独立开来，并使其并行操作。CVS基于客户端/服务器的行为使其可容纳多个用户，构成网络也很方便。这一特性使得CVS成为位于不同地点的人同时处理数据文件（特别是程序的源代码）时的首选。 所有重要的软件项目都可以使用CVS作为其程序员之间的中心点，以便能够综合各程序员的改进和更改。 CVS的基本工作思路是这样的：在一台服务器上建立一个源代码库，库里可以存放许多不同项目的源程序。由源代码库管理员统一管理这些源程序。每个用户在使用源代码库之前，首先要把源代码库里的项目文件下载到本地，然后用户可以在本地任意修改，最后用winCVS的Commit(提交修改)功能进行提交，由CVS源代码库统一管理修改。这样，就好象只有一个人在修改文件一样，既避免了冲突，又可以做到跟踪文件变化等。下面将详细说明该系统的操作使用方法。1. 环境要求l CPU ：P3-450以上、内存64M、8M以上显卡、自由硬盘空间大于2G。 l 操作系统 ： Windows2000操作系统（pack2 /pack3）。l WNCVS ：websrvsoftwarewin CVS 1.3.11 wincvs1.3.11.1beta11.exe2. wincvs界面与基本设置安装好wincvs后，启动该系统，可以看到如下图的操作界面：现在需要进行基本配置。配置步骤如下：1. 点击菜单Admin-login，弹出的窗口如下所示: 2. Authenticatio ：pserver（认证方式，这里选择的是PC机连接服务器）；3. Path ：输入CVS 服务器上配置的路径，即“数据库根”；4. Host address ：输入CVS服务器端的IP地址或主机名；5. User name ：输入自己在CVS 服务器上的用户名；6. 选择此窗口的Globals标签；7. 注意checkout read-only选项，表示“检出时文件只读”（建议选中此项）。8. 注意 prune（remove）empty directories选项，表示“自动删掉空目录”。9. 点击【确定】按钮，配置完成。10. 公司服务器数据库根、CVS服务器IP及主机名由配置管理员通知。3. 登录CVS服务器配置完后，开始登陆CVS服务器端，登陆过程如下：1. 点击菜单Admin-login，弹出的窗口如下所示:2. 点击【确定】按钮，出现选择本地工作目录窗口（建议选择一个空目录）；例如选择：“D:CVS”3. 选择目录之后，点击【确定】按钮，会弹出如下所示窗口：4. 输入用户口令之后，点击【OK】按钮，出现界面如下：5. 查看上图所示红色圈选部分，如果提示为“cvs exited normally with code 0”则登陆成功。接下来就是系统的具体使用了，它的工作流程如下图：图中名词定义：导入(Import):将本地原始工作目录中的文件或文件夹导入到CVS的仓库中。检出(Checkout):将自己或其他人员上传到CVS仓库中的文件或文件夹下载到本地的一个工作目录中（服务器端已有相应模块）。提交(Commit):将本地作完修改后的文件提交到CVS的仓库中。同步(Update):将CVS仓库中最新的修改后文件下载到本地工作目录中。4. 导入文件（Import）与检出文件（Checkout）将本地文件导入到服务器端相应的“数据库根”中的模块中。若服务器端没有建立相应的模块，则需自己导入模块； 若服务器端己建立好模块，则直接导入文件即可。l 服务器端未建模块时，操作步骤如下：1. 如图：选择放置模块（项目）的目录，即本地工作目录，如下图选择：“D:CVS”为本地工作目录:2. 设置好本地工作目录后，首先在资源管理器中将要导入到服务器端的模块及模块下的文件拷贝到本地工作目录中，回到CVS界面，如下图所示:3. 选中模块名，例如下图中的“源代码”，然后选择菜单“Create-Import module.”选项，出现如下界面：Wincvs会自动检测所添加的目录中的文件类型，分成两类：binary和TEXT类，并请求确认4. 点击【Continue】按钮，出现如下界面：5. 在“Enter the log message”中输入“注释”信息，点击【确定】按钮6. 看到如下图所示提示，显示“CVS exited normally with code 0”，即操作成功，将本地文件导入到服务端后，本地并没有跟服务端建立联系。如要建立联系，必须再将模块从服务端检出（checkout）才行（与服务器端建好模块的操作相同） l 服务器端己建好模块时（公司服务器，配置管理员己建好相应模块），操作步骤如下：1. 按如下图所示红色圈选的按钮，选择放置模块（项目）的目录，即本地工作目录。下图例中选择了：“D:CVS”作为本地的工作目录：按此按钮选择本地工作目录2. 点击菜单Createcheckout module，输入模块名即可，例如：输入模块名为“源代码”：3. 此时要注意，如果服务器端的模块是空的，即模块里没有文件（如初始配置管理员建立模块时，模块是空的），则必须在Globals标签上将prune（remove）empty directories选项去掉，如下图所示：4. 点击【确定】按钮，即将服务器端的模块下载到本地了。可以左边“Modules”中看到当前目录中，下载的模块名为“源代码”的目录，源代码的文件夹显示前有黑色箭头显示，表明其是CVS模块。5. 在资源管理器中将文件拷入本地工作目录中，然后回到WINCVS操作界面，点右上角的刷新按钮，可看到如下图所示界面：6. 先选中文件，然后点击添加按钮。出现如下图所示界面：注意此处有三个按钮，第一个添加一般的文件；第二个添加二进制文件，如图片文件；第三个添加采用双字节对字符进行编码的文件。（除.txt文档可以第一个按钮外，其它均用第二个按纽，建议全部用第二个按钮添加）7. 点击【Ignore】按钮，出现如下界面：8. Commit（提交修改）添加后的文件显示为红色，其属性“Rev”中显示“0”，即文件己添加到本地工作目录中，然后保持选中状态，右键选择“Commit selection.”选项，如下图所示：9. 则会出现如下所示界面：10. 在“Enter the log message”中输入注释信息(这里一般输入的是软件在公司的版本号)，点击【确定】按钮，则界面如下所示：11. 此时文件己提交到服务器端，默认版本号为“1.1”，即初始版本（注：初次提交文件时，一定要有初始版本，即每个文件都应有1.1版本。）12. 同步（Update）同步的操作：使用鼠标选择一个目录或者一个文件，也可选择多个，使用下面三种等效操作即可：1)菜单: Modify-Update2)快捷键：Ctrl+U3)点击Update工具按钮， 如下图所示点击该选项后，出现下面界面使用后三项，更新服务器上最新版本的文件，若要按rev版本（tag标签、branch分支）更新则使用输入相应版本号（标签、分支），则更新到本地的文件与输入的版本相同，而不是服务器上的最新版本。好习惯“先同步 后工作”。每次使用WinCvs开始工作前，应该先Update一次，这样我们就能在文件的最新版本上工作。Update与Checkout之间的区别Checkout是把CVS服务器上的module下载到本地进行工作。Update主要同步本地文件（目录）和CVS服务器库中相应文件（目录）之间的差异，使本地相应文件是最新版本，另外Update也能执行获取文件旧版本的操作。5. 同步（Update）-将服务端文件更新到本地在对本地的文件修改前，最好先从服务端更新文件，因为多人操作同一个文件时，没有及时更新容易引起冲突。如甲乙检出的版本同为1.2，甲修改提交后的版本为1.3，乙此时没有更新，在本地1.2的基础上修改提交，CVS服务器此时不允许提交动作。同步（Update）的操作方法如下：点击选中文件（可多选），从右键菜单中选择“update selection”。出现提示窗口（如下图）后直接点击【确定】按钮命令，即可将服务端的最新文件更新到本地。此方法只适用更新此时所在的分支上的版本。l 模块级同步同步本地模块时，可选中本地模块，从右键菜单中选择“update selection”。出现提示窗口（如上图），选中后三项，点击【确定】按钮，则更新主干版本；若要更新分支版本，可继续在“update ptions”标签页中选中“Retrieve rev/tag/bran”选项，输入分支名称，点击【确定】按钮即可。 Update settings标签中选项的含义：l Reset any sticky date/tag/-k options ：不按本地模块所在的分支进行下载。如果不与“Update options”标签中的“Retrieve rev./tag/bran”输入框进行配合，下载的文件会按本地模块所在的分支进行下载。l Create mission directories that exist in the rev ：当下Check out 到本地后，其它开发人员对此模块又作了提交或删除文件的动作，选择此选项可下载这些错过的文件。Update options标签中选项的含义：l Before date ：按时间更新文件；l Retrieve rev./tag/bran ：按版本、tag、分支号更新文件；6. 文件提交修改 (Commit)从服务端checkout项目后，会在本地建立文件的拷贝，在客户端修改后提交（Commit）到服务端即可将最新的文件保存到服务端，如下图，修改后的文件显示为红色。此时的修改只修改了本地的文件，如果要提交到服务器端，点击选中被修改过的文件，从右键菜单中选择“commit selection”命令即可提交到服务器。提交之后，文件版本会自动加1。也可在提交时强制提交后的版本号，原则是在本分支中，版本号要比提交前的版本要大。可选择要提交的模块名称，如上图中选中“源代码”模块，从右键菜单中选择“commit selection”命令，提交时的选项如下图：此时可强制提升到1.5版本。在文档没有经过改动的情况下，也可使用此方法。注意：当提交单个未经改变的文档时，有时需选中“Force commit”选项。7. 删除文件1. 选中文件后，点击删除按钮，或菜单命令：“Modify Remove”,将文件从本地删除。2. 删除后，从右键菜单中选择commite selection命令，才能将服务端的文件删除。8. 找回被删除的文件1. 如果只是点击删除按钮删除文件，则点击添加按钮即可将文件找回。2. 如果已执行了提交操作，将文件从服务端删除，则应在本地建立一个同名的文件（若为文本文档，可为空），将文件添加并提交到服务器端。此时，可以找到丢失的文件，只不过会在原来被删除版本的基础上将本地的创建的文件升级一个版本。文件的历史版本仍然存在。3. 纯文本文档可实现历史版本覆盖当前版本，办法是合并（merge） 。4. 二进制格式文档实现历史版本覆盖当前版本，只能人为的增加内容之后，提交新版本。9. 添加目录到模块中1. 当加入一个不包含文件的空文件夹时首先下载要将文件夹添加入的模块，见操作“4、检出（checkout）文件”，再把要添加的目录加入本地CVS工作目录的此模块文件夹中（此操作在资源管理器中完成）。例如添加了一个文件夹NewFlod。选中此新加的文件夹，点击右上角的红色“添加”按钮，如下图所示：最后进行Commit（提交修改）操作即可。注意，此操作时在Perferences菜单中的Globals中 “prune（remove）empty directories”选项为未选中状态，否则提交动作失败。2. 当加入一个包含文件的非空文件夹时此项操作可以按上节的方法作，按上节的方法做时，首先应该加入目录，然后添加文件；也可参见“导入文件”一节中的“服务器端未建模块时”的操作，只是在添写的模块名称变为要提交的“模块名称”加上要添加的“目录名称”。如下图： 例如：我们准备在“源程序”模块中加入一个名为“NewF”的文件夹，则可以按照导入模块的方法加入。多作的工作只是执行“Import module”命令后出的的提示窗口（如下图）中的模块名称中要写成：要将文件夹加入的“模块名称/要添加的文件夹名”，即可。10. 删除模块中的目录先下载包含此目录的文件的模块。首先，在本地CVS工作目录中删除要删除的文件夹中的内容，使之变成空目录，然后在WinCvs中选中要删除的文件夹，在右键中选择”Commit Selection”并在弹出的窗口中选择“prune（remove）empty directories”选项，确认即可。11. 标签( Tag )操作在modify菜单下有create a tag onselection条目，可给文件创建tag。在create菜单下有create a tag by module，可对模块创建标签。创建分支跟tag一样，也在modify和create菜单下，只不过条目不同而已。具体步骤如下：首先选中要为其创建标签的文件或模块名，在modify菜单下有create a tag onselection条目，出现如下界面：在“New tag name”中输入标签名称(建立规则为CS_0.0.0001即CS_ + 公司版本号)，点击【确定】按钮，即创建标签成功；删除标签时，首先选中己创建过标签的文件或模块，然后选择modify菜单下有delete a tag 。12. 分支 ( Branch )版本操作Branch：分支是个很有用的概念，当我们在原来的版本基础上需要创建另外一个版本（项目）时，可创建一个分支，分支跟主版本可独立开发，又可以相互合并。如我们的双厂项目跟富厂基本上相同，可直接在双厂的基础上创建一个分支v_ds。双厂上有用的地方直接合并到富厂分支上。创建分支方法如下：首先选中要创建分支的文件或模块，选择菜单“modify” 中的“Create a branch”选项，出现如下界面：可在“New branch”中输入分支标识（建立规则为branch_jx即branch_ + 分支名），点击【确定】按钮。此时仅创建了分支版本，但并未在分支版本上工作，若要在分支版本上工作，则须将分支版本“checkout”到本地工作目录中。在cvs中，checkout或update某个tag或branch或revision是通过同一个界面选项，如下图，红色部分输入所要下载模块的tag号、branch标签或revision，点击【确定】按钮即可。13. 查看文件的状态1. 右键菜单中选择status selection可查看文件的当前状态，如下例其中，Sticky Tag 项可表示此文件所在的分支名称，或不在分支上。下例就是不在分支而在主干上，因为Sticky Tag 项为“none”。 =File: test.txt Status: Up-to-dateWorking revision: 1.4Repository revision: 1.4 /usr1/tt/test1/test.txt,vSticky Tag: (none)Sticky Date: (none)Sticky Options: (none)Existing Tags:v_zs (revision: 1.3)v_ds (branch: 1.1.4)v_xj (branch: 1.1.2)test (revision: 1.1)V2 (branch: 1.0.4)v1_2 (branch: 1.0.2)2. 右键菜单中选择log selection可查看文件的历史信息，包括修改者，修改时间等，如下例=Revision : 1.4Date : 2002/1/16 2:14:25Author : lixinState : ExpLines : +1 1Description :no mess