Date: Fri, 15 Apr 2016 12:07:46 +0000 (UTC) From: Ryusuke SUZUKI <ryusuke@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r48639 - in head/ja_JP.eucJP/books/handbook: cutting-edge mirrors Message-ID: <201604151207.u3FC7klr011385@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: ryusuke Date: Fri Apr 15 12:07:46 2016 New Revision: 48639 URL: https://svnweb.freebsd.org/changeset/doc/48639 Log: - Merge the following from the English version: r48529 -> r48637 head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml r47746 -> r48637 head/ja_JP.eucJP/books/handbook/mirrors/chapter.xml Modified: head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml head/ja_JP.eucJP/books/handbook/mirrors/chapter.xml Modified: head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml ============================================================================== --- head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml Fri Apr 15 00:24:25 2016 (r48638) +++ head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml Fri Apr 15 12:07:46 2016 (r48639) @@ -3,7 +3,7 @@ The FreeBSD Documentation Project The FreeBSD Japanese Documentation Project - Original revision: r48529 + Original revision: r48637 $FreeBSD$ --> <chapter xmlns="http://docbook.org/ns/docbook" @@ -75,9 +75,8 @@ <itemizedlist> <listitem> - <para><application>freebsd-update</application>, - <application>Subversion</application> もしくは - <application>CTM</application> + <para><application>freebsd-update</application> もしくは + <application>Subversion</application> を使った &os; システムの更新方法</para> </listitem> @@ -1087,17 +1086,6 @@ before running "/usr/sbin/freebsd-update </listitem> <listitem> - <para>インターネットの接続がとても遅かったり、 - 制限がある場合には、 - <xref linkend="ctm"/> で説明されている CTM - を利用すると良いでしょう。 - ただし、<application>svn</application> - ほどには信頼はできないので、 - <application>svn</application> - を利用されることを推奨します。</para> - </listitem> - - <listitem> <para>リポジトリのサイズが大きいため、興味のある部分や、 パッチを当てる部分のソースのみを同期するユーザもいます。 しかしながら、 @@ -1210,9 +1198,7 @@ before running "/usr/sbin/freebsd-update 希望する開発ブランチのソースをチェックアウしてください。 <literal>stable/9</literal> といったブランチ名は、 <link xlink:href="&url.base;/releng/">www.freebsd.org/releng</link> - で説明されています。 - インターネットへの接続に信頼できる回線を利用できないのであれば、 - CTM (<xref linkend="ctm"/>) を使ってください。</para> + で説明されています。</para> </listitem> <listitem> @@ -1239,8 +1225,8 @@ before running "/usr/sbin/freebsd-update <para>&os; のソースの最新を追いかける方法は色々あります。 この節では、基本的なサービスである - <application>Subversion</application> および - <application>CTM</application> について説明します。</para> + <application>Subversion</application> + について説明します。</para> <warning> <para>ソースツリーの一部を最新のものに更新することは可能です。 @@ -1274,38 +1260,9 @@ before running "/usr/sbin/freebsd-update <application>Subversion</application> によるソースの同期方法については、 <xref linkend="svn"/> で説明されています。</para> - <indexterm> - <primary><application>CTM</application></primary> - </indexterm> - <para>一方、<application>CTM</application> - はあなたが持っているソースとマスタアーカイブ上に - あるそれとの対話的な比較をおこないませんし、 - あるいは向こう側から変更点を pull したりもしません。 - そのかわりに、前回の実行時からの変更を認識するスクリプトが - マスタ CTM マシン上で一日に数回実行され、 - すべての変更を compress して通し番号を振り、 - さらに電子メールで、印字可能な <acronym>ASCII</acronym> - キャラクタのみで転送できるようにエンコードします。 - ダウンロードした後は、 - これらの <quote>デルタ</quote> は、 - 自動的にデコード、検査してユーザのソースのコピーに変更を適用する - <command>ctm.rmail</command> によって処理可能です。 - この処理は <application>Subversion</application> - よりずっと効率的であり、<emphasis>pull</emphasis> モデルというよりむしろ - <emphasis>push</emphasis> モデルであるため、 - サーバ資源の負荷は軽くなります。 - <application>CTM</application> を用いたソースの同期方法については、 - <xref linkend="ctm"/> をご覧ください。</para> - <para><application>Subversion</application> であれば、 うっかりローカルのアーカイブの一部を消してしまっても、 - 壊れた部分を検出して再構築してくれます。 - <application>CTM</application> はこれをやってくれません。 - もしソースツリーの一部を消してしまい、 - そしてバックアップを取っていないのであれば、最新の - <firstterm>ベースデルタ</firstterm> を用いて、一からやり直し、 - <application>CTM</application> - を使ってすべてを再構築しなければなりません。</para> + 壊れた部分を検出して再構築してくれます。</para> </sect1> <sect1 xml:id="makeworld"> Modified: head/ja_JP.eucJP/books/handbook/mirrors/chapter.xml ============================================================================== --- head/ja_JP.eucJP/books/handbook/mirrors/chapter.xml Fri Apr 15 00:24:25 2016 (r48638) +++ head/ja_JP.eucJP/books/handbook/mirrors/chapter.xml Fri Apr 15 12:07:46 2016 (r48639) @@ -3,7 +3,7 @@ The FreeBSD Documentation Project The FreeBSD Japanese Documentation Project - Original revision: r47746 + Original revision: r48637 $FreeBSD$ --> <appendix xmlns="http://docbook.org/ns/docbook" @@ -135,317 +135,6 @@ This site doesn't have any products newe &chap.mirrors.ftp.inc; </sect1> - <sect1 xml:id="ctm"> - <title>CTM を使う</title> - - <indexterm> - <primary>CTM</primary> - </indexterm> - - <para><emphasis>訳: &a.hanai;、1997 年 9 月 13 日</emphasis></para> - - <para><application>CTM</application> は、 - リモートのディレクトリツリーを中央のツリーに同期させるための手段です。 - &os; システムに組み込まれており、&os; - のソースリポジトリとの同期に使うことができます。 - リポジトリ全体の同期や特定のブランチセットの同期に用いることができます。</para> - - <para><application>CTM</application> は、 - 特にお粗末な TCP/IP 接続しか持っていなかったり、 - TCP/IP 接続が行なえない環境での利用を想定して設計されています。 - 変更点を自動的にメールで送られてくるように設定することができます。 - アクティブなブランチでは 1 - 日に最大三つまでのデルタを受け取る必要があります。 - デルタのサイズは常にできるだけ小さく保たれています。 - 大抵の場合 5KB よりも小さく、 - たまに (10 回に 1 回程度) 10-50KB になり、 - ときおり 100KB 以上のサイズになります。</para> - - <para><application>CTM</application> を使って &os; - の開発を追いかける時には、 - あらかじめパッケージ化されたリリースとは異なり、 - 開発ソースの作業ディレクトリに関連した注意点に気をつけてください。 - これに関しては、 - <link linkend="current-stable">開発ブランチを追いかける</link> - の章を参照してください。</para> - - <para>デルタを作り出す過程や <application>CTM</application> - を他の目的に使うためのドキュメントは現在ほとんどありません。 - <application>CTM</application> に関連した質問については、 - &a.ctm-users.name; メーリングリストに相談してください。</para> - - <sect2 xml:id="mirrors-ctm"> - <title>デルタを入手する</title> - - <para><application>CTM</application> が用いる <quote>デルタ</quote> - は、anonymous <acronym>FTP</acronym> - もしくはメールで入手できます。</para> - - <para><acronym>FTP</acronym> - のデルタは以下のミラーサイトから入手できます。 - もし anonymous <acronym>FTP</acronym> を使って - <application>CTM</application> のデルタを手にいれる場合は、 - 地理的に近くにあるミラーサイトを利用するようにしてください。 - 何か問題がある場合は、&a.ctm-users.name; - メーリングリストに相談してください。</para> - - <variablelist> - <varlistentry> - <term>グローバルミラー</term> - <listitem> - <itemizedlist> - <listitem> - <para><uri - xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/">ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/</uri></para>; - </listitem> - </itemizedlist> - </listitem> - </varlistentry> - - <varlistentry> - <term>南アフリカ、古い差分ファイルのバックアップサーバ</term> - <listitem> - <itemizedlist> - <listitem> - <para><uri - xlink:href="ftp://ftp.za.FreeBSD.org/pub/FreeBSD/CTM/">ftp://ftp.za.FreeBSD.org/pub/FreeBSD/CTM/</uri></para>; - </listitem> - </itemizedlist> - </listitem> - </varlistentry> - - <varlistentry> - <term>台湾/中華民国</term> - - <listitem> - <itemizedlist> - <listitem> - <para><uri - xlink:href="ftp://ctm.tw.FreeBSD.org/pub/FreeBSD/development/CTM/">ftp://ctm.tw.FreeBSD.org/pub/FreeBSD/development/CTM/</uri></para>; - </listitem> - - <listitem> - <para><uri - xlink:href="ftp://ctm2.tw.FreeBSD.org/pub/FreeBSD/development/CTM/">ftp://ctm2.tw.FreeBSD.org/pub/FreeBSD/development/CTM/</uri></para>; - </listitem> - - <listitem> - <para><uri - xlink:href="ftp://ctm3.tw.FreeBSD.org/pub/FreeBSD/development/CTM/">ftp://ctm3.tw.FreeBSD.org/pub/FreeBSD/development/CTM/</uri></para>; - </listitem> - </itemizedlist> - </listitem> - </varlistentry> - </variablelist> - - <para>メールでデルタを得たいという場合は、<uri - xlink:href="http://lists.freebsd.org/mailman/listinfo">http://lists.freebsd.org/mailman/listinfo</uri>; - から、<literal>ctm-src</literal> - 配布メーリングリストのいずれかに参加してください。 - たとえば &a.ctm-src-cur.name; - は head 開発ブランチに対応しています。&a.ctm-src-9.name; - は 9.X リリースのブランチに対応したものです</para> - - <para>メールで <application>CTM</application> - の更新ファイルを受け取り始めたら、 - 中身を取り出して使用するために - <command>ctm_rmail</command> を使ってください。 - このプロセスを自動で行ないたいのであれば、 - このコマンドを <filename>/etc/aliases</filename> - から直接実行することもできます。 - さらに詳しいことは &man.ctm.rmail.1; をご覧ください。</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> デルタを使う方法です。 - スタータデルタは - <filename>src-cur.3210XEmpty.gz</filename> - のように、<literal>XEmpty</literal> - というファイル名になります。 - <literal>X</literal> - の後ろは最初の開始ポイントに対応し、 - <filename>Empty</filename> は空のディレクトリを表します。 - ルールとして <literal>Empty</literal> からの移行デルタは - 100 デルタごとに作られます。 - スタータデルタである - <filename>XEmpty</filename> のデルタは、70 から 80MB の - <command>gzip</command> - で圧縮された大きなデータということに注意してください。</para> - - <para>もう一つの方法は、RELEASE - のメディアからソースをコピーしたり展開する方法です。 - この方法では、 - インターネット上で大きなデータの転送を行う必要がありません。</para> - - <para>一度ベースとなるデルタを作成したら、 - それに続く大きな数字を持つ多数のすべてのデルタを適用してください。 - デルタを適用するためには、以下のように実行してください。</para> - - <screen>&prompt.root; <userinput>cd /directory/to/store/the/stuff</userinput> -&prompt.root; <userinput>ctm -v -v /directory/which/stores/the/deltas/src-xxx.*</userinput></screen> - - <para>一度に適用されるデルタは一つで、 - 一度適用されたデルタは無視されるので、 - 複数のデルタを一つのコマンドで適用することができます。 - <application>CTM</application> - は <command>gzip</command> で圧縮されているデルタを理解するので、 - ディスクの節約にもなります。</para> - - <para>デルタを適用せずに確認だけを行うには、 - コマンドラインに <option>-c</option> フラグを加えてください。 - <application>CTM</application> - はローカルのツリーに対して実際には何も行ないません。 - デルタの完全性を確認し、 - 現在のツリーに問題なく使用できるかを確認します。 - オプションに関するより多くの情報や、 - デルタを適用する時に <application>CTM</application> - が用いるプロセスの全体については、&man.ctm.1; をご覧ください。</para> - - <para>ローカルのソースツリーを最新に保つには、 - 新しいデルタが入手可能になるたびに、 - <application>CTM</application> に適用してください。</para> - - <para>デルタを適用後、 - もしデルタを再ダウンロードするのが骨の折れる作業であれば、 - デルタを消さないでおいてください。 - このようにすると、将来のディザスタリカバリで必要になった場合に、 - ローカルにあるコピーを利用できます。</para> - </sect2> - - <sect2> - <title>ローカルの変更を保存する</title> - - <para>開発者はソースツリー中のファイルを使って、 - 実験したり変更したくなるものです。 - <application>CTM</application> - はローカルの変更を制限つきでサポートします。 - ファイルの存在をチェックする前に、同じ名前で - <filename>.ctm</filename> - という拡張子のついたファイルを参照しにいきます。 - このファイルが存在する場合、<application>CTM</application> - はオリジナルファイルの代りにこのファイルを処理します。</para> - - <para>この動作はローカルの変更を保持する簡単な手段を提供します。 - ファイルを変更する前に、<filename>.ctm</filename> - という拡張子のファイル名にコピーしてください。 - あとは自由にオリジナルの名前を持つファイルを変更してください。 - <application>CTM</application> は、<filename>.ctm</filename> - の拡張子を持つファイルにのみに適用されます。</para> - </sect2> - - <sect2> - <title><application>CTM</application> - のその他のオプション</title> - - <variablelist> - <varlistentry> - <term>更新で変更されるファイルを正確に知る</term> - - <listitem> - <para><application>CTM</application> - がローカルのソースリポジトリに対して、 - どのような変更を行うかを知るには、 - <option>-l</option> - オプションを使ってください。 - このオプションは、変更のログを作成したり、 - 変更されたファイルに対して、 - なんらかの方法で 前・後処理したい場合には、 - 役に立つでしょう。</para> - </listitem> - </varlistentry> - - <varlistentry> - <term>更新前にバックアップを取る</term> - - <listitem> - <para><application>CTM</application> - の更新によって変更されるファイルすべてのバックアップをとるには、 - <option>-B - <replaceable>backup-file</replaceable></option> - オプションを指定してください。 - このオプションを使うと、 - <application>CTM</application> は、 - デルタで変更されるファイルすべてを - <filename>backup-file</filename> - としてバックアップするようになります。</para> - </listitem> - </varlistentry> - - <varlistentry> - <term>更新で変更されるファイルを制限する</term> - - <listitem> - <para><application>CTM</application> - の更新の範囲を制限したり一連のデルタのから - ほんの数ファイルを抽出するには、 - 使用するファイルを指定する - <option>-e</option> と - どのファイルを無視するかを指定する - <option>-x</option> - オプションを使って、正規表現で指定できます。</para> - - <para>例えば、<filename>lib/libc/Makefile</filename> - の最新のコピーを保存してある <application>CTM</application> - デルタのコレクションから抽出するには、 - 以下のコマンドを実行してください。</para> - - <screen>&prompt.root; <userinput>cd /directory/to/extract/to/</userinput> -&prompt.root; <userinput>ctm -e '^lib/libc/Makefile' /directory/which/stores/the/deltas/src-xxx.*</userinput></screen> - - <para><application>CTM</application> - デルタで指定されたファイルごとに、<option>-e</option> - そして <option>-x</option> - オプションがコマンドラインで指定された順序で適用されます。 - すべての<option>-e</option> そして <option>-x</option> - オプションが適用された後に更新対象と選択された場合に限り、 - <application>CTM</application> - はそのファイルを処理します。</para> - </listitem> - </varlistentry> - </variablelist> - </sect2> -<!-- -Comment out for now until these can be verified. - <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> - - <para><literal>ports</literal> コレクションに対するデルタもあるのですが、 - これに興味を持っている人はまだ少ないようです。</para> - </sect2> - --> - </sect1> - <sect1 xml:id="svn"> <title><application>Subversion</application> を使う</title>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201604151207.u3FC7klr011385>