os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

- Merge the following from the English version:

Browse source 
r48529 -> r48637	head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml
	r47746 -> r48637	head/ja_JP.eucJP/books/handbook/mirrors/chapter.xml
This commit is contained in:
Ryusuke SUZUKI 2016-04-15 12:07:46 +00:00
parent ca36c9a56a
commit e6c6b044b9
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=48639
2 changed files with 8 additions and 362 deletions
Download patch file Download diff file Expand all files Collapse all files

57
ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml
View file

@ -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>
@ -1086,17 +1085,6 @@ before running "/usr/sbin/freebsd-update install"</screen>
-CURRENT コードをチェックアウトしてください。</para>
</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 install"</screen>
希望する開発ブランチのソースをチェックアウしてください。
<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 install"</screen>
<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 install"</screen>
<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">

313
ja_JP.eucJP/books/handbook/mirrors/chapter.xml
View file

@ -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 newer than 8.1 which is now EOL'd
&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>