Date: Thu, 6 Mar 2014 13:41:13 +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: r44145 - head/ja_JP.eucJP/books/handbook/cutting-edge Message-ID: <201403061341.s26DfD21013065@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: ryusuke Date: Thu Mar 6 13:41:13 2014 New Revision: 44145 URL: http://svnweb.freebsd.org/changeset/doc/44145 Log: - Merge the following from the English version: r43782 -> r43794 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 Thu Mar 6 02:34:17 2014 (r44144) +++ head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml Thu Mar 6 13:41:13 2014 (r44145) @@ -3,7 +3,7 @@ The FreeBSD Documentation Project The FreeBSD Japanese Documentation Project - Original revision: r43782 + Original revision: r43794 $FreeBSD$ --> <chapter xmlns="http://docbook.org/ns/docbook" @@ -1486,62 +1486,58 @@ before running "/usr/sbin/freebsd-update <para>&os.stable;、&os.current; などの &os; のどれか特定のバージョンについて、 ローカルのソースツリーを同期させたら、 - そのソースツリーを使ってシステムを再構築できます。</para> + そのソースツリーを使ってシステムを再構築できます。 + このプロセスは world の再構築と呼ばれます。</para> - <warning> - <title>バックアップの作成</title> + <para>world を再構築する<emphasis>前</emphasis>に、 + 以下を行ってください。</para> + + <procedure> + <title>world の構築前に行う作業</title> - <para>システムを再構築する<emphasis>前に</emphasis>、 + <step> + <para>重要なデータを他のシステムやリムーバブルメディアにバックアップし、 + きちんとバックアップが作成されていることを確認したら、 + 起動可能なインストールメディアを用意してください。 + システムを再構築する<emphasis>前に</emphasis>、 バックアップを作成することの重要性は、 いくら強調してもし過ぎると言うことはありません。 - システム全体の再構築とは難しい作業ではありませんが、 + システム全体の再構築は難しい作業ではありませんが、 どんなに注意していたとしても、<!-- hrs:2000/01/12 inevitably --> ソースツリーそのものに手違いがあった時には、 システムが起動しなくなってしまう状態になることがあるのです。 - </para> - - <para>まず、バックアップがきちんと作成されていることを確認して、 - 起動可能インストールメディアを用意してください。 多分、それを使うことはないと思いますが、 - あとで後悔することのないよう、念のため用意しておきましょう。</para> - </warning> - - <warning> - <title>メーリングリストに参加する</title> + あとで後悔することのないよう、念のため用意しておきましょう!</para> + </step> + <step> <indexterm><primary>メーリングリスト</primary></indexterm> - - <para>もともと、&os.stable; と &os.current; のコードブランチは、 - <emphasis>開発中のもの</emphasis>です。 - &os; の作業に貢献してくださっている人達も人間ですから、 - 時にはミスをすることだってあるでしょう。 - </para> - - <para>そのような間違いは、 - 単に警告を示す見慣れない診断メッセージをシステムが表示するような、 - まったく害のないものであることもあれば、システムを起動できなくしたり、 - ファイルシステムを破壊してしまうような、 - 恐ろしい結果を招くものかも知れません。</para> - - <para>問題が生じた場合、 - 問題の詳細と、どのようなシステムが影響を受けるかについて書かれた - <quote>注意 (heads up)</quote> - の記事が適切なメーリングリストに投稿されます。 - そして、その問題が解決されると、 + <para>追いかけているブランチに応じて、 + &a.stable.name; もしくは &a.current.name; + の最近のエントリを調べて、 + 既知の問題や影響を受けるシステムを確認してください。 + 既知の問題が同期しているバージョンのコードに影響する場合は、 + その問題が解決されたことを報告する <quote>問題解決 (all clear)</quote> - のアナウンス記事が同様に投稿されます。</para> - - <para>&os.stable; や &os.current; ブランチを追随しているユーザで、 - &a.stable; や &a.current; を読まないというのは、 - 自ら災難を招くようなものです。</para> - - <para><emphasis>訳注:</emphasis> - これらのメーリングリストは英語でやりとりされているため、 - 日本語での投稿は歓迎されません。英語でのやりとりができない人は、 - <link xlink:href="http://www.jp.FreeBSD.org">FreeBSD 友の会</link> - の運営しているメーリングリストをあたってみるのがいいでしょう。 - </para> - </warning> + のアナウンスが投稿されるまで待ってから、 + ソースを同期して、ローカルのソースに必要な修正を入れてください。</para> + </step> + + <step> + <para>buildworld 前の必要なステップとして、 + 同期しているバージョンのソースの + <filename>/usr/src/UPDATING</filename> を読んでください。 + このファイルには潜在的な問題や特定のコマンドを実行する順などの重要な情報が含まれています。 + 大きなアップグレードでは、 + installworld の前に特定のファイルの名前を変更したり、削除するといった、 + 特別なステップが追加で必要となることがあります。 + ファイルの最後には、 + 現在推奨されているアップグレードの手順が詳しく正確に説明されています。 + もし、<filename>UPDATING</filename> に書かれている手順が、 + この節に書かれているものと矛盾していたら、 + <filename>UPDATING</filename> の手順を採用してください。</para> + </step> + </procedure> <warning> <title><command>make world</command> は使わないこと</title> @@ -1558,11 +1554,8 @@ before running "/usr/sbin/freebsd-update <sect2 xml:id="canonical-build"> <title>システムを更新する正式な方法</title> - <para>システムを更新する前に、 - <filename>/usr/src/UPDATING</filename> を読んでください。 - このファイルには、用意したソースコードで buildworld - を行う前に必要な手順が書かれています。 - その後、以下の手順を踏んでください。</para> + <para>上で述べた作業を行ったら、 + 以下の手順を踏んでシステムをアップデートしてください。</para> <para>この節で説明するアップデートのプロセスは、古いコンパイラ、 古いカーネル、古い world、そして古いコンフィグレーションファイルからなる、 @@ -1751,13 +1744,6 @@ before running "/usr/sbin/freebsd-update <para>メジャーリリースをまたいだアップデートでは、 この方法を用いないと、何らかの問題にぶつかるでしょう。</para> - <para>大きなアップグレードにおいては、 - installworld の前に特定のファイルの名前の変更や削除するといった、 - 特別な追加のステップが必要となることがあります。 - <filename>/usr/src/UPDATING</filename> を注意深く読んでください。 - 特にファイルの最後には、 - 現在推奨されているアップグレードの手順が詳しく正確に説明されています。</para> - <para>この手続きは、 開発者たちがある種のミスマッチを完全に避けるために、長い年月をかけて進化してきました。 願わくば、この現在の手順が長い間安定してほしいものです。</para> @@ -1816,23 +1802,6 @@ before running "/usr/sbin/freebsd-update </sect2> <sect2 xml:id="src-updating"> - <title><filename>/usr/src/UPDATING</filename> を読む</title> - - <para>アップデートする前に、 - <filename>/usr/src/UPDATING</filename> を読んでください。 - このファイルには潜在的な問題や - 特定のコマンドの順などの重要な情報が含まれています。 - <filename>UPDATING</filename> がこの節に書かれているものと矛盾している時は - <filename>UPDATING</filename> を優先してください。</para> - - <important> - <para><filename>UPDATING</filename> を読むということは、 - 適切なメーリングリストを購読する代わりにはなりません。 - 二つの要求は相補的なもので排他的なものではないのです。</para> - </important> - </sect2> - - <sect2 xml:id="make-conf"> <title><filename>/etc/make.conf</filename> の確認</title> <indexterm> @@ -1990,12 +1959,9 @@ before running "/usr/sbin/freebsd-update &prompt.root; <userinput>rm -rf *</userinput></screen> </sect2> - <sect2 xml:id="updating-upgrading-compilebase"> + <sect2 xml:id="make-buildworld"> <title>ベースシステムの再構築</title> - <sect3> - <title>出力メッセージの保存</title> - <para>実行される &man.make.1; からの出力は、ファイルに保存すると良いでしょう。 もし、何か障害が発生した場合、エラーメッセージのコピーを &os; メーリングリストに投稿してください。</para> @@ -2018,10 +1984,6 @@ Script done, …</screen> 出力の保存には、<filename>/var/tmp</filename> や <systemitem class="username">root</systemitem> のホームディレクトリが適しています。</para> - </sect3> - - <sect3 xml:id="make-buildworld"> - <title>ベースシステムの構築</title> <para><filename>/usr/src</filename> にて、 次のように実行してください。</para> @@ -2144,10 +2106,6 @@ Script done, …</screen> <para>もし、複数の CPU を備えたマシンで SMP 設定が行なわれたカーネルを 利用しているなら、6 から 10 の間の値を設定し、速度がどれくらい 向上するか確認してみてください。</para> - </sect3> - - <sect3> - <title>システムの構築にかかる時間</title> <indexterm> <primary><quote>world</quote> の再構築</primary> @@ -2159,7 +2117,6 @@ Script done, …</screen> トリックや近道を使わずに普通に構築した場合、&os.stable; の構築には 1, 2 時間しかかからないでしょう。 &os.current; の構築は、もう少し時間がかかります。</para> - </sect3> </sect2> <sect2 xml:id="new-kernel">
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201403061341.s26DfD21013065>