<!--
     The FreeBSD Documentation Project
     The FreeBSD Chinese Documentation Project

     Original Revision: 1.381
     $FreeBSD$
-->

<appendix id="mirrors">
  <title>获取 FreeBSD</title>

  <sect1 id="mirrors-cdrom">
    <title>CDROM 和 DVD 发行商</title>

    <sect2>
      <title>零售盒装产品</title>

      <para>可以从下面几个零售商那里买到 FreeBSD 的盒装产品(FreeBSD CD，
	附加软件，印刷文档)：</para>

      <itemizedlist>
	<listitem>
	  <address>
	    <otheraddr>CompUSA</otheraddr>
	    WWW: <otheraddr><ulink url="http://www.compusa.com/"></ulink></otheraddr>
	  </address>
	</listitem>

	<listitem>
	  <address>
	    <otheraddr>Frys Electronics</otheraddr>
	    WWW: <otheraddr><ulink url="http://www.frys.com/"></ulink></otheraddr>
	  </address>
	</listitem>
      </itemizedlist>
    </sect2>

    <sect2>
      <title>CD 和 DVD 光盘</title>

      <para>FreeBSD CD 和 DVD 光盘可以从许多在线零售商那里买到：</para>

    <itemizedlist>
      <listitem>
        <address>
	  <otheraddr>BSD Mall by Daemon News</otheraddr>
	  <street>PO Box 161</street>
	  <city>Nauvoo</city>, <state>IL</state> <postcode>62354</postcode>
	  <country>USA</country>
	  Phone: <phone>+1 866 273-6255</phone>
	  Fax: <fax>+1 217 453-9956</fax>
	  Email: <email>sales@bsdmall.com</email>
	  WWW: <otheraddr><ulink url="http://www.bsdmall.com/freebsd1.html"></ulink></otheraddr>
        </address>
      </listitem>

      <listitem>
        <address>
	  <otheraddr>BSD-Systems</otheraddr>
	  Email: <email>info@bsd-systems.co.uk</email>
	  WWW: <otheraddr><ulink url="http://www.bsd-systems.co.uk"></ulink></otheraddr>
        </address>
      </listitem>

      <listitem>
        <address>
	  <otheraddr>fastdiscs.com</otheraddr>
	  <street>6 Eltham Close</street>
	  <city>Leeds</city>, <postcode>LS6 2TY</postcode>
	  <country>United Kingdom</country>
	  Phone: <phone>+44 870 1995 171</phone>
	  Email: <email>sales@fastdiscs.com</email>
	  WWW: <otheraddr><ulink url="http://fastdiscs.com/freebsd/"></ulink></otheraddr>
        </address>
      </listitem>

      <listitem>
        <address>
	  <otheraddr>FreeBSD Mall, Inc.</otheraddr>
	  <street>3623 Sanford Street</street>
	  <city>Concord</city>, <state>CA</state>  <postcode>94520-1405</postcode>
	  <country>USA</country>
	  Phone: <phone>+1 925 674-0783</phone>
	  Fax: <fax>+1 925 674-0821</fax>
	  Email: <email>info@freebsdmall.com</email>
	  WWW: <otheraddr><ulink url="http://www.freebsdmall.com/"></ulink></otheraddr>
        </address>
      </listitem>

      <listitem>
        <address>
	  <otheraddr>FreeBSD Services Ltd</otheraddr>
	  <street>11 Lapwing Close</street>
	  <city>Bicester</city>
	  <postcode>OX26 6XR</postcode>
	  <country>United Kingdom</country>
	  WWW: <otheraddr><ulink url="http://www.freebsd-services.com/"></ulink></otheraddr>
        </address>
      </listitem>

      <listitem>
	<address>
	  <otheraddr>Hinner EDV</otheraddr>
	  <street>St. Augustinus-Str. 10</street>
	  <postcode>D-81825</postcode> <city>M&uuml;nchen</city>
	  <country>Germany</country>
	  Phone: <phone>(089) 428 419</phone>
	  WWW: <otheraddr><ulink url="http://www.hinner.de/linux/freebsd.html"></ulink></otheraddr>
        </address>
      </listitem>

      <listitem>
	<address>
	  <otheraddr>Ikarios</otheraddr>
	  <street>22-24 rue Voltaire</street>
	  <postcode>92000</postcode> <city>Nanterre</city>
	  <country>France</country>
	  WWW: <otheraddr><ulink url="http://ikarios.com/form/#freebsd"></ulink></otheraddr>
        </address>
      </listitem>

      <listitem>
	<address>
	  <otheraddr>JMC Software</otheraddr>
	  <country>Ireland</country>
	  Phone: <phone>353 1 6291282</phone>
	  WWW: <otheraddr><ulink url="http://www.thelinuxmall.com"></ulink></otheraddr>
	</address>
      </listitem>

      <listitem>
	<address>
	  <otheraddr>The Linux Emporium</otheraddr>
	  <street>Hilliard House, Lester Way</street>
	  <city>Wallingford</city>
	  <postcode>OX10 9TA</postcode>
	  <country>United Kingdom</country>
	  Phone: <phone>+44 1491 837010</phone>
	  Fax: <fax>+44 1491 837016</fax>
	  WWW: <otheraddr><ulink url="http://www.linuxemporium.co.uk/products/freebsd/"></ulink></otheraddr>
        </address>
      </listitem>

      <listitem>
	<address>
	  <otheraddr>Linux+ DVD Magazine</otheraddr>
	  <street>Lewartowskiego 6</street>
	  <city>Warsaw</city>
	  <postcode>00-190</postcode>
	  <country>Poland</country>
	  Phone: <phone>+48 22 860 18 18</phone>
	  Email: <email>editors@lpmagazine.org</email>
	  WWW: <otheraddr><ulink url="http://www.lpmagazine.org/"></ulink></otheraddr>
	</address>
      </listitem>

      <listitem>
	<address>
	  <otheraddr>Linux System Labs Australia</otheraddr>
	  <street>21 Ray Drive</street>
	  <city>Balwyn North</city>
	  <postcode>VIC - 3104</postcode>
	  <country>Australia</country>
	  Phone: <phone>+61 3 9857 5918</phone>
	  Fax: <fax>+61 3 9857 8974</fax>
	  WWW: <otheraddr><ulink url="http://www.lsl.com.au"></ulink></otheraddr>
        </address>
      </listitem>

      <listitem>
	<address>
	  <otheraddr>LinuxCenter.Ru</otheraddr>
	  <street>Galernaya Street, 55</street>
	  <city>Saint-Petersburg</city>
	  <postcode>190000</postcode>
	  <country>Russia</country>
	  Phone: <phone>+7-812-3125208</phone>
	  Email: <email>info@linuxcenter.ru</email>
	  WWW: <otheraddr><ulink url="http://linuxcenter.ru/freebsd"></ulink></otheraddr>
	</address>
      </listitem>

      <listitem>
	<address>
	  <otheraddr>UNIXDVD.COM LTD</otheraddr>
	  <street>57 Primrose Avenue</street>
	  <city>Sheffield</city>
	  <postcode>S5 6FS</postcode>
	  <country>United Kingdom</country>
	  WWW: <otheraddr><ulink url="http://www.unixdvd.com/"></ulink></otheraddr>
	</address>
      </listitem>

    </itemizedlist>
    </sect2>

    <sect2>
      <title>发行人</title>

      <para>如果您是销售商并且想销售 FreeBSD CDROM 产品，
	请和发行人联系：</para>

      <itemizedlist>
	<listitem>
	  <address>
	    <otheraddr>Cylogistics</otheraddr>
	    <street>809B Cuesta Dr., #2149</street>
	    <city>Mountain View</city>, <state>CA</state> <postcode>94040</postcode>
	    <country>USA</country>
	    Phone: <phone>+1 650 694-4949</phone>
	    Fax: <fax>+1 650 694-4953</fax>
	    Email: <email>sales@cylogistics.com</email>
	    WWW: <otheraddr><ulink url="http://www.cylogistics.com/"></ulink></otheraddr>
	  </address>
	</listitem>

	<listitem>
	  <address>
	    <otheraddr>FreeBSD Services Ltd</otheraddr>
	    <street>11 Lapwing Close</street>
	    <city>Bicester</city>
	    <postcode>OX26 6XR</postcode>
	    <country>United Kingdom</country>
	    WWW: <otheraddr><ulink url="http://www.freebsd-services.com/"></ulink></otheraddr>
	  </address>
	</listitem>

        <listitem>
	  <address>
	    <otheraddr>Ingram Micro</otheraddr>
	    <street>1600 E. St. Andrew Place</street>
	    <city>Santa Ana</city>, <state>CA</state>  <postcode>92705-4926</postcode>
	    <country>USA</country>
	    Phone: <phone>1 (800) 456-8000</phone>
	    WWW: <otheraddr><ulink url="http://www.ingrammicro.com/"></ulink></otheraddr>
          </address>
        </listitem>

	<listitem>
	  <address>
	    <otheraddr>Kudzu, LLC</otheraddr>
	    <street>7375 Washington Ave. S.</street>
	    <city>Edina</city>, <state>MN</state> <postcode>55439</postcode>
	    <country>USA</country>
	    Phone: <phone>+1 952 947-0822</phone>
	    Fax: <fax>+1 952 947-0876</fax>
	    Email: <email>sales@kudzuenterprises.com</email>
	  </address>
	</listitem>

	<listitem>
	  <address>
	    <otheraddr>LinuxCenter.Ru</otheraddr>
	    <street>Galernaya Street, 55</street>
	    <city>Saint-Petersburg</city>
	    <postcode>190000</postcode>
	    <country>Russia</country>
	    Phone: <phone>+7-812-3125208</phone>
	    Email: <email>info@linuxcenter.ru</email>
	    WWW: <otheraddr><ulink url="http://linuxcenter.ru/freebsd"></ulink></otheraddr>
	  </address>
	</listitem>

	<listitem>
	  <address>
	    <otheraddr>Navarre Corp</otheraddr>
	    <street>7400 49th Ave South</street>
	    <city>New Hope</city>, <state>MN</state> <postcode>55428</postcode>
	    <country>USA</country>
	    Phone: <phone>+1 763 535-8333</phone>
	    Fax: <fax>+1 763 535-0341</fax>
	    WWW: <otheraddr><ulink url="http://www.navarre.com/"></ulink></otheraddr>
	  </address>
	</listitem>
      </itemizedlist>
    </sect2>
  </sect1>

  <sect1 id="mirrors-ftp">
    <title>FTP 站点</title>

    <para>官方的 FreeBSD 源代码可以从遍布全球的镜像站点
      通过匿名 FTP 下载。 站点
      <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/"></ulink>
      有着良好的网络连接并且允许大量的并发连接， 但是
      您或许更想找一个 <quote>更近的</quote>
      镜像站点 (特别是当您想进行某种形式的镜像的时候)。</para>

    <para><ulink
	url="http://mirrorlist.FreeBSD.org/">FreeBSD 镜像
	站点数据库</ulink>要比使用手册中的镜像列表更加精确，
      因为它从 DNS 中获取信息而不依赖于静态的主机列表。</para>

    <para>FreeBSD 可以从下面这些镜像站点通过匿名 FTP
      下载。如果您选择了通过匿名 FTP 获取 FreeBSD，
      请尽量使用离您比较近的站点。被列为
      <quote>主镜像站点</quote> 的镜像站点一般都有完整的 FreeBSD 文件
      (针对每种体系结构的所有当前可用的版本)，
      您或许从您所在的国家或地区的站点下载会得到更快的下载速度。
      每个站点提供了最流行的体系结构的最近的版本而有可能不提供完整的
      FreeBSD 存档。所有的站点都提供匿名 FTP
      访问而有些站点也提供其他的访问方式。对每个站点可用的访问方式
      在其主机名后有所说明。</para>

    &chap.mirrors.ftp.inc;
  </sect1>

    <sect1 id="anoncvs">
      <title>匿名 CVS</title>

      <sect2>
	<title><anchor id="anoncvs-intro">概述</title>

	<indexterm>
	  <primary>CVS</primary>
	  <secondary>匿名</secondary>
	</indexterm>

	<para>匿名 CVS(或人们常说的
	  <emphasis>anoncvs</emphasis>)是由和 FreeBSD 附带的 CVS 实用工具提供的用于和远程的
	  CVS 代码库同步的一种特性。
	  尤其是， 它允许 FreeBSD 用户不需要特殊的权限对任何一台 FreeBSD 项目的官方
	  anoncvs 服务器执行只读的 CVS 操作。
	  要使用它，简单的设置 <envar>CVSROOT</envar>
	  环境变量指向适当的 anoncvs 服务器，
	  输入 <command>cvs login</command> 命令
	  并提供广为人知的密码<quote>anoncvs</quote>，然后使用
	  &man.cvs.1; 命令像访问任何本地仓库一样来访问它。</para>

	<note>
	  <para><command>cvs login</command> 命令把用来登录 CVS
	    服务器的密码储存在您的 <envar>HOME</envar> 目录中一个叫
	    <filename>.cvspass</filename> 的文件里。
	    如果这个文件不存在，
	    第一次使用 <command>cvs
	    login</command> 的时候可能会出错。 请创建一个空的
	    <filename>.cvspass</filename> 文件，然后试试重新登录。</para>
	</note>

	<para>也可以这么说 <link
	  linkend="cvsup">CVSup</link> 和 <emphasis>anoncvs</emphasis>
	  服务本质上提供了同样的功能，但是有各种各样
	  不同的场合可以影响用户对同步方式的选择。简单来说，
	  <application>CVSup</application> 在网络资源利用方面
	  更加有效，而且是到目前为止在两者之中技术上更成熟的
	  除了成本方面。要使用
	  <application>CVSup</application>，在下载任何东西之前
	  必须首先安装配置特定的客户端，
	  而且只能用于下载相当大块的
	  <application>CVSup</application> 称作
	  <emphasis>collections</emphasis>。</para>

	<para>相比之下，<application>anoncvs</application> 可以通过 CVS
	  模块名来从单个文件里检出任何东西并赋给特定的程序
	  (比如 <command>ls</command> 或者 <command>grep</command>)。
	  当然，<application>anoncvs</application> 也只适用于对
	  CVS 仓库的只读操作，所以如果您是想用和 FreeBSD 项目共享的仓库提供本地开发的话，
	  <application>CVSup</application> 几乎是您唯一的选择。</para>
      </sect2>

      <sect2>
	<title><anchor id="anoncvs-usage">使用匿名 CVS</title>

	<para>配置 &man.cvs.1; 使用匿名 CVS 仓库可以简单的设定
	  <envar>CVSROOT</envar> 环境变量指向 FreeBSD 项目的
	  <emphasis>anoncvs</emphasis> 服务器之一。到此书写作为止，
	  下面的服务器都是可用的：</para>

	<itemizedlist>
	  <listitem>
	    <para><emphasis>奥地利</emphasis>:
	      :pserver:anoncvs@anoncvs.at.FreeBSD.org:/home/ncvs
	      (使用 <command>cvs login</command> 然后在提示输入口令时输入任意口令。)</para>
	  </listitem>
	  <listitem>
	    <para><emphasis>法国</emphasis>:
	      :pserver:anoncvs@anoncvs.fr.FreeBSD.org:/home/ncvs
	      (pserver (口令是 <quote>anoncvs</quote>), ssh (没有口令))
	    </para>
	  </listitem>
	  <listitem>
	    <para><emphasis>德国</emphasis>:
	      :pserver:anoncvs@anoncvs.de.FreeBSD.org:/home/ncvs
	      (Use <command>cvs login</command> and enter the password
	      <quote>anoncvs</quote> when prompted.)</para>
	  </listitem>
	  <listitem>
	    <para><emphasis>德国</emphasis>:
	      :pserver:anoncvs@anoncvs2.de.FreeBSD.org:/home/ncvs
	      (rsh, pserver, ssh, ssh/2022)
	      </para>
	  </listitem>
	  <listitem>
	    <para><emphasis>日本</emphasis>:
	      :pserver:anoncvs@anoncvs.jp.FreeBSD.org:/home/ncvs
	      (Use <command>cvs login</command> and enter the password
	      <quote>anoncvs</quote> when prompted.)</para>
	  </listitem>
	  <listitem>
	    <para><emphasis>瑞典</emphasis>:
	      freebsdanoncvs@anoncvs.se.FreeBSD.org:/home/ncvs
	      (仅 ssh - 无口令)</para>

	    <programlisting>SSH HostKey: 1024 a7:34:15:ee:0e:c6:65:cf:40:78:2d:f3:cd:87:bd:a6 root@apelsin.fruitsalad.org
