<?xml version="1.0" encoding="euc-jp"?>
<!--
     The FreeBSD Documentation Project
     The FreeBSD Japanese Documentation Project

     Original revision: r41189
     $FreeBSD$
-->

<appendix id="mirrors">
  <title>&os; の入手方法</title>

  <sect1 id="mirrors-cdrom">
    <title>CDROM/DVD 出版社</title>

    <sect2>
      <title>CD/DVD セット</title>

      <para>&os; の CD/DVD セットは以下のオンライン業者から入手できます。</para>

    <itemizedlist>
      <listitem>
	<address>
	  <otheraddr>&os; Mall, Inc.</otheraddr>
	  <street>2420 Sand Creek Rd C-1 #347</street>
	  <city>Brentwood</city>, <state>CA</state>  <postcode>94513</postcode>
	  <country>USA</country>
	  電話: <phone>+1 925 240-6652</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>Dr. Hinner EDV</otheraddr>
	  <street>Kochelseestr. 11</street>
	  <postcode>D-81371</postcode> <city>M&uuml;nchen</city>
	  <country>Germany</country>
	  電話: <phone>(0177) 428 419 0</phone>
	  WWW: <otheraddr><ulink url="http://www.hinner.de/linux/freebsd.html"></ulink></otheraddr>
        </address>
      </listitem>

      <listitem>
	<address>
	  <otheraddr>Linux Distro UK</otheraddr>
	  <street>42 Wharfedale Road</street>
	  <city>Margate</city>
	  <postcode>CT9 2TB</postcode>
	  <country>United Kingdom</country>
	  WWW: <otheraddr><ulink url="https://linux-distro.co.uk/"></ulink></otheraddr>
        </address>
      </listitem>

      <listitem>
	<address>
	  <otheraddr>The Linux Emporium</otheraddr>
	  <street>The Techno Centre, Puma Way</street>
	  <city>Parkside</city>
	  <postcode>CV1 2TT</postcode>
	  <country>United Kingdom</country>
	  電話: <phone>+44 (0)247 615 8121</phone>
	  Fax: <fax>+44 1491 837016</fax>
	  WWW: <otheraddr><ulink url="http://www.linuxemporium.co.uk/products/bsd/"></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>+7-812-3125208</phone>
	  Email: <email>info@linuxcenter.ru</email>
	  WWW: <otheraddr><ulink url="http://linuxcenter.ru/shop/freebsd"></ulink></otheraddr>
	</address>
      </listitem>
     </itemizedlist>
    </sect2>
  </sect1>

  <sect1 id="mirrors-ftp">
    <title>FTP サイト</title>

    <para>&os; の公式な情報は anonymous FTP
      によって世界中のミラーサイトより入手できます。
      <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/"></ulink>
      サイトは接続が良く、大規模な接続を受け付けていますが、
      <quote>よりネットワーク的に近い</quote>
      ミラーサイトを探した方が良いでしょう
      (特にミラーサイトのようなものを構築しようとした場合はこれに該当します)。</para>

    <para>さらに、&os; は以下のミラーサイトから anonymous FTP
      によって入手できます。もし &os; を anonymous FTP
      によって手にいれる場合は、
      近くのサイトを利用するようにしてください。
      <quote>一次ミラーサイト</quote> としてあげられているサイトには、
      &os; の各アーキテクチャで利用可能なすべてのバージョンのアーカイブ一式が用意されています。
      あなたが住んでいる国や地域には、
      より高速にダウンロードできるサイトがおそらくあるでしょう。
      各国のミラーサイトには、
      人気のあるアーキテクチャの最新のバージョンが置いてありますが、
      &os; のアーカイブ全体はもしかするとないかもしれません。
      すべてのサイトは anonymous FTP によるアクセスを提供していますが、
      別の方法によるアクセスを提供しているサイトもあります。
      各サイトで提供しているアクセス方法は、
      ホスト名に続く括弧の中に記載されています。</para>

    &chap.mirrors.ftp.index.inc;

    &chap.mirrors.lastmod.inc;

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

  <sect1 id="mirrors-bittorrent">
    <title>BitTorrent</title>

    <indexterm>
      <primary>BitTorrent</primary>
    </indexterm>

    <para>BitTorrent を使って、リリース CD の ISO イメージをダウンロードできます。
      ISO イメージをダウンロードするための torrent ファイルは <ulink
      url="http://torrents.freebsd.org:8080/">http://torrents.freebsd.org:8080</ulink>
      にて配布されています。</para>

    <para>BitTorrent クライアントソフトは、
      <filename role="package">net-p2p/py-bittorrent</filename> port
      またはコンパイル済みの package として入手できます。</para>

    <para>BitTorrent を用いてダウンロードした ISO イメージを、
      <xref linkend="burncd"/> で説明されている burncd を使って
      CD や DVD メディアに書き込めます。</para>
  </sect1>

  <sect1 id="anoncvs">
    <title>Anonymous CVS (非推奨)</title>

    <sect2>
      <title>Warning</title>

      <warning>
	<para>CVS は、プロジェクトにおいて使用されなくなったため、
	  非推奨になりました。かわりに 
	  <ulink url="&url.books.handbook;/svn.html">Subversion</ulink>
	  を使ってください。</para>
      </warning>
    </sect2>
  </sect1>

  <sect1 id="ctm">
    <title>CTM を使う</title>

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

    <para><emphasis>訳: &a.hanai;、1997 年 9 月 13 日</emphasis></para>

    <para><application>CTM</application>
      はリモートのディレクトリツリーを中央のツリーに同期させるための
      手段です。
      これは &os; のソースツリーの配布を行なうために開発されまし
      たが、時が経つにつれて別の目的にも有用であることがわかるかも
      しれません。
      デルタを作り出す処理に関するドキュメントは現在ほとんど
      ありません。従って、もしあなたが<application>CTM</application>
      を他のことに使いたいなら
      &a.ctm-users.name; メーリングリストにさらなる情報を問い合わせてください。</para>

    <sect2>
      <title>なぜ <application>CTM</application> を使うの?</title>

      <para><application>CTM</application> を使うことにより &os;
	ソースツリーのローカルコピーを手にいれることができます。
	ソースツリーが使えることの魅力は数多くあります。完全な cvs
	ツリーを追いかけるにしても、ひとつのブランチを追いかける
	にしても <application>CTM</application>
	は必要な情報を与えてくれます。
	もしあなたが &os; のアクティブな開発者であるにもかかわらず
	お粗末な TCP/IP 接続しか持っていなかったり、または TCP/IP 接続が
	行なえないとしたら、あるいは単に変更が自動的に送られてきて
	ほしいというのであれば <application>CTM</application>
	はそんなあなたのために 作られたのです。
	アクティブなブランチでは 1
	日に最大三つまでのデルタを受け取る必要があります。
	これが自動的に e-mail で送られてくるという方法を
	ぜひ検討してみてください。
	デルタのサイズは常にできるだけ小さく保たれています。
	大抵の場合 5KB よりも小さく、
	たまに (10 回に 1 回程度) 10-50KB になり、
	ときおり 100KB かもっと大きくなるでしょう。</para>

      <para>開発ソースから直接に得られたものを使うことについては、
	あらかじめパッケージにされたリリースとは違い、
	いろいろと注意することが あります。これは特に
	<quote>current</quote> のソースを選んでいるときは重要です。
	<link linkend="current">最新の &os;
	  を追いかける</link>を読むことをお勧めします。</para>
    </sect2>

    <sect2>
      <title><application>CTM</application>を使うには何が必要?</title>

      <para>二つのものが必要でしょう: <application>CTM</application>
	プログラムとそれに与える (<quote>current</quote>
	レベルを得るための) 最初のデルタです。</para>

      <para><application>CTM</application>
	プログラムはバージョン 2.0 のリリース以来 &os; の一部になりました。
	もしソースのコピーを持っているなら
	<filename>/usr/src/usr.sbin/ctm</filename>にあります。</para>

      <para>から入手できます。<application>CTM</application>
	に与える <quote>デルタ</quote> は二つの方法、FTP または e-mail、
	で得ること ができます。
	もしインターネットに FTP アクセスできるなら、
	次の FTP サイト:</para>

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

      <para>または、その<link linkend="mirrors-ctm">ミラーサイト</link>が
	<application>CTM</application> へのアクセスをサポートします。</para>

      <para>適切なディレクトリに FTP して <filename>README</filename>
	ファイルを入手し、そこからスタートしてください。</para>

      <para>e-mail によってデルタを得たいという場合は:</para>

      <para><application>CTM</application>
	配布メーリングリストのいずれかに参加してください。
	&a.ctm-cvs-cur.name; は完全な CVS ツリー、
	&a.ctm-src-cur.name;
	は開発先端ブランチに対応しています。&a.ctm-src-9.name;
	は 9.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>
	manページを御覧ください。</para>

      <note>
	<para>どの方法を使って <application>CTM</application>
	  デルタを入手していたとしても、
	  &a.ctm-announce.name;
	  メーリングリストには参加しておくといいでしょう。
	  このメーリングリストは将来的には
	  <application>CTM</application> システムの操作に関する
	  アナウンスがポストされる唯一の場になるでしょう。
	  メーリングリストに参加するには、上のメーリングリスト名をクリックして、
          参加手順に従ってください。</para>
      </note>
    </sect2>

    <sect2>
      <title>はじめて <application>CTM</application> を使い始める</title>

      <para><application>CTM</application>
	デルタを使い始めるためには、これは以降作られる全ての
	デルタの出発点を手にいれる必要があります。</para>

      <para>最初にあなたが何をすでに持っているかをはっきりさせましょう。
	すべての人は
	<quote>空</quote> のディレクトリから始めなければなりません。
	ツリーをサポートしてるあなたの
	<application>CTM</application> を稼働するためには
	指定した <quote>空</quote>
	のデルタを使う必要があります。いくつかの分岐点
	では、あなたの都合により CD
	内に分配されている <quote>スタータ</quote>
	デルタを使用できるようになっています。しかしながら、これは
	頻繁に行われることではありません。
      </para>

      <para>適切な出発点が決まれば、その出発点を
	<application>CTM</application> が
	維持するツリーへ変換するための <quote>スタータ</quote>
	初期デルタを使う必要が あります。</para>

      <para>移行デルタは番号の後ろに <literal>X</literal>
	をつけたものがそうです
	(たとえば <filename>src-cur.3210XEmpty.gz</filename>)。
	<literal>X</literal>
	の後ろは最初の開始ポイントに対応します。
	<filename>Empty</filename> は 空のディレクトリです。
	ルールとして <literal>Empty</literal> からの移行デルタは
	100 デルタごとに 作られます。ちなみに、
	これらは非常に大きくなります!
	<filename>XEmpty</filename>のデルタは 70 から 80MB の
	<command>gzip</command>
	で圧縮されたデータというのが普通です。</para>

      <para>一度スタートするためのベースデルタを得ると、
	それに続く多数のすべてのデルタも必要になるでしょう。</para>
    </sect2>

    <sect2>
      <title><application>CTM</application> を日常で使う</title>

      <para>デルタを適用するためには、単に</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>とします。</para>

      <para><application>CTM</application>
	はどれが <command>gzip</command> されているか理解します。
	従って最初に <command>gunzip</command> しておく必要はありません。
	ディスクの節約にもなります。</para>

      <para>全体の処理に関して確信するまでは
	<application>CTM</application> は (ソース) ツリーに対して
	何もしません。また、デルタを確かめるためには
	<option>-c</option> フラグを使うことができます。
	このフラグがあると <application>CTM</application>
	はツリーに対して実際には何も行ないません。
	単にデルタの完全性を確認し、
	現在のツリーに問題なく使用できるかを確認
	するだけです。</para>

      <para><application>CTM</application>
	には他にもオプションがあります。詳細に関しては
	マニュアルページを参照するかソースを見てください。</para>

      <para>以上でやることは本当に全部です。
	新しいデルタを入手した時には、
	ソースを最新のものにするためにそれを
	<application>CTM</application>に通すだけです。</para>

      <para>もしデルタを再ダウンロードするのが
	骨の折れる作業であれば、デルタを消さないでおいてください。
	なにかおかしなことが起こった場合には置いておけば良かった
	と思うかもしれません。
	もしフロッピーディスクしか持っていない状況
	であってもコピーを取るのに
	<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> 付きのファイル名で
	コピーするだけです。あとは自由にコードをハックでき、
	<filename>.ctm</filename>  ファイルの方は
        <application>CTM</application>
	が最新状態に保ってくれます。</para>
    </sect2>

    <sect2>
      <title><application>CTM</application>
	のその他の面白いオプション</title>

      <sect3>
	<title>更新で変更されるファイルを正確に知る</title>

	<para><application>CTM</application>
	  のソースリポジトリに対する変更のリストを
	  <option>-l</option>
	  オプションを使って決定することができます。</para>

	<para>これは、変更のログを保存したい、
	  変更されたファイルをなんらかの方法で 前・後処理したい、
	  または単にこだわりたい場合には、
	  役に立つでしょう。</para>
      </sect3>

      <sect3>
	<title>更新前にバックアップを取る</title>

	<para><application>CTM</application>
	  の更新によって変更されるファイルすべてのバックアップを
	  取りたくなることがあります。</para>

	<para><option>-B backup-file</option> オプションを指定すると
	  <application>CTM</application> は
	  デルタで変更されるファイルすべてを
	  <filename>backup-file</filename>
	  としてバックアップするようになります。</para>
      </sect3>

      <sect3>
	<title>更新で変更されるファイルを制限する</title>

	<para><application>CTM</application>
	  の更新の範囲を制限したり一連のデルタのから
	  ほんの数ファイルを抽出したくなることがあります。</para>

	<para><option>-e</option> と <option>-x</option>
	  オプションを用い正規表現を指定することで、
	  <application>CTM</application>
	  が処理するファイルのリストを制御することが
	  できます。</para>

	<para>例えば、<filename>lib/libc/Makefile</filename>
	  の最新のコピーを保存してある <application>CTM</application>
	  デルタのコレクションから抽出するには、
	  以下のコマンドを実行します。</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>
	  デルタで指定されたファイルごとに、<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> コレクションに対するデルタもあるのですが、
        これに興味を持っている人はまだ少ないようです。</para>
    </sect2>

    <sect2 id="mirrors-ctm">
      <title>CTM サイト</title>

      <para><link linkend="ctm">CTM</link>/&os;
	は以下のミラーサイトから anonymous FTP によって入手できます。
	もし <application>CTM</application> を anonymous FTP によって手にいれる場合は、
	近くのサイトを利用するようにしてください。</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>南アフリカ、ctm、sup、
	    CVSupなどの古い差分ファイルのバックアップサーバ</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="svn">
    <title><application>Subversion</application> を使う</title>

    <indexterm>
      <primary>Subversion</primary>
    </indexterm>

    <sect2 id="svn-intro">
      <title>はじめに</title>

      <para>2012 年 7 月から、&os;
	はすべてのソースコード、ドキュメント、Ports Collection
	を管理するメインのバージョン管理システムに <ulink
	  url="http://subversion.apache.org/">Subversion</ulink>
	(<emphasis>svn</emphasis>) を使っています。</para>

      <note>
	<para>一般的には Subversion は開発者向けのツールです。
	  大部分のユーザは、&os; のベースシステムのアップデートに <link
	  linkend="updating-upgrading-freebsdupdate">FreeBSD
	  Update</link>、
	  Ports Collection のアップデートには <link
	  linkend="updating-upgrading-portsnap">Portsnap</link>
	  を使うべきでしょう。</para>
      </note>

      <para>Subversion では、リポジトリの指定に
	<literal>protocol://hostname/path</literal> 形式の URL を用います。
	以下に記載されているように、
	ミラーサイトは異なる複数のプロトコルに対応しています。
	アクセスする FreeBSD のリポジトリは、パス (path) の最初で指定します。
	リポジトリは 3 つあります。
	<literal>base</literal> は &os; ベースシステムのソースコード、
	<literal>ports</literal> は Ports Collection、
	そして <literal>doc</literal> はドキュメントのリポジトリです。
	たとえば、
	<literal>svn://svn0.us-east.FreeBSD.org/ports/head/</literal>
	という URL は、<literal>svn</literal> プロトコルによる <hostid
	role="fqdn">svn0.us-east.FreeBSD.org</hostid> ミラー上の
	ports リポジトリのメインブランチを示しています。</para>
    </sect2>

    <sect2 id="svn-install">
      <title>インストール</title>

      <para>リポジトリの中身をチェックアウトできるよう、事前に
	<application>Subversion</application>
	をインストールしておく必要があります。
	もし、すでに ports ツリーが用意してあれば、
	以下のようにして <application>Subversion</application>
	をインストールできます。</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/devel/subversion</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>

      <para>もし ports ツリーを利用できなければ、package から
	<application>Subversion</application> をインストールできます。</para>

      <screen>&prompt.root; <userinput>pkg_add -r subversion</userinput></screen>

      <para>もし、packages の管理に <application>pkgng</application>
	を使っているのであれば、かわりに以下のようにして
	<application>Subversion</application> をインストールできます。</para>

      <screen>&prompt.root; <userinput>pkg install devel/subversion</userinput></screen>
    </sect2>

    <sect2 id="svn-usage">
      <title><application>Subversion</application> の実行</title>

      <para><command>svn</command> コマンドを使って、
	必要なリポジトリのソースコードを以下のようにしてダウンロードします。
        このディレクトリにあるファイルを
        <emphasis>ローカル作業コピー</emphasis> と呼びます。</para>

      <warning>
	<para>すでにローカルディレクトリが存在していても、
	  それが <command>svn</command> によって生成されたディレクトリでなければ、
	  チェックアウトする前に名前を変更するか、削除してください。
	  <command>svn</command>
	  以外の方法で用意されたディレクトリでチェックアウトすると、
	  すでに存在するファイルと、
	  リポジトリから持ってきたファイルとの間で衝突が起きてしまいます。</para>
      </warning>
 
      <para>以下のように入力して、リポジトリからチェックアウトしてください。</para>

      <screen>&prompt.root; <userinput>svn checkout <replaceable>svn-mirror</replaceable>/<replaceable>repository</replaceable>/<replaceable>branch</replaceable> <replaceable>lwcdir</replaceable></userinput></screen>

      <para>ここで、<replaceable>repository</replaceable>,
	<replaceable>branch</replaceable> および <replaceable>root</replaceable>
	は以下のとおりです。</para>

      <itemizedlist>
	<listitem>
	  <para><replaceable>svn-mirror</replaceable> は、
	    <link linkend="svn-mirrors">Subversion
	    ミラーサイト</link> のひとつの URL です。</para>
	</listitem>

	<listitem>
	  <para><replaceable>repository</replaceable> には、
	    プロジェクトのリポジトリ、すなわち <literal>base</literal>,
	    <literal>ports</literal>, または <literal>doc</literal>
	    のどれかひとつを指定します。</para>
	</listitem>

	<listitem>
	  <para><replaceable>branch</replaceable> は、使うリポジトリによります。
	    <literal>ports</literal> および <literal>doc</literal>
	    では、ほとんどの変更が
	    <literal>head</literal> ブランチで行われます。
	    <literal>base</literal> リポジトリでは、<literal>head</literal>
	    ブランチで -CURRENT の最新バージョンを管理しています。
	    -STABLE ブランチの最新バージョンは、8.<replaceable>x</replaceable> は
	    <literal>stable/8</literal>、
	    9.<replaceable>x</replaceable> は <literal>stable/9</literal>
	    で管理しています。</para>
	</listitem>

	<listitem>
	  <para><replaceable>lwcdir</replaceable> は、
	    指定したブランチの中身が置かれるターゲットのディレクトリです。
	    通常 <literal>ports</literal> は <filename
	    class="directory">/usr/ports</filename>、
	    <literal>base</literal> は <filename
	    class="directory">/usr/src</filename>、
	    そして <literal>doc</literal> では <filename
	    class="directory">/usr/doc</filename> と指定します。</para>
	</listitem>
      </itemizedlist>

      <para>以下の例では、Ports Collection を western US リポジトリから
        <acronym>HTTPS</acronym> プロトコルを使って、チェックアウトします。
	そしてそれらは、
	<filename class="directory">/usr/ports</filename>
	のローカル作業コピーに置かれます。
	もし <filename class="directory">/usr/ports</filename> がすでに存在して、
	それが <command>svn</command> によって生成されたものでなければ、
	チェックアウトする前に、名前を変更するか削除してください。</para>

      <screen>&prompt.root; <userinput>svn checkout <replaceable>https://svn0.us-west.FreeBSD.org</replaceable>/ports/head /usr/ports</userinput></screen>

      <para>初めてチェックアウトする際には、
	リモートリポジトリのすべてのブランチをダウンロードするので時間がかかります。
	どうぞ我慢してください。</para>

      <para>初めてのチェックアウト後は、
	以下を実行することでローカル作業コピーをアップデートできます。</para>

      <screen>&prompt.root; <userinput>svn update <replaceable>lwcdir</replaceable></userinput></screen>

      <para>この例で作成された
	<filename class="directory">/usr/ports</filename> をアップデートするには、
	以下のようにしてください。</para>

      <screen>&prompt.root; <userinput>svn update /usr/ports</userinput></screen>

      <para>アップデートはチェックアウトにくらべ、
	変更点のあるファイルのみが転送されるので高速です。</para>

      <para>チェックアウト後、ローカル作業コピーをアップデートするもうひとつの方法は、
	<filename
	class="directory">/usr/ports</filename>,
	<filename class="directory">/usr/src</filename> または
	<filename class="directory">/usr/doc</filename> ディレクトリの
	<filename>Makefile</filename> で提供されています。
	<makevar>SVN_UPDATE</makevar> を設定して
	<maketarget>update</maketarget> ターゲットを使ってください。
	たとえば、<filename class="directory">/usr/src</filename>
        をアップデートするには、以下のようにしてください。</para>

      <screen>&prompt.root; <userinput>cd /usr/src</userinput>
