wincvs操作使用说明

WINCVS用户手册编写：相伟版本号：4黑龙江傲立信息产业有限企业

目录TOC\o"1-3"\h\z1. 环境规定 22. wincvs界面与基本设置 23. 登录CVS服务器 44. 导入文献（Import）与检出文献（Checkout） 65. 同步（Update）--将服务端文献更新到当地 156. 文献提交修改(Commit) 177. 删除文献 188. 找回被删除的文献 199. 添加目录到模块中 1910. 删除模块中的目录 2011. 标签(Tag)操作 2112. 分支(Branch)版本操作 2113. 查看文献的状态 2214. 需求要尤其注意的事项 2415. 创立分支的注意事项 24

CVS（ConcurrentVersionSystem）版本控制系统是一种GNU软件包，重要用于在多人开发环境下的源码的维护。实际上CVS可以维护任意文档的开发和使用，例如共享文献的编辑修改，而不仅仅局限于程序设计。CVS维护的文献类型可以是文本类型也可以是二进制类型。CVS用Copy-Modify-Merge（拷贝、修改、合并）变化表支持对文献的同步访问和修改。它明确地将源文献的存储和顾客的工作空间独立开来，并使其并行操作。CVS基于客户端/服务器的行为使其可容纳多种顾客，构成网络也很以便。这一特性使得CVS成为位于不一样地点的人同步处理数据文献（尤其是程序的源代码）时的首选。所有重要的软件项目都可以使用CVS作为其程序员之间的中心点，以便可以综合各程序员的改善和更改。CVS的基本工作思绪是这样的：在一台服务器上建立一种源代码库，库里可以寄存许多不一样项目的源程序。由源代码库管理员统一管理这些源程序。每个顾客在使用源代码库之前，首先要把源代码库里的项目文献下载到当地，然后顾客可以在当地任意修改，最终用winCVS的Commit(提交修改)功能进行提交，由CVS源代码库统一管理修改。这样，就好象只有一种人在修改文献同样，既防止了冲突，又可以做到跟踪文献变化等。下面将详细阐明该系统的操作使用措施。环境规定CPU：P3-450以上、内存>64M、8M以上显卡、自由硬盘空间不小于2G。操作系统：Windows操作系统（pack2/pack3）。WNCVS：\\websrv\software\winCVS1.3.11\wincvs1.3.11.1beta11.exewincvs界面与基本设置安装好wincvs后，启动该系统，可以看到如下图的操作界面：目前需要进行基本配置。配置环节如下：点击菜单Admin->login，弹出的窗口如下所示:

Authenticatio：pserver（认证方式，这里选择的是PC机连接服务器）；Path：输入CVS服务器上配置的途径，即“数据库根”；Hostaddress：输入CVS服务器端的IP地址或主机名；Username：输入自己在CVS服务器上的顾客名；选择此窗口的Globals标签；注意"checkoutread-only"选项，表达“检出时文献只读”（提议选中此项）。注意"prune（remove）emptydirectories"选项，表达“自动删掉空目录”。

点击【确定】按钮，配置完毕。企业服务器数据库根、CVS服务器IP及主机名由配置管理员告知。登录CVS服务器配置完后，开始登陆CVS服务器端，登陆过程如下：点击菜单Admin->login，弹出的窗口如下所示:

点击【确定】按钮，出现选择当地工作目录窗口（提议选择一种空目录）；例如选择：“D:\CVS”选择目录之后，点击【确定】按钮，会弹出如下所示窗口：

输入顾客口令之后，点击【OK】按钮，出现界面如下：

查看上图所示红色圈选部分，假如提醒为“cvsexitednormallywithcode0”接下来就是系统的详细使用了，它的工作流程如下图：图中名词定义：导入(Import):将当地原始工作目录中的文献或文献夹导入到CVS的仓库中。检出(Checkout):将自己或其他人员上传到CVS仓库中的文献或文献夹下载到当地的一种工作目录中（服务器端已经有对应模块）。提交(Commit):将当地作完修改后的文献提交到CVS的仓库中。同步(Update):将CVS仓库中最新的修改后文献下载到当地工作目录中。导入文献（Import）与检出文献（Checkout）将当地文献导入到服务器端对应的“数据库根”中的模块中。若服务器端没有建立对应的模块，则需自己导入模块；若服务器端己建立好模块，则直接导入文献即可。服务器端未建模块时，操作环节如下：

如图：选择放置模块（项目）的目录，即当地工作目录，如下图选择：“D:\CVS”为当地工作目录:

设置好当地工作目录后，首先在资源管理器中将要导入到服务器端的模块及模块下的文献拷贝到当地工作目录中，回到CVS界面，如下图所示:

选中模块名，例如下图中的“源代码”，然后选择菜单“Create->Importmodule...”选项，出现如下界面：

Wincvs会自动检测所添加的目录中的文献类型，提成两类：binary和TEXT类，并祈求确认点击【Continue】按钮，出现如下界面：