SSH2 HostKey: 1024 21:df:04:03:c7:26:3e:e8:36:1a:50:2d:c7:ae:b8:5f ssh_host_dsa_key.pub</programlisting>

	  </listitem>
	  <listitem>
	    <para><emphasis>美国</emphasis>:
	      freebsdanoncvs@anoncvs.FreeBSD.org:/home/ncvs
	      (仅 ssh - 无口令)</para>

	    <programlisting>SSH HostKey: 1024 a1:e7:46:de:fb:56:ef:05:bc:73:aa:91:09:da:f7:f4 root@sanmateo.ecn.purdue.edu
SSH2 HostKey: 1024 52:02:38:1a:2f:a8:71:d3:f5:83:93:8d:aa:00:6f:65 /etc/ssh/ssh_host_dsa_key.pub</programlisting>

	  </listitem>
	  <listitem>
	    <para><emphasis>USA</emphasis>:
	      anoncvs@anoncvs1.FreeBSD.org:/home/ncvs (仅 ssh - 无口令)</para>

	    <programlisting>SSH HostKey: 1024 f1:6a:9c:6d:e3:f3:ae:f8:b5:68:ac:30:cb:11:32:9b root@ender.liquidneon.com
SSH2 HostKey: 1024 9a:d6:e1:e2:4f:58:36:77:e5:5b:60:ee:94:1b:c1:c0 ssh_host_dsa_key.pub</programlisting>

	  </listitem>
	</itemizedlist>

	<para>因为 CVS 实际上允许 <quote>检出</quote>
	  曾经存在的 (或者，某种情况下将会存在)
	  FreeBSD 源代码的任意版本， 您需要熟悉
	  &man.cvs.1; 的版本 (<option>-r</option>) 参数，
	  以及在 FreeBSD 代码库中可用的值。</para>

	<para>有两种标签，修订标签和分支标签。
	  修订标签特指一个特定的修订版本。含义始终是不变的。
	  分支标签，另一方面，
	  指代给定时间给定开发分支的最新修订，
	  因为分支标签不涉及特定的修订版本，
	  它明天所代表的含义就可能和今天的不同。</para>

	<para><xref linkend="cvs-tags"> 包括了用户可能感兴趣的
 	  修订标签。 另外，这里面没有一个可以用于 Ports Collection，
	  因为它没有多个修订版本。</para>

	<para>当您指定一个分支标签，您通常会得到那个开发分支的文件的最新版本。
	  如果您希望得到一些旧的版本，您可以用
	  <option>-D date</option> 标记制定一个日期。
	  察看 &man.cvs.1; 手册页了解更多细节。</para>
      </sect2>

      <sect2>
	<title>示例</title>

	<para>在这之前强烈建议您通读 &man.cvs.1; 的手册页，
	  这里有一些简单的例子来展示如何使用匿名
	  CVS：</para>

	<example>
	  <title>从 -CURRENT 检出些东西(&man.ls.1;)
	    然后再删除：</title>

	  <screen>&prompt.user; <userinput>setenv CVSROOT :pserver:anoncvs@anoncvs.FreeBSD.org:/home/ncvs</userinput>
&prompt.user; <userinput>cvs login</userinput>
<emphasis>在提示符处，输入密码</emphasis> <quote>anoncvs</quote>.
&prompt.user; <userinput>cvs co ls</userinput>
&prompt.user; <userinput>cvs release -d ls</userinput>
&prompt.user; <userinput>cvs logout</userinput>
	  </screen>
	</example>

	<example>
	  <title>通过 SSH 检出整个 <filename>src/</filename>
	    代码树：</title>
	  <screen>&prompt.user; <userinput>cvs -d freebsdanoncvs@anoncvs.FreeBSD.org:/home/ncvs co src</userinput>
