CVS 并发版本控制系统 (CVS) 提供了一个框架,使多个用户可以修改相同的一组文件。可以想象,如果用户们在同一个目录中修改文件,将产生极大的混乱。使用 CVS,用户们就可以安全地修改相同的一组文件了。CVS 保留文件的主备份,并且在一个中央仓库中记录谁在何时修改了哪些内容。如果出现了冲突,CVS 可以告诉用户。CVS 通常用在程序员间共享代码,但是在文档撰写中也很方便。 cvs
CVS 如何运作 cvs CVS 如何运作 cvs 概述 多数情况下,构成项目的文件集在 CVS 服务器上保存为 module(模块)。 在使用 CVS 时,先将模块 checkout(检出)一份到本地文件系统中。修改一个或多个文件后,将它们 commit(提交)回中央 CVS 服务器。 使用 CVS 时,不必获取许可或加锁就可以修改文件。CVS 的名字中,concurrent(并发)这个词来源于它允许不同的人编辑同一文件的不同部分这一能力。只要这些修改不重叠,CVS 就可以正确地记录修改。如果出现重复的修改,会被标识在文件中,作者必须自行解决它们。 在提交修改时,只有服务器知道的文件才会得到提交。也就是说,如果您在本地工作目录中创建了一个文件,新文件不会自动传输到服务器。您必须 add(添加)文件到仓库中,然后再提交它。如果您要删除一个文件,必须说明要从 CVS 服务器的仓库中删除文件,然后将文件的删除提交。 执行这些动作的命令请参阅 从上次您从 CVS 获取文件,到打算提交某个修改,这段时间里如果有人修改过这个文件,CVS 将尝试将修改合并到 CVS 服务器上的复本中。如果您与他人修改的是文件的不同部分,提交也许不会有任何 conflict(冲突)问题。如果他人修改的正是您打算提交的部分,您将看到发生冲突的提示。这时,您必须 update(更新)文件。在修改文件前总是更新它是个好习惯。请参考 中解决冲突的步骤。
为 CVS 作准备 cvs 为 cvs 作准备 在使用 CVS 之前,您必须在 CVS 服务器上建立帐户。得到帐户后,就不必再执行这些操作了。
CVS 是否已安装在系统中 cvs RPM 方式安装 您必须安装 CVSRPM。可以这样检查是否已经安装: $ rpm -q cvs 如果您看到了类似 cvs-1.11.19-1 的输出,那么已经安装了。如果看到类似 package cvs is not installed 的输出,这意味着您需要安装它。如果您不知道怎么安装,请向管理员求助。
生成 SSH 密钥 OpenSSH 认证密钥 CVS 服务器使用 SSH 2 协议密钥来认证用户。因此,您需要生成一对密钥,才能得到 CVS 帐号。如果您已经有了 SSH DSA 密钥,就可以跳过这一步。 技巧 如果系统中有 ~/.ssh/id_dsa.pub 这个文件,那么您已经有了 DSA 密钥。 如果现有的 DSA 密钥不需要 passphrase(口令),您最好尽快生成一个需要口令的密钥。 按照下列步骤来生成 SSH 2 协议使用的 DSA 密钥。这是 cvs.fedora.redhat.com CVS 帐号必需的。 OpenSSH ssh-keygen ssh-keygen 要生成 SSH2 协议的 DSA 密钥,在 shell 提示符下,输入命令: $ ssh-keygen -t dsa 接受默认的文件位置 ~/.ssh/id_dsa。您应当使用口令来加强密钥的安全。输入与帐号密码不同的口令,然后确认它,只要重新输入一次。 输入下列命令,将新的密钥复制到正确的文件中: $ cat ~/.ssh/id_dsa.pub>>~/.ssh/authorized_keys 在按下 ENTER(回车)键之前仔细检查命令。如果 ~/.ssh/authorized_keys 已经存在, ~/.ssh/id_dsa.pub 的内容将被追加到 ~/.ssh/authorized_keys 文件的结尾。 输入下列命令,修改 ~/.ssh 目录和密钥文件的权限: $ chmod 755 ~/.ssh $ chmod 644 ~/.ssh/authorized_keys 技巧 您可以让系统记住口令,这样访问 CVS 服务器时就不必每次输入了。请参考 ssh-add 程序的文档。
配置 CVS 访问 cvs 配置 cvs 访问 cvs CVSROOT cvs CVS_RSH CVSROOT CVS_RSH cvs .cvsrc .cvsrc
避免重复输入 cvs 避免重复输入 许多 CVS 命令需要特定的命令行选项才能搭配使用。与其每次用到时输入这些选项,您可以将它们保存在文件里,让 CVS 每次执行前读取它。 在个人目录中创建一个叫做 ~/.cvsrc 的文件。它应当包含下列命令,每个命令占一行: cvs -z3 diff -uNp rdiff -uNp update -dP
配置只读的 CVS 访问 cvs 配置只读访问 cvs 匿名访问 如果您的目的是下载各篇 &FC; 文档并在自己的系统中编译,那么只读访问就够了。照做本节的指令,然后直接跳转到 切换到将存放 CVS 中文件的目录,然后执行下面的命令: $ export CVSROOT=:pserver:cvs.fedora.redhat.com:/cvs/docs $ cvs login $ cvs checkout docs-common module-name $ cvs checkout module-name $ cd module-name 检出模块之后,CVSROOT 环境变量的设置就不再有用,因为正确的值已经保存在了本地工作目录的每个子目录中,文件 CVS/Root 里面。只要当前工作目录包含 CVS/ 目录,CVS 程序就可以自动找到 &FC; 仓库。
配置可读写的 CVS 访问 cvs 配置读写访问 cvs 作为作者的设置 要创作新文档,或是修改已有的,必须得到 &FC; Docs CVS 仓库的完整读写权限。关于这个过程,请参考 http://fedoraproject.org/wiki/DocsProject/NewWriters 页面。下面是大致的步骤: 订阅 fedora-docs-list 邮件列表,这是项目主要的讨论区。 创建一个 GNU Privacy Guard (GPG) 密钥来向其他人标识自己的身份。 注册 Bugzilla 帐号,如果以前没有注册过的话。Bugzilla 是跟踪问题、修改和项目更新的途径。 向邮件列表发出 self introduction(自我介绍)。 当您的 自我介绍 被接受后,您将获得 CVS 访问权。 每位作者,也包括您,在自我介绍被接纳之后,就使用独一无二的 $CVSROOT 来访问 CVS 仓库: $ export CVSROOT=:ext: yourname @cvs.fedora.redhat.com:/cvs/docs $ export CVS_RSH=/usr/bin/ssh 设置了 $CVSROOT$CVS_RSH 环境变量后,就可以访问仓库了: $ cvs co -c 您将被提示输入 SSH 密钥的口令。按下 ENTER 可以看到仓库中已有模块的列表。
基本的 CVS 命令 cvs 命令 配置好系统的 CVS 访问之后,检出要处理的模块。 技巧 关于是否需要设置 $CVSROOT 环境变量,或命令行选项 repository,应当看当前工作目录是否有一个 CVS/ 子目录。 如果有 CVS/ 子目录,CVS 忽略任何 $CVSROOT 命令行选项设置。
检出模块 cvs 检出模块 您只需检出模块一次。当一个模块检出到本地之后,它就一直在那儿了。 要检出一个模块,执行下面的命令: $ cvs co <module-name> 例如,要检出 example-tutorial 模块,先进入工作目录,然后执行下面的命令: $ cvs co example-tutorial 当前目录下将新建一个名字是 example-tutorial/ 的子目录。 如果检出模块时没有指定分支名称,默认就是 CVS 中模块的 HEAD 分支。
检出模块的分支 cvs 检出模块 检出分支 可以将 CVS 分支视为一篇手册的某个版本,或是一个文件的不同版本。 要检出模块的分支,运行下面的命令: $ cvs co <directory> <branchname> <module-name> 将创建名为 <directory> 的目录, 模块 <module-name><branchname> 分支的文件将被复制到这个目录中。 例如,要检出 mymodule 模块的 BRANCH-VERSION-1.2 分支,运行命令: $ cvs co -d mymodule-1.2 -r BRANCH-VERSION-1.2 mymodule 模块的 BRANCH-VERSION-1.2 分支将被检出到 mymodule-1.2 目录中。 要查看文件有哪些分支和标记,运行命令: $ cvs status <filename> 例如,文件 foo.sgml 的状态如下: =================================================================== File: foo.sgml Status: Up-to-date Working revision: 1.47 Repository revision: 1.47 /cvs/docs/custom-guide/rhl-cg-en.sgml,v Sticky Tag: (none) Sticky Date: (none) Sticky Options: (none) Existing Tags: BRANCH-VERSION-1.2 (branch: 1.25.2) 只有在 Existing Tags(现有标记)中显示为"分支"的标记才可以作为分支检出。
更新文件 cvs 更新文件 要获取模块中文件的最新版本,切换到包含模块文件的目录,执行命令: $ cvs update 模块所有文件的最新版本将下载到本地。如果您看到了文件冲突提示,请参考
提交文件 cvs 提交文件 在本地修改模块的文件之后,将它们提交,以在 CVS 服务器上保存更改: $ cvs commit "some log message" filename 如果您想用喜欢的文本编辑器来撰写日志信息,并且已经定义了 $VISUAL 或 $EDITOR 环境变量,就可以忽略 -m "some log message"。编辑缓冲区中会包含一些描述修改的注释,您在添加自己的文字时,不必删掉它们。 日志信息应当尽可能有描述性,这样您和共同作者都可以了解做过了哪些修改。如果日志消息是 updated some files(更新了一些文件),那它无法描述修改了什么,将来对您毫无用处。如果您修正了一个错误,应当包含 Bugzilla 引用。 <filename> 可以是一个文件名,一系列以空格分隔的文件名,或者一组以通配符指定的文件名,类似 *.pngfoo-*.sgml 如果在 commit 命令中没有给出文件名或通配符,所有修改都会被提交到服务器。这个命令是递归的,模块中任何子目录的修改也都会被提交。不带文件名执行 commit 命令时要小心,因为您可能不记得改过了什么。 如果您看到了文件冲突,请参考
添加文件 cvs 添加文件 要向模块添加文件,在本地目录中创建这个文件,然后执行下面的命令: $ cvs add file-to-add 添加文件之后,必须 commit(提交)添加的文件到服务器: $ cvs commit "some log message" file-to-add
管理二进制文件 cvs 二进制文件 通常存档的文件是简单的文本文件,但是有时也会存档二进制文件。CVS 程序可以识别大多数文件扩展名,类似 .png.jpg,这样就不会做坏事。 当文件被检出时,cvs 扫描它,查找特殊的关键字,类似 "$id:$",然后替换为相应的值, 例如版本号。 关键字替换通常会损坏二进制文件,因此如果 CVS 无法正确识别文件为二进制文件,必须关闭替换。标识文件为二进制就关闭了关键字替换,输入命令: $ cvs filename 注意在使用 命令前,文件必须已被检入 CVS 仓库。这样不会出错,因为关键字扩展是在文件被检出并复制到本地目录时进行的,而不是提交到仓库中的时候。 恢复二进制文件 如果您将二进制文件检入仓库,发现它在检出时被损坏了,不要心急。只要运行上面的 命令,再删掉本地文件,然后再次检出就可以了。
删除文件 cvs 删除文件 如果模块不再需要某个文件,使用 remove 命令来删除它,然后用 commit 命令将删除提交到服务器。即使模块的当前版本删除了某个文件,这个文件的副本还会被保留在服务器上,可以随时用 add 命令恢复。 $ cvs rm -f file-to-remove 删除文件后,必须 commit(提交)删除: $ cvs commit "some log message" file-to-remove 在用 commit 命令提交删除时不能使用通配符。必须明确地指定文件名。 如果需要重命名某个文件,最好在 CVS 服务器上重命名它,这样文件的历史可以保留下来。如果需要重命名文件,就向 cvsdocs-administrator@fedora.redhat.com 发送一封邮件,写明要重命名的文件。
文件的状态 cvs 文件的状态 有时需要查看模块中文件的 status(状态)。执行命令: $ cvs status filename 仓库文件的状态报告如下所示: Up-to-date 您的文件版本正是 CVS 服务器上的最新版本。 Locally Modified 您已从服务器上更新了最新的版本,并且做了修改。 Locally Added 您使用 cvs add 命令添加了文件,但是尚未提交文件的添加。 Locally Removed 您使用 cvs remove 命令删除了文件,但是尚未提交文件的删除。 Needs Checkout 服务器上有新版本的文件,您需要更新。尽管状态中说,需要检出,实际的意思是,您需要用 cvs update 命令更新文件。 Needs Patch 本地文件需要打补丁以更新到服务器的最新版。执行 cvs update 命令来解决。 Needs Merge 服务器上有更新的版本,您的本地版本却做了未提交的修改。这种情况可能经常发生,如果您没有获取最新版本就进行修改的话。 File had conflicts on merge 类似 Needs Merge,但是当您执行 cvs update 命令时,将无法自动解决冲突。关于如何解决冲突请参考 Unknown CVS 服务器不知道文件的任何信息。它没有被本地添加或删除,也从未提交到服务器上。这种情况通常发生在不应被提交到 CVS 服务器的文件上,例如 generated-index.sgml,或者是想添加到仓库但尚未执行 cvs add 命令的文件。
解决冲突 cvs 解决冲突 如果您修改了一个文件,而另一个人修改了同样的区域并且先提交了,您在提交文件或更新本地目录时就会看到类似下面的消息: RCS file: /cvs/docs/module-name/filename.sgml,v retrieving revision 1.12 retrieving revision 1.13 Merging differences between 1.12 and 1.13 into filename.sgml rcsmerge: warning: conflicts during merge cvs server: conflicts found in filename.sgml C filename.sgml 要解决冲突,打开文件,搜索 <<<<<<< 然后判断哪个版本才是正确的。例如: <para> Some sentence. <<<<<<< filename.sgml A sentence that was changed in the working copy. ======= A same sentence that was changed differently and committed. >>>>>>> 1.13 </para> <<<<<<<======= 之间的内容是工作目录里原有的。 =======>>>>>>> 之间是服务器上的内容。 修改文件,解决冲突,然后提交它。
小结 cvs 命令 小结 所有命令都假定您的当前目录是正确的。 基本的 CVS 命令 命令 描述 cvs checkout <module-name>cvs co <module-name> 创建一个名为 <module-name> 的目录, 将模块内容放在目录中 cvs co -d <directory> -r <branchname><module-name> 创建 <directory> 目录,将 <module-name> 模块的 <branchname> 分支放在目录中。 cvs updatecvs up 从服务器将文件更新到最新版 cvs add <filename> 将文件 "filename" 添加到 CVS 服务器 cvs commit -m "My message" <filename> 将本地计算机上的文件 <filename> 提交为最新版 cvs log <filename> 查看文件 <filename> 的提交信息 cvs status <filename> 查看文件的状态,类似 Locally Modified cvs status -v <filename> 查看文件现有的标签和分支 cvs diff <filename> 查看文件的工作版本与分支中的最新版本的不同之处 cvs diff -r1.1 -r1.2 <filename> 查看文件 1.1 和 1.2 版本的不同之处
请阅读系统中的 CVS 手册来获取更多信息,位置是 /usr/share/doc/cvs-<version-number>/cvs.ps (CVS 版本可能有所不同)。还可以访问 CVS 主页,位置是 http://www.cvshome.org/ 技巧 由于 CVS 使用 ssh 来连接 CVS 服务器,在发出 CVS 请求前,您将被提示输入密码。如果您打算配置一下,省去输入密码的步骤,请参考 &RH; Linux 9 Customization Guide(定制指南)中使用 ssh-agent 的细节。