The RCS MINI-HOWTO <author> Robert Kiesling <date>$Id: RCS-HOWTO.sgml,v 1.4 1997/08/14 15:09:56 rak Exp rak $ <abstract> 这文件包涵 RCS基本的安装及使用法, RCS 是在 Linux 之下的 GNU 修订版本控制系统,这也包括 <tt>diff(1)</tt>和 <tt>diff3(1)</tt> 工具的安装 ,它对 RCS 的操作而言是必要的 .这文件可以是可以整个或者部分自由重制, ,这份文件的任何使用方法如同 一般的 Linux 文件计划的 HOWTO系列的版权宣告 .关於详细资料请看档案版权.送所有的 抱怨,建议,错误,和杂项目问题到 <htmlurl url="mailto:kiesling@terracom.net" name = "kiesling@terracom.net">, 使 我就可以尽可能保持这文件是最新且最完整. </abstract> <toc> <sect> RCS 全览. <p> RCS, 版本控制系统,是一套的程式它可以追踪 文件的改变和在有工作小组情形下可控制共享存取文件 .这是通常使用在维护原始码 模组.它也提供追踪它自己的文件档案的修订版本. RCS 由 Walter F. Tichy和 Paul Eggert 所写.最近 Linux 的 版是 RCS版本 5.7.有 也一个半官方的,分支的版本也可以用. 这份 HOWTO 之中的许多资料都是从 RCS man page 取得. RCS 包含 <tt>rcs(1)</tt>程式,它控制 RCS 档案合集 文件属性, <tt>ci(1)</tt>和 <tt>co(1)</tt>,它检查文件在 RCS 档案合集的进出, <tt>ident(1)</tt>,它藉由关键字辨识寻找 RCS 档案合集, <tt>rcsclean(1)</tt>,这个程式 没有人在其中工作或者没有改变的档案然後清除它, <tt>rcsdiff(1)</tt>,它执行 <tt>diff(1)</tt>比较 修订版本, <tt>rcsmerge(1),</tt>它合并两个 RCS 分支到一个 单一的工作档,和 <tt>rlog(1),</tt>它列印 RCS 记录讯息. 由 RCS 的收集档案可以是任何格式的纯文字,或是二进位元可执行档如果 <tt>diff</tt>程式使用来产生改变文件操纵 8-位元 数据.靠 <tt>ident(1)</tt>追踪有助於文件可以可选择地包括辨识的字串 .在修订版本之间 RCS 使用工具 <tt>diff(1)</tt>和 <tt>diff3(3)</tt> 产生改变文件 .一个 RCS档案合集由一个档案的最初的修订版本组成 ,它是版本 1.1,和一系列改变文件, 每一次修订版本就有一个.每一次从一档案合集中提出一个档案是使用 <tt>co(1)</tt>,编辑,和重新收入档案合集中使用 <tt>ci(1)</tt>,版本号码被增加,例如, 1.2, 1.3, 1.4,等等连续的修订版本. 档案合集他们本身一般在一个 <tt>./RCS</tt> 子目录,尽管 RCS 有别的选项针对档案合集存储的位置. 对於 RCS 做全览,看 <tt>rcsintro(1)</tt>手册页. <sect>系统需求. <p> RCS 需要 <tt>diff(1)</tt>和 <tt>diff3(3)</tt>在修订版本之间产生 上下文 diff 文件. 你的系统上需要装上 diff 工具程式套件 ,和当你安装 RCS,软体将会检查它的存在. 事先编译好的 diff 工具程式的二进位档可以在以下网址取得 <verb> ftp://sunsite.unc.edu/pub/Linux/utils/text/diffutils-2.6.bin.ELF.tar.gz </verb> 和它的镜像站台.如果你需要编译 <tt>diff(1)</tt>, et al.,从来源,它的位置是在 <verb> ftp://prep.ai.mit.edu/pub/gnu/diffutils-2.7.tar.gz </verb> 和它的镜像站台. 你将需要有 ELF libraries 安装在你的系统上 如果你要安装事先建好的二进位元档.看 ELF-HOWTO 有更多的详细资料. <sect>由原始档编译 RCS. <p> 取得 RCS版本 5.7 的来源套件.这可以在以下网址取得 <verb> ftp://sunsite.unc.edu/pub/Linux/devel/vc/rcs-5.7.src.tar.gz </verb> 和它的镜射站台.在你打开包装的档案合集之後到你的来源 树,你需要针对你的系统设定 RCS .在来源目录有程序档 <tt>configure</tt> 来完成它,这个首先你需要 执行它.这将要产生一个 <tt>Makefile</tt>和 适当的 <tt>conf.sh</tt>针对你的系统.你能够然後键入 <verb> make install </verb> 它将会建立二进位元可执行档.在一些地方你也许需要 <tt>su</tt> 改变身份成为 root 那麽二进位元可执行档就可以被装在正确的目录. <sect>建立和维护档案. <p> 程式 <tt>rcs(1)</tt> 做这个工作或者建立档案合集和 修改他们的属性. <tt>rcs(1)</tt>的选项总合可以在 <tt>rcs(1)</tt>说明页中找到. 最容易的方法是建立一个档案合集是首先 <tt>mkdir RCS</tt>在 现在目录,当时初始化档案合集使用 <verb> rcs -i name_of_work_file </verb> 命令.它使用这名称建立和收集档案 <tt>./RCS/name_of_work_file,v</tt>和要求一个文字讯息 描述这档案合集,但是这没有储存什麽修订版本在 档案合集中.你能够打开或者关掉严厉的档案锁住的使用以下的命令 <verb> rcs -L name_of_work_file </verb> 和 <verb> rcs -U name_of_work_file </verb> 各自地.有别的选项针对控制存取 档案合集,设定它的格式,和设定修订版本数目,这些包涵在 <tt>rcs(1)</tt>说明页中. <sect><tt>ci(1)</tt>和 <tt>co(1)</tt>. <p> <tt>ci(1)</tt>和 <tt>co(1)</tt>是命令被用来检查 他们的 RCS档案合集的文件进出. <tt>ci(1)</tt>命令 也可以使用在检查一个档案在一档案合集中的进与出.在 他们的最简单的形式, <tt>ci(1)</tt>和 <tt>co(1)</tt>拿唯一的名称的工作档案. <verb> ci name_of_work_file </verb> 和 <verb> co name_of_work_file </verb> The command form <verb> ci -l name_of_work_file </verb> 使用锁定属性启动检查档案,和 <verb> co -l name_of_work_file </verb> <em>是履行自动地.</em>即, <tt>ci -l</tt>检查 使用锁定启动重新检查档案提出. <verb> ci -u name_of_work_file </verb> 检查档案进入档案合集,重新再一次检查它的进外使用 锁住无效属性.在所有的案例中,使用者是由一个记录讯息提示. <tt>ci(1)</tt>如果没有已经存在一个档案它会建立一个 RCS 储存档案. 如果你没有详细说明一个修订版本, <tt>ci(1)</tt>在储存档案中增加 最後的修订版本锁定的版本号目,和附加 改订的工作档案到其中.如果你详细说明一个修订版本在一个 存在的分支,这必须是比已经存在的修订版本号码还高的. <tt>ci(1)</tt>将也创造一个新的分支如果你详细说明 没有存在的一个分支的修订版本.看 <tt>ci(1)</tt> 和 <tt>co(1)</tt> man pages(说明页) 有详细资料. <tt>ci(1)</tt>和 <tt>co(1)</tt>有不同的选项针对 和非互动的使用.再一次,看 <tt>ci(1)</tt>和 <tt>co(1)</tt> man pages(说明页) 有详细资料. <sect>修订版本的历史记录. <p> <tt>rlog(1)</tt>程式提供资料关於收集 档案和的各修订版本的记录储存在其中.命令如下 <verb> rlog work_file_name </verb> 将会列印档案的版本历史记录,各修订版的创造 日期和作者的 <tt>userids</tt>和是谁锁定那 档案.你可以详细说明档案合集的属性和修订版本参数来检视. <sect>在工作文件中包含 RCS 资料. <p> <tt>co(1)</tt>维修一份 RCS 资料库的关键字清单,它 是扩充的何时工作档案是领出.关键词 <tt>$Id$</tt> 在一个文件中将要扩大为一串字串它 包含档案名,修订版本号码,提领出来的日期, 作者,修订版本状态,和上锁人,如果有的话.包含 关键词 <tt>$Log$</tt> 将要扩大到文件的 修订版本历史记录. 这些和别的关键字也许是使用当做是 RCS 的档案合集的搜索条件 .看 <tt>ident(1)</tt>man page(说明页) 可以知道进一步的细节. <sect>RCS和 <tt>emacs(1)</tt>版本控制. <p> <tt>emacs(1)</tt>的版本控制便利性可用作是 RCS 的前端 .这资料运用特别地针对版本 19.34 的 GNU Emacs,在主要 Linux distributions 中有提供.当 使用<tt>emacs(1)</tt>编辑一个档案 它是使用 RCS 注册, 命令 <tt>vc-toggle-read-only</tt> (预设使用 <tt>C-x C-q</tt> )将会检查一个档案在 emacs 的版本控制中,然後 进入 RCS 中. Emacs 将会打开一个缓冲区在哪里你能够键入一个记录讯息 是被包含在 RCS 记录中.当你是完结了的键入一个记录 栏位,键入 <tt>C-c C-c</tt>结束你的输入和执行 登录的程序. 如果你有选择用 RCS 严厉的锁住档案,你必须 重新打开锁定的档案来编辑靠 <tt>emacs(1)</tt>.你可以提 出档案用 emacs 版本控制使用那指令 <tt>%</tt> 在 buffer-menu 模式下. 更多资料,请看 GNU Emacs 手册和 Emacs info (信息)页. </article>