The authenticity of host 'anoncvs.freebsd.org (128.46.156.46)' can't be established.
DSA key fingerprint is 52:02:38:1a:2f:a8:71:d3:f5:83:93:8d:aa:00:6f:65.
Are you sure you want to continue connecting (yes/no)? <userinput>yes</userinput>
Warning: Permanently added 'anoncvs.freebsd.org' (DSA) to the list of known hosts.</screen>
	</example>

	<example>
	  <title>检出 &man.ls.1; 在 3.X-STABLE 分支中的版本：</title>
	    
	  <screen>&prompt.user; <userinput>setenv CVSROOT :pserver:anoncvs@anoncvs.FreeBSD.org:/home/ncvs</userinput>
&prompt.user; <userinput>cvs login</userinput>
<emphasis>在提示符处，输入密码</emphasis> <quote>anoncvs</quote>.
&prompt.user; <userinput>cvs co -rRELENG_3 ls</userinput>
&prompt.user; <userinput>cvs release -d ls</userinput>
&prompt.user; <userinput>cvs logout</userinput>
	  </screen>
	</example>

	<example>
	  <title>创建 &man.ls.1; 的变化列表(用标准的 diff)</title>

	  <screen>&prompt.user; <userinput>setenv CVSROOT :pserver:anoncvs@anoncvs.FreeBSD.org:/home/ncvs</userinput>
&prompt.user; <userinput>cvs login</userinput>
<emphasis>在提示符处，输入密码</emphasis> <quote>anoncvs</quote>.
&prompt.user; <userinput>cvs rdiff -u -rRELENG_3_0_0_RELEASE -rRELENG_3_4_0_RELEASE ls</userinput>
&prompt.user; <userinput>cvs logout</userinput>
	  </screen>
	</example>

	<example>
	  <title>找出可以使用的其它的模块名：</title>

	  <screen>&prompt.user; <userinput>setenv CVSROOT :pserver:anoncvs@anoncvs.FreeBSD.org:/home/ncvs</userinput>
&prompt.user; <userinput>cvs login</userinput>
<emphasis>在提示符处，输入密码</emphasis> <quote>anoncvs</quote>.
&prompt.user; <userinput>cvs co modules</userinput>
&prompt.user; <userinput>more modules/modules</userinput>
&prompt.user; <userinput>cvs release -d modules</userinput>
&prompt.user; <userinput>cvs logout</userinput>
	  </screen>
	</example>
      </sect2>

      <sect2>
	<title>其他资源</title>

	<para>下面附加的资源可能对学习
	  CVS 有帮助：</para>

	<itemizedlist>
	  <listitem>
	    <para><ulink 
		url="http://www.csc.calpoly.edu/~dbutler/tutorials/winter96/cvs/">CVS 指南</ulink> 来自 Cal Poly。</para>
	  </listitem>

	  <listitem>
	    <para><ulink url="http://www.cvshome.org/">CVS 主页</ulink>，
	      CVS 开发和支持论坛。</para>
	  </listitem>

	  <listitem>
	    <para><ulink
		url="http://www.FreeBSD.org/cgi/cvsweb.cgi">CVSweb</ulink> 是
	      FreeBSD 项目的 CVS web 界面。</para>
	  </listitem>
	</itemizedlist>
      </sect2>
    </sect1>
    
    
  <sect1 id="ctm">
    <title>使用 CTM</title>

      <indexterm>
	<primary>CTM</primary>
      </indexterm>

      <para><application>CTM</application> 是保持远程目录树和中央服务器目录树同步的一种方法。
	它被开发用于 FreeBSD 的源代码树，虽然其他人随着时间推移会发现它可以用于其他目的。
	当前几乎没有，也或者只有很少的文档讲述创建 deltas 的步骤，
	所以如果您希望使用 <application>CTM</application> 去做其它事情，
	请联系 &a.ctm-users.name; 邮件列表了解更多信息。</para>

      <sect2>
	<title>为什么我该使用 <application>CTM</application>?</title>

	<para><application>CTM</application> 会给您一份 FreeBSD
	  源代码树的本地拷贝。代码树有很多的
	  <quote>flavors</quote> 可用。不管您是希望跟踪完整的 CVS 树还是只是一个分支，
	  <application>CTM</application> 都会给您提供信息。
	  如果您是 FreeBSD 上的一个活跃的开发者，但是缺乏或者不存在 TCP/IP 连接，或者只是希望把变化自动发送给您，
	  <application>CTM</application> 就是适合您的。对于最积极的分支
	  您将会每天获得三个以上的 deltas。
	  然而，您应该考虑通过邮件来自动发送。
	  升级的大小总是保证尽可能的小。
	  通常小于 5K，也偶然(十分之一可能)会有 10-50K，也不时地有个大的 100K+ 甚至更大的。</para>

	<para>您也需要让自己了解直接和开发代码而不是预发行版本打交道的各种警告。这种情况会很显著，
	  如果您选择了 <quote>current</quote> 代码的话。强烈建议您阅读<link linkend="current">和
	  FreeBSD 保持同步</link>。</para>
      </sect2>

      <sect2>
	<title>使用
	  <application>CTM</application> 我需要做什么？</title>

	<para>您需要两样东西：<application>CTM</application>
	  程序，还有初始的 deltas 来 feed it(达到
	  <quote>current</quote> 级别)。</para>
	    
	<para><application>CTM</application> 程序从版本 2.0 发布以来
	  已经是 FreeBSD 的一部分了，如果您有一份源代码拷贝的话它位于
	  <filename>/usr/src/usr.sbin/ctm</filename>。</para>

	<para>如果您再运行一个比 2.0 版本早的 FreeBSD 系统，
	  可以直接从下面下载最新的 <application>CTM</application>
	  源代码：</para>
	    
	<para><ulink url="http://www.FreeBSD.org/cgi/cvsweb.cgi/src/usr.sbin/ctm/"></ulink></para>

	<para>您喂给 <application>CTM</application> 的 <quote>deltas</quote>
	  可以有两种方式，FTP 或者 email。
	  如果您有普通的访问 Internet 的 FTP 权限，
	  那么下面的 FTP 站点支持访问
	  <application>CTM</application>：</para>

	<para><ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CTM/"></ulink></para>

	<para>或者看看这一小节<link
	  linkend="mirrors-ctm">镜像</link>。</para>

	<para>FTP 访问相关的目录并取得
	  <filename>README</filename> 文件，从那里开始。</para>

	<para>如果您希望通过 email 得到您的 deltas：</para>

	<para>订阅一个
	  <application>CTM</application> 分发列表。
	  &a.ctm-cvs-cur.name; 支持完整的 CVS 树。
	  &a.ctm-src-cur.name; 支持最新的开发分支。
	  &a.ctm-src-4.name; 支持 4.X 发行分支，
	  等等。。(如果您不知道如何订阅邮件列表，
	  点击上面的列表名或者到
	  &a.mailman.lists.link; 点击您希望订阅的列表。
	  列表页包含了所有必要的订阅指导。)</para>

	<para>当您开始接收到您邮件中的 <application>CTM</application>
	  升级时，您可以使用
	  <command>ctm_rmail</command> 程序来解压并应用它们。
	  事实上如果您想要让进程以全自动的形式运行的话，您可以通过在
	  <filename>/etc/aliases</filename> 中设置直接使用 <command>ctm_rmail</command> 程序。
	  查看 <command>ctm_rmail</command> 手册页了解更多细节。</para>

	<note>
	  <para>不管您使用什么方法得到
	    <application>CTM</application> deltas，您都应该订阅
	    &a.ctm-announce.name; 邮件列表。
	    以后会有单独的地方提交有关
	    <application>CTM</application> 系统的操作的公告。
	    点击上面的邮件列表名并按照指示订阅邮件列表。</para>
	</note>
      </sect2>

      <sect2>
	<title>第一次使用 <application>CTM</application></title>

	<para>在您开始使用 <application>CTM</application>
	  delta 之前，您需要获得一个起始点。</para>

	<para>首先您应该确定您已经有了什么。每个人都可以从一个<quote>空</quote>目录开始。
	  您必须用一个初始的 <quote>空的</quote> delta 来开始您的
	  <application>CTM</application> 支持树。曾经为了您的便利这些
	  <quote>起始</quote> deltas 被有意的通过 CD 来发行，
	  然而现在已经不这样做了。</para>

	<para>因为代码树有数十兆字节，您应该更喜欢从手头上已经有的东西开始。如果您有一张
	  -RELEASE CD 光盘，您可以从里面拷贝或者解压缩一份初始代码出来。
	  这会节省非常多的数据传输量。</para>

	<para>您会发现这些<quote>初始的</quote> deltas 名字的数字后面都有个
	  <literal>X</literal> (比如 <filename>src-cur.3210XEmpty.gz</filename>)。
	  后面加一个 <literal>X</literal> 的设计符合您的初始 <quote>seed</quote> 的由来。
	  <filename>Empty</filename> 是一个空目录。通常一个基本的从
	  <literal>Empty</literal> 开始的转换由
	  100 个 deltas 构成。顺便说一下，他们都很大！70 到 80
	  兆字节的 <command>gzip</command> 压缩的数据对于
	  <filename>XEmpty</filename> deltas 是很平常的。</para>

	<para>一旦您已经选定了一个基本的 delta 开始，您就需要比这个数高的所有的 delta。</para>
      </sect2>

      <sect2>
	<title>在您的日常生活中使用 <application>CTM</application></title>

	<para>要应用 deltas，简单的键入：</para>

	<screen>&prompt.root; <userinput>cd /where/ever/you/want/the/stuff</userinput>
