Date: Sat, 6 Apr 2013 02:37:29 +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: r41383 - head/ja_JP.eucJP/books/handbook/cutting-edge Message-ID: <201304060237.r362bTjO069480@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: ryusuke Date: Sat Apr 6 02:37:29 2013 New Revision: 41383 URL: http://svnweb.freebsd.org/changeset/doc/41383 Log: - Merge the following from the English version: r40809 -> r41349 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 Sat Apr 6 01:50:46 2013 (r41382) +++ head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml Sat Apr 6 02:37:29 2013 (r41383) @@ -3,7 +3,7 @@ The FreeBSD Documentation Project The FreeBSD Japanese Documentation Project - Original revision: r40809 + Original revision: r41349 $FreeBSD$ --> @@ -52,11 +52,9 @@ セキュリティや他の重要な修正のため、時にはアップデートを行う必要があります。 使用しているバージョンに関わらず、&os; は、 手元のシステムを最新の開発ツリーと同期するために必要なツールをすべて用意しています。 - そして、これらのツールは、&os; のバージョンをアップグレードするためにも使えます。 - もしもあなたが、開発途中のシステムを追いかけようか、 - それともリリースバージョンのどれかを使い続けようかと迷っているのなら、 - きっとこの章が参考になるでしょう。 - 手元のシステムをアップデートする基本的なツールについても解説しています。</para> + そして、これらのツールは、&os; のバージョンをアップグレードするために使えます。 + この章では、開発ブランチを追いかける方法、および、&os; + システムをアップデートする基本的なツールについて解説しています。</para> <para>この章を読んで分かるのは:</para> @@ -70,7 +68,7 @@ <para><application>freebsd-update</application>, <application>Subversion</application> もしくは <application>CTM</application> - を使ったシステム更新方法</para> + を使った &os; システムの更新方法</para> </listitem> <listitem> @@ -81,7 +79,7 @@ <para><application>Subversion</application> またはドキュメント用の ports<!-- and <application>Docsnap</application>--> を使って、 - ドキュメントを最新のものにアップデートする方法。</para> + インストールされているドキュメントを最新のものにアップデートする方法。</para> </listitem> <listitem> @@ -89,8 +87,7 @@ </listitem> <listitem> - <para><command>make buildworld</command> (等) - を使ってベースシステム全体を再構築しインストールする方法</para> + <para>ベースシステム全体を再構築しインストールする方法</para> </listitem> </itemizedlist> @@ -98,8 +95,9 @@ <para>この章を読む前に、以下の準備をしましょう。</para> <itemizedlist> - <listitem><para>ネットワーク接続の適切な設定 (<xref - linkend="advanced-networking"/>)</para> + <listitem> + <para>ネットワーク接続の適切な設定 (<xref + linkend="advanced-networking"/>)</para> </listitem> <listitem><para>サードパーティ製のソフトウェアのインストール方法の習得 (<xref linkend="ports"/>)</para></listitem> @@ -108,8 +106,8 @@ <note> <para>この章を通じて、 &os; のソースコードをダウンロードしたりアップデートするのに - <command>svn</command> コマンドが用いられます。 - このコマンドを使うには、<filename + <command>svn</command> が用いられます。 + このコマンドを使うためには、<filename role="package">devel/subversion</filename> port または package をインストールしておく必要があります。</para> </note> @@ -132,7 +130,7 @@ </author> </authorgroup> </sect1info> - <title>FreeBSD Update</title> + <title>&os; Update</title> <indexterm><primary>Updating and Upgrading</primary></indexterm> <indexterm> @@ -157,9 +155,10 @@ <note> <para>バイナリアップデートは、 セキュリティチームがサポートしているすべてのアーキテクチャとリリースで利用できます。 - 新しいリリースにアップデートする前に、現在のリリースのアナウンスに目を通し、 - アップデートしようとしているリリースに対して重要な情報がないかどうかを確認してください。 - これらのアナウンスは + 新しいリリースにアップデートする前に、 + アップデートしようとしているリリースのアナウンスに目を通し、 + 重要な情報がないかどうかを確認してください。 + リリースのアナウンスは <ulink url="http://www.FreeBSD.org/ja/releases/"></ulink>; で確認できます。</para> </note> @@ -171,11 +170,11 @@ <sect2 id="freebsdupdate-config-file"> <title>設定ファイル</title> - <para>設定ファイル <filename>/etc/freebsd-update.conf</filename> - をデフォルトからきめ細かく調整して、 + <para><filename>/etc/freebsd-update.conf</filename> + の設定をデフォルトからきめ細かく調整して、 アップデートプロセスを制御するユーザもいます。 この作業は良く文書化されていますが、 - 以下のいくつかの項目については説明が必要でしょう。</para> + 以下の項目については説明が必要でしょう。</para> <programlisting># Components of the base system which should be kept updated. Components src world kernel</programlisting> @@ -190,7 +189,7 @@ Components src world kernel</programlist ソースコードのアップデートを許可します。</para> <para>この部分についてはデフォルトのままにしておき、 - アップデートしたい項目をユーザがリストに加える形にするのがベストでしょう。 + アップデートする項目をユーザがリストに加える形にするのがベストでしょう。 ソースコードとバイナリが同期していないと、 悲惨な結果をもたらす可能性があります。</para> @@ -198,9 +197,10 @@ Components src world kernel</programlist # statement will be ignored. IgnorePaths</programlisting> - <para>アップデートで変更されてはいけない特定のディレクトリ、 - <filename class="directory">/bin</filename> や - <filename class="directory">/sbin</filename> 等のパスを追加してください。 + <para><filename class="directory">/bin</filename> や + <filename class="directory">/sbin</filename> + 等の特定のディレクトリをアップデートで変更しないように、 + これらのパスを追加してください。 このオプションは、ローカルの変更点を <command>freebsd-update</command> が上書きすることを防ぐ目的にも利用できます。</para> @@ -209,7 +209,7 @@ IgnorePaths</programlisting> # modified by the user (unless changes are merged; see below). UpdateIfUnmodified /etc/ /var/ /root/ /.cshrc /.profile</programlisting> - <para>指定したディレクトリにある設定ファイルを、 + <para>このオプションは、指定したディレクトリにある設定ファイルを、 ローカルで変更されていない場合のみアップデートします。 ユーザがこれらのファイルを変更していると、 これらのファイルの自動アップデートは無効になります。 @@ -225,14 +225,14 @@ MergeChanges /etc/ /var/named/etc/</prog <para><command>freebsd-update</command> がマージすべきファイルが存在するディレクトリの一覧です。 ファイルのマージのプロセスは、 - &man.mergemaster.8; と同様 &man.diff.1; パッチの連続です。 - マージを承認するか、エディタを起動するか、 + &man.mergemaster.8; と同様 &man.diff.1; パッチの連続ですが、 + 選択肢は少なく、マージを承認するか、エディタを起動するか、 <command>freebsd-update</command> を中断するかどうかを選んでください。 もし、心配な点があれば、 <filename class="directory">/etc</filename> をバックアップしてからマージを承認してください。 - <command>mergemaster</command> コマンドの詳細な情報については、 + <command>mergemaster</command> の詳細な情報については、 <xref linkend="mergemaster"/> で確認してください。</para> <programlisting># Directory in which to store downloaded updates and temporary @@ -249,7 +249,7 @@ MergeChanges /etc/ /var/named/etc/</prog # which actually are installed and upgrade those (StrictComponents no)? # StrictComponents no</programlisting> - <para><literal>yes</literal> に設定すると、 + <para>このオプションを <literal>yes</literal> に設定すると、 <command>freebsd-update</command> は <literal>Components</literal> のリストが完全に正しいと判断し、 このリスト以外の変更点については取り扱いません。 @@ -261,30 +261,32 @@ MergeChanges /etc/ /var/named/etc/</prog <sect2 id="freebsdupdate-security-patches"> <title>セキュリティパッチ</title> - <para>セキュリティパッチはリモートマシンに保存されており、 - 以下のコマンドを実行すると、ダウンロードしてインストールします。</para> + <para>以下のコマンドを実行すると、&os; + のセキュリティパッチがダウンロードされ、インストールされます。</para> <screen>&prompt.root; <userinput>freebsd-update fetch</userinput> &prompt.root; <userinput>freebsd-update install</userinput></screen> - <para>カーネルにパッチが当たった場合には、システムを再起動する必要があります。 - すべてがうまく実行でき、システムにパッチが当たるようであれば、 - 毎晩の &man.cron.8; ジョブとして <command>freebsd-update</command> - を実行してもよいでしょう。 - このタスクを実行できるようにするには、 - 以下のエントリを <filename>/etc/crobntab</filename> に追加してください。</para> + <para>アップデートによってカーネルにパッチが当たった場合には、 + パッチが当たったカーネルで起動するように、 + システムを再起動する必要があります。 + もしくは、システムにパッチが当てられ、 + 毎晩の &man.cron.8; ジョブとして、<command>freebsd-update</command> + を実行するように、 + 以下のエントリを <filename>/etc/crobntab</filename> + に追加してください。</para> <programlisting>@daily root freebsd-update cron</programlisting> - <para>このエントリは、毎日一度 - <command>freebsd-update</command> ユーティリティを実行することを意味します。 - このように <option>cron</option> に記述すると、 + <para>このエントリは、毎日一度 <command>freebsd-update</command> + を実行することを意味します。 + <option>cron</option> と共に実行すると、 <command>freebsd-update</command> はアップデートが存在するときだけ確認します。 パッチが存在すると、 自動的にローカルディスクにダウンロードされますが、適用はされません。 - ダウンロードされたパッチを手動でインストールする必要があり、 - このことは <username>root</username> 宛てにメールで通知されます。</para> + ダウンロードされたパッチを確認し、手動でインストールする必要のあることが、 + <username>root</username> 宛てにメールで通知されます。</para> <para>うまく行かなかった場合には、<command>freebsd-update</command> を以下のように実行すると、最後の変更までロールバックできます。</para> @@ -298,15 +300,15 @@ MergeChanges /etc/ /var/named/etc/</prog <para><command>freebsd-update</command> ユーティリティが自動的にアップデートするカーネルは <filename>GENERIC</filename> のみです。 - カスタムカーネルを使っている場合には、<command>freebsd-update</command> - が他の部分をアップデートした後、 + カスタムカーネルがインストールされている場合には、 + <command>freebsd-update</command> が他の部分をインストールした後、 カーネルを再構築し、もう一度インストールする必要があります。 - <filename>GENERIC</filename> カーネルが <filename + しかしながら、<filename>GENERIC</filename> カーネルが <filename class="directory">/boot/GENERIC</filename> に存在する場合には、 - <command>freebsd-update</command> により - (現在のシステムで実行されているカーネルでなくとも) - アップデートされます。</para> + 現在のシステムで実行されているカーネルでなくとも、 + <command>freebsd-update</command> + によりアップデートされます。</para> <note> <para><filename>GENERIC</filename> カーネルを、常に <filename @@ -333,9 +335,10 @@ MergeChanges /etc/ /var/named/etc/</prog カスタムカーネルを再構築する必要はありません。 しかしながら <command>freebsd-update</command> は、 <filename>/usr/src/sys/conf/newvers.sh</filename> - ファイルを常にアップデートします。 - これは、現在のシステムのパッチレベル (<command>uname -r</command> が - <literal>-p</literal> で表示する番号) を示す際に参照されるファイルです。 + を常にアップデートします。 + これは、現在のシステムのパッチレベルを + <command>uname -r</command> が <literal>-p</literal> + で表示する時にこのファイルが参照されます。 そのため、何も変更されていない場合でも、カスタムカーネルを再構築することにより、 &man.uname.1; がシステムの正確なパッチレベルを報告するようになります。 各システムにインストールされているアップデートをすばやく把握できるようになるので、 @@ -360,12 +363,12 @@ MergeChanges /etc/ /var/named/etc/</prog これらに依存する多くのサードパーティ製アプリケーションに影響を与える可能性があります。 インストールされているすべての ports を削除して再インストールするか、 メジャーアップグレード後、 - <filename role="package">ports-mgmt/portupgrade</filename> - ユーティリティを使ってアップグレードすることが推奨されています。 + <filename role="package">ports-mgmt/portmaster</filename> + といったユーティリティを使ってアップグレードすることが推奨されています。 インストールされているアプリケーションのブルートフォース的な再構築は、 以下のコマンドにより行うことができます。</para> - <screen>&prompt.root; <userinput>portupgrade -af</userinput></screen> + <screen>&prompt.root; <userinput>portmaster -f</userinput></screen> <para>このコマンドは、すべての ports を適切に再インストールしようとします。 <makevar>BATCH</makevar> 環境変数を @@ -382,7 +385,7 @@ MergeChanges /etc/ /var/named/etc/</prog アップグレードの手順は &os; のバージョンによって変わります。</para> <sect4 id="freebsd-update-custom-kernel-8x"> - <title>&os; 8.X 以前のシステムにおけるカスタムカーネル</title> + <title>&os; 8.X におけるカスタムカーネル</title> <para><filename>GENERIC</filename> カーネルが <filename class="directory">/boot/GENERIC</filename> @@ -397,16 +400,16 @@ MergeChanges /etc/ /var/named/etc/</prog <filename class="directory">/boot/kernel.old</filename> は <filename>GENERIC</filename> カーネルそのものです。 - ただ単にこのディレクトリの名前を + このディレクトリの名前を <filename class="directory">/boot/GENERIC</filename> へと変更してください。</para> </listitem> <listitem> <para>コンピュータへの物理的なアクセスが可能であれば、 - CD-ROM メディアから <filename>GENERIC</filename> - カーネルをインストールできます。 - インストールディスクを挿入して、以下のコマンドを実行してください。</para> + 以下のコマンドを実行することで、 + インストールメディアから <filename>GENERIC</filename> + カーネルをインストールできます。</para> <screen>&prompt.root; <userinput>mount /cdrom</userinput> &prompt.root; <userinput>cd /cdrom/<replaceable>X.Y-RELEASE</replaceable>/kernels</userinput> @@ -458,9 +461,9 @@ MergeChanges /etc/ /var/named/etc/</prog <listitem> <para>コンピュータへの物理的なアクセスが可能であれば、 - CD-ROM メディアから <filename>GENERIC</filename> - カーネルをインストールできます。 - インストールディスクを挿入して、以下のコマンドを実行してください。</para> + 以下のコマンドで、インストールメディアから + <filename>GENERIC</filename> + カーネルをインストールできます。</para> <screen>&prompt.root; <userinput>mount /cdrom</userinput> &prompt.root; <userinput>cd /cdrom/usr/freebsd-dist</userinput> @@ -494,20 +497,19 @@ MergeChanges /etc/ /var/named/etc/</prog <para><command>freebsd-update</command> によるメジャー、またはマイナーバージョンのアップデートでは、 リリースバージョンをターゲットにして実行します。 - たとえば、&os; 8.1 - にアップデートするには以下のコマンドを実行してください。</para> + 以下のコマンドは、&os; 9.1 にアップデートします。</para> - <screen>&prompt.root; <userinput>freebsd-update -r 8.1-RELEASE upgrade</userinput></screen> + <screen>&prompt.root; <userinput>freebsd-update -r 9.1-RELEASE upgrade</userinput></screen> <para>コマンドを実行すると、<command>freebsd-update</command> は設定ファイルと現在のシステムを評価し、 - システムをアップデートするために必要な情報を収集します。 + アップデートするために必要な情報を収集します。 画面には、どのコンポーネントが認識され、 - どのコンポーネントが認識されていないかといったリストが表示されます。 + どのコンポーネントが認識されていないといったリストが表示されます。 たとえば以下のように表示されます。</para> <screen>Looking up update.FreeBSD.org mirrors... 1 mirrors found. -Fetching metadata signature for 8.0-RELEASE from update1.FreeBSD.org... done. +Fetching metadata signature for 9.0-RELEASE from update1.FreeBSD.org... done. Fetching metadata index... done. Inspecting system... done. @@ -531,7 +533,7 @@ Does this look reasonable (y/n)? y</scre 上記のステップで以下のような警告が表示されます。</para> <screen>WARNING: This system is running a "<replaceable>MYKERNEL</replaceable>" kernel, which is not a -kernel configuration distributed as part of FreeBSD 8.0-RELEASE. +kernel configuration distributed as part of FreeBSD 9.0-RELEASE. This kernel will not be updated: you MUST update the kernel manually before running "/usr/sbin/freebsd-update install"</screen> @@ -541,11 +543,12 @@ before running "/usr/sbin/freebsd-update <para>すべてのパッチがローカルシステムへダウンロードされたら、 次にパッチが適用されます。 - このプロセスにかかる時間はコンピュータの性能とワークロードに依存します。 + このプロセスには時間がかかります。 + この時間はコンピュータの性能とワークロードに依存します。 その後、設定ファイルがマージされます。 - このプロセスでは、ファイルをマージするか、 + このプロセスでは、ユーザはファイルをマージするか、 画面上にエディタを立ち上げて手動でマージするかを尋ねられます。 - プロセスごとに、マージに成功した情報がユーザに示されます。 + プロセスが進むごとに、成功したマージのすべての結果の情報がユーザに示されます。 マージに失敗したり、無視した場合には、プロセスが中断します。 ユーザによっては <filename class="directory">/etc</filename> のバックアップを取り、 @@ -556,51 +559,48 @@ before running "/usr/sbin/freebsd-update <para>すべてのパッチは別のディレクトリでマージされており、 まだ、システムには反映されていません。 すべてのパッチが正しく適用され、 - すべての設定ファイルがマージされてプロセスがスムーズに進んでいる時には、 - ユーザによる変更点のコミットは必要ありません。</para> - </note> - - <para>このプロセスが終わったら、 - 以下のコマンドを用いて、アップグレードをディスクに反映してください。</para> + すべての設定ファイルがマージされてプロセスがスムーズに進んだら、 + ユーザは以下のコマンドを用いて、 + 変更点をディスクに反映してください。</para> <screen>&prompt.root; <userinput>freebsd-update install</userinput></screen> + </note> + <para>パッチは最初にカーネルとカーネルモジュールに対して当てられます。 ここでコンピュータを再起動する必要があります。 システムがカスタムカーネルを実行している場合には、 - &man.nextboot.8; コマンドを使って次回の再起動時のカーネルを - (アップデートされた) <filename - class="directory">/boot/GENERIC</filename> に変更してください。</para> + &man.nextboot.8; を使って次回の再起動時のカーネルを、 + アップデートされた <filename + class="directory">/boot/GENERIC</filename> + に設定してください。</para> <screen>&prompt.root; <userinput>nextboot -k GENERIC</userinput></screen> <warning> <para><filename>GENERIC</filename> カーネルで再起動する前に、 - システムが適切に起動するために必要な - (もしコンピュータにリモートでアクセスしてアップデートしていたのであれば、 - ネットワーク接続に必要な) - すべてのドライバが含まれていることを確認してください。 - 特に、これまでに実行していたカスタムカーネルが - (通常はカーネルモジュールとして提供されている) - ビルド済みの機能を含んでいるのであれば、 + カーネルにシステムが適切に起動するために必要なすべてのドライバが含まれていること、 + もしアップデートしているコンピュータがリモートでアクセスしているのであれば、 + ネットワーク接続に必要なすべてのドライバも含まれていることを確認してください。 + 特に、これまで実行しているカスタムカーネルが、 + カーネルモジュールとして提供されているビルドインの機能を含んでいるのであれば、 これらのモジュールを一時的に <filename>/boot/loader.conf</filename> の機能を用いて、 - <filename>GENERIC</filename> へと読み込んでください。 + <filename>GENERIC</filename> に読み込んでください。 アップグレードプロセスが終わるまでは、 - 重要ではないサービスを無効にし、 - ディスクやネットワークのマウントなどは避けてください。</para> + 重要ではないサービスを無効にするとともに、 + 必要のないディスクやネットワークのマウントなども避けることが推奨されています。</para> </warning> <para>アップデートされたカーネルでコンピュータを再起動してください。</para> <screen>&prompt.root; <userinput>shutdown -r now</userinput></screen> - <para>システムがオンラインに戻ったら、 - <command>freebsd-update</command> を再び実行する必要があります。 + <para>システムがオンラインに戻ったら、以下のコマンドを使って + <command>freebsd-update</command> を再び実行してください。 アップデートプロセスの状態は保存されているので、 <command>freebsd-update</command> を実行すると、最初からではなく、 - 古い共有ライブラリとオブジェクトファイルを削除するプロセスから始まります。 - このステージを続行するには、以下のコマンドを実行してください。</para> + 古い共有ライブラリとオブジェクトファイルを削除するプロセスから始まります。</para> <screen>&prompt.root; <userinput>freebsd-update install</userinput></screen> @@ -619,19 +619,15 @@ before running "/usr/sbin/freebsd-update この作業が必要なのは、インストールされているソフトウェアが、 アップグレードの際に削除されたライブラリに依存している可能性があるためです。 <filename role="package">ports-mgmt/portupgrade</filename> - コマンドは、このプロセスを自動化します。 - 以下のコマンドで、このプロセスを開始します。</para> + は、このプロセスを自動化します。</para> - <screen>&prompt.root; <userinput>portupgrade -f ruby</userinput> -&prompt.root; <userinput>rm /var/db/pkg/pkgdb.db</userinput> -&prompt.root; <userinput>portupgrade -f ruby18-bdb</userinput> -&prompt.root; <userinput>rm /var/db/pkg/pkgdb.db /usr/ports/INDEX-*.db</userinput> -&prompt.root; <userinput>portupgrade -af</userinput></screen> + <screen>&prompt.root; <userinput>portmaster -f</userinput></screen> <para>この作業の終了後、最後にもう一度 <command>freebsd-update</command> - を実行すると、アップグレードのプロセスが完了します。 - 以下のコマンドですべてのアップグレードプロセスのやり残し作業が行われます。</para> + を実行して、 + すべてのアップグレードプロセスのやり残し作業を行い、 + アップグレードのプロセスを完了してください。</para> <screen>&prompt.root; <userinput>freebsd-update install</userinput></screen> @@ -647,7 +643,7 @@ before running "/usr/sbin/freebsd-update <sect2 id="freebsdupdate-system-comparison"> <title>システムの状態の比較</title> - <para><command>freebsd-update</command> ユーティリティを用いて、 + <para><command>freebsd-update</command> を用いて、 インストールされている &os; の状態と、 正しく動作することが分かっている状態とを比較できます。 このオプションは、システムのユーティリティ、ライブラリ、 @@ -659,10 +655,10 @@ before running "/usr/sbin/freebsd-update <warning> <para>コマンドライン名は <acronym>IDS</acronym> ですが、 <filename role="package">security/snort</filename> - のような侵入検知システムの置き換えになるものではありません。 + のような侵入検知システムの本当の置き換えになるものではありません。 <command>freebsd-update</command> はデータをディスクに保存するので、 不正な変更が行われる可能性があります。 - <varname>kern.securelevel</varname> の設定と、 + <varname>kern.securelevel</varname> と、 <command>freebsd-update</command> のデータを使用しないときに、 読み取りのみの許可属性に設定されているファイルシステムに置くことで、 不正な変更の可能性を低くできますが、 @@ -674,10 +670,8 @@ before running "/usr/sbin/freebsd-update <para>このコマンドを実行すると、システムは検査され、 リリースファイルの &man.sha256.1; - ハッシュ値と現在インストールされているファイルのハッシュ値がファイルの一覧と共に表示されます。 - これが <filename>outfile.ids</filename> ファイルに出力する理由です。 - 目で比較するにはとても早くスクロールし、 - コンソールバッファをいっぱいに満たしてしまいます。</para> + ハッシュ値と現在インストールされているファイルのハッシュ値がファイルの一覧と共に、指定した + <filename>outfile.ids</filename> ファイルに送られます。</para> <para>これらの行は極めて長いのですが、出力形式は簡単にすぐに解析できます。 たとえば、これらのリリースで異なっているすべてのファイルを知りたいのであれば、 @@ -694,9 +688,9 @@ before running "/usr/sbin/freebsd-update これらのファイルには、運用中に変更されるファイルがあります。 たとえば、<filename>/etc/passwd</filename> はユーザがシステムに追加されると変更されます。 - また、カーネルモジュールのようなファイルがあります。 - これらは <command>freebsd-update</command> - によりアップデートされます。 + また、カーネルモジュールのようなファイルは、 + <command>freebsd-update</command> + によりアップデートされるため、変更されます。 このような特別なファイルやディレクトリを除外するには、 それらを <filename>/etc/freebsd-update.conf</filename> の <literal>IDSIgnorePaths</literal> オプションに追加してください。</para> @@ -731,12 +725,12 @@ before running "/usr/sbin/freebsd-update <see>アップデートとアップグレード</see> </indexterm> - <para>&os; のベースシステムには、&man.portsnap.8; と呼ばれる - Ports Collection のアップデートユーティリティがあります。 - 実行すると、リモートサイトに接続し、セキュリティキーを検証し、 - Ports Collection をダウンロードします。 + <para>&os; のベースシステムには、 + Ports Collection をアップデートする &man.portsnap.8; があります。 + このユーティリティは、&os; のサイトに接続し、セキュリティキーを検証し、 + Ports Collection の最新版をダウンロードします。 セキュリティキーは、 - ダウンロードしたすべてのファイルがダウンロード中に変更されていないことの検証に用いられます。 + ダウンロードしたすべてのファイルの検証に用いられます。 最新の Ports Collection ファイルをダウンロードするには、 以下のコマンドを実行してください。</para> @@ -779,8 +773,8 @@ Fetching 133 new ports or files... done. <replaceable>...</replaceable></screen> <para>すでにインストールされている Ports Collection - をアップデートするには、以下のように - <command>portsnap update</command> コマンドを使ってください。</para> + をアップデートするには、 + <command>portsnap update</command> を使ってください。</para> <screen>&prompt.root; <userinput>portsnap update</userinput></screen> @@ -789,9 +783,9 @@ Fetching 133 new ports or files... done. アプリケーションをインストールしたり、 アップグレードできます。</para> - <para><literal>fetch</literal> と <literal>extract</literal> または - <literal>update</literal> のプロセスを連続して行うには、 - 以下の例のように実行してください。</para> + <para><literal>fetch</literal> を使う場合には、 + <literal>extract</literal> および <literal>update</literal> + を連続して行うことができます。</para> <screen>&prompt.root; <userinput>portsnap fetch update</userinput></screen> @@ -811,22 +805,20 @@ Fetching 133 new ports or files... done. <see>Updating and Upgrading</see> </indexterm> - <para>ベースシステム、Ports Collection に加え、 - ドキュメントも &os; オペレーティングシステムの構成要素です。 + <para>ドキュメントは、&os; オペレーティングシステムの必須要素です。 &os; ドキュメントセットの最新バージョンは、<ulink url="http://www.freebsd.org/doc/">&os; ウェブサイト</ulink> から入手できますが、 ネットワーク接続が遅い、もしくはまったく接続できないユーザもいます。 - 幸運にも、各リリースで提供されるドキュメントをアップデートして、 - 最新の &os; - ドキュメントセットをローカルで維持する方法が用意されています。</para> + ローカルのドキュメントを最新の &os; + ドキュメントセットにアップデートする方法がいくつも用意されています。</para> <sect2 id="dsvn-doc"> <title><application>Subversion</application> を用いたドキュメントのアップデート方法</title> <para>&os; のドキュメントのソースは、 - <application>Subversion</application> を用いて入手できます。 + <application>svn</application> を用いて入手できます。 この節では以下について説明します。</para> <itemizedlist> @@ -837,7 +829,7 @@ Fetching 133 new ports or files... done. </listitem> <listitem> - <para><application>Subversion</application> を用いて、 + <para><application>svn</application> を用いて、 ドキュメントのソースを <filename class="directory">/usr/doc</filename> 以下にダウンロードする方法。</para> @@ -858,22 +850,21 @@ Fetching 133 new ports or files... done. </sect2> <sect2 id="installing-documentation-toolchain"> - <title><application>Subversion</application> + <title><application>svn</application> およびドキュメントツールチェインのインストール</title> <para>&os; のドキュメントをソースから再構築するには、 - かなり大きなツールのコレクションが必要です。 - これらのツールは多くのディスク容量を必要とし、また、 - すべての &os; ユーザにとって有用というわけではないので、 + ツールのコレクションが必要です。 + これらのツールは多くのディスク容量を使用するため、 &os; ベースシステムの一部ではありません。 - これらのツールは、&os; + また、すべての &os; ユーザにとって有用というわけではなく、&os; のために新しいドキュメントを活発に執筆している方や、 頻繁にドキュメントをソースからアップデートする方に向けたものです。</para> - <para>必要なツールは、すべて Ports Collection で入手できます。<filename - role="package">textproc/docproj</filename> は、 - &os; ドキュメンテーションプロジェクトにより開発されているマスター port で、 - これらのツールのインストールやアップデートを容易にします。</para> + <para><application>svn</application> を含め必要なツールは、 + <filename role="package">textproc/docproj</filename> メタ port + からインストールできます。この port は、 + &os; ドキュメンテーションプロジェクトにより開発されています。</para> <note> <para>ドキュメントの &postscript; や PDF 版が必要なければ、かわりに @@ -887,20 +878,14 @@ Fetching 133 new ports or files... done. そのため、もし PDF 出力を本当に必要としなければ、 このツールをインストールしないことはとても賢明です。</para> </note> - - <para><filename role="package">textproc/docproj</filename> - をインストールすると、<application>Subversion</application> - もインストールされます。</para> </sect2> <sect2 id="updating-documentation-sources"> <title>ドキュメントのソースをアップデートする</title> - <para>ドキュメントのソースは、 - <application>Subversion</application> - プログラムを使ってダウンロードできます。 - western US ミラーから HTTPS - プロトコルを用いてダウンロードするには以下のように入力してください。</para> + <para>以下の例では、<application>svn</application> を使って + western US ミラーから HTTPS プロトコルを用いて、 + ドキュメントのソースをダウンロードします。</para> <screen>&prompt.root; <userinput>svn checkout <replaceable>https://svn0.us-west.FreeBSD.org</replaceable>/doc/head /usr/doc</userinput></screen> @@ -916,9 +901,8 @@ Fetching 133 new ports or files... done. <screen>&prompt.root; <userinput>svn update <filename class="directory">/usr/doc</filename></userinput></screen> - <para>ソースを入手したら、<filename - class="directory">/usr/doc</filename> ディレクトリの - <filename>Makefile</filename> を使い、 + <para>ソースを入手したら、 + <filename>/usr/doc/Makefile</filename> を使い、 以下のようにドキュメントをアップデートすることもできます。</para> <screen>&prompt.root; <userinput>cd /usr/doc</userinput> @@ -928,14 +912,14 @@ Fetching 133 new ports or files... done. <sect2 id="updating-documentation-options"> <title>ドキュメントのソースの調整可能なオプション</title> - <para>&os; のドキュメントのアップデートとビルドシステムは、 + <para>&os; のドキュメントセットのアップデートとビルドシステムは、 ドキュメンテーションの一部のアップデートを簡単にするオプションや、 特定の翻訳のビルドに対応しています。 これらのオプションは、システム全般のオプションである - <filename>/etc/make.conf</filename> ファイルや、&man.make.1; - ユーティリティに与えるコマンドラインオプションで設定できます。</para> + <filename>/etc/make.conf</filename> や、&man.make.1; + に与えるコマンドラインオプションで設定できます。</para> - <para>以下がこれらのオプションの一部です。</para> + <para>オプションには以下のようなものがあります。</para> <variablelist> <varlistentry> @@ -943,7 +927,7 @@ Fetching 133 new ports or files... done. <listitem> <para>ビルドおよびインストールの言語およびエンコーディングの一覧。 - たとえば、英語のドキュメントのみを指定するには + たとえば、英語のドキュメントを指定するには <literal>en_US.ISO8859-1</literal> を設定します。</para> </listitem> </varlistentry> @@ -971,11 +955,12 @@ Fetching 133 new ports or files... done. </varlistentry> </variablelist> - <para>&os; のシステム全般のオプションに関連するもっと多くの make 変数については、 + <para>&os; のシステム全般のオプションに関連するもっと多くの + <command>make</command> 変数については、 &man.make.conf.5; をご覧ください。</para> - <para>&os; ドキュメントのビルドシステムで対応しているさらなる make の変数に関しては、 - + <para>&os; ドキュメントのビルドシステムで対応しているさらなる + <command>make</command> の変数に関しては、 <ulink url="&url.doc.langbase.en;/books/fdp-primer">新しい貢献者のための &os; ドキュメンテーションプロジェクト入門 </ulink> を参照してください。</para> </sect2> @@ -983,11 +968,11 @@ Fetching 133 new ports or files... done. <title>ソースから &os; ドキュメントをインストールする</title> <para>ドキュメントのソースの最新スナップショットを - <filename class="directory">/usr/doc</filename> にダウンロードし終わったら、 + <filename class="directory">/usr/doc</filename> にダウンロードしたら、 インストールされているドキュメントをアップデートする準備がすべて整いました。</para> - <para>makefile の <makevar>DOC_LANG</makevar> - オプションで定義されているすべての言語を完全にアップデートするには、 + <para><makevar>DOC_LANG</makevar> + で定義されているすべての言語を完全にアップデートするには、 以下のように入力してください。</para> <screen>&prompt.root; <userinput>cd /usr/doc</userinput> @@ -1000,7 +985,7 @@ Fetching 133 new ports or files... done. <screen>&prompt.root; <userinput>cd /usr/doc/en_US.ISO8859-1</userinput> &prompt.root; <userinput>make update install clean</userinput></screen> - <para>make の <makevar>FORMATS</makevar> 変数を設定して、 + <para><makevar>FORMATS</makevar> を設定して、 以下のようにインストールする出力形式を指定できます。</para> <screen>&prompt.root; <userinput>cd /usr/doc</userinput> @@ -1008,7 +993,7 @@ Fetching 133 new ports or files... done. <para>ドキュメントを編集したり、訂正したものを提出する方法については、 <ulink - url="&url.books.fdp-primer;">新しい貢献者のための FreeBSD + url="&url.books.fdp-primer;">新しい貢献者のための &os; ドキュメンテーションプロジェクト入門</ulink> をご覧ください。</para> </sect2> @@ -1034,31 +1019,32 @@ Fetching 133 new ports or files... done. <para>これまでのセクションでは、ソースコードを用いた &os; ドキュメントのアップデート方法について説明してきました。 - しかしながら、すべてのシステムにおいて、 + すべての &os; システムで、 ソースからドキュメントをアップデートすることは難しいかも知れませんし、 できたとしても現実的ではないこともあります。 ドキュメントをソースから構築するには、 かなり大きなツールとユーティリティから構成される - <emphasis>ドキュメンテーションツールチェイン</emphasis> が必要です。 - また、<application>Subversion</application> + <emphasis>ドキュメンテーションツールチェイン</emphasis> + が必要なためです。 + また、<application>svn</application> リポジトリからソースをチェックアウトし、 チェックアウトしたソースからドキュメントを手動で構築する方法について、 それなりに熟知している必要もあります。 この節では、インストールされている &os; のドキュメントをアップデートするもう一つの方法である、 - Ports Collection を用いた以下の方法について説明します。</para> + Ports Collection を用いた方法について説明し、 + 以下について説明します。</para> <itemizedlist> <listitem> <para>構築済のドキュメントのスナップショットをダウンロードしてインストールする方法。 - ローカルでの構築作業は必要ありません - (ドキュメンテーションツールチェインをインストールする必要はありません)。</para> + ローカルでの構築作業やドキュメンテーションツールチェインをインストールする必要はありません。</para> </listitem> <listitem> <para>ドキュメントのソースをダウンロードし、ports - フレームワークを使って構築する方法 - (チェックアウトおよび構築作業が簡単になります)。</para> + フレームワークを使って構築する方法です。 + チェックアウトおよび構築作業が簡単になります。</para> </listitem> </itemizedlist> @@ -1068,7 +1054,7 @@ Fetching 133 new ports or files... done. によりサポートされています。 これらの ports は、&os; Ports Collection の <ulink url="http://www.freshports.org/docs/">docs</ulink>; - 仮想カテゴリにまとめられています。</para> + カテゴリにまとめられています。</para> <sect3 id="doc-ports-install-make"> <title>ドキュメンテーション ports の構築とインストール</title> @@ -1095,9 +1081,7 @@ Fetching 133 new ports or files... done. <listitem> <para><quote>マスタ port</quote>, <filename role="package">misc/freebsd-doc-en</filename>。 - ドキュメンテーション port のファイルはここにあります。 - この port は、すべてのドキュメンテーション ports のベースです。 - デフォルトでは、英語の文書のみを構築します。</para> + すべての英語文書の ports をインストールします。</para> </listitem> <listitem> @@ -1107,35 +1091,30 @@ Fetching 133 new ports or files... done. </listitem> <listitem> - <para>最後に、各言語のために <quote>スレーブ port</quote> + <para>各言語のために <quote>スレーブ port</quote> が用意されています。たとえば、<filename role="package">misc/freebsd-doc-hu</filename> - はハンガリー語のドキュメンテーション port です。 - この port は、すべてマスタ port に依存し、 - 各言語の翻訳されたドキュメントをインストールします。</para> + はハンガリー語のドキュメンテーション port です。</para> </listitem> </itemizedlist> - <para>ソースからドキュメンテーション port をインストールするには、 - 以下のコマンドを (<username>root</username> 権限で) - 実行してください。</para> + <para>たとえば、<ulink + url="http://www.FreeBSD.org"></ulink>; と同じ形式である、 + 英語版の分割された <acronym>HTML</acronym> 形式を構築し、 + <filename + class="directory">/usr/local/share/doc/freebsd</filename> + にインストールするには以下の port をインストールしてください。</para> <screen>&prompt.root; <userinput>cd /usr/ports/misc/freebsd-doc-en</userinput> &prompt.root; <userinput>make install clean</userinput></screen> - <para>英語版の分割された <acronym>HTML</acronym> 形式 (<ulink - url="http://www.FreeBSD.org"></ulink>; と同じ形式) - のドキュメントが構築され、<filename - class="directory">/usr/local/share/doc/freebsd</filename> - ディレクトリにインストールされます。</para> - <sect4 id="doc-ports-options"> <title>共通のオプション</title> <para>ドキュメンテーション ports にはたくさんのオプションが用意されており、 - ports の振る舞いをデフォルトの設定から変更できます。 - 以下はその中からいくつかをリストアップしたものです。</para> + 以下のように + ports の振る舞いをデフォルトの設定から変更できます。</para> <variablelist> <varlistentry> @@ -1143,11 +1122,11 @@ Fetching 133 new ports or files... done. <listitem> <para>HTML 形式を構築します。 - それぞれのドキュメントごとに単一版の HTML ファイルが構築されます。 + 各ドキュメントに対し、単一版の HTML ファイルが構築されます。 整形されたドキュメントは、 <filename>article.html</filename> や <filename>book.html</filename> といった名前で、 - 画像とともにインストールされます。</para> + 必要に応じて画像とともにインストールされます。</para> </listitem> </varlistentry> @@ -1155,11 +1134,7 @@ Fetching 133 new ports or files... done. <term><makevar>WITH_PDF</makevar></term> <listitem> - <para>&adobe; Portable Document Format を構築します。 - &adobe; &acrobat.reader;, - <application>Ghostscript</application>、 - または、他の PDF - リーダで読むためのものです。 + <para>&adobe; Portable Document Format (PDF) を構築します。 整形されたドキュメントは、 <filename>article.pdf</filename> や <filename>book.pdf</filename> @@ -1178,10 +1153,8 @@ Fetching 133 new ports or files... done. <note> <para>デフォルトのターゲットディレクトリは、 - <application>Subversion</application> + <application>svn</application> を用いる方法とは異なります。 - なぜならば、この節で説明をしている方法では - port を用いてインストールしており、 ports は通常 <filename class="directory">/usr/local</filename> ディレクトリ以下にインストールされるためです。 @@ -1193,7 +1166,7 @@ Fetching 133 new ports or files... done. </variablelist> <para>以下は、上記の変数を用いてハンガリー語のドキュメントを - PDF 形式でインストールする方法を示す、簡単な例です。</para> + PDF 形式でインストールする方法です。</para> <screen>&prompt.root; cd /usr/ports/misc/freebsd-doc-hu &prompt.root; make -DWITH_PDF DOCBASE=share/doc/freebsd/hu install clean</screen> @@ -1231,7 +1204,7 @@ Fetching 133 new ports or files... done. <screen>&prompt.root; <userinput>pkg_add -r hu-freebsd-doc</userinput></screen> <note> - <para>ドキュメントの package は、言語ごとに対応する port に + <para>ドキュメントの package は、対応する port 名とは異なり、 <literal><replaceable>lang</replaceable>-freebsd-doc</literal> の形式で名前がつけられています。 ここで、<replaceable>lang</replaceable> は言語コードの短縮形です。 @@ -1243,15 +1216,13 @@ Fetching 133 new ports or files... done. <sect3 id="doc-ports-update"> <title>ドキュメンテーション ports のアップデート</title> - <para>インストール済みのドキュメンテーション port - をアップデートするには、 - ports のアップデートツールが用意されていれば十分です。 + <para>他の port と同様に、ドキュメンテーション port + をアップデートできます。 たとえば、以下のコマンドを実行すると、<filename role="package">ports-mgmt/portupgrade</filename> - ツールで、package - だけを使ってハンガリー語のドキュメントをアップデートします。</para> + から、package だけを使ってインストールされているハンガリー語のドキュメントをアップデートします。</para> - <screen>&prompt.root; <userinput>portupgrade -PP hu-freebsd-doc</userinput></screen> + <screen>&prompt.root; <userinput>portmaster -PP hu-freebsd-doc</userinput></screen> </sect3> </sect2> @@ -1288,16 +1259,17 @@ Fetching 133 new ports or files... done. <para>The only requirement for using this technique is the <filename role="package">net/rsync</filename> port or - package. To add it, use the following command:</para> + package. To install the package, use the following + command:</para> <screen>&prompt.root; <userinput>pkg_add -r rsync</userinput></screen> <note> - <para><application>Docsnap</application> has been originally + <para><application>Docsnap</application> was originally developed for updating documentation installed - to <filename class="directory">/usr/share/doc</filename>, but - the following examples could be adapted for other directories - as well. For user directories, it does not require + <filename class="directory">/usr/share/doc</filename>, but + the following examples could be adapted for other + directories. Updating to user directories does not require <username>root</username> privileges.</para> </note> @@ -1308,17 +1280,15 @@ Fetching 133 new ports or files... done. <note> <para>There is only one <application>Docsnap</application> - server at the moment; - the <hostid>docsnap.sk.FreeBSD.org</hostid> shown - above.</para> + server at the moment; the + <hostid>docsnap.sk.FreeBSD.org</hostid> shown above.</para> </note> - <para>Do not use the <option>--delete</option> flag here as there - are some items installed - into <filename class="directory">/usr/share/doc</filename> - during <command>make installworld</command>, which would - accidentally be removed. To clean up, use this command - instead:</para> + <para>Do not use <option>--delete</option> as there are some + items installed into <filename + class="directory">/usr/share/doc</filename> during + <command>make installworld</command> which would accidentally + be removed. To clean up, use this command instead:</para> <screen>&prompt.root; <userinput>rsync -rltvz --delete <replaceable>docsnap.sk.FreeBSD.org</replaceable>::docsnap/??_??\.\* <replaceable>/usr/share/doc</replaceable></userinput></screen> @@ -1336,11 +1306,10 @@ Fetching 133 new ports or files... done. <indexterm><primary>-CURRENT</primary></indexterm> <indexterm><primary>-STABLE</primary></indexterm> - <para>FreeBSD には二つの開発ブランチがあります。 + <para>&os; には二つの開発ブランチがあります。 それは &os.current; と &os.stable; です。 - この章ではそれぞれについて簡単に説明し、 - どのようにしてあなたのシステムを対応するツリーに対して、 - どうやって常に最新の状態に保つかについて扱います。 + この章ではそれぞれについて説明し、 + どのようにしてシステムの対応するツリーを最新の状態に保つかについて説明します。 まずは &os.current;、次に &os.stable; について説明します。</para> <para><emphasis>訳: &a.hanai;、1996 年 11 月 6 日</emphasis></para> @@ -1348,9 +1317,7 @@ Fetching 133 new ports or files... done. <sect2 id="current"> <title>最新の &os; を追いかける</title> - <para>これを読む前に、 - 心にとめておいて欲しいことがあります。 - &os.current; とは &os; の開発の <quote>最前線</quote> だということです。 + <para>&os.current; とは &os; の開発の <quote>最前線</quote> です。 &os.current; のユーザは高い技術力を持つことが要求され、 自分のシステムが抱える困難な問題を自力で解決できなければなりません。 もし &os; を使い始めたばかりなら、 @@ -1363,21 +1330,20 @@ Fetching 133 new ports or files... done. 中には現在開発途上のソフトウェア、 実験的な変更、あるいは過渡的な機能などが含まれています。 また、この中に入っている機能がすべて、 - 次の公式リリースに入るとは限りません。 - &os.current; をソースからほぼ毎日コンパイルしている人は - たくさんいますが、 + 次の公式リリースに入るとは限りません。&os.current; + をソースからほぼ毎日コンパイルしている人はたくさんいますが、 *** DIFF OUTPUT TRUNCATED AT 1000 LINES ***
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201304060237.r362bTjO069480>