&prompt.root; <userinput>make update SVN_UPDATE=yes</userinput></screen>
    </sect2>

    <sect2>
      <title>より詳しい情報</title>

      <para><application>Subversion</application> の利用に関する他の情報は、<ulink
	url="http://svnbook.red-bean.com/">Version Control with
	Subversion</ulink> や <ulink
	url="http://subversion.apache.org/docs/">Subversion
	Documentation</ulink> といった
	<quote>Subversion Book</quote> をご覧ください。</para>
    </sect2>
  </sect1>

  <sect1 id="svn-mirrors">
    <title><application>Subversion</application> ミラーサイト</title>

    <indexterm>
      <primary>Subversion Repository</primary>
      <secondary>ミラーサイト</secondary>
    </indexterm>

    <para>すべてのミラーはすべてのリポジトリを持っています。</para>

    <para>&os; <application>Subversion</application> サーバのマスタである
      <hostid role="fqdn">svn.FreeBSD.org</hostid> は、
      公には読み出し専用でアクセスできますが、
      将来的には変更される予定ですので、
      オフィシャルミラーを使うことが推奨されます。
      ブラウザを用いて &os; の Subversion リポジトリを参照するには、<ulink
	url="http://svnweb.FreeBSD.org/">http://svnweb.FreeBSD.org/</ulink>
      を利用してください。</para>

    <note>
      <para>&os; の svn ミラーネットワークは、
	まだ初期の段階にあるので、今後変更されることがあります。
	以下のミラー一覧を不変なものとは考えないでください。
      特に、サーバの SSL 証明書は、いずれかの時点で変更になるでしょう。</para>
    </note>

    <informaltable>
      <tgroup cols="4">
	<colspec colwidth="3"/>
	<colspec colwidth="1"/>
	<colspec colwidth="2"/>
	<colspec colwidth="10"/>
	<thead>
	  <row>
	    <entry>名前</entry>

	    <entry>プロトコル</entry>

	    <entry>位置</entry>

	    <entry>SSL フィンガープリント</entry>
	  </row>
	</thead>

	<tbody>
	  <row>
	    <entry><hostid
		role="fqdn">svn0.us-west.FreeBSD.org</hostid></entry>

	    <entry>svn, <ulink
		url="http://svn0.us-west.FreeBSD.org/">http</ulink>,
	      <ulink
		url="https://svn0.us-west.FreeBSD.org/">https</ulink></entry>

	    <entry>USA, カリフォルニア</entry>

	    <entry>SHA1
	      <literal>79:35:8F:CA:6D:34:D9:30:44:D1:00:AF:33:4D:E6:11:44:4D:15:EC</literal></entry>
	  </row>

	  <row>
	    <entry><hostid
		role="fqdn">svn0.us-east.FreeBSD.org</hostid></entry>

	    <entry>svn, <ulink
		url="http://svn0.us-east.FreeBSD.org/">http</ulink>,
	      <ulink
		url="https://svn0.us-east.FreeBSD.org/">https</ulink></entry>

	    <entry>USA, ニュージャージ</entry>

	    <entry>SHA1
	      <literal>06:D1:23:DE:5E:7A:F7:2B:7A:7E:74:95:5F:54:8D:5C:B0:D6:2E:8F</literal></entry>
	  </row>
	</tbody>
      </tgroup>
    </informaltable>

    <para><acronym>HTTPS</acronym> は推奨されているプロトコルです。
      他のコンピュータが &os; ミラーを装う (一般的には
      <quote>マン・イン・ザ・ミドル</quote> 攻撃として知られています) ことや、
      もしくは、エンドユーザに対し好ましくない内容を送りつけようということに対し保護を行います。</para>

    <para><acronym>HTTPS</acronym> ミラーへの最初の接続の際には、
      サーバの <emphasis>フィンガープリント</emphasis> の確認を求められます。</para>

    <screen>Error validating server certificate for 'https://svn0.us-west.freebsd.org:443':
 - The certificate is not issued by a trusted authority. Use the
   fingerprint to validate the certificate manually!