&prompt.root; <userinput>ctm -v -v /where/you/store/your/deltas/src-xxx.*</userinput></screen>

	<para><application>CTM</application> 能够理解被
	  <command>gzip</command> 压缩的 deltas，所以您不需要先
	  <command>gunzip</command> 他们，这可以节省磁盘空间。</para>

	<para>除非觉得整个过程非常可靠，
	  <application>CTM</application> 不会涉及到您的代码树的。您也可以使用
	  <option>-c</option> 标记来校验 delta，
	  这样 <application>CTM</application> 就不会涉及代码树；
	  它会只校验 delta 的完整性看看是否可以安全的用于您的当前代码树。</para>

	<para><application>CTM</application> 还有其他的一些参数，
	  查看手册页或者源代码了解更多信息。</para>

	<para>这真的就是全部的事情了。每次得到一个新的
	  delta，就通过 <application>CTM</application> 运行它来保证您的代码是最新的。</para>

	<para>如果这些 deltas 很难重新下载的话不要删除它们。
	  有些东西坏掉的时候您会想到保留它们的。
	  即使您只有软盘，也请考虑使用
	  <command>fdwrite</command> 来做一份拷贝。</para>
      </sect2>

      <sect2>
	<title>维持您本地的变动</title>

	<para>作为一名开发者喜欢实验，改动代码树中的文件。
	  <application>CTM</application>
	  用一种受限的方式支持本地修改：再检查文件
	  <filename>foo</filename> 存在之前，首先查找
	  <filename>foo.ctm</filename>。如果这个文件存在，
	  <application>CTM</application> 会对它操作而不是
	  <filename>foo</filename>。</para>

	<para>这种行为给我们提供了一种简单的方式来维持本地的改动：
	  只要复制您计划修改的文件并用
	  <filename>.ctm</filename> 的后缀重新命名。
	  然后就可以自由的修改代码了，<application>CTM</application> 会更新
	  <filename>.ctm</filename> 文件到最新版本。</para>
      </sect2>

      <sect2>
	<title>其他有趣的 <application>CTM</application> 选项</title>

	<sect3>
	  <title>正确的找出哪些将被更新</title>

	  <para>您可以确定变动列表，
	    <application>CTM</application> 可以做到，在您的代码库上使用
	    <application>CTM</application> 的
	    <option>-l</option> 选项。</para>

	  <para>这很有用如果您想要保存改动的日志，
	    pre- 或者 post- 用各种风格处理修改的文件的纪录，
	    或者仅仅是想感受一下孩子般的疯狂。</para>
	</sect3>

	<sect3>
	  <title>在升级前制作备份</title>

	  <para>有时您可能想备份将要被 <application>CTM</application>
	    升级所改动的所有文件。</para>

	  <para>指定 <option>-B backup-file</option> 选项会导致
	    <application>CTM</application> 备份将要被给定的 <application>CTM</application>
	    delta 改动的所有文件到 <filename>backup-file</filename>。</para>
	</sect3>

	<sect3>
	  <title>限定受升级影响的文件</title>

	  <para>有时您可能对限定一个给定的 <application>CTM</application>
	    升级的范围感兴趣，也有可能想知道怎样从一列 deltas 中解压缩一部分文件。</para>

	  <para>您可以通过使用 <option>-e</option> 和 <option>-x</option>
	    选项指定过滤规则表达式来控制 <application>CTM</application>
	    即将对之操作的文件列表。</para>

	  <para>例如，要从您保存的<application>CTM</application> deltas
	    集里解压缩出一个最新的 <filename>lib/libc/Makefile</filename>
	    文件，运行这个命令：</para>

	  <screen>&prompt.root; <userinput>cd /where/ever/you/want/to/extract/it/</userinput>