在“Enterthelogmessage”中输入“注释”信息，点击【确定】按钮看到如下图所示提醒，显示“CVSexitednormallywithcode0”，即操作成功，将当地文献导入到服务端后，当地并没有跟服务端建立联络。如要建立联络，必须再将模块从服务端检出（checkout）才行服务器端己建好模块时（企业服务器，配置管理员己建好对应模块），操作环节如下：

按如下图所示红色圈选的按钮，选择放置模块（项目）的目录，即当地工作目录。下图例中选择了：“D:\CVS”作为当地的工作目录：

按此按钮选择当地工作目录点击菜单Create－>checkoutmodule，输入模块名即可，例如：输入模块名为“源代码”：

按此按钮选择当地工作目录此时要注意，假如服务器端的模块是空的，即模块里没有文献（如初始配置管理员建立模块时，模块是空的），则必须在Globals标签上将"prune（remove）emptydirectories"选项去掉，如下图所示：

点击【确定】按钮，即将服务器端的模块下载到当地了。可以左边“Modules”中看到目前目录中，下载的模块名为“源代码”的目录，源代码的文献夹显示前有黑色箭头显示，表明其是CVS模块。

在资源管理器中将文献拷入当地工作目录中，然后回到WINCVS操作界面，点右上角的刷新按钮，可看到如下图所示界面：

先选中文献，然后点击"添加按钮"。出现如下图所示界面：注意此处有三个按钮，第一种添加一般的文献；第二个添加二进制文献，如图片文献；第三个添加采用双字节对字符进行编码的文献。（除.txt文档可以第一种按钮外，其他均用第二个按纽，提议所有用第二个按钮添加）

点击【Ignore】按钮，出现如下界面：

Commit（提交修改） 添加后的文献显示为红色，其属性“Rev”中显示“0”，即文献己添加到当地工作目录中，然后保持选中状态，右键选择“Commitselection...”则会出现如下所示界面：

在“Enterthelogmessage”中输入注释信息(这里一般输入的是软件在企业的版本号)，点击【确定】按钮，则界面如下所示：

此时文献己提交到服务器端，默认版本号为“1.1”，即初始版本（注：初次提交文献时，一定要有初始版本，即每个文献都应有1.1版本。）同步（Update） 同步的操作：使用鼠标选择一种目录或者一种文献，也可选择多种，使用下面三种等效操作即可：1)菜单:Modify->Update2)快捷键：Ctrl+U3)点击Update工具按钮，如下图所示点击该选项后，出现下面界面使用后三项，更新服务器上最新版本的文献，若要按rev版本（tag标签、branch分支）更新则使用输入对应版本号（标签、分支），则更新到当地的文献与输入的版本相似，而不是服务器上的最新版本。好习惯“先同步后工作”。每次使用WinCvs开始工作前，应当先Update一次，这样我们就能在文献的最新版本上工作。Update与Checkout之间的区别Checkout是把CVS服务器上的module下载到当地进行工作。Update重要同步当地文献（目录）和CVS服务器库中对应文献（目录）之间的差异，使当地对应文献是最新版本，此外Update也能执行获取文献旧版本的操作。同步（Update）--将服务端文献更新到当地在对当地的文献修改前，最佳先从服务端更新文献，由于多人操作同一种文献时，没有及时更新轻易引起冲突。如甲乙检出的版本同为1.2，甲修改提交后的版本为1.3，乙此时没有更新，在当地1.2的基础上修改提交，CVS服务器此时不容许提交动作。同步（Update）的操作措施如下：点击选中文献（可多选），从右键菜单中选择“updateselection”。出现提醒窗口（如下图）后直接点击【确定】按钮命令，即可将服务端的最新文献更新到当地。此措施只合用更新此时所在的分支上的版本。模块级同步同步当地模块时，可选中当地模块，从右键菜单中选择“updateselection”。出现提醒窗口（如上图），选中后三项，点击【确定】按钮，则更新主干版本；若要更新分支版本，可继续在“updateptions”标签页中选中“Retrieverev/tag/bran”选项，输入分支名称，点击【确定】按钮即可。Updatesettings标签中选项的含义：Resetanystickydate/tag/’-k’options：不按当地模块所在的分支进行下载。假如不与“Updateoptions”标签中的“Retrieverev./tag/bran”输入框进行配合，下载的文献会按当地模块所在的分支进行下载。Createmissiondirectoriesthatexistintherev：当下Checkout到当地后，其他开发人员对此模块又作了提交或删除文献的动作，选择此选项可下载这些错过的文献。Updateoptions标签中选项的含义：Beforedate：准时间更新文献；Retrieverev./tag/bran：按版本、tag、分支号更新文献；文献提交修改(Commit)从服务端checkout项目后，会在当地建立文献的拷贝，在客户端修改后提交（Commit）到服务端即可将最新的文献保留到服务端，如下图，修改后的文献显示为红色。 此时的修改只修改了当地的文献，假如要提交到服务器端，点击选中被修改正的文献，从右键菜单中选择“commitselection”命令即可提交到服务器。提交之后，文献版本会自动加1。也可在提交时强制提交后的版本号，原则是在本分支中，版本号要比提交前的版本要大。可选择要提交的模块名称，如上图中选中“源代码”模块，从右键菜单中选择“commitselection”命令，提交时的选项如下图：此时可强制提高到1.5版本。在文档没有通过改动的状况下，也可使用此措施。注意：当提交单个未经变化的文档时，有时需选中“Forcecommit”选项。删除文献选中文献后，点击删除按钮，或菜单命令：“Modify→Remove”,将文献从当地删除。删除后，从右键菜单中选择"commiteselection"命令，才能将服务端的文献删除。