Certificate information:
 - Hostname: svnmir.ysv.FreeBSD.org
 - Valid: from Fri, 24 Aug 2012 22:04:04 GMT until Sat, 24 Aug 2013 22:04:04 GMT
 - Issuer: clusteradm, FreeBSD.org, CA, US
 - Fingerprint: 79:35:8f:ca:6d:34:d9:30:44:d1:00:af:33:4d:e6:11:44:4d:15:ec
(R)eject, accept (t)emporarily or accept (p)ermanently?</screen>

    <para>フィンガープリントを上の表の一覧のものと照合してください。
      フィンガープリントが一致したら、
      サーバのセキュリティ証明書を一時的 (permanently)
      もしくは恒久的 (temporarily) に受け入れてください。
      一時的な認証であれば、サーバとの一回のセッションで有効期限が切れるため、
      次回の接続時にはもう一度検証が行われます。
      恒常的な認証を選んだ場合には、認証のための証明書が
      <filename class="directory">~/.subversion/auth/</filename> に保存され、
      有効期限が切れるまでは、フィンガープリントの確認は求められません。</para>

    <para>ファイアウォールまたは他の問題のため、<acronym>HTTPS</acronym>
      を使えなければ、転送速度がより少し早い <literal>SVN</literal> を使ってください。
      両方を使えない場合には、
      <acronym>HTTP</acronym> を使ってください。</para>
  </sect1>

  <sect1 id="cvsup">
    <title>CVSup を使う (非推奨)</title>

    <para><emphasis>訳: &a.jp.iwasaki;、1997 年 2 月 27 日</emphasis></para>

    <sect2 id="cvsup-intro">
      <title>紹介</title>

      <warning>
	<para><command>cvsup</command> は、
	  プロジェクトにおいて使用されなくなったため、
	  非推奨になりました。
	  かわりに <application>Subversion</application>
	  を使ってください。</para>
      </warning>

      <para><application>CVSup</application> は、
	リモートのサーバホストにあるマスタ CVS リポジトリから
	ソースツリーを配布し更新するための
	ソフトウェアパッケージです。&os; のソースは、
	カリフォルニアにある中心的な開発マシンの CVS リポジトリの
	中でメンテナンスしています。<application>CVSup</application>
	を使用することで、&os; ユーザは
	簡単に自分のソースツリーを最新の状態に
	しておくことができます。</para>

      <para><application>CVSup</application> は
	<emphasis>pull</emphasis>
	モデルとよばれる更新のモデルを採用しています。pull
	モデルでは、
	各クライアントが更新したい場合に更新したい時点で、
	サーバに更新の問い合わせをおこないます。
	サーバはクライアントからの
	更新の要求を受け身の状態で待ちます。したがって、
	すべての更新はクライアント主導でおこなわれます。
	サーバは頼まれもしない更新情報を送るようなことはしません。
	ユーザは <application>CVSup</application>
	クライアントを手動で実行して更新をおこなうか、
	<command>cron</command>
	ジョブを設定して定期的に自動実行する必要があります。</para>

      <para>用語 <application>CVSup</application>
	のように大文字で表記しているものは、ソフトウェアパッケージ
	全体を指します。主な構成物は、
	各ユーザマシンで実行するクライアントである
	<command>cvsup</command>、&os;
	の各ミラーサイトで実行するサーバ <command>cvsupd</command>
	です。</para>

      <note>
	<para><application>csup</application> ユーティリティは
	  <application>CVSup</application>
	  ソフトウェアを C 言語で書き直したものです。
	  処理速度が速く、また、Modula-3 言語を使わないため、
	  Modula-3 をインストールする必要がありません。
	  さらに、ベースシステムに含まれているので、
	  すぐに使うことができます。
	  <application>csup</application> を使う場合は、
	  <application>CVSup</application> のインストールを省略し、
	  以下の文章中の <application>CVSup</application> を
	  <application>csup</application> に置きかえて読んでください。</para>
      </note>
    </sect2>

    <sect2 id="cvsup-install">
      <title>インストール</title>

      <para><application>CVSup</application>
	をインストールする最も簡単な方法は、&os;
	<link linkend="ports">Ports コレクションのパッケージ</link>
	からコンパイル済みの
	<filename role="package">net/cvsup</filename> パッケージをインストールすることです。
	もしくは、<filename role="package">net/cvsup</filename> でも構いません。
	ただし、<filename role="package">net/cvsup</filename> は
	Modula-3 システムに依存していて、構築にかかる時間、
	ディスクスペースは比較的大きくなります。</para>

	<note>
	  <para>たとえばサーバのような <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>
	と呼ばれるコンフィグレーションファイルで制御します。
	<filename>supfile</filename> のサンプルは、ディレクトリ
        <ulink url="file://localhost/usr/share/examples/cvsup/"><filename>/usr/share/examples/cvsup/</filename></ulink>
        の下にあります。
      </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">
	      どこに status ファイルを置きたいのか?</link></para>
	</listitem>
      </itemizedlist>

      <para>次のセクションで、これらの質問に順番に答えながら典型的な
	<filename>supfile</filename> を組み立てていきます。最初に
	<filename>supfile</filename> の全体構造を説明します。</para>

      <para><filename>supfile</filename> はテキストファイルです。
	コメントは <literal>#</literal> から行末までです。
	空行とコメントだけの行は無視します。</para>

      <para>残りの各行には、
	ユーザが受け取りたいファイル群について記述します。
	行の始めは、
	サーバ側で定義した論理的なファイルのグループである
	<quote>コレクション</quote> の名称です。
	コレクションの名称を指定して、欲しいファイル群を
	サーバに伝えます。コレクション名の後には、
	ホワイトスペースで区切られた 0 個以上のフィールドが続きます。
	これらのフィールドが上記の質問に対する答えになります。
	フィールドには 2 種類あります: flag フィールドと value
	フィールドです。flag フィールドは <literal>delete</literal>
	や <literal>compress</literal> のような
	単独のキーワードから成ります。また、value
	フィールドもキーワードで始まりますが、
	キーワードの後にはホワイトスペースは入らず、
	<literal>=</literal> と二つめの単語が続きます。例えば、
	<literal>release=cvs</literal> は value
	フィールドです。</para>

      <para>通常、<filename>supfile</filename>
	には受け取りたいコレクションを一つ以上指定します。
	<filename>supfile</filename> を組み立てる一つの方法として、
	コレクション毎にすべての関係の
	あるフィールドを明示的に指定する方法があります。しかし、
	これでは <filename>supfile</filename>
	のすべてのコレクションに対して
	ほとんどのフィールドが同じになるため、
	行が非常に長くなってしまい不便になります。
	これらの問題を避けるため、<application>CVSup</application>
	ではデフォルトを指定することのできる
	メカニズムが提供されています。特殊な擬似コレクション名
	<literal>*default</literal> で始まる行は、
	<filename>supfile</filename> 中の後続の
	コレクションに対して使用する flag フィールドと value
	フィールドのデフォルトを設定するために利用できます。
	個々のコレクションで固有の値を指定すると、
	デフォルト値を無効にできます。また <option>*default</option>
	行を追加すると、<filename>supfile</filename>
	の途中からデフォルト値の変更や追加が可能になります。</para>

      <para>これまでの予備知識を基に、
	<link linkend="current">&os;-CURRENT</link>
	のメインのソースツリーを受け取って更新するための
	<filename>supfile</filename> を組み立ててみましょう。</para>

      <itemizedlist>
	<listitem>
	  <para><anchor id="cvsup-config-files"/>
	    どのファイルを受け取りたいのか?</para>

	  <para><application>CVSup</application>
	    を通して入手できるファイルは <quote>コレクション</quote>
	    と呼ばれる名前の付けられたグループにまとめられています。
	    利用可能なコレクションについては
	    <link linkend="cvsup-collec">後の節</link>の中で説明しています。
	    ここでは、&os; システムのメインのソースツリー全体
	    を受け取るための設定例を紹介します。
	    すべてを含む <literal>src-all</literal>
	    という単一の大きなコレクションがあります。
	    <filename>supfile</filename>
	    を組み立てる最初のステップとして、
	    これらのコレクションを一行に一つずつ記述します
	    (この場合は一行だけです)。</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> の value フィールドを使用して、
	    欲しいバージョンの 一つを指定します。</para>

	  <warning>
	    <para><literal>tag=</literal>
	      のフィールドの指定は正確に行うように十分注意
	      してください。いくつかのタグは特定のコレクションに
	      対してのみ有効です。
	      タグの綴りが違っていたり不適切なタグを指定すると、
	      <application>CVSup</application> はユーザが消し
	      たくないファイルまで削除してしまいます。特に
	      <literal>ports-*</literal> のコレクション に対しては
	      <literal>tag=.</literal> <emphasis>だけ</emphasis>
	      を指定するようにしてください。</para>
	  </warning>

	  <para><literal>tag=</literal>
	    フィールドはリポジトリ中のシンボリックタグを指定します。
	    tag には revision tag と branch tag の二種類があります。
	    revision tag は特定のリビジョンを指します。これは、
	    毎日同じ状態に保つことになります。一方 branch tag は、
	    ある時点での開発分流の最新のリビジョンを指します。
	    branch tag
	    は特定のリビジョンを指定している訳ではないので、
	    今日と明日では
	    異なるリビジョンを参照することになるかもしれません。</para>

	  <para><xref linkend="cvs-tags"/>
        にはユーザが興味を持つであろうリビジョンタグの一覧が載せられています。
	    <application>CVSup</application> の設定ファイル中でタグを指定する時は、
	    <literal>tag=</literal> に続けて書きます
	    (<literal>RELENG_8</literal> は
	    <literal>tag=RELENG_8</literal> になります)。
	    <literal>tag=.</literal> だけが Ports Collection には
	    適切であることに注意してください。</para>

	  <warning>
	    <para>tag
	      名を示した通りにタイプされているか十分注意してく
	      ださい。<application>CVSup</application> は tag
	      名が正しいかどうかを見分けることはできません。tag
	      が間違っていた場合、
	      たまたまファイルがまったく存在しない正しい tag が
	      指定されたものとして<application>CVSup</application>
	      は動作します。その場合は、現在あるソースが削
	      除されるでしょう。</para>
	  </warning>

	  <para>branch tag を指定した際には、
	    通常はその開発分流の最新バージョンの
	    ファイルを受け取ります。
	    いくらか前のバージョンを受け取りたい場合は、
	    <option>date=</option> の value
	    フィールドを使って日付を指定することで、
	    これを実現することが できます。&man.cvsup.1;
	    のマニュアルページで、
	    その方法を説明しています。</para>

	    <para>例として、&os;-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>更新情報をどこから入手するかを
	    <command>cvsup</command> に伝えるために
	    <literal>host=</literal> フィールドを使用します。
	    <link linkend="cvsup-mirrors">CVSup ミラーサイト</link>
	    のどこからでも入手できますが、
	    ネット上での最寄りのサイトを選ぶべきでしょう。
	    この例では、仮想上の &os; 配布サイト
	    <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>
	    ディレクトリはすでにファイルを受け取るために
	    選択したコレクションで暗黙に指定しているので、
	    これは正しい仕様となります:</para>

	  <programlisting>*default prefix=/usr</programlisting>
	</listitem>

	<listitem>
	  <para><anchor id="cvsup-config-status"/>
	    どこに status ファイルを置きたいのか?</para>

	  <para><application>CVSup</application> クライアントは
	    <quote>base</quote>
	    ディレクトリと呼ばれる場所に、ある status
	    ファイルを維持しています。
	    すでに受け取った更新情報を追従し続けることで、
	    これらのファイルは <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> は、サーバがメインの
	    &os; 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 speed 以上である場合、
	    この圧縮を使用しない方がよいかもしれません。
	    そうでない場合は十分に役に立ちます。</para>
	</listitem>

	<listitem>
	  <para><filename>supfile</filename> の例のまとめ:</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 method)</emphasis>を用いるのですが、
          これは基本的に次のようなことを意味します。
          まずあなたが <application>CVSup</application> サーバに接続します。
          するとサーバは
          <quote>あなたがダウンロードできるのはこれこれです</quote> と言います。
          それに対し、あなたが使っているクライアントは
          <quote>わかりました。
            では、これとこれとこれをもらいます</quote> と答えます。
          デフォルトの設定の <application>CVSup</application> クライアントは、
	  設定ファイルで選んだコレクションとタグに適合するすべてのファイルを取得します。
	  ツリーの一部をダウンロードするには、
	  <filename>refuse</filename> ファイルを使ってください。</para>

        <para><filename>refuse</filename> ファイルは
          <application>CVSup</application> に対し、
          コレクションに含まれる一部のファイルを取得することを伝えます。
          言い換えれば、それはクライアントに対し、
          サーバから来る一部のファイルを<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>

	<programlisting>bin/