&prompt.root; <userinput>ctm -e '^lib/libc/Makefile' ~ctm/src-xxx.*</userinput></screen>

	  <para>对于每一个在 <application>CTM</application>
	    delta 中指定的文件，<option>-e</option>
	    和 <option>-x</option> 选项按照命令行给定的顺序应用。
	    文件只有在所有的 <option>-e</option> 和
	    <option>-x</option> 被应用之后标记为合格之后
	    才能被 <application>CTM</application> 操作。</para>
	</sect3>
      </sect2>

      <sect2>
	<title><application>CTM</application> 未来的计划</title>

	<para>其中几项：</para>

	<itemizedlist>
	  <listitem>
	    <para>在 <application>CTM</application> 中使用一些认证方式，
	      这样来允许察觉冒充的 <application>CTM</application> 补丁。</para>
	  </listitem>

	  <listitem>
	    <para>整理 <application>CTM</application> 的选项，
	      它们变得杂乱而违反直觉了。</para>
	  </listitem>
	</itemizedlist>
      </sect2>

      <sect2>
	<title>杂项</title>

	<para>也有一系列的
	  <literal>ports</literal> collection 的 deltas，但是人们对它的兴致还没有那么高。</para>
      </sect2>

    <sect2 id="mirrors-ctm">
      <title>CTM 镜像</title>
      
    <para><link linkend="ctm">CTM</link>/FreeBSD 可以在下面的镜像站点通过匿名
      FTP 下载。如果您选择通过匿名 FTP 获取 <application>CTM</application>，
      请试着使用一个离您较近的站点。</para>

    <para>如果有问题，请联系 &a.ctm-users.name;
      邮件列表。</para>

    <variablelist>
      <varlistentry>
	<term>加利福尼亚州，海湾地区，官方源代码</term>

	<listitem>
	  <itemizedlist>
	    <listitem>
	      <para><ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/"></ulink></para>
	    </listitem>
	  </itemizedlist>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>南非，旧的 deltas 的备份服务器</term>

	<listitem>
	  <itemizedlist>
	    <listitem>
	      <para><ulink url="ftp://ftp.za.FreeBSD.org/pub/FreeBSD/CTM/"></ulink></para>
	    </listitem>
	  </itemizedlist>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>中国台湾</term>

	<listitem>
	  <itemizedlist>
	    <listitem>
	      <para><ulink url="ftp://ctm.tw.FreeBSD.org/pub/FreeBSD/development/CTM/"></ulink></para>
	    </listitem>

	    <listitem>
	      <para><ulink url="ftp://ctm2.tw.FreeBSD.org/pub/FreeBSD/development/CTM/"></ulink></para>
	    </listitem>

	    <listitem>
	      <para><ulink url="ftp://ctm3.tw.FreeBSD.org/pub/FreeBSD/development/CTM/"></ulink></para>
	    </listitem>
	  </itemizedlist>
	</listitem>
      </varlistentry>
    </variablelist>

    <para>如果您在您附近找不到镜像或者镜像不完整，
      试着使用搜索引擎比如
      <ulink url="http://www.alltheweb.com/">alltheweb</ulink>.</para>
  </sect2></sect1>

  <sect1 id="cvsup">
    <title>使用 CVSup</title>
    
    <sect2 id="cvsup-intro">
      <title>概述</title>
      
      <para><application>CVSup</application> 是一个用于从远程服务器主机上的主
	CVS 仓库发布和升级源代码树的软件包。
	FreeBSD 的源代码维护在加利福尼亚州一台主开发服务器的 CVS 仓库里。
	有了 <application>CVSup</application>，FreeBSD
	用户可以很容易的保持他们自己的源代码树更新。</para>
      
      <para><application>CVSup</application> 使用所谓的升级
	<emphasis>pull</emphasis> 模式。在 pull
	模式下，客户端在需要的时候向服务器端请求更新。
	服务器被动的等待客户端的升级请求。
	因此所有的升级都是客户端发起的。
	服务器决不会发送未请求的升级。用户必须手动运行
	<application>CVSup</application> 客户端获取更新，
	或者设置一个 <command>cron</command> 作业来让它以固定的规律自动运行。</para>
      
      <para>术语 <application>CVSup</application>用大写字母写正是表示，
	代表了完整的软件包。 它的主要组件是运行在每个用户机器上的客户端 <command>cvsup</command>，
	和运行在每个 FreeBSD 镜像站点上的服务器端 <command>cvsupd</command>。</para>

      <para>当您阅读 FreeBSD 文档和邮件列表时，您可能会看见
	<application>sup</application>。
	<application>Sup</application> 是
	<application>CVSup</application> 的前身，有着相似的目的。
	<application>CVSup</application> 使用很多和 sup 相同的方式，
	而且， 它还是用使用和 <command>sup</command> 的兼容的配置文件。
	<application>Sup</application> 已经不再被 FreeBSD 项目使用了，
	因为 <application>CVSup</application> 既快又有更好的灵活性。</para>
    </sect2>

    <sect2 id="cvsup-install">
      <title>安装</title>
      
      <para>安装 <application>CVSup</application> 最简单的方式就是使用
	FreeBSD <link linkend="ports">packages collection</link>
	中预编译的 <filename role="package">net/cvsup</filename> 包。
	如果您想从源代码构建 <application>CVSup</application>，
	您可以使用 <filename role="package">net/cvsup</filename>
	port。但是预先警告一下：
	<filename role="package">net/cvsup</filename> port 依赖于 Modula-3
	系统，会花费相当的时间和磁盘空间来下载编译。</para>

	<note>
	  <para>如果想在没有安装 <application>&xfree86;</application>
	  或 <application>&xorg;</application> 的计算机， 例如服务器上使用
	  <application>CVSup</application>， 则只能使用不包含
	  <application>CVSup</application> <acronym>GUI</acronym>
	  的 <filename role="package">net/cvsup-without-gui</filename>。</para>
	</note>
    </sect2>

    <sect2 id="cvsup-config">
      <title>CVSup 配置</title>
      
      <para><application>CVSup</application> 的操作被一个叫做
	<filename>supfile</filename> 的配置文件所控制。
	在目录 <ulink type="html"
	  url="file://localhost/usr/share/examples/cvsup/"><filename>/usr/share/examples/cvsup/</filename></ulink>
	  下面有一些示例的 <filename>supfiles</filename>。</para>
      
      <para><filename>supfile</filename> 中的信息解答了
	<application>CVSup</application> 下面的几个问题：</para>
      
      <itemizedlist>
	<listitem>
	  <para><link linkend="cvsup-config-files">您想接收
	      哪些文件？</link></para>
	</listitem>
	
	<listitem>
	  <para><link linkend="cvsup-config-vers">您想要它们的
	      哪个版本？</link></para>
	</listitem>
	
	<listitem>
	  <para><link linkend="cvsup-config-where">您想从哪里
	      获取它们？</link></para>
	</listitem>
	
	<listitem>
	  <para><link linkend="cvsup-config-dest">您想把它们
	      放在您自己机器的什么地方？</link></para>
	</listitem>
	
	<listitem>
	  <para><link linkend="cvsup-config-status">您想把
	      您的状态文件放在哪？</link></para>
	</listitem>
      </itemizedlist>

      <para>在下面的章节里，我们通过依次回答这些问题来创建一个典型的
	<filename>supfile</filename> 文件。首先，我们描述一下
	<filename>supfile</filename> 的整体构成。</para>

      <para><filename>supfile</filename> 是个文本文件。注释用
	<literal>#</literal> 开头，至行尾有效。
	空行和只包含注释的行会被忽略。</para>
      
      <para>每个保留行描述一批用户希望接收的文件。
	每行以 <quote>collection</quote>，
	由服务器端定义的合理的文件分组，的名字开头。
	collection 的名字告诉服务器您想要的文件。
	collection 名字结束或者有更多的字段，用空格分隔。
	这些字段回答了上面列出的问题。
	字段类型有两种：标记字段和值字段。
	标记字段由独立的关键字组成，比如，
	<literal>delete</literal> 或者
	<literal>compress</literal>。值字段也用关键字开头，
	关键字后面跟 <literal>=</literal> 和第二个词而没有空格。
	例如，<literal>release=cvs</literal> 是一个值字段。</para>
      
      <para>一个典型的 <filename>supfile</filename> 往往接收多于一个的
	collection。创建
	<filename>supfile</filename> 的一种方式是明确的为每一个
	collection 指定相关的字段。然而，这样使得
	<filename>supfile</filename> 的行变得特别长，很不方便，
	因为 <filename>supfile</filename> 中的所有 collection 的大部分
	字段都是相同的。
	<application>CVSup</application> 提供了一个默认机制来避免
	这些问题。用特定的伪 collection 名 <literal>*default</literal>
	开头的行可以被用来设置标记和值为 <filename>supfile</filename>
	中随后的 collection 中的默认值。
	默认值可以通过为这个 collection 自身指定不同的值来对单个的
	collection 覆盖设置，
	也可以在 mid-supfile 中通过附加的
	<literal>*default</literal> 行改变或扩充。</para>

      <para>知道了这些，我们现在就可以开始创建一个
	用于接收和升级 <link
	  linkend="current">FreeBSD-CURRENT</link> 主源代码树的
	<filename>supfile</filename> 文件了。</para>

      <itemizedlist>
	<listitem>
	  <para><anchor id="cvsup-config-files">您想接收哪些文件？</para>
	  
	  <para>通过 <application>CVSup</application> 可用的文件组织成叫做
	    <quote>collections</quote> 的名称组。
	    这些可用的 collection 在 <link
	      linkend="cvsup-collec">随后的章节</link> 中描述。
	    在这个例子里，
	    我们希望接收 FreeBSD 系统的完整的主代码树。
	    有一个单独的大的 collection
	    <literal>src-all</literal> 让我们完成这个。
	    创建我们的
	    <filename>supfile</filename> 的第一步，
	    我们简单的列出这些 collection，每个一行(在这个例子里，
	    只有一行)：</para>

	  <programlisting>src-all</programlisting>
	</listitem>

	<listitem>
	  <para><anchor id="cvsup-config-vers">您想要他们的
	    哪个版本？</para>

	  <para>通过 <application>CVSup</application>，您实际上可以接收
	    曾经存在的源代码的任何版本。
	    这是有可能的，因为
	    <application>cvsupd</application> 服务器直接通过
	    CVS 仓库工作，那包含了所有的版本。您可以
	    用 <literal>tag=</literal> 和 <option>date=</option> 值字段
	    指定一个您想要的版本。</para>
	  
	  <warning>
	    <para>仔细的正确指定任何 <literal>tag=</literal>
	      字段。有一些 tag 只对特定的 collection 文件合法。
	      如果您指定了一个不正确的或者
	      拼写错误的 tag，<application>CVSup</application>
	      会删除您可能不想删除的文件。
	      特别地，对 <literal>ports-*</literal>
	      collection <emphasis>只</emphasis>使用
	      <literal>tag=.</literal>。</para>
	  </warning>

	  <para><literal>tag=</literal> 字段在仓库中表示为一个符号标签。
	    有两种标签，修订标签和分支标签。
	    修订标签代表一个特定的修订版本。
	    它的含义是一成不变的。
	    分支标签，另一方面，代表给定开发线上给定时间的最新修订。
	    因为分支标签不代表一个特定的修订版本，
	    它明天的含义就可能和今天的有所不同。</para>
	  
	  <para><xref linkend="cvs-tags"> 包含了用户可能感兴趣的分支标签。
	    当在 <application>CVSup</application> 的配置文件中指定标签的时候，必须用
	    <literal>tag=</literal> 开头
	    (<literal>RELENG_4</literal> 会变成
	    <literal>tag=RELENG_4</literal>)。
	    记住只有 <literal>tag=.</literal> 可以用于
	    Ports Collection。</para>

	  <warning>
	    <para>注意像看到的那样正确的输入标签名。
	      <application>CVSup</application> 不能辨别合法和不合法标签。
	      如果您拼写错了标签名，
	      <application>CVSup</application>
	      会像您指定了一个没有任何文件的合法标签一样工作，
	      那会删除您已经存在的代码。</para>
	  </warning>

	  <para>当您指定一个分支标签的时候，您通常会收到开发线上文件的最新版本。
	    如果您希望接收一些过时的版本，您可以通过用
	    <option>date=</option> 值字段指定一个日期来做到。
	    &man.cvsup.1; 手册页解释了如何来做。</para>

	  <para>对于我们的示例来说，我们希望接收 FreeBSD-CURRENT。
	    我们在我们的
	    <filename>supfile</filename> 的开头添加这行：</para>
	  
	  <programlisting>*default tag=.</programlisting>

	  <para>有一个重要的特例，
	    如果您既没指定 <literal>tag=</literal> 字段也没指定
	    <literal>date=</literal> 字段的情况。这种情况下，
	    您会收到直接来自于服务器 CVS 仓库的真实的 RCS 文件，
	    而不是某一特定版本。
	    开发人员一般喜欢这种操作模式。
	    通过在他们的系统上维护一份仓库自身的副本，
	    他们可以浏览修订历史以及检查文件过去的版本。
	    然而，这个好处是以大量的磁盘空间为代价的。</para>
	</listitem>

	<listitem>
	  <para><anchor id="cvsup-config-where">您想从哪里获取他们？</para>
	  
	  <para>我们使用 <literal>host=</literal> 字段来告诉
	    <command>cvsup</command> 从哪里获取更新。
	    任何一个 <link linkend="cvsup-mirrors">CVSup 镜像站点</link>都可以，
	    虽然您应该选择一个离您比较近的站点。
	    在这个例子里我们将使用一个虚拟的 FreeBSD 发布站点，
	    <hostid role="fqdn">cvsup99.FreeBSD.org</hostid>：</para>

	  <programlisting>*default host=cvsup99.FreeBSD.org</programlisting>
	  
	  <para>您需要在运行 <application>CVSup</application>
	    之前把这个改成一个实际存在的站点。
	    在任何 <command>cvsup</command> 运行的特定时刻，
	    您都可以在命令行上使用 <option>-h
	      <replaceable>hostname</replaceable></option> 选项来覆盖主机设置。</para>
	</listitem>
	
	<listitem>
	  <para><anchor id="cvsup-config-dest">您想把它们放在
	    您自己机器的什么地方？</para>
	  
	  <para><literal>prefix=</literal> 字段告诉
	    <command>cvsup</command> 把接收的文件放在哪里。
	    在这个例子里，我们把源代码文件直接放进我们的主源代码树，
	    <filename>/usr/src</filename>。
	    <filename>src</filename> 目录已经隐含在我们选择接收的 collection 里了，
	    所以正确的写法是：</para>
	  
	  <programlisting>*default prefix=/usr</programlisting>
	</listitem>

	<listitem>
	  <para><anchor id="cvsup-config-status">
	    <command>cvsup</command> 在哪里维护它的状态文件？</para>

	  <para><application>CVSup</application> 客户端在被叫做 <quote>base</quote>
	    的目录里维护了几个状态文件。 这些文件帮助
	    <application>CVSup</application> 更有效的工作，
	    通过跟踪您已经接收到哪些更新的方式。
	    我们将使用标准的 base 目录，
	    <filename>/var/db</filename>：</para>

	  <programlisting>*default base=/var/db</programlisting>

	  <para>如果您的 base 目录还不存在，现在最好创建它。
	    如果 base 目录不存在，<command>cvsup</command>
	    客户端会拒绝工作。</para>
	</listitem>

	<listitem>
	  <para>其他的 <filename>supfile</filename>
	    设置：</para>
	  
	  <para>在 <filename>supfile</filename>
	    中有一些其他选项需要介绍一下：</para>

	  <programlisting>*default release=cvs delete use-rel-suffix compress</programlisting>

	  <para><literal>release=cvs</literal> 显示服务器应该从 FreeBSD 的主 CVS 仓库中获取信息。
	    事实上总是这样的，但是也有可能会超出这个讨论的范围。</para>
	  
	  <para><literal>delete</literal> 给
	    <application>CVSup</application> 权限删除文件。
	    您应该总是指定这个，这样
	    <application>CVSup</application>
	    可以保证您的源代码树完全更新。<application>CVSup</application>
	    很小心的只删除那些不再依赖的文件。
	    您拥有的任何额外的文件会被严格的保留。</para>

	  <para><literal>use-rel-suffix</literal> 是 ... 不可思议的。
	    如果您真的想了解它，查看 &man.cvsup.1; 手册页。
	    否则，就指定而不用担心这个。</para>

	  <para><literal>compress</literal> 启用 gzip 风格的信道压缩。
	    如果您的网络连接是 T1 或者更快， 您可能不想使用压缩。
	    否则，它非常有帮助。</para>
	</listitem>

	<listitem>
	  <para>把它们放在一起：</para>

	  <para>这是我们的示例的完整 <filename>supfile</filename> 
	    文件：</para>

	  <programlisting>*default tag=.
*default host=cvsup99.FreeBSD.org
*default prefix=/usr
*default base=/var/db
*default release=cvs delete use-rel-suffix compress