找回被删除的文献假如只是点击删除按钮删除文献，则点击添加按钮即可将文献找回。假如已执行了提交操作，将文献从服务端删除，则应在当地建立一种同名的文献（若为文本文档，可为空），将文献添加并提交到服务器端。此时，可以找到丢失的文献，只不过会在本来被删除版本的基础上将当地的创立的文献升级一种版本。文献的历史版本仍然存在。纯文本文档可实现历史版本覆盖目前版本，措施是合并（merge）。二进制格式文档实现历史版本覆盖目前版本，只能人为的增长内容之后，提交新版本。添加目录到模块中当加入一种不包括文献的空文献夹时首先下载要将文献夹添加入的模块，见操作“4、检出（checkout）文献”，再把要添加的目录加入当地CVS工作目录的此模块文献夹中（此操作在资源管理器中完毕）。例如添加了一种文献夹NewFlod。选中此新加的文献夹，点击右上角的红色“添加”按钮，如下图所示：最终进行Commit（提交修改）操作即可。注意，此操作时在Perferences菜单中的Globals中“prune（remove）emptydirectories”选项为未选中状态，否则提交动作失败。当加入一种包括文献的非空文献夹时此项操作可以按上节的措施作，按上节的措施做时，首先应当加入目录，然后添加文献；也可参见“导入文献”一节中的“服务器端未建模块时”的操作，只是在添写的模块名称变为要提交的“模块名称”加上要添加的“目录名称”。如下图：例如：我们准备在“源程序”模块中加入一种名为“NewF”的文献夹，则可以按照导入模块的措施加入。多作的工作只是执行“Importmodule”命令后出的的提醒窗口（如下图）中的模块名称中要写成：要将文献夹加入的“模块名称/要添加的文献夹名”，即可。删除模块中的目录先下载包括此目录的文献的模块。首先，在当地CVS工作目录中删除要删除的文献夹中的内容，使之变成空目录，然后在WinCvs中选中要删除的文献夹，在右键中选择”CommitSelection”并在弹出的窗口中选择“prune（remove）emptydirectories”选项，确认即可。标签(Tag)操作在modify菜单下有"createatagonselection"条目，可给文献创立tag。在create菜单下有"createatagbymodule"，可对模块创立标签。创立分支跟tag同样，也在modify和create菜单下，只不过条目不一样而已。详细环节如下：首先选中要为其创立标签的文献或模块名，在modify菜单下有"createatagonselection"条目，出现如下界面：在“Newtagname”中输入标签名称(建立规则为CS_0.0.0001即CS_+企业版本号)，点击【确定】按钮，即创立标签成功；删除标签时，首先选中己创立过标签的文献或模块，然后选择modify菜单下有"deleteatag"。分支(Branch)版本操作Branch：分支是个很有用的概念，当我们在本来的版本基础上需要创立此外一种版本（项目）时，可创立一种分支，分支跟主版本可独立开发，又可以互相合并。如我们的双厂项目跟富厂基本上相似，可直接在双厂的基础上创立一种分支v_ds。双厂上有用的地方直接合并到富厂分支上。创立分支措施如下：首先选中要创立分支的文献或模块，选择菜单“modify”中的“Createabranch”选项，出现如下界面：可在“Newbranch”中输入分支标识（建立规则为branch_jx即branch_+分支名），点击【确定】按钮。此时仅创立了分支版本，但并未在分支版本上工作，若要在分支版本上工作，则须将分支版本“checkout”到当地工作目录中。在cvs中，checkout或update某个tag或branch或revision是通过同一种界面选项，如下图，红色部分输入所要下载模块的tag号、branch标签或revision，点击【确定】按钮即可。查看文献的状态右键菜单中选择"statusselection"可查看文献的目前状态，如下例其中，StickyTag项可表达此文献所在的分支名称，或不在分支上。下例就是不在分支而在主干上，由于StickyTag项为“none”。

===============================================================

File:test.txtStatus:Up-to-date

Workingrevision:1.4

Repositoryrevision:1.4/usr1/tt/test1/test.txt,v

StickyTag:(none)

StickyDate:(none)

StickyOptions:(none)

ExistingTags:

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)右键菜单中选择"logselection"可查看文献的历史信息，包括修改者，修改时间等，如下例

===============================================================

Revision:1.4

Date:/1/162:14:25

Author:'lixin'

State:'Exp'

Li