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

- Merge the following from the English version:

Browse source 
r40739 -> r40795	head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml
This commit is contained in:
Ryusuke SUZUKI 2013-01-29 10:31:55 +00:00
parent 6bfee3cfc7
commit f879691468
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=40797
1 changed files with 52 additions and 115 deletions

167
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: r40739
Original revision: r40795
$FreeBSD$
-->
@ -68,9 +68,7 @@
<listitem>
<para><application>freebsd-update</application>,
<application>Subversion</application>,
<application>CVSup</application>,
<application>CVS</application> もしくは
<application>Subversion</application> もしくは
<application>CTM</application>
を使ったシステム更新方法</para>
</listitem>
@ -112,7 +110,7 @@
&os; のソースコードをダウンロードしたりアップデートするのに
<command>svn</command> コマンドが用いられます。
このコマンドを使うには、<filename
role="package">devel/subversion</filename> port または package
role="package">devel/subversion</filename> port または package
をインストールしておく必要があります。</para>
</note>
</sect1>
@ -396,11 +394,12 @@ MergeChanges /etc/ /var/named/etc/</programlisting>
<itemizedlist>
<listitem>
<para>ただ一度だけカスタムカーネルを構築したのであれば、
<filename class="directory">/boot/kernel.old</filename>
は <filename>GENERIC</filename> カーネルそのものです。
ただ単にこのディレクトリの名前を
<filename class="directory">/boot/GENERIC</filename>
へと変更してください。</para>
<filename
class="directory">/boot/kernel.old</filename>
は <filename>GENERIC</filename> カーネルそのものです。
ただ単にこのディレクトリの名前を
<filename class="directory">/boot/GENERIC</filename>
へと変更してください。</para>
</listitem>
<listitem>
@ -417,7 +416,7 @@ MergeChanges /etc/ /var/named/etc/</programlisting>
class="directory"><replaceable>X.Y-RELEASE</replaceable></filename>
を実際のリリース番号に置き換えてください。
<filename>GENERIC</filename> は、デフォルトで <filename
class="directory">/boot/GENERIC</filename>
class="directory">/boot/GENERIC</filename>
にインストールされます。</para>
</listitem>
@ -449,7 +448,8 @@ MergeChanges /etc/ /var/named/etc/</programlisting>
<itemizedlist>
<listitem>
<para>ただ一度だけカスタムカーネルを構築したのであれば、
<filename class="directory">/boot/kernel.old</filename>
<filename
class="directory">/boot/kernel.old</filename>
は <filename>GENERIC</filename> カーネルそのものです。
ただ単にこのディレクトリの名前を
<filename class="directory">/boot/kernel</filename>
@ -899,9 +899,14 @@ Fetching 133 new ports or files... done.</screen>
<para>ドキュメントのソースは、
<application>Subversion</application>
プログラムを使ってダウンロードできます。
ダウンロードするには以下のように入力してください。</para>
western US ミラーから HTTPS
プロトコルを用いてダウンロードするには以下のように入力してください。</para>
<screen>&prompt.root; <userinput>svn checkout <literal>svn://svn.FreeBSD.org/doc/head</literal> <filename class="directory">/usr/doc</filename></userinput></screen>
<screen>&prompt.root; <userinput>svn checkout <literal>https://svn0.us-west.FreeBSD.org/doc/head</literal> /usr/doc</userinput></screen>
<para>利用可能な <link
linkend="svn-mirrors">Subversion ミラーサイト</link>
の中からもっとも近いミラーを使ってください。</para>
<para>最初にドキュメントのソースをダウンロードするには少し時間がかかります。
ダウンロードが終わるまでお待ちください。</para>
@ -1475,21 +1480,22 @@ Fetching 133 new ports or files... done.</screen>
<listitem>
<para>&os; <link linkend="mirrors">ミラーサイト</link>
からのソースの入手。以下の 3 つの方法のいずれかでできます。</para>
からソースの入手するには、以下のようないくつかの方法があります。</para>
<orderedlist>
<indexterm>
<primary><command>svn</command></primary>
<primary>Subversion</primary>
</indexterm>
<indexterm>
<primary><command>cvsup</command></primary>
</indexterm>
<indexterm>
<primary><command>cron</command></primary>
</indexterm>
<indexterm>
<primary>-CURRENT</primary>
<secondary><application>CVSup</application> を使った同期</secondary>
<secondary><application>Subversion</application> を使った同期</secondary>
</indexterm>
<indexterm>
<primary>-CURRENT</primary>
<secondary><application>CTM</application> を使った同期</secondary>
</indexterm>
<listitem>
@ -1498,48 +1504,13 @@ Fetching 133 new ports or files... done.</screen>
もしくはリリースブランチをチェックアウトしてください。
この方法は、開発中の &os; リポジトリへのアクセスを提供しており、
推奨されています。
<application>Subversion</application> を使って
-CURRENT ベースシステムをチェックアウトする際の
URL のプレフィックスは、
<literal>http://svn.freebsd.org/base/head/</literal>
です。
<link linkend="svn-mirrors">Subversion ミラーサイト</link>
のひとつの <literal>head</literal> ブランチから
-CURRENT コードをチェックアウトしてください。
リポジトリサイズの観点から、
希望するサブツリーのみをチェックアウトすることが推奨されます。</para>
</listitem>
<listitem>
<para><link linkend="cvsup">cvsup</link> を
<filename>/usr/share/examples/cvsup</filename> にある
<filename>standard-supfile</filename> という名称の
<filename>supfile</filename> と合わせて使ってください。
上に挙げた見本の <filename>supfile</filename>
をカスタマイズするとともに、あなたの環境に合わせて <link
linkend="cvsup">cvsup</link> を設定する必要があります。</para>
<warning>
<para><command>cvsup</command> は、
プロジェクトにおいて廃止されたので、
現在では推奨されていません。</para>
</warning>
<note>
<para>サンプルファイルの <filename>standard-supfile</filename>
は、&os; の特定のセキュリティブランチを追いかけるためのものであり、
&os.current; 用ではありません。
このファイルの中にある次の行を</para>
<programlisting>*default release=cvs tag=RELENG_<replaceable>X</replaceable>_<replaceable>Y</replaceable></programlisting>
<para>以下に置き換えてください。</para>
<programlisting>*default release=cvs tag=.</programlisting>
<para>使用可能なタグに関する詳細な説明は、
ハンドブックの <link
linkend="cvs-tags">CVS タグ</link> の章にあります。</para>
</note>
</listitem>
<listitem>
<indexterm>
<primary>-CURRENT</primary>
@ -1709,15 +1680,12 @@ Fetching 133 new ports or files... done.</screen>
<para>もし、既に &os; の以前のリリースが動いている場合で、
これをソースからアップグレードしようとするならば、
&os; <link linkend="mirrors">ミラーサイト</link>
から簡単に行えます。これには次の 3 つの方法があります。
から簡単に行えます。以下のようないくつかの方法があります。
</para>
<orderedlist>
<indexterm>
<primary><command>svn</command></primary>
</indexterm>
<indexterm>
<primary><command>cvsup</command></primary>
<primary>Subversion</primary>
</indexterm>
<indexterm>
<primary><command>cron</command></primary>
@ -1742,29 +1710,13 @@ Fetching 133 new ports or files... done.</screen>
<literal>releng/9.0</literal> となります。
<application>Subversion</application>
を使ってベースシステムをチェックアウトする際の
URL のプレフィックスは、
<literal>http://svn.freebsd.org/base/</literal>
となります。
URL のプレフィックスは、<link
linkend="svn-mirrors">Subversion ミラーサイト</link>
で説明されています。
リポジトリサイズの観点から、
希望するサブツリーのみをチェックアウトすることが推奨されます。</para>
</listitem>
<listitem>
<para><link linkend="cvsup">cvsup</link> を
<filename>/usr/share/examples/cvsup</filename> にある
<filename>stable-supfile</filename> という名称の
<filename>supfile</filename> と合わせて使ってください。
上に挙げた見本の <filename>supfile</filename>
をカスタマイズするとともに、あなたの環境に合わせて <link
linkend="cvsup">cvsup</link> を設定する必要があります。</para>
<warning>
<para><command>cvsup</command> は、
プロジェクトにおいて廃止されたので、
現在では推奨されていません。</para>
</warning>
</listitem>
<listitem>
<indexterm>
<primary>-STABLE</primary>
@ -1782,8 +1734,8 @@ Fetching 133 new ports or files... done.</screen>
<listitem>
<para>基本的には、
ソースに迅速でオンデマンドなアクセスが必要で、
接続のバンド幅が問題でなければ、<command>cvsup</command>
か <command>ftp</command> を使いましょう。そうで
接続のバンド幅が問題でなければ、
<command>Subversion</command> を使いましょう。そうで
ない場合は <application>CTM</application>
を使いましょう。</para>
</listitem>
@ -1820,10 +1772,8 @@ Fetching 133 new ports or files... done.</screen>
プロジェクトのソースのある一部分または全体の最新を
追いかける方法は色々あります。
私たちが提供している基本的なサービスは <link
linkend="svn">Subversion</link>、<link
linkend="anoncvs">Anonymous CVS</link>、<link
linkend="cvsup">CVSup</link> と <link linkend="ctm">CTM</link>
です:</para>
linkend="svn">Subversion</link>
と <link linkend="ctm">CTM</link> です。</para>
<warning>
<para>ソースツリーの一部を最新のものに更新することは可能です。
@ -1839,30 +1789,20 @@ Fetching 133 new ports or files... done.</screen>
</warning>
<indexterm>
<primary>CVS</primary>
<secondary>anonymous</secondary>
<primary>Subversion</primary>
</indexterm>
<para><application>Subversion</application>,
<application>Anonymous CVS</application> と
<application>CVSup</application> は <emphasis>pull</emphasis>
同期モデルを採用しています。
<application>Subversion</application> の場合、ユーザ
(または <command>cron</command> スクリプト) が <command>svn</command>
<para><application>Subversion</application>
は <emphasis>pull</emphasis> 同期モデルを採用しています。
ユーザ (または <command>cron</command> スクリプト) が <command>svn</command>
を起動し、ファイルを最新状態にします。
<application>Subversion</application> は、
ローカルのソースツリーをアップデートする最も好ましい方法です。
<command>cvsup</command> および <command>cvs</command> も同様の原理で動作しますが、
Subversion への移行に伴い廃止されました。
届けられる更新情報はその時点の最新のものであり、
また必要な時にだけ取り寄せられます。
興味のある特定のファイルやディレクトリに限定して更新することも簡単にできます。
クライアント側のソースツリーの状態・
設定ファイルの指定に従い、サーバによって更新情報が素早く生成されます。
本当にやむを得ない理由がない限り、同期システムとして、
<application>Subversion</application> を用いるべきです。
他の同期メカニズムは廃止されており、将来停止する予定です。
</para>
設定ファイルの指定に従い、サーバによって更新情報が素早く生成されます。</para>
<indexterm>
<primary><application>CTM</application></primary>
@ -1880,23 +1820,20 @@ Fetching 133 new ports or files... done.</screen>
これらの <quote>CTM のデルタ</quote> は自動
的にデコード、検査してユーザのソースのコピーに変更を適用する
&man.ctm.rmail.1; によって処理可能となります。
この処理は <application>CVSup</application> や
<application>Anonymous CVS</application> よりずっと効率
的であり、<emphasis>pull</emphasis> モデルというよりむしろ
この処理は <application>Subversion</application>
よりずっと効率的であり、<emphasis>pull</emphasis> モデルというよりむしろ
<emphasis>push</emphasis> モデルで
あるため、私たちのサーバ資源の負荷は軽くなります。</para>
<para>もちろん他のトレードオフもあります。うっかりアーカイブ
の一部を消してしまっても、<application>CVSup</application>
の一部を消してしまっても、<application>Subversion</application>
は壊れた部分を検出して再構築してくれます。
<application>CTM</application> はこれをやってくれませんし、
<application>Anonymous CVS</application>
はおそらく他の何よりも深く混乱してしまうことが多いでしょう。
もしソースツリーの一部を消してしまったら、(最新の CVS
<application>CTM</application> はこれをやってくれません。
もしソースツリーの一部を消してしまったら
(そしてバックアップを取っていないのであれば)、(最新の CTM
<quote>ベースデルタ</quote> から) 一からやり直し、
<application>CTM</application> か <application>Anonymous CVS</application>
を使って悪い部分を消去し、再同期させることによって
すべてを再構築しなければなりません。</para>
<application>CTM</application>
を使ってすべてを再構築しなければなりません。</para>
</sect1>
<sect1 id="makeworld">
@ -3035,7 +2972,7 @@ Script done, &hellip;</screen>
<answer>
<para>
それは変更の性質によるので、なんとも言えません。
たとえば、<application>CVSup</application> を実行したとき、最後に実行したときから比べて
たとえば、<application>Subversion</application> を実行したとき、最後に実行したときから比べて
次にあげるようなファイルが更新されていたとします。</para>
<screen><filename>src/games/cribbage/instr.c</filename>