src-all</programlisting>
	</listitem>
      </itemizedlist>
      <sect3 id="cvsup-refuse-file">
       <title><filename>refuse</filename> 文件</title>

       <para>像上面提到的，<application>CVSup</application> 使用一种
       <emphasis>pull 方法</emphasis>。基本上，这意味着您要连接到
       <application>CVSup</application> 服务器，服务器说，
       <quote>这有些您能下载的东西
       ...</quote>，然后您的客户端反应<quote>好，我要这个，
       这个，这个，还有这个。</quote>在默认的配置中，
       <application>CVSup</application> 客户端会取回您在配置文件中选定的
       collection 和标签的每个文件。
       然而，并不总是您想要的，
       尤其是您在同步 <filename>doc</filename>，<filename>ports</filename>，或者
       <filename>www</filename> 树 &mdash; 大部分人都不能阅读四种或者五种
       语言，因此他们不需要下载特定语言的文件。
       如果您在 <application>CVSup</application> Ports Collection，您
       可以通过单独指定每个 collection 来避免这个
       (比如，<emphasis>ports-astrology</emphasis>，
       <emphasis>ports-biology</emphasis>，等等取代简单的说明
       <emphasis>ports-all</emphasis>)。然而，因为 <filename>doc</filename>
       和 <filename>www</filename> 树没有特定语言的 collection，您必须
       使用 <application>CVSup</application> 许多极好的特性之一：
       <filename>refuse</filename> 文件。</para>

       <para><filename>refuse</filename> 文件本质上是告诉
       <application>CVSup</application> 它不应该从 collection
       中取得某些文件；换句话说，它告诉客户端
       <emphasis>拒绝</emphasis> 来自服务器的特定的文件。
       <filename>refuse</filename> 文件可以在
       <filename><replaceable>base</replaceable>/sup/</filename>
       中找到(或者，如果您没有，应该创建一个)。
       <replaceable>base</replaceable> 在您的 <filename>supfile</filename> 中定义；
       默认情况下，<replaceable>base</replaceable> 就是
       <filename>/var/db</filename>，
       这意味着默认的 <filename>refuse</filename> 文件就是
       <filename>/var/db/sup/refuse</filename>。</para>

       <para><filename>refuse</filename> 文件的格式很简单；
       它仅仅包含您不希望下载的文件和目录名。
       例如，如果您除了英语和德语之外不会讲其他语言，
       而且也不打算阅读德文的文档翻译版本，
       则可以把下面这些放在您的
       <filename>refuse</filename> 文件里：</para>

       <screen>doc/bn_*
doc/da_*
doc/de_*
doc/el_*
doc/es_*
doc/fr_*
doc/it_*
doc/ja_*
doc/nl_*
doc/no_*
doc/pl_*
doc/pt_*
doc/ru_*
doc/sr_*
doc/tr_*
doc/zh_*</screen>

       <para>等等其他语言(您可以通过浏览
       <ulink
       url="http://www.FreeBSD.org/cgi/cvsweb.cgi/">FreeBSD
       CVS 仓库</ulink>找到完整的列表)。</para>

       <para>有这个非常有用的特性，那些慢速连接或者要为他们的 Internet
       连接按时付费的用户就可以节省宝贵的时间因为他们不再需要
       下载那些从来不用的文件。要了解
       <filename>refuse</filename> 文件的更多信息以及其它
       <application>CVSup</application> 的优雅的特性，请浏览它的
       手册页。</para> 
      </sect3>
    </sect2>
    
    <sect2>
      <title>运行 <application>CVSup</application></title>
      
      <para>您现在准备尝试升级了。命令很简单：</para>

      <screen>&prompt.root; <userinput>cvsup <replaceable>supfile</replaceable></userinput></screen>

      <para><filename><replaceable>supfile</replaceable></filename>
	的位置当然就是您刚刚创建的 <filename>supfile</filename> 文件名啦。 
	如果您在 X11 下面运行，<command>cvsup</command>
	会显示一个有一些可以做平常事情的按钮的 GUI 窗口。
	按 <guibutton>go</guibutton> 按钮，然后看着它运行。</para>
      
      <para>在这个例子里您将要升级您目前的
	<filename>/usr/src</filename> 树，您将需要
	用 <username>root</username> 来运行程序，这样
	<command>cvsup</command> 有需要的权限来更新您的文件。
	刚刚创建了您的配置文件，又从来没有使用过这个程序，
	紧张不安是可以理解的。有一个简单的方法不改变您当前的文件
	来做一次试验性的运行。只要在方便的地方创建一个
	空目录，并在命令行上作为一个额外的参数说明：</para>

      <screen>&prompt.root; <userinput>mkdir /var/tmp/dest</userinput>
