Date: Tue, 29 Jan 2013 10:31:56 +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: r40797 - head/ja_JP.eucJP/books/handbook/cutting-edge Message-ID: <201301291031.r0TAVuGi061016@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: ryusuke Date: Tue Jan 29 10:31:55 2013 New Revision: 40797 URL: http://svnweb.freebsd.org/changeset/doc/40797 Log: - Merge the following from the English version: r40739 -> r40795 head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml Modified: head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml Modified: head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml ============================================================================== --- head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml Tue Jan 29 10:29:41 2013 (r40796) +++ head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml Tue Jan 29 10:31:55 2013 (r40797) @@ -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/</prog <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/</prog 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/</prog <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. <para>ドキュメントのソースは、 <application>Subversion</application> プログラムを使ってダウンロードできます。 - ダウンロードするには以下のように入力してください。</para> + western US ミラーから HTTPS + プロトコルを用いてダウンロードするには以下のように入力してください。</para> + + <screen>&prompt.root; <userinput>svn checkout <literal>https://svn0.us-west.FreeBSD.org/doc/head</literal>; /usr/doc</userinput></screen> - <screen>&prompt.root; <userinput>svn checkout <literal>svn://svn.FreeBSD.org/doc/head</literal> <filename class="directory">/usr/doc</filename></userinput></screen> + <para>利用可能な <link + linkend="svn-mirrors">Subversion ミラーサイト</link> + の中からもっとも近いミラーを使ってください。</para> <para>最初にドキュメントのソースをダウンロードするには少し時間がかかります。 ダウンロードが終わるまでお待ちください。</para> @@ -1475,21 +1480,22 @@ Fetching 133 new ports or files... done. <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. もしくはリリースブランチをチェックアウトしてください。 この方法は、開発中の &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. <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,30 +1710,14 @@ Fetching 133 new ports or files... done. <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> <secondary>CTM を使って同期する</secondary> @@ -1782,8 +1734,8 @@ Fetching 133 new ports or files... done. <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. プロジェクトのソースのある一部分または全体の最新を 追いかける方法は色々あります。 私たちが提供している基本的なサービスは <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. </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. これらの <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, …</screen> <answer> <para> それは変更の性質によるので、なんとも言えません。 - たとえば、<application>CVSup</application> を実行したとき、最後に実行したときから比べて + たとえば、<application>Subversion</application> を実行したとき、最後に実行したときから比べて 次にあげるようなファイルが更新されていたとします。</para> <screen><filename>src/games/cribbage/instr.c</filename>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201301291031.r0TAVuGi061016>