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

Whitespace and comment cleanups.

Browse source
This commit is contained in:
Jun Kuriyama 2000-01-23 11:12:51 +00:00
parent 79d2c126ac
commit fa1280f03e
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=6420
1 changed files with 142 additions and 148 deletions

290
ja_JP.eucJP/books/handbook/cutting-edge/chapter.sgml
View file

@ -3,7 +3,7 @@
The FreeBSD Japanese Documentation Project
Original revision: 1.30
$FreeBSD: doc/ja_JP.eucJP/books/handbook/cutting-edge/chapter.sgml,v 1.6 1999/09/23 12:01:37 kuriyama Exp $
$FreeBSD: doc/ja_JP.eucJP/books/handbook/cutting-edge/chapter.sgml,v 1.7 1999/09/24 14:48:23 kuriyama Exp $
-->
<chapter id="cutting-edge">
@ -25,8 +25,7 @@
<para><emphasis>原作: &a.jkh;.</emphasis></para>
<para><emphasis>訳: &a.hanai;<!-- <br> -->
6 November 1996.</emphasis></para>
<para><emphasis>訳: &a.hanai; 6 November 1996.</emphasis></para>
<sect2>
<title>FreeBSD-current ってなに?</title>
@ -34,17 +33,17 @@
<para>FreeBSD-current とは，文字通りに，日々変更されている
FreeBSD のソース
のスナップショット以外の何ものでもありません．
中には現在開発途上の ソフトウェア, 実験的な変更,
中には現在開発途上のソフトウェア, 実験的な変更,
あるいは過渡的な機能などが含まれています. また,
この中に入っている機能がすべて次の公式リリースに
入るとはかぎりません. FreeBSD-current
をソースからほとんど毎日コンパイルしている人はたくさん
いますが, 時期によっては FreeBSD-current
はコンパイルさえできない状態に なっていることもあります.
これらの問題は一般的には可能な限り素早く解決 されますが,
はコンパイルさえできない状態になっていることもあります.
これらの問題は一般的には可能な限り素早く解決されますが,
FreeBSD-current のソースが不幸をもたらすか, それとも非常に
素晴らしい機能をもたらすかというのは文字通り,
ある与えられた24時間の間
ある与えられた 24 時間の間
のどの部分であなたがソースを手に入れたか,
による場合もあります.</para>
</sect2>
@ -76,7 +75,7 @@
<listitem>
<para>単に, 様々な事に目を向け, 参考のために
(例えば，動かすためではなく <emphasis>読むため
</emphasis>に) 最新のソースを使いたいと思って いる FreeBSD
</emphasis>に) 最新のソースを使いたいと思っている FreeBSD
(または他の) グループのまわりにいるメンバー.
これらの人々はまた,
時々コメントやコードを寄稿してくれます.</para>
@ -107,9 +106,9 @@
技術的なサポートを行なうには 単に「時間が足りない」のです.
これは我々が外の人を助けるの好まない,
ケチで意地悪い人間だと いうことではなく (もしそうなら
FreeBSD なんかやっていません), 文字通り 我々は一日に 400
FreeBSD なんかやっていません), 文字通り我々は一日に 400
ものメッセージに答え <emphasis>かつ</emphasis> FreeBSD
の作業をする ことなど出来ない! ということなのです. もし,
の作業をすることなど出来ない! ということなのです. もし,
たくさんの質問に答えるか, それとも FreeBSD
を良くする作業を続けるかという選択が与えられた場合,
あなた方のほとんどは後者を支持する,
@ -129,8 +128,8 @@
<emphasis>FreeBSD-current</emphasis>
メーリングリストに入っていなければ,
様々な人がシステムの現在の状態について
述べているコメントを決して見ることは ありませんし,
従って他の人が既に見つけて解決している多くの問題に 戸惑っ
述べているコメントを決して見ることはありませんし,
従って他の人が既に見つけて解決している多くの問題に戸惑っ
てあきらめてしまうでしょう. さらに言うと,
システムを正常に保つための
重要な情報を見逃してしまう可能性もあります.</para>
@ -172,12 +171,12 @@ subscribe cvs-all</programlisting>
<para><link linkend="cvsup">cvsup</link> を <ulink
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/src/share/examples/cvsup/standard-supfile"> この supfile</ulink>
を用いて使用する. これは 2 番目に推薦される方法です.
なぜなら, cvsup によって一度全体 を入手し,
なぜなら, cvsup によって一度全体を入手し,
後は変更されたところだけを入手することが
出来るからです.
たくさんの人が自動的にソースを最新のもに保つために
cvsup を cron から起動しています.
これを行なうための非常に簡単な 方法は, 単に</para>
これを行なうための非常に簡単な方法は, 単に</para>
<blockquote><screen>&prompt.root; <userinput>pkg_add -f \
ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></screen></blockquote>
@ -192,7 +191,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/</ulink>
に &ldquo;公開&rdquo; されています.
我々はまた全体を compress/tar して入手できる
<command>wu-ftpd</command> を使ってい ます. 例えば,</para>
<command>wu-ftpd</command> を使っています. 例えば,</para>
<screen>usr.bin/lex</screen>
@ -201,7 +200,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
<screen><prompt>ftp&gt;</prompt> <userinput>cd usr.bin</userinput>
<prompt>ftp&gt;</prompt> <userinput>get lex.tar.Z</userinput></screen>
<para>とすることにより, ディレクトリ全体(この場合,
<para>とすることにより, ディレクトリ全体 (この場合,
usr.bin/lex以下全体) を compress された tar
ファイルとして入手することができます.</para>
</listitem>
@ -218,11 +217,11 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
<listitem>
<para>もしソースを,
眺めるだけでなく走らせるために入手しているので あれば,
眺めるだけでなく走らせるために入手しているのであれば,
一部だけ選ぶのではなく, current
の<emphasis>全体</emphasis>を手に入れてください. なぜなら,
ソースの様々な部分が他の部分の更新に依存しており,
一部のみを コンパイルしようとすると,
一部のみをコンパイルしようとすると,
ほぼ間違いなくトラブルを起こすからです.</para>
</listitem>
@ -239,8 +238,8 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
<listitem>
<para>アクティブになって下さい! もし FreeBSD-current
を走らせているなら 我々はそれに関するコメント,
特に拡張やバグ潰しに関する提案, を欲して います.
を走らせているなら我々はそれに関するコメント,
特に拡張やバグ潰しに関する提案, を欲しています.
コードを伴う提案はもっとも歓迎されるものです!</para>
</listitem>
</orderedlist>
@ -260,7 +259,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
<para>FreeBSD-stable は,
次の本流のリリースを目指した新機能をあまり採り入
れない保守的な変更のための開発の支流です.
実験的またはテスト未完の変更 はこの支流には取り入れられません
実験的またはテスト未完の変更はこの支流には取り入れられません
(<link linkend="current">最新の FreeBSD を追いかける</link>
参照).</para>
</sect2>
@ -269,14 +268,14 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
<title>誰が FreeBSD-stable を必要としているの?</title>
<para>もしあなたが仕事で使用しているとか, なによりも FreeBSD
システムの安 定性を最重要視するなら,
システムの安定性を最重要視するなら,
<emphasis>stable</emphasis> を追いかけることを考えるべきで
しょう. <emphasis>stable</emphasis>
の支流は前のリリースに関して効果的にバグフィッ
クスされた流れであるため, 最新のリリース (<ulink
の支流は前のリリースに関して効果的にバグフィックスされた
流れであるため, 最新のリリース (<ulink
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/&rel.current;-RELEASE/">
&rel.current;-RELEASE</ulink> 執筆時点)
をインストールしているのであれば, 特に そうです.</para>
をインストールしているのであれば, 特にそうです.</para>
<warning>
<para><emphasis>stable</emphasis>
@ -286,10 +285,10 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
されずに素早く送られた変更を含むソースがまだあるのです).
また, <emphasis>current</emphasis> を
<emphasis>stable</emphasis>
へ移行する前に完璧なテストフィック スに最善を尽くしますが,
へ移行する前に完璧なテストフィックスに最善を尽くしますが,
私たちのテストはすべてのケースを十分に網羅して
いるとは限りません. もし何か <emphasis>stable</emphasis>
で不具合があるようでした ら,
で不具合があるようでしたら,
私たちに<emphasis>すぐに</emphasis>教えてください
(次の節参照).</para>
</warning>
@ -303,7 +302,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
<para>&a.stable; へ加わってください. このメーリングリスト
では, <emphasis>stable</emphasis> の構築に関連する事柄や,
その他の注意すべき点 に関する情報が流れています.
また開発者は議論の余地がある修正や変更 を考えている場合に,
また開発者は議論の余地がある修正や変更を考えている場合に,
このメーリングリストで公表し, 提案された変更に
関して問題が生じるかどうかを返答する機会を
ユーザに与えます. </para>
@ -311,7 +310,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
<para>また, &a.cvsall; メーリングリストでは,
それぞれの変更がなされると
起こりうる副作用に関するすべての適切な情報と一緒に commit
log を 読むことができます. subscribe
log を読むことができます. subscribe
しておきたいもう一つのメーリングリストです. </para>
<para>メーリングリストに参加するには, &a.majordomo
@ -323,8 +322,8 @@ subscribe freebsd-stable
subscribe cvs-all</programlisting>
<para>オプションとして本文に `help' と書けば, Majordomo
は私たちがサポー トする様々なメーリングリストに参加 /
脱退する方法に関する詳しいヘ ルプを送付します.</para>
は私たちがサポートする様々なメーリングリストに参加 /
脱退する方法に関する詳しいヘルプを送付します.</para>
</listitem>
<listitem>
@ -339,26 +338,26 @@ subscribe cvs-all</programlisting>
<para>もし, 既に FreeBSD の以前のリリースが動いている場合で,
これをソースからアップグレードしようとするならば, <hostid
role="fqdn">ftp.FreeBSD.org</hostid> より簡単に
これを行う事が出来ます. これには次の 3つの方法があります.
これを行う事が出来ます. これには次の 3 つの方法があります.
</para>
<orderedlist>
<listitem>
<para><application><link
linkend="ctm">CTM</link></application>
機能を使用する. 転送レートが 安定している TCP/IP
接続でない場合は, この方法が適して います.</para>
機能を使用する. 転送レートが安定している TCP/IP
接続でない場合は, この方法が適しています.</para>
</listitem>
<listitem>
<para><link linkend="cvsup">cvsup</link> を <ulink
<para><link linkend="cvsup">cvsup</link> を <ulink
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/src/share/examples/cvsup/stable-supfile">
この supfile</ulink> を用いて使用する.
一度コレクション全体を入手してしまえば,
前回からの変更部分だけですむので, 2
番目に推奨される方法です.
多くの人が cron から cvsup を実行し,
自動的にソースコー ドを最新の状態に保っています.
自動的にソースコードを最新の状態に保っています.
これを簡単に扱うには次のようにタイプしてください.</para>
<blockquote><screen>&prompt.root; <userinput>pkg_add -f \
@ -368,7 +367,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
<listitem>
<para><command>ftp</command> を使用する. FreeBSD-stable
用のソースツリーは
常に次のところで&ldquo;公開&rdquo;されています :
常に次のところで&ldquo;公開&rdquo;されています:
<ulink
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-stable/">ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-stable/</ulink></para>
@ -387,7 +386,6 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
された tar
ファイルとして入手することができます.</para>
</listitem>
<!-- kuriyama - duplicated above? -->
</orderedlist>
</listitem>
@ -404,7 +402,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
<para>stable をコンパイルする前に,
<filename>/usr/src</filename> にある Makefile をよ
く読んでください.
少なくとも一回はアップグレードの処理の一部として 最初に
少なくとも一回はアップグレードの処理の一部として最初に
<link linkend="makeworld">make world</link>
を実行するべきでしょう. &a.stable; を読めば,
次のリリースに移行する
@ -421,11 +419,10 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
<para><emphasis>原作: &a.jkh;.</emphasis></para>
<para><emphasis>訳: &a.jp.iwasaki;.<!-- <br> -->
13 September 1997.</emphasis></para>
<para><emphasis>訳: &a.jp.iwasaki;. 13 September 1997.</emphasis></para>
<para>インターネット接続 (または電子メール) を使用して,
あなたの興味の対 象によって FreeBSD
あなたの興味の対象によって FreeBSD
プロジェクトのソースのある一部分または全体の最新を
追いかける方法は色々あります.
私たちが提供している基本的なサービスは <link
@ -496,8 +493,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
<title>Anonymous CVS</title>
<para><emphasis>原作: &a.jkh;</emphasis></para>
<para><emphasis>訳: &a.jp.sugimura;</emphasis>.<!-- <br> -->
19 July 1998.</para>
<para><emphasis>訳: &a.jp.sugimura;</emphasis>. 19 July 1998.</para>
<sect3>
<title><anchor id="anoncvs-intro">導入</title>
@ -763,8 +759,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
最も新しいバージョンのファイルを受け取ることができます.
もし以前のバージョンのものが欲しいときには, 日付を
<option>-D date</option>
オプションを使って指定すればよいです.<!-- kuriyama - ?
cvs(1) --></para>
オプションを使って指定すればよいです.</para>
</sect3>
<sect3>
@ -776,7 +771,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
の使い方の本質的なところを簡単に例を挙げて説明します.</para>
<example>
<title>-current (ls(1))
<title>-current (&man.ls.1;)
をちょっと確認してから消してみます.</title>
<screen>
@ -788,9 +783,8 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
</example>
<example>
<title>ls(1) のバージョンを 2.2-stable
<title>&man.ls.1; のバージョンを 2.2-stable
ブランチから調べてみます.</title>
<!-- kuriyama - ls should man.ls.1 -->
<screen>
&prompt.user; <userinput>setenv CVSROOT
@ -801,7 +795,8 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
</example>
<example>
<title>ls(1) の変更点のリストを (unidiff で) 作ってみます.</title>
<title>&man.ls.1; の変更点のリストを
(unidiff で) 作ってみます.</title>
<screen>
&prompt.user; <userinput>setenv CVSROOT
@ -856,8 +851,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
<para><emphasis>原作: &a.phk;. 更新: 19-October-1997.</emphasis></para>
<para><emphasis>訳: &a.hanai;<!-- <br> -->
13 September 1997.</emphasis></para>
<para><emphasis>訳: &a.hanai; 13 September 1997.</emphasis></para>
<para><application>CTM</application>
はリモートのディレクトリツリーを中央のツリーに同期させるための
@ -874,7 +868,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
<title>なぜ<application>CTM</application>を使うの?</title>
<para><application>CTM</application> を使うことにより FreeBSD
ソースツリーのローカルコピー を手にいれることができます.
ソースツリーのローカルコピーを手にいれることができます.
ソースツリーが使えることの魅力は数多くあります. 完全な cvs
ツリーを追いかけるにしても, ひとつのブランチを追いかける
にしても <application>CTM</application>
@ -885,20 +879,20 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
ほしいというのであれば <application>CTM</application>
はそんなあなたのために 作られたのです.
アクティブなブランチでは 1
日に最大三つまでのデルタを受け取る必 要があります.
日に最大三つまでのデルタを受け取る必要があります.
これが自動的に e-mail で送られてくるという方法を
ぜひ検討してみてください.
デルタのサイズは常にできるだけ小さく保たれています.
大抵の場合5KBよりも小さく,
たまに(10回に1回程度)10-50KBになり,
ときおり100KBかもっと大きくなる でしょう.</para>
ときおり100KBかもっと大きくなるでしょう.</para>
<para>開発ソースから直接に得られたものを使うことについては,
あらかじめ パッケージにされたリリースとは違い,
あらかじめパッケージにされたリリースとは違い,
いろいろと注意することが あります. これは特に
&ldquo;current&rdquo; のソースを選んでいるときは 重要です.
&ldquo;current&rdquo; のソースを選んでいるときは重要です.
<link linkend="current">最新の FreeBSD
を追いかける</link>を読むことを お勧めします.</para>
を追いかける</link>を読むことをお勧めします.</para>
</sect3>
<sect3>
@ -930,7 +924,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
linkend="mirrors-ctm">ミラーサイト</link> が
<application>CTM</application> へのアクセスをサポートします.
適切なディレクトリに FTP して <filename>README</filename>
ファイルを入手し, そこから スタートしてください.</para>
ファイルを入手し, そこからスタートしてください.</para>
<para>e-mail によってデルタを得たいという場合は:</para>
@ -941,7 +935,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
をサポートします. &ldquo;ctm-src-cur&rdquo;
は開発先端ブランチをサポートします &ldquo;ctm-src-2_2&rdquo;
は 2.2 リリースのブランチのサポートです.
(もしmajordomoを使って参加する方法を知らない のであれば,
(もしmajordomoを使って参加する方法を知らないのであれば,
最初に<literal>help</literal>
という語を含むメッセージを送ってください. &mdash;
使い方の説明が送られてくるでしょう.)</para>
@ -1008,7 +1002,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
で圧縮されたデータというのが普通です.</para>
<para>一度スタートするためのベースデルタを得ると,
それに続く多数の 全てのデルタも必要になるでしょう.</para>
それに続く多数の全てのデルタも必要になるでしょう.</para>
</sect3>
<sect3>
@ -1041,8 +1035,8 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
マニュアルページを参照するかソースを見てください.</para>
<para>もし誰かが &ldquo;ユーザ インターフェース&rdquo;
の部分に関して助けてくれるなら 私はとても嬉しいです.
なぜならどういうオプションが何を, どのよう に,
の部分に関して助けてくれるなら私はとても嬉しいです.
なぜならどういうオプションが何を, どのように,
いつ行なうようにするべきか決めかねているからです.</para>
<para>以上でやることは本当に全部です.
@ -1116,10 +1110,10 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
<para><application>CTM</application>
の更新の範囲を制限したり一連のデルタのから
ほんの数ファイルを 抽出したくなることがあります.</para>
ほんの数ファイルを抽出したくなることがあります.</para>
<para><option>-e</option> と <option>-x</option>
オプションを用い正規表現を 指定することで,
オプションを用い正規表現を指定することで,
<application>CTM</application>
が処理するファイルのリストを制御することが
できます.</para>
@ -1135,7 +1129,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
<para><application>CTM</application>
デルタで指定されたファイルごとに, <option>-e</option>
そして <option>-x</option>
オプションがコマンドラインで指定された順序で 適用されます.
オプションがコマンドラインで指定された順序で適用されます.
すべての<option>-e</option> そして <option>-x</option>
オプションが適用された後に更新対象と選択された場合に限り,
<application>CTM</application>
@ -1151,26 +1145,26 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
<itemizedlist>
<listitem>
<para>なんらかの CTM システムへの認証機構を用い, 不正な
CTM の更新の 検出を可能とする.</para>
CTM の更新の検出を可能とする.</para>
</listitem>
<listitem>
<para><application>CTM</application>
へのオプションを整理する. さもないと混乱し,
直観に反したもの になります.</para>
直観に反したものになります.</para>
</listitem>
</itemizedlist>
<para>残念なことに私は非常に忙しいです.
従ってこれを行なうどんな手助け でも歓迎します. その際,
自分が何をやりたいかを私に 言うのを忘れずに.</para>
従ってこれを行なうどんな手助けでも歓迎します. その際,
自分が何をやりたいかを私に言うのを忘れずに.</para>
</sect3>
<sect3>
<title>その他</title>
<para>&ldquo;DESに染まった&rdquo; (例えば,
国外への持ち出しが規制された)ソースは まったく含まれません.
国外への持ち出しが規制された)ソースはまったく含まれません.
手に入るのは&ldquo;国際&rdquo;バージョンだけです.
もし興味のある人が多いようであれば,
我々は<literal>sec-cur</literal>シーケンスも
@ -1179,7 +1173,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
まだあまり興味は持たれていないようです.
もしこれに対するメーリング
リストが欲しい時も私に言ってください.
我々はセットアップすることを 考えます.</para>
我々はセットアップすることを考えます.</para>
</sect3>
<sect3>
@ -1228,8 +1222,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
<para><emphasis>原作: &a.jdp;</emphasis>.</para>
<para><emphasis>訳: &a.jp.iwasaki;.<!-- <br> -->
27 February 1997.</emphasis></para>
<para><emphasis>訳: &a.jp.iwasaki;. 27 February 1997.</emphasis></para>
<sect3 id="cvsup-intro">
<title><application>CVSup</application> の紹介</title>
@ -1237,7 +1230,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
<para><application>CVSup</application> は,
リモートのサーバホストにあるマスタ CVS リポジトリから
ソースツリーを配布し更新するための
ソフトウェアパッケージです. FreeBSD のソースは,
ソフトウェアパッケージです. FreeBSD のソースは,
カリフォルニアにある中心的な開発マシンの CVS リポジトリの
中でメンテナンスしています. <application>CVSup</application>
を使用することで, FreeBSD ユーザは
@ -1252,10 +1245,10 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
サーバに更新の問い合わせをおこないます.
サーバはクライアントからの
更新の要求を受け身の状態で待ちます. したがって,
すべての更新は クライアント主導でおこなわれます.
サーバは頼まれもしない更新情報を 送るようなことはしません.
すべての更新はクライアント主導でおこなわれます.
サーバは頼まれもしない更新情報を送るようなことはしません.
ユーザは <application>CVSup</application>
クライアントを手動で実行して 更新をおこなうか,
クライアントを手動で実行して更新をおこなうか,
<command>cron</command>
ジョブを設定して定期的に自動実行する必要があります.</para>
@ -1271,9 +1264,9 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
<application>sup</application> についての言及を
見かけたかもしれません. <application>sup</application> は
<application>CVSup</application> の前に存在していたもので,
同様の 目的で使われていました.
同様の目的で使われていました.
<application>CVSup</application> は sup
と同じように使用されており, 実際, <command>sup</command>
と同じように使用されており, 実際, <command>sup</command>
と互換性のあるコンフィグレーションファイルを使用します.
<application>CVSup</application>
の方がより高速で柔軟性もあるので, もはや
@ -1323,7 +1316,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
コンパイルそして/またはインストールされます.</para>
<para>Modula-3 ライブラリはかなり大きく,
これらの転送やコンパイルはすぐに 終わるものではありません.
これらの転送やコンパイルはすぐに終わるものではありません.
この理由から, 三つめの選択肢が提供されています.
以下のアメリカ合衆国にある配布サイトから,
FreeBSD 用の <emphasis>スタティックリンクされた</emphasis>
@ -1352,8 +1345,8 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
からも入手可能です.</para>
<para>ほとんどのユーザはクライアントのみが必要になるでしょう.
これらの 実行形式は完全に自己完結しており, FreeBSD-2.1.0
から FreeBSD-current までの,
これらの実行形式は完全に自己完結しており, FreeBSD-2.1.0
から FreeBSD-current までの,
どのバージョンでも動作します.</para>
<para>まとめると, CVSup
@ -1377,15 +1370,16 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
<sect3 id="cvsup-config">
<title>CVSup のコンフィグレーション</title>
<para><application>CVSup</application> の動作は, <filename>supfile</filename>
と呼ばれるコンフィグレーションファイルで 制御します.
<para><application>CVSup</application> の動作は,
<filename>supfile</filename>
と呼ばれるコンフィグレーションファイルで制御します.
FreeBSD-2.2 からは, <filename>supfile</filename>
のサンプルがディレクトリ <ulink
url="file:/usr/share/examples/cvsup/">/usr/share/examples/cvsup/
のサンプルがディレクトリ
<ulink url="file:/usr/share/examples/cvsup/">
/usr/share/examples/cvsup/
</ulink> の下にあります. 2.2 以前のシステムを
使用している場合は, これらの サンプルを
<ulink
url="ftp://ftp.freebsd.org/pub/FreeBSD/FreeBSD-current/src/share/examples/cvsup/">
使用している場合は, これらのサンプルを
<ulink url="ftp://ftp.freebsd.org/pub/FreeBSD/FreeBSD-current/src/share/examples/cvsup/">
ftp://ftp.freebsd.org/pub/FreeBSD/FreeBSD-current/src/share/examples/cvsup/
</ulink> から入手することができます.</para>
@ -1420,7 +1414,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
</itemizedlist>
<para>次のセクションで, これらの質問に順番に答えながら典型的な
<filename>supfile</filename> を組み立てていきます. 最初に
<filename>supfile</filename> を組み立てていきます. 最初に
<filename>supfile</filename> の全体構造を説明します.</para>
<para><filename>supfile</filename> はテキストファイルです.
@ -1434,15 +1428,15 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
&ldquo;コレクション&rdquo;の名称です.
コレクションの名称を指定して, 欲しいファイル群を
サーバに伝えます. コレクション名の後には,
ホワイトスペースで区切られた 0個以上のフィールドが続きます.
これらのフィールドが上記の質問に対する 答えになります.
フィールドには 2種類あります: flag フィールドと value
ホワイトスペースで区切られた 0 個以上のフィールドが続きます.
これらのフィールドが上記の質問に対する答えになります.
フィールドには 2 種類あります: flag フィールドと value
フィールドです. flag フィールドは <literal>delete</literal>
や <literal>compress</literal> のような
単独のキーワードから成ります. また, value
フィールドもキーワードで 始まりますが,
フィールドもキーワードで始まりますが,
キーワードの後にはホワイトスペースは入らず,
<literal>=</literal> と 二つめの単語が続きます. 例えば,
<literal>=</literal> と二つめの単語が続きます. 例えば,
<literal>release=cvs</literal> は value
フィールドです.</para>
@ -1457,43 +1451,43 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz</userinput></scr
行が非常に長くなってしまい不便になります.
これらの問題を避けるため, <application>CVSup</application>
ではデフォルトを指定することのできる
メカニズムが提供されています. 特殊な擬似コレクション名
メカニズムが提供されています. 特殊な擬似コレクション名
<literal>*default</literal> で始まる行は,
<filename>supfile</filename> 中の後続の
コレクションに対して使用する flag フィールドと value
フィールドの デフォルトを設定するために利用できます.
個々のコレクションで固有の値を 指定すると,
フィールドのデフォルトを設定するために利用できます.
個々のコレクションで固有の値を指定すると,
デフォルト値を無効にできます. また <option>*default</option>
行を追加すると, <filename>supfile</filename>
行を追加すると, <filename>supfile</filename>
の途中からデフォルト値の変更や追加が可能になります.</para>
<para>これまでの予備知識を基に, <link
linkend="current">FreeBSD-current</link>
<para>これまでの予備知識を基に,
<link linkend="current">FreeBSD-current</link>
のメインのソースツリーを受け取って更新するための
<filename>supfile</filename> を 組み立ててみましょう.</para>
<filename>supfile</filename> を組み立ててみましょう.</para>
<itemizedlist>
<listitem>
<para>どのファイルを受け取りたいのか?<anchor
id="cvsup-config-files"></para>
<para>どのファイルを受け取りたいのか?
<anchor id="cvsup-config-files"></para>
<para><application>CVSup</application>
を通して入手できるファイルは &ldquo;コレクション&rdquo;
と呼ばれる名前の付けられたグループにまとめられています.
利用可能なコレクションについては <link
linkend="cvsup-collec">ここ</link> で説明しています.
利用可能なコレクションについては
<link linkend="cvsup-collec">ここ</link> で説明しています.
ここでは, FreeBSD システムのメインのソースツリー全体
を受け取るための設定例を紹介します.
輸出規制されている暗号化サポートの
コード以外のすべてを含む <literal>src-all</literal>
という 単一の大きなコレクションがあります.
という単一の大きなコレクションがあります.
この例では私たちがアメリカ合衆国か
カナダにいるものと仮定します. その場合,
<literal>cvs-crypto</literal> という一つの付化的な
コレクションで暗号化コードを入手することができます.
<filename>supfile</filename>
を組み立てる最初のステップとして,
これらのコレクションを一行に一つづつ 記述します:</para>
これらのコレクションを一行に一つづつ記述します:</para>
<programlisting>
src-all
@ -1501,16 +1495,16 @@ cvs-crypto</programlisting>
</listitem>
<listitem>
<para>どのバージョンのものが欲しいのか?<anchor
id="cvsup-config-vers"></para>
<para>どのバージョンのものが欲しいのか?
<anchor id="cvsup-config-vers"></para>
<para><application>CVSup</application> を使用すると,
かつて存在していたことのある, 事実上どのバージョンの
ソースでも受け取ることができます. これは cvsupd
サーバがすべてのバージョンを含む CVS
リポジトリに基づいて動作することにより,
実現されています. <!-- kuriyama - date should be
literal --> <literal>tag=</literal> および
実現されています.
<literal>tag=</literal> および
<option>date=</option> の value フィールドを使用して,
欲しいバージョンの 一つを指定します.</para>
@ -1530,7 +1524,7 @@ cvs-crypto</programlisting>
<para><literal>tag=</literal>
フィールドはリポジトリ中のシンボリックタグを指定します.
tag には revision tag と branch tag の二種類があります.
revision tag は特定のリビジョンを指します. これは,
revision tag は特定のリビジョンを指します. これは,
毎日同じ状態に保つことになります. 一方 branch tag は,
ある時点での開発分流の最新のリビジョンを指します.
branch tag
@ -1750,17 +1744,17 @@ cvs-crypto</programlisting>
</listitem>
<listitem>
<para>どこから入手したいのか?<anchor
id="cvsup-config-where"></para>
<para>どこから入手したいのか?
<anchor id="cvsup-config-where"></para>
<para>更新情報をどこから入手するかを
<command>cvsup</command> に伝えるために
<literal>host=</literal> フィールドを使用します.<link
linkend="mirrors-cvsup">CVSup ミラーサイト</link>
<literal>host=</literal> フィールドを使用します.
<link linkend="mirrors-cvsup">CVSup ミラーサイト</link>
のどこからでも入手できますが,
ネット上での最寄りのサイトを選ぶべきでしょう.
この例では, 仮想上の FreeBSD 配布サイト <hostid
role="fqdn">cvsup666.FreeBSD.org</hostid>
この例では, 仮想上の FreeBSD 配布サイト
<hostid role="fqdn">cvsup666.FreeBSD.org</hostid>
を使用します:</para>
<programlisting>
@ -1775,8 +1769,8 @@ cvs-crypto</programlisting>
</listitem>
<listitem>
<para>自分のマシンのどこに置きたいのか?<anchor
id="cvsup-config-dest"></para>
<para>自分のマシンのどこに置きたいのか?
<anchor id="cvsup-config-dest"></para>
<para><literal>prefix=</literal> フィールドは,
<command>cvsup</command>
@ -1793,15 +1787,15 @@ cvs-crypto</programlisting>
</listitem>
<listitem>
<para>どこに status ファイルを置きたいのか?<anchor
id="cvsup-config-status"></para>
<para>どこに status ファイルを置きたいのか?
<anchor id="cvsup-config-status"></para>
<para>cvsup クライアントは &ldquo;base&rdquo;
ディレクトリと呼ばれる場所に, ある status
ディレクトリと呼ばれる場所に, ある status
ファイルを維持しています.
すでに受け取った更新情報を追従し続け ることで,
すでに受け取った更新情報を追従し続けることで,
これらのファイルは <application>CVSup</application>
がより効果的に動作することを支援し ます. 標準の base
がより効果的に動作することを支援します. 標準の base
ディレクトリ <filename>/usr/local/etc/cvsup</filename>
を使用します:</para>
@ -1848,14 +1842,14 @@ cvs-crypto</programlisting>
まったく手をつけずに残しておきます.</para>
<para><literal>use-rel-suffix</literal> は ...
神秘的なものです. これについて本当に 知りたい人は,
神秘的なものです. これについて本当に知りたい人は,
&man.cvsup.1; のマニュアルページをご覧ください.
でなければ, 何も考えずに指定してみてください.</para>
でなければ, 何も考えずに指定してみてください.</para>
<para><literal>compress</literal> は通信チャネルで gzip
形式の圧縮の使用を有効にします.
ご使用のネットワーク接続が T1 speed 以上である場合,
この圧縮を 使用しない方がよいかもしれません.
この圧縮を使用しない方がよいかもしれません.
そうでない場合は十分に役に立ちます.</para>
</listitem>
@ -1881,26 +1875,26 @@ cvs-crypto</programlisting>
<title><application>CVSup</application> の実行</title>
<para>さて, 更新の準備ができました.
これを実行するコマンドラインは 実に簡単です:</para>
これを実行するコマンドラインは実に簡単です:</para>
<screen>&prompt.root; <userinput>cvsup <replaceable>supfile</replaceable></userinput></screen>
<para>もちろん, ここでの
<filename><replaceable>supfile</replaceable></filename>
は作成したばかりの supfile のファイル名です. X11
は作成したばかりの supfile のファイル名です. X11
環境で実行するものと仮定して, <command>cvsup</command> は
通常の操作に必要なボタンを持つ GUI ウィンドウを表示します.
&ldquo;go&rdquo; ボタンを押して,
実行を監視してください.</para>
<para>この例では実際の <filename>/usr/src</filename>
ツリーを更新しているので, <command>cvsup </command>
ツリーを更新しているので, <command>cvsup</command>
にファイルを更新するのに必要なパーミッションを与えるために,
ユーザ <username>root</username> で実行する必要があります.
ユーザ <username>root</username> で実行する必要があります.
コンフィグレーションファイルを作ったばかりで,
しかも以前にこのプログラムを実行したことがないので,
神経質になるのは 無理もない話だと思います.
大切なファイルに触らずに試しに実行する簡単な 方法があります.
神経質になるのは無理もない話だと思います.
大切なファイルに触らずに試しに実行する簡単な方法があります.
どこか適当な場所に空のディレクトリを作成して,
コマンドラインの引数で指定するだけです:</para>
@ -1910,16 +1904,16 @@ cvs-crypto</programlisting>
<para>指定したディレクトリは, すべての更新されるファイルの
更新先ディレクトリとして使用します.
<application>CVSup</application> は
<filename>/usr/src</filename> の下の ファイルを検査しますが,
変更や削除はまったくおこないません. かわりに
<filename>/usr/src</filename> の下のファイルを検査しますが,
変更や削除はまったくおこないません. かわりに
<filename>/var/tmp/dest/usr/src</filename>
に更新されたすべてのファイルが 置かれるようになります.
に更新されたすべてのファイルが置かれるようになります.
この方法で実行した場合は, <application>CVSup</application>
は base ディレクトリの status
は base ディレクトリの status
ファイルを更新せずにそのままにします.
これらのファイルの新しいバージョンは指定されたディレクトリ
に書き込まれます. <filename>/usr/src</filename>
の読み取り許可がある限り, このような 試し実行のためにユーザ
の読み取り許可がある限り, このような試し実行のためにユーザ
root になる必要はありません.</para>
<para>X11 を利用していないとか単に GUI が気に入らない場合は,
@ -1941,14 +1935,14 @@ cvs-crypto</programlisting>
しません.</para>
<para>たくさんの他のオプション変数があります.
それらの簡単な一覧は <command>cvsup -H</command>
それらの簡単な一覧は <command>cvsup -H</command>
で表示されます.
より詳しい説明はマニュアルページをご覧ください.</para>
<para>動作している更新の方法に満足したら, &man.cron.8;
を使って cvsup を定期的に
実行させる準備をすることができます. cron から起動する際には,
明示的に cvsup が GUI
明示的に cvsup が GUI
を使わないようにする必要があります.</para>
</sect3>
@ -1968,7 +1962,7 @@ cvs-crypto</programlisting>
<para>最も一般的に使用するコレクションは
<literal>src-all</literal>, <literal>cvs-crypto</literal>,
そして <literal>ports-all</literal> です.
他のコレクションは特別な目的を持つ人達だけが 使用しており,
他のコレクションは特別な目的を持つ人達だけが使用しており,
ミラーサイトはそれらのすべてを
持っていないかもしれません.</para>
@ -2580,7 +2574,7 @@ cvs-crypto</programlisting>
The CVSup Home Page</ulink> をご覧ください.</para>
<para><application>CVSup</application> のほとんどの FreeBSD
関連の議論は &a.hackers; で おこなわれています.
関連の議論は &a.hackers; でおこなわれています.
ソフトウェアの新しいバージョンは &a.announce; で
アナウンスされます.</para>
@ -2596,8 +2590,7 @@ cvs-crypto</programlisting>
<para><emphasis>Contributed by &a.nik;.</emphasis></para>
<para><emphasis>訳: &a.jp.y-koga;.<!-- <br> -->
16 March 1998.</emphasis></para>
<para><emphasis>訳: &a.jp.y-koga;. 16 March 1998.</emphasis></para>
<para>FreeBSD のどれか特定のバージョン (<literal>stable</literal>,
<literal>current</literal> など)
@ -2608,7 +2601,8 @@ cvs-crypto</programlisting>
<para>その方法については, <ulink
url="http://www.nothing-going-on.demon.co.uk/FreeBSD/make-world/make-world.html">http://www.nothing-going-on.demon.co.uk/FreeBSD/make-world/make-world.html</ulink> が今のところ一番よいチュートリアル資料です.</para>
<para>このチュートリアルの次のバージョンは, ハンドブックに統合される予定です.</para>
<para>このチュートリアルの次のバージョンは,
ハンドブックに統合される予定です.</para>
</sect1>
</chapter>