&prompt.root; <userinput>cvsup supfile /var/tmp/dest</userinput></screen>
      
      <para>您指定的目录会作为所有文件更新的目的路径。
	<application>CVSup</application> 会检查您在
	<filename>/usr/src</filename> 中的文件，但是不会修改或
	删除。任何文件更新都会被放到
	<filename>/var/tmp/dest/usr/src</filename> 里了。
	在这种方式下运行 <application>CVSup</application> 也会把它的 base
	目录状态文件保持原样。这些文件的新版本
	会被写到指定的目录。
	因为您有
	<filename>/usr/src</filename> 目录的读权限，所以执行这种试验性的运行
	甚至不需要使用 <username>root</username> 用户。</para>
      
      <para>如果您没有运行 X11 或者不喜欢 GUI，
	当您运行 <command>cvsup</command> 的时候需要在命令行添加
	两个选项：</para>
      
      <screen>&prompt.root; <userinput>cvsup -g -L 2 <replaceable>supfile</replaceable></userinput></screen>
	    
      <para><option>-g</option> 告诉
	<application>CVSup</application> 不要使用 GUI。如果您
	没在运行 X11 这个是自动的，否则您必须指定它。</para>
      
      <para><option>-L 2</option> 告诉
	<application>CVSup</application> 输出所有正在升级的文件的细节。
	有三个等级可以选择，从 <option>-L 0</option> 到
	<option>-L 2</option>。默认是 0，意味着除了错误消息
	什么都不输出。</para>
      
      <para>还有许多其它的选项可用。想要一个简短的列表，
	输入 <command>cvsup -H</command>。要查看更详细的描述，
	请查看手册页。</para>

      <para>一旦您对升级工作的方式满意了，您就
	可以使用 &man.cron.8; 来安排规则的运行
	<application>CVSup</application>。
	很显然的，您不应该让 <application>CVSup</application>
	通过 &man.cron.8; 运行的时候使用它的 GUI。</para>
    </sect2>

    <sect2 id="cvsup-collec">
      <title><application>CVSup</application> 文件 collection</title>
	    
      <para><application>CVSup</application> 可用的文件 collection
	是分级组织的。
	有几个大的 collection，然后它们有分成更小的子
	collection。接收一个大的 collection 等同于
	接收它的每一个子 collection。
	collection 的等级关系在下面列表中通过缩进的使用
	反映出来。</para>
      
      <para>最常用的 collection 是
	<literal>src-all</literal>，和
	<literal>ports-all</literal>。其它的 collection 只被有着特定
	目的的小部分人使用，
	有些站点可能不全部支持。</para>
      
      <variablelist>
	<varlistentry>
	  <term><literal>cvs-all release=cvs</literal></term>
	  
	  <listitem>
	    <para>FreeBSD 主 CVS 仓库，包含
	      密码系统的代码。</para>
	    
	    <variablelist>
	      <varlistentry>
		<term><literal>distrib release=cvs</literal></term>
		
		<listitem>
		  <para>FreeBSD 发行版本和镜像相关的
		    文件。</para>
		</listitem>
	      </varlistentry>
	      
	      <varlistentry>
		<term><literal>doc-all release=cvs</literal></term>
		<listitem>
		  <para>FreeBSD 使用手册和其它文档的源代码。
		    其中不包含 FreeBSD web 站点的文件。</para>
		</listitem>
	      </varlistentry>

	      <varlistentry>
		<term><literal>ports-all release=cvs</literal></term>

		<listitem>
		  <para>FreeBSD Ports Collection。</para>

		  <important id="cvsup-collec-pbase-warn">
		    <para>如果您不想升级全部的
		      <literal>ports-all</literal>(整个 ports 树)，
		      而只是使用下面列出的一个子集，
		      请确保您<emphasis>总是</emphasis>升级了
		      <literal>ports-base</literal> 子 collection！
		      无论何时在 ports 构建下层构造有所改变的时候都会通过
		      <literal>ports-base</literal> 表现出来，事实上某些
		      改变会很快的被<quote>实际的</quote>
		      ports 使用，因此，如果您只升级了
		      <quote>实际的</quote> ports 而他们使用了一些新的特性，
		      就有极大的可能编译会因一些神秘的错误信息而失败。
		      这种情况下<emphasis>非常快速的</emphasis>要做的事情
		      就是确保您的
		      <literal>ports-base</literal> 子 collection 更新到
		      最新。</para>
		  </important>

		  <important id="cvsup-collec-index-warn">
		    <para>要自行构建 <filename>ports/INDEX</filename>， 您
		      <emphasis>必须</emphasis> 接受
		      <literal>ports-all</literal> (完整的 ports tree)。
		      在部分 ports tree 上构建 <filename>ports/INDEX</filename>
		      是不被支持的。 请参见
		      <ulink url="&url.books.faq;/applications.html#MAKE-INDEX">
		      FAQ</ulink>。</para>
		  </important>

		  <variablelist>
		    <varlistentry>
		      <term><literal>ports-accessibility
			  release=cvs</literal></term>

		      <listitem>
			<para>用以帮助残疾用户的软件。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-arabic
			  release=cvs</literal></term>

		      <listitem>
			<para>阿拉伯语支持。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-archivers
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>存档工具。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-astro
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>天文相关的 ports。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-audio
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>声音支持。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-base
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>Ports Collection 构建下部构造 -
			  位于 <filename>/usr/ports</filename> 的
			  <filename>Mk/</filename> 和
			  <filename>Tools/</filename> 子目录的
			  各种各样的文件。</para>

			<note>
			  <para>请查看<link
			    linkend="cvsup-collec-pbase-warn">
			    重要警告</link>：您应该
			    <emphasis>总是</emphasis>更新这个
			    子 collection，无论您更新
			    FreeBSD Ports Collection 的任何部分的时候！</para>
			</note>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-benchmarks
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>基准。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-biology
			  release=cvs</literal></term>

		      <listitem>
			<para>生物学。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-cad
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>计算机辅助设计工具。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-chinese
			  release=cvs</literal></term>
			
		      <listitem>
			<para>中文语言支持。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-comms
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>通信软件。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-converters
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>字符编码转换。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-databases
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>数据库</para>
		      </listitem>
		    </varlistentry>
		    
		    <varlistentry>
		      <term><literal>ports-deskutils
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>计算机发明前常出现在桌面上的东西。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-devel
			  release=cvs</literal></term>

		      <listitem>
			<para>开发工具。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-dns
			  release=cvs</literal></term>

		      <listitem>
			<para>DNS 相关软件。</para>
		      </listitem>
		    </varlistentry>
		    
		    <varlistentry>
		      <term><literal>ports-editors
			  release=cvs</literal></term>

		      <listitem>
			<para>编辑器</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-emulators
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>其它操作系统的模拟器</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-finance
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>货币，金融相关应用程序。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-ftp
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>FTP 客户端和服务器端工具。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-games
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>游戏</para>
		      </listitem>
		    </varlistentry>
		    
		    <varlistentry>
		      <term><literal>ports-german
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>德语支持。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-graphics
			  release=cvs</literal></term>

		      <listitem>
			<para>图形图像工具。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-hebrew
			  release=cvs</literal></term>

		      <listitem>
			<para>希伯来语支持。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-hungarian
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>匈牙利语言支持。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-irc
			  release=cvs</literal></term>

		      <listitem>
			<para>Internet 多线交谈(IRC)工具。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-japanese
			  release=cvs</literal></term>

		      <listitem>
			<para>日语支持。</para>
		      </listitem>
		    </varlistentry>
		    
		    <varlistentry>
		      <term><literal>ports-java
			  release=cvs</literal></term>

		      <listitem>
			<para>&java; 工具。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-korean
			  release=cvs</literal></term>

		      <listitem>
			<para>韩国语言支持。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-lang
			  release=cvs</literal></term>

		      <listitem>
			<para>编程语言。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-mail
			  release=cvs</literal></term>

		      <listitem>
			<para>邮件软件。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-math
			  release=cvs</literal></term>

		      <listitem>
			<para>数值计算软件。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-mbone
			  release=cvs</literal></term>

		      <listitem>
			<para>MBone 应用程序。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-misc
			  release=cvs</literal></term>

		      <listitem>
			<para>杂样工具。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-multimedia
			  release=cvs</literal></term>

		      <listitem>
			<para>多媒体软件。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-net
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>网络软件。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-net-mgmt
			  release=cvs</literal></term>

		      <listitem>
			<para>网管软件。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-news
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>USENET 新闻软件。</para>
		      </listitem>
		    </varlistentry>
		    
		    <varlistentry>
		      <term><literal>ports-palm
			  release=cvs</literal></term>
		      
		      <listitem>
			<para><trademark class="trade">Palm</trademark>
			  系列软件支持。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-polish
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>波兰语支持。</para>
		      </listitem>
		    </varlistentry>
	
		    <varlistentry>
		      <term><literal>ports-portuguese
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>葡萄牙语支持。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-print
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>打印软件。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-russian
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>俄语支持。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-science
			  release=cvs</literal></term>

		      <listitem>
			<para>科学计算。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-security
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>安全工具。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-shells
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>命令行 shell。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-sysutils
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>系统实用工具。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-textproc
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>文本处理工具(不
			  包含桌面出版)。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-ukrainian
			  release=cvs</literal></term>

		      <listitem>
			<para>乌克兰语支持。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-vietnamese
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>越南语支持。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-www
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>万维网(WWW)相关软件。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-x11
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>支持 X window 系统的 ports。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-x11-clocks
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>X11 时钟。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-x11-fm
			  release=cvs</literal></term>

		      <listitem>
			<para>X11 文件管理器。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-x11-fonts
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>X11 字体和字体工具。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-x11-toolkits
			  release=cvs</literal></term>

		      <listitem>
			<para>X11 工具包。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-x11-servers
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>X11 服务器。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-x11-themes
			  release=cvs</literal></term>

		      <listitem>
			<para>X11 主题。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>ports-x11-wm
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>X11 窗口管理器。</para>
		      </listitem>
		    </varlistentry>
		  </variablelist>
		</listitem>
	      </varlistentry>

	      <varlistentry>
		<term><literal>src-all release=cvs</literal></term>
		
		<listitem>
		  <para>FreeBSD 主代码，包含密码系统的代码。</para>

		  <variablelist>
		    <varlistentry>
		      <term><literal>src-base
			  release=cvs</literal></term>

		      <listitem>
			<para><filename>/usr/src</filename>
			  顶层的各式各样的文件。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>src-bin
			  release=cvs</literal></term>

		      <listitem>
			<para>但用户模式下可能用到的用户工具
			  (<filename>/usr/src/bin</filename>)。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>src-contrib
			  release=cvs</literal></term>

		      <listitem>
			<para>FreeBSD 项目之外的工具和库，通常在 FreeBSD 中不作修改
			  (<filename>/usr/src/contrib</filename>)。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>src-crypto release=cvs</literal></term>

		      <listitem>
			<para>FreeBSD 项目之外的
			  密码系统工具和库，通常在 FreeBSD 中不作修改
			  (<filename>/usr/src/crypto</filename>)。</para>
			  </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>src-eBones release=cvs</literal></term>
		
		      <listitem>
			<para>Kerberos 和 DES
			  (<filename>/usr/src/eBones</filename>)。
			  没有在当前的 FreeBSD 发行中使用。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>src-etc
			  release=cvs</literal></term>

		      <listitem>
			<para>系统配置文件
			  (<filename>/usr/src/etc</filename>)。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>src-games
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>游戏
			  (<filename>/usr/src/games</filename>)。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>src-gnu
			  release=cvs</literal></term>

		      <listitem>
			<para>GNU 公共许可协议的工具
			  (<filename>/usr/src/gnu</filename>)。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>src-include
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>头文件
			  (<filename>/usr/src/include</filename>)。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>src-kerberos5
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>Kerberos5 安全包
			  (<filename>/usr/src/kerberos5</filename>)。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>src-kerberosIV
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>KerberosIV 安全包
			  (<filename>/usr/src/kerberosIV</filename>)。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>src-lib
			  release=cvs</literal></term>

		      <listitem>
			<para>库
			  (<filename>/usr/src/lib</filename>)。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>src-libexec
			  release=cvs</literal></term>

		      <listitem>
			<para>通常被其它程序调用的系统程序
			  (<filename>/usr/src/libexec</filename>)。</para>
		      </listitem>
		    </varlistentry>
		    
		    <varlistentry>
		      <term><literal>src-release
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>生成 FreeBSD 版本必需的文件
			  (<filename>/usr/src/release</filename>)。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>src-sbin release=cvs</literal></term>

		      <listitem>
			<para>但用户模式的系统工具
			  (<filename>/usr/src/sbin</filename>)。</para>
		      </listitem>
		    </varlistentry>
		    
		    <varlistentry>
		      <term><literal>src-secure
			  release=cvs</literal></term>

		      <listitem>
			<para>密码相关库和命令
			  (<filename>/usr/src/secure</filename>)。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>src-share
			  release=cvs</literal></term>

		      <listitem>
			<para>跨多个平台的共享的文件
			  (<filename>/usr/src/share</filename>)。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>src-sys
			  release=cvs</literal></term>

		      <listitem>
			<para>内核
			  (<filename>/usr/src/sys</filename>)。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>src-sys-crypto
			release=cvs</literal></term>
		
		      <listitem>
			<para>内核密码系统代码
			  (<filename>/usr/src/sys/crypto</filename>)。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>src-tools
			  release=cvs</literal></term>

		      <listitem>
			<para>维护 FreeBSD 的各种各样的工具
			  (<filename>/usr/src/tools</filename>)。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>src-usrbin
			  release=cvs</literal></term>

		      <listitem>
			<para>用户工具
			  (<filename>/usr/src/usr.bin</filename>)。</para>
		      </listitem>
		    </varlistentry>

		    <varlistentry>
		      <term><literal>src-usrsbin
			  release=cvs</literal></term>
		      
		      <listitem>
			<para>系统工具
			  (<filename>/usr/src/usr.sbin</filename>)。</para>
		      </listitem>
		    </varlistentry>
		  </variablelist>
		</listitem>
	      </varlistentry>
	      
	      <varlistentry>
		<term><literal>www release=cvs</literal></term>
		
		<listitem>
		  <para>FreeBSD WWW 站点的源代码。</para>
		</listitem>
	      </varlistentry>
	    </variablelist>
	  </listitem>
	</varlistentry>
	
	<varlistentry>
	  <term><literal>distrib release=self</literal></term>

	  <listitem>
	    <para><application>CVSup</application> 服务器的 
	      配置文件。用于 <application>CVSup</application>
	      镜像站点。</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><literal>gnats release=current</literal></term>

	  <listitem>
	    <para>GNATS bug 跟踪数据库。</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><literal>mail-archive release=current</literal></term>
	  
	  <listitem>
	    <para>FreeBSD 邮件列表存档。</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><literal>www release=current</literal></term>

	  <listitem>
	    <para>预处理过的 FreeBSD WWW 站点文件(不是源文件)。
	      用于 WWW 镜像站点。</para>
	  </listitem>
	</varlistentry>
      </variablelist>
    </sect2>

    <sect2>
      <title>更多信息</title>

      <para><application>CVSup</application> FAQ 和关于
	<application>CVSup</application> 的其它信息，请查看
	<ulink url="http://www.polstra.com/projects/freeware/CVSup/">
	  CVSup 主页</ulink>。</para>

      <para>大多数
	<application>CVSup</application> 的和 FreeBSD 相关的讨论都在
	&a.hackers;。软件的新版本在那发布，
	还有 &a.announce;。</para>
      
      <para>问题和 bug 报告应该发给
	程序作者 <email>cvsup-bugs@polstra.com</email>。</para>
    </sect2>

    <sect2 id="cvsup-mirrors">
    <title>CVSup 站点</title>

    <para>FreeBSD 的 <link linkend="cvsup">CVSup</link> 服务器运行于
      下列站点：</para>

    &chap.mirrors.cvsup.inc;
    </sect2>
  </sect1>
  
  <sect1 id="cvs-tags">
    <title>CVS 标签</title>

    <para>当使用 <application>cvs</application> 或者
      <application>CVSup</application>
      获取和升级源代码的时候，必须指定一个修订标签。
      修订标签代表 &os; 开发的一个特定分支，
      或者一个特定的时间点。第一种叫做
      <quote>分支标签</quote>，第二种叫做
      <quote>版本标签</quote>。</para>

    <sect2>
      <title>分支标签</title>

      <para>所有这些，除了 <literal>HEAD</literal> (这个总是
	合法标签)以外，只适用于 <filename>src/</filename>
	树。<filename>ports/</filename>，<filename>doc/</filename>，和
	<filename>www/</filename> 树没有分支。</para>

    <variablelist>
      <varlistentry>
	<term>HEAD</term>

	<listitem>
	  <para>主线的符号名，或者说 FreeBSD-CURRENT。
	    当没有指定修订版本的时候也是默认的。</para>

	  <para>在 <application>CVSup</application> 里，这个标签通过
	    一个 <literal>.</literal> 来反映出来(不是标点，而是一个
	    <literal>.</literal> 字符)。</para>

	  <note>
	    <para>在 CVS 里，当没有修订标签指定时这是默认的。
	      在一台 STABLE 机器上检出或者升级到 CURRENT 源代码
	      通常<emphasis>不是</emphasis>
	      一个好主意，除非这是您的本意。</para>
	  </note>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5</term>

	<listitem>
	  <para>这是 FreeBSD-5.X 的开发分支，
	    也被称作 FreeBSD 5-STABLE。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5_3</term>

	<listitem>
	  <para>FreeBSD-5.3 安全分支。 只被安全公告和其它重要更新使用。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5_2</term>

	<listitem>
	  <para>针对 FreeBSD-5.2 和 FreeBSD-5.2.1 的发行版本分支，只做
	    安全咨询和其它紧急的修正。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5_1</term>

	<listitem>
	  <para>针对 FreeBSD-5.1 的发行版本分支，只做
	    安全咨询和其它紧急的修正。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5_0</term>

	<listitem>
	  <para>针对 FreeBSD-5.0 的发行版本分支，只做
	    安全咨询和其它紧急的修正。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4</term>

	<listitem>
	  <para>FreeBSD-4.X 开发线，也被叫做
	    FreeBSD-STABLE。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_11</term>

	<listitem>
	  <para>FreeBSD-4.11 发行版， 只被安全公告和其它重要更新使用。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_10</term>

	<listitem>
	  <para>针对 FreeBSD-4.10 的发行版本分支，只做
	    安全咨询和其它紧急的修正。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_9</term>

	<listitem>
	  <para>针对 FreeBSD-4.9 的发行版本分支，只做
	    安全咨询和其它紧急的修正。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_8</term>

	<listitem>
	  <para>针对 FreeBSD-4.8 的发行版本分支，只做
	    安全咨询和其它紧急的修正。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_7</term>

	<listitem>
	  <para>针对 FreeBSD-4.7 的发行版本分支，只做
	    安全咨询和其它紧急的修正。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_6</term>

	<listitem>
	  <para>针对 FreeBSD-4.6 和 FreeBSD-4.6.2 的发行版本分支，只做
	    安全咨询和其它紧急的修正。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_5</term>

	<listitem>
	  <para>针对 FreeBSD-4.5 的发行版本分支，只做
	    安全咨询和其它紧急的修正。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_4</term>

	<listitem>
	  <para>针对 FreeBSD-4.4 的发行版本分支，只做
	    安全咨询和其它紧急的修正。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_3</term>

	<listitem>
	  <para>针对 FreeBSD-4.3 的发行版本分支，只做
	    安全咨询和其它紧急的修正。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_3</term>

	<listitem>
	  <para>FreeBSD-3.X 的开发线，也被叫做
	    3.X-STABLE。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_2_2</term>

	<listitem>
	  <para>FreeBSD-2.2.X 的开发线，也被叫做
	    2.2-STABLE。这个分支过于陈旧了。</para>
	</listitem>
      </varlistentry>
    </variablelist>
    </sect2>

    <sect2>
      <title>版本标签</title>

      <para>当一个特定的 &os; 版本发行时，
        这些标签代表了一个指定的时间点。发布工程进程在
	<ulink url="&url.base;/releng/">Release Engineering
	  Information</ulink> 和
        <ulink url="&url.articles.releng;/release-proc.html">Release
	  Process</ulink> 文档中被详细描述。
	<filename class="directory">src</filename>
	树使用以 <literal>RELENG_</literal> 开头的标签。
	<filename class="directory">ports</filename> 和
	<filename class="directory">doc</filename> 树使用以
	<literal>RELEASE</literal> 开头的标签。
	最后， <filename class="directory">www</filename> 树上不会有任何特定发行版的标签。</para>

    <variablelist>
      <varlistentry>
	<term>RELENG_4_11_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD 4.11</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5_3_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD 5.3</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_10_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD 4.10</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5_2_1_RELEASE</term>

	<listitem>
	  <para>FreeBSD 5.2.1</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5_2_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD 5.2</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_9_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD 4.9</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5_1_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD 5.1</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_8_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD 4.8</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5_0_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD 5.0</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_7_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD 4.7</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_6_2_RELEASE</term>

	<listitem>
	  <para>FreeBSD 4.6.2</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_6_1_RELEASE</term>

	<listitem>
	  <para>FreeBSD 4.6.1</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_6_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD 4.6</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_5_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD 4.5</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_4_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD 4.4</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_3_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD 4.3</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_2_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD 4.2</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_1_1_RELEASE</term>

	<listitem>
	  <para>FreeBSD 4.1.1</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_1_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD 4.1</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_0_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD 4.0</para>
	</listitem>
      </varlistentry>
	  
      <varlistentry>
	<term>RELENG_3_5_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD-3.5</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_3_4_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD-3.4</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_3_3_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD-3.3</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_3_2_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD-3.2</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_3_1_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD-3.1</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_3_0_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD-3.0</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_2_2_8_RELEASE</term>

	<listitem>
	  <para>FreeBSD-2.2.8</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_2_2_7_RELEASE</term>

	<listitem>
	  <para>FreeBSD-2.2.7</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_2_2_6_RELEASE</term>

	<listitem>
	  <para>FreeBSD-2.2.6</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_2_2_5_RELEASE</term>

	<listitem>
	  <para>FreeBSD-2.2.5</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_2_2_2_RELEASE</term>

	<listitem>
	  <para>FreeBSD-2.2.2</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_2_2_1_RELEASE</term>

	<listitem>
	  <para>FreeBSD-2.2.1</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_2_2_0_RELEASE</term>

	<listitem>
	  <para>FreeBSD-2.2.0</para>
	</listitem>
      </varlistentry>
    </variablelist>
    </sect2>
  </sect1>

  <sect1 id="mirrors-afs">
    <title>AFS 站点</title>

    <para>FreeBSD 的 AFS 服务器运行于下面的站点：</para>

    <variablelist>
      <varlistentry>
	<term>瑞典</term>

	<listitem>
	  <para>文件的路径是：
  	    <filename>/afs/stacken.kth.se/ftp/pub/FreeBSD/</filename></para>

	  <programlisting>stacken.kth.se         # Stacken Computer Club, KTH, Sweden