usr.bin/</programlisting>

	<para>まったく必要としないファイルをダウンロードする必要がなくなり、
	  インターネット接続の回線が遅かったり従量制で課金されている人は時間を節約できるようになります。
          <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>
        ツリーを更新しているので、<command>cvsup</command>
        にファイルを更新するのに必要なパーミッションを与えるために、
        ユーザ <username>root</username> で実行する必要があります。
        コンフィグレーションファイルを作ったばかりで、
        しかも以前にこのプログラムを実行したことがないので、
        神経質になるのは無理もない話だと思います。
        大切なファイルに触らずに試しに実行する簡単な方法があります。
        どこか適当な場所に空のディレクトリを作成して、
        コマンドラインの引数で指定するだけです:</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 ディレクトリの status
        ファイルを更新せずにそのままにします。
        これらのファイルの新しいバージョンは指定されたディレクトリ
        に書き込まれます。<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> を定期的に
        実行させる準備をすることができます。cron から起動する際には、
        明示的に <application>CVSup</application> が GUI
        を使わないようにする必要があります。</para>
    </sect2>

    <sect2 id="cvsup-collec">
      <title><application>CVSup</application> ファイルコレクション</title>

      <para><application>CVSup</application>
        経由で入手できるファイルコレクションは
        階層的に組織化されています。
        いくつか大きなコレクションがあり、
        それらは小さなサブコレクションに 分割されています。
        大きなコレクションは、そのサブコレクション毎に
        受信することと同じことになります。
        下の一覧ではコレクション間の階層関係を
        字下げして表現します。</para>

      <para>最も一般的に使用するコレクションは
        <literal>src-all</literal> です。</para>

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

          <listitem>
            <para>メインの &os; CVS リポジトリであり、
              暗号のコードを含んでいます。</para>

            <variablelist>
              <varlistentry>
                <term><literal>distrib release=cvs</literal></term>

                <listitem>
                  <para>&os;
                    の配布とミラーに関連するファイルです。</para>
                </listitem>
              </varlistentry>

              <varlistentry>
		<term><literal>projects-all release=cvs</literal></term>
		<listitem>
		  <para>&os; プロジェクトのリポジトリのソース。</para>
		</listitem>
	      </varlistentry>

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

                <listitem>
                  <para>メインの &os; ソース群であり、
                    暗号のコードを含んでいます。</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-cddl
			  release=cvs</literal></term>

		      <listitem>
			<para>CDDL ライセンスのユーティリティおよびライブラリ
			  (<filename>/usr/src/cddl</filename>)。</para>
		      </listitem>
		    </varlistentry>

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

                      <listitem>
                        <para>&os; プロジェクト外部からの
                          ユーティリティおよびライブラリ、
                          比較的無修正
                          (<filename>/usr/src/contrib</filename>)。</para>
                      </listitem>
                    </varlistentry>

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

		      <listitem>
		        <para>&os; プロジェクトの外部で開発された暗号ユーティリティとライブラリで、
		          ほとんどそのままの形で使われます
		          (<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>) のこと。
		          現在の &os; リリースでは使われていません。</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 Public License
                          下にあるユーティリティ
                          (<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>&os; の release
                          を構築するために必要なファイル
                          (<filename>/usr/src/release</filename>)。</para>
                      </listitem>
                    </varlistentry>

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

		      <listitem>
			<para>システム復旧のためのスタティックリンクされている緊急用プログラム。
			   &man.rescue.8; をご覧ください
			  (<filename>/usr/src/rescue</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>&os; の保守用の色々なツール
                          (<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>&os; WWW サイトのソースです。</para>
                </listitem>
              </varlistentry>
            </variablelist>
          </listitem>
        </varlistentry>

        <varlistentry><term><literal>distrib release=self</literal></term>
          <listitem>
            <para><application>CVSup</application>
              サーバ自身のコンフィグレーションファイルです。CVSup
              ミラーサイトが使用します。</para>
          </listitem>
        </varlistentry>

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

          <listitem>
            <para>GNATS バグトラッキングデータベースです。</para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term><literal>mail-archive release=current</literal></term>

          <listitem>
	    <para>&os; 関連メーリングリストのアーカイブ。</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>

    <sect2>
      <title>詳細について</title>

      <para><application>CVSup</application> の FAQ や
        <application>CVSup</application> に関するその他の情報については
        <ulink url="http://www.cvsup.org">
          The CVSup Home Page</ulink> をご覧ください。</para>

      <para><application>CVSup</application> のほとんどの &os;
        関連の議論は &a.hackers; でおこなわれています。
        ソフトウェアの新しいバージョンは &a.announce; で
        アナウンスされます。</para>

      <para><application>CVSup</application> に関する質問やバグ報告については
	<ulink url="http://www.cvsup.org/faq.html#bugreports">
	CVSup FAQ</ulink> をご覧ください。</para>
    </sect2>

    <sect2 id="cvsup-mirrors">
      <title>CVSup サイト</title>

      <para>&os; の <link linkend="cvsup">CVSup</link>
        サーバは以下のサイトで稼働しています。</para>

      &chap.mirrors.cvsup.index.inc;

      &chap.mirrors.lastmod.inc;

      &chap.mirrors.cvsup.inc;
    </sect2>
  </sect1>

  <sect1 id="cvs-tags">
    <title>CVS タグ</title>

    <warning>
      <para>CVS は、プロジェクトにおいて使用されなくなったため、
	非推奨になりました。
	かわりに <application>Subversion</application>
	を使ってください。</para>
    </warning>

    <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>主要部をなす流れ、すなわち &os;-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_9</term>

	<listitem>
	  <para>&os;-9.X の開発のための流れです。
	    &os; 9-STABLE としても知られています。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_9_0</term>

	<listitem>
	  <para>&os;-9.0 用のリリースブランチ。セキュリティ勧告や
	    その他の深刻なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_8</term>

	<listitem>
	  <para>&os;-8.X の開発のための流れです。
	    &os; 8-STABLE としても知られています。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_8_3</term>

	<listitem>
	  <para>&os;-8.3 用のリリースブランチ。セキュリティ勧告や、
	    その他の深刻なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_8_2</term>

	<listitem>
	  <para>&os;-8.2 用のリリースブランチ。セキュリティ勧告や
	    その他の深刻なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_8_1</term>

	<listitem>
	  <para>&os;-8.1 用のリリースブランチ。セキュリティ勧告や
	    その他の深刻なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_8_0</term>

	<listitem>
	  <para>&os;-8.0 用のリリースブランチ。セキュリティ勧告や
	    その他の深刻なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_7</term>

	<listitem>
	  <para>&os;-7.X の開発のための流れです。
	    &os; 7-STABLE としても知られています。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_7_4</term>

	<listitem>
	  <para>&os;-7.4 用のリリースブランチ。セキュリティ勧告や
	    その他の深刻なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_7_3</term>

	<listitem>
	  <para>&os;-7.3 用のリリースブランチ。セキュリティ勧告や
	    その他の深刻なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_7_2</term>

	<listitem>
	  <para>&os;-7.2 用のリリースブランチ。セキュリティ勧告や
	    その他の深刻なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_7_1</term>

	<listitem>
	  <para>&os;-7.1 用のリリースブランチ。セキュリティ勧告や
	    その他の深刻なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_7_0</term>

	<listitem>
	  <para>&os;-7.0 用のリリースブランチ。セキュリティ勧告や
	    その他の深刻なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_6</term>

	<listitem>
	  <para>&os;-6.X の開発のための流れです。
	    &os; 6-STABLE としても知られています。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_6_4</term>

	<listitem>
	  <para>&os;-6.4 用のリリースブランチ。セキュリティ勧告や
	    その他の深刻なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_6_3</term>

	<listitem>
	  <para>&os;-6.3 用のリリースブランチ。セキュリティ勧告や
	    その他の深刻なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_6_2</term>

	<listitem>
	  <para>&os;-6.2 用のリリースブランチ。セキュリティ勧告や
	    その他の深刻なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_6_1</term>

	<listitem>
	  <para>&os;-6.1 用のリリースブランチ。セキュリティ勧告や
	    その他の深刻なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_6_0</term>

	<listitem>
	  <para>&os;-6.0 用のリリースブランチ。セキュリティ勧告や
	    その他の深刻なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5</term>

	<listitem>
	  <para>&os;-5.X の開発のための流れです。
	    &os; 5-STABLE としても知られています。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5_5</term>

	<listitem>
	  <para>&os;-5.5 用のリリースブランチ。セキュリティ勧告や
	    その他の深刻なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5_4</term>

	<listitem>
	  <para>&os;-5.4 用のリリースブランチ。セキュリティ勧告や
	    その他の深刻なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5_3</term>

	<listitem>
	  <para>&os;-5.3 用のリリースブランチ。セキュリティ勧告や
	    その他の深刻なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5_2</term>

	<listitem>
	  <para>&os;-5.2 および &os;-5.2.1 用のリリースブランチ。セキュリティ勧告や
	    その他の深刻なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

       <varlistentry>
	<term>RELENG_5_1</term>

	<listitem>
	  <para>&os;-5.1 用のリリースブランチ。セキュリティ勧告や
            その他の深刻なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5_0</term>

	<listitem>
	  <para>&os;-5.0 用のリリースブランチ。セキュリティ勧告や
            その他の重要なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4</term>

	<listitem>
	  <para>&os;-4.X の開発のための流れです。
	    &os; 4-STABLE としても知られています。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_11</term>

	<listitem>
	  <para>&os;-4.11 用のリリースブランチ。セキュリティ勧告や
	    その他の重要なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_10</term>

	<listitem>
	  <para>&os;-4.10 用のリリースブランチ。セキュリティ勧告や
	    その他の重要なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_9</term>

	<listitem>
	  <para>&os;-4.9 用のリリースブランチ。セキュリティ勧告や
            その他の重要なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_8</term>

	<listitem>
	  <para>&os;-4.8 用のリリースブランチ。セキュリティ勧告や
            その他の重要なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_7</term>

	<listitem>
	  <para>&os;-4.7 用のリリースブランチ。セキュリティ勧告や
            その他の重要なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_6</term>

	<listitem>
	  <para>&os;-4.6 および &os;-4.6.2 用のリリースブランチ。セキュリティ勧告や
            その他の重要なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_5</term>

	<listitem>
	  <para>&os;-4.5 用のリリースブランチ。セキュリティ勧告や
            その他の重要なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_4</term>

	<listitem>
	  <para>&os;-4.4 用のリリースブランチ。セキュリティ勧告や
            その他の重要なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_3</term>

	<listitem>
	  <para>&os;-4.3 用のリリースブランチ。セキュリティ勧告や
            その他の重要なセキュリティ上の修正があった場合にのみ使われます。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_3</term>

	<listitem>
	  <para>&os;-3.X の開発のための流れです。
            3.X-STABLE としても知られています。</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_2_2</term>

	<listitem>
	  <para>&os;-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.en;/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_9_0_0_RELEASE</term>

	<listitem>
	  <para>&os; 9.0</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_8_3_0_RELEASE</term>

	<listitem>
	  <para>&os; 8.3</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_8_2_0_RELEASE</term>

	<listitem>
	  <para>&os; 8.2</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_8_1_0_RELEASE</term>

	<listitem>
	  <para>&os; 8.1</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_8_0_0_RELEASE</term>

	<listitem>
	  <para>&os; 8.0</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_7_4_0_RELEASE</term>

	<listitem>
	  <para>&os; 7.4</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_7_3_0_RELEASE</term>

	<listitem>
	  <para>&os; 7.3</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_7_2_0_RELEASE</term>

	<listitem>
	  <para>&os; 7.2</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_7_1_0_RELEASE</term>

	<listitem>
	  <para>&os; 7.1</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_7_0_0_RELEASE</term>

	<listitem>
	  <para>&os; 7.0</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_6_4_0_RELEASE</term>

	<listitem>
	  <para>&os; 6.4</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_6_3_0_RELEASE</term>

	<listitem>
	  <para>&os; 6.3</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_6_2_0_RELEASE</term>

	<listitem>
	  <para>&os; 6.2</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_6_1_0_RELEASE</term>

	<listitem>
	  <para>&os; 6.1</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_6_0_0_RELEASE</term>

	<listitem>
	  <para>&os; 6.0</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5_5_0_RELEASE</term>

	<listitem>
	  <para>&os; 5.5</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5_4_0_RELEASE</term>

	<listitem>
	  <para>&os; 5.4</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_11_0_RELEASE</term>

	<listitem>
	  <para>&os; 4.11</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5_3_0_RELEASE</term>

	<listitem>
	  <para>&os; 5.3</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_10_0_RELEASE</term>

	<listitem>
	  <para>&os; 4.10</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5_2_1_RELEASE</term>

	<listitem>
	  <para>&os; 5.2.1</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5_2_0_RELEASE</term>

	<listitem>
	  <para>&os; 5.2</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_9_0_RELEASE</term>

	<listitem>
	  <para>&os; 4.9</para>
	</listitem>
      </varlistentry>

       <varlistentry>
	<term>RELENG_5_1_0_RELEASE</term>

	<listitem>
	  <para>&os; 5.1</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_8_0_RELEASE</term>

	<listitem>
	  <para>&os; 4.8</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_5_0_0_RELEASE</term>

	<listitem>
	  <para>&os; 5.0</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_7_0_RELEASE</term>

	<listitem>
	  <para>&os; 4.7</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_6_2_RELEASE</term>

	<listitem>
	  <para>&os; 4.6.2</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_6_1_RELEASE</term>

	<listitem>
	  <para>&os; 4.6.1</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_6_0_RELEASE</term>

	<listitem>
	  <para>&os; 4.6</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_5_0_RELEASE</term>

	<listitem>
	  <para>&os; 4.5</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_4_0_RELEASE</term>

	<listitem>
	  <para>&os; 4.4</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_3_0_RELEASE</term>

	<listitem>
	  <para>&os; 4.3</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_2_0_RELEASE</term>

	<listitem>
	  <para>&os; 4.2</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_1_1_RELEASE</term>

	<listitem>
	  <para>&os; 4.1.1</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_1_0_RELEASE</term>

	<listitem>
	  <para>&os; 4.1</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_4_0_0_RELEASE</term>

	<listitem>
	  <para>&os; 4.0</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_3_5_0_RELEASE</term>

	<listitem>
	  <para>&os;-3.5</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_3_4_0_RELEASE</term>

	<listitem>
	  <para>&os;-3.4</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_3_3_0_RELEASE</term>

	<listitem>
	  <para>&os;-3.3</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_3_2_0_RELEASE</term>

	<listitem>
	  <para>&os;-3.2</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_3_1_0_RELEASE</term>

	<listitem>
	  <para>&os;-3.1</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_3_0_0_RELEASE</term>

	<listitem>
	  <para>&os;-3.0</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_2_2_8_RELEASE</term>

	<listitem>
	  <para>&os;-2.2.8</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_2_2_7_RELEASE</term>

	<listitem>
	  <para>&os;-2.2.7</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_2_2_6_RELEASE</term>

	<listitem>
	  <para>&os;-2.2.6</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_2_2_5_RELEASE</term>

	<listitem>
	  <para>&os;-2.2.5</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_2_2_2_RELEASE</term>

	<listitem>
	  <para>&os;-2.2.2</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_2_2_1_RELEASE</term>

	<listitem>
	  <para>&os;-2.2.1</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>RELENG_2_2_0_RELEASE</term>

	<listitem>
	  <para>&os;-2.2.0</para>
	</listitem>
      </varlistentry>
    </variablelist>
    </sect2>
  </sect1>

  <sect1 id="mirrors-rsync">
    <title><application>rsync</application> ミラーサイト</title>

    <para>次のサイトは、&os; を rsync プロトコルで提供しています。
      <application>rsync</application> ユーティリティは
      &man.rcp.1; コマンドとほぼ同じ機能を実現するもので、
      こちらの方が豊富なオプションを備え、送り側と受け側の差分だけを
      転送するという rsync リモート更新プロトコルを使用するという点が異なります。
      rsync を使うと、ネットワーク経由での同期を非常に高速に行なうことが可能です。
      特に、&os; FTP サーバや CVS リポジトリのミラーサイトを作成する時に便利でしょう。
      <application>rsync</application> は、多くのオペレーティングシステムで
      利用することができます。&os; 版は、
      <filename role="package">net/rsync</filename> の
      port か、package を使ってください。</para>

    <variablelist>
      <varlistentry>
	<term>チェコ共和国</term>

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

	  <para>提供しているコレクション:</para>
	  <itemizedlist>
	    <listitem><para>ftp: &os; FTP サーバの部分ミラー</para></listitem>
	    <listitem><para>&os;: &os; FTP サーバの全体ミラー</para></listitem>
	  </itemizedlist>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>オランダ</term>

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

	  <para>提供しているコレクション:</para>

	  <itemizedlist>
	    <listitem><para>&os;: &os; FTP サーバの全体ミラー</para></listitem>
	  </itemizedlist>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>ロシア</term>

	<listitem>
	  <para>rsync://ftp.mtu.ru/</para>

	  <para>提供しているコレクション:</para>
	  <itemizedlist>
	    <listitem><para>&os;: &os; FTP サーバの全体ミラー</para></listitem>
	    <listitem><para>&os;-gnats: GNATS バグトラッキングデータベース
	      </para></listitem>
	    <listitem>
	      <para>&os;-Archive: &os; アーカイブ FTP サーバのミラー</para>
	    </listitem>
 	  </itemizedlist>
 	</listitem>
       </varlistentry>

      <varlistentry>
	<term>スウェーデン</term>

	<listitem>
	  <para>rsync://ftp4.se.freebsd.org/</para>

	  <para>提供しているコレクション:</para>
	  <itemizedlist>
	    <listitem><para>&os;: &os; FTP サーバの全体ミラー</para></listitem>
 	  </itemizedlist>
 	</listitem>
      </varlistentry>

      <varlistentry>
	<term>台湾</term>

	<listitem>
	  <para>rsync://ftp.tw.FreeBSD.org/</para>
	  <para>rsync://ftp2.tw.FreeBSD.org/</para>
	  <para>rsync://ftp6.tw.FreeBSD.org/</para>

	  <para>提供しているコレクション:</para>
	  <itemizedlist>
	    <listitem><para>&os;: &os; FTP サーバの全体ミラー</para></listitem>
	  </itemizedlist>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>イギリス</term>

	<listitem>
	  <para>rsync://rsync.mirrorservice.org/</para>

	  <para>提供しているコレクション:</para>

	  <itemizedlist>
	    <listitem><para>ftp.freebsd.org: &os; FTP サーバの全体ミラー</para></listitem>
	  </itemizedlist>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>アメリカ合衆国</term>

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

	  <para>このサーバは、&os; の一次ミラーサイトとしてのみ使われています。</para>

	  <para>提供しているコレクション:</para>

	  <itemizedlist>
	    <listitem><para>&os;: &os; FTP サーバのマスタアーカイブ</para></listitem>
	    <listitem><para>acl: The &os; マスタ ACL リスト</para></listitem>
	  </itemizedlist>

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

	  <para>提供しているコレクション:</para>

	  <itemizedlist>
	    <listitem><para>&os;: &os; FTP サーバの全体ミラー</para></listitem>
	  </itemizedlist>
	</listitem>
      </varlistentry>
    </variablelist>
  </sect1>
</appendix>