130.237.234.43         #hot.stacken.kth.se
130.237.237.230        #fishburger.stacken.kth.se
130.237.234.3          #milko.stacken.kth.se</programlisting>

	  <para>维护者 <email>ftp@stacken.kth.se</email></para>
	</listitem>
      </varlistentry>
    </variablelist>
  </sect1>

  <sect1 id="mirrors-rsync">
    <title>rsync 站点</title>

    <para>下面的站点让 FreeBSD 可以通过 rsync 协议下载。
      <application>rsync</application> 实用程序和
      &man.rcp.1; 的工作方式很相像，
      但是有更多的选项，使用 rsync 远程更新协议只传输
      两份文件的不同之处，
      因此能够大幅度的提高网络同步速率。  
      如果您是 FreeBSD FTP 服务器或者 CVS 仓库的镜像站点，
      这一点非常有用。
      <application>rsync</application> 套件可以工作在许多种
      操作系统上，在 FreeBSD 上，查看
      <filename role="package">net/rsync</filename>
      port 或者使用 package。</para>

    <variablelist>
      <varlistentry>
	<term>捷克共和国</term>

	<listitem>
	  <para>rsync://ftp.cz.FreeBSD.org/</para>

	  <para>可用的 collection：</para>
	  <itemizedlist>
	    <listitem><para>ftp：FreeBSD FTP 服务器的
	      部分镜像。</para></listitem>
	    <listitem><para>FreeBSD：FreeBSD FTP 服务器的
	      完整镜像。</para></listitem>
	  </itemizedlist>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>德国</term>

	<listitem>
	  <para>rsync://grappa.unix-ag.uni-kl.de/</para>

	  <para>可用的 collection：</para>
	  <itemizedlist>
	    <listitem><para>freebsd-cvs：完整的 FreeBSD
	      CVS 仓库。</para></listitem>
	  </itemizedlist>
	  <para>这台服务器也镜像 NetBSD 和 OpenBSD 项目，
	    还有其他的一些项目的 CVS 仓库。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>荷兰</term>

	<listitem>
	  <para>rsync://ftp.nl.FreeBSD.org/</para>

	  <para>可用的 collection：</para>
	  <itemizedlist>
	    <listitem><para>vol/4/freebsd-core: 对于
	      FreeBSD FTP 服务器的完整镜像。</para></listitem>
	  </itemizedlist>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>英国</term>

	<listitem>
	  <para>rsync://rsync.mirror.ac.uk/</para>

	  <para>可用的 collection：</para>
	  <itemizedlist>
	    <listitem><para>ftp.FreeBSD.org: FreeBSD FTP 服务器
	      的完整镜像。</para></listitem>
	  </itemizedlist>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>美国</term>

	<listitem>
	  <para>rsync://ftp-master.FreeBSD.org/</para>

	  <para>服务器只供 FreeBSD 主镜像站点使用。</para>
	  <para>可用的 collection：</para>
	  <itemizedlist>
	    <listitem><para>FreeBSD：FreeBSD FTP 服务器的主要存档。</para></listitem>
	    <listitem><para>acl：FreeBSD 主 ACL
	      列表。</para></listitem>  
	  </itemizedlist>

	  <para>rsync://ftp13.FreeBSD.org/</para>

	  <para>可用的 collection：</para>
	  <itemizedlist>
	    <listitem><para>FreeBSD：FreeBSD FTP 服务器的完整
	      镜像。</para></listitem>
	  </itemizedlist>
	</listitem>
      </varlistentry>
    </variablelist>
  </sect1>  
</appendix>

<!--
     Local Variables:
     mode: sgml
     sgml-declaration: "../appendix.decl"
     sgml-indent-data: t
     sgml-omittag: nil
     sgml-always-quote-attributes: t
     sgml-parent-document: ("../book.sgml" "part" "appendix")
     End:
-->
