- Merge the following from the English version:

r39474 -> r39642	head/ja_JP.eucJP/books/handbook/ports/chapter.sgml
This commit is contained in:
Ryusuke SUZUKI 2012-10-03 11:09:34 +00:00
parent bc59d4da99
commit 3b21260b06
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=39648

View file

@ -3,7 +3,7 @@
The FreeBSD Documentation Project
The FreeBSD Japanese Documentation Project
Original revision: r39474
Original revision: r39642
$FreeBSD$
-->
@ -626,24 +626,135 @@ docbook =
利用可能な <command>make</command> のターゲットや環境変数についての詳細は
&man.ports.7; をご覧ください。</para>
<warning>
<para>2012 年後期の現時点において、FreeBSD Ports プロジェクトは、
CVS から Subversion へとバージョン管理システムの移行期にあります。
そのため、以下で説明する手順も今後変化する可能性があります。
一般的な ports の利用において推奨される方法は
<application>Portsnap</application> です。
ローカルで ports をカスタマイズしたい
(すなわち、ローカルで追加のパッチをメンテナンスしたい)
と考えているユーザは、直接 Subversion を使うとよいでしょう。
<application>CVSup</application> のサービスは、
2013 年 2 月 28 日までに段階的に廃止されるので、
今後 CVSup の利用を進めることは、推奨されません。</para>
</warning>
<sect2 id="ports-tree">
<title>Ports Collection の準備</title>
<para>ports をインストールするためには、まず Ports Collection
を用意しなくてはなりません。
Ports Collection とは、<filename>/usr/ports</filename>
<para>Ports Collection とは、<filename>/usr/ports</filename>
以下に置かれる <filename>Makefile</filename>, 修正パッチ、
説明文などの一連のファイルのことです。</para>
説明文などの一連のファイルのことです。このファイルのセットは、
アプリケーションを構築して &os; にインストールするのに用いられます。
以下では、&os; のセットアップ時に Ports Collection をインストールしなかった場合に、
Ports Collection を準備する方法について示します。</para>
<para>FreeBSD のシステムインストール時に、
<application>sysinstall</application>
が Ports Collection をインストールするかどうかを尋ねてきたはずです。
No を選んだ場合、以下の作業をおこない
Ports Collection をインストールしてください。</para>
<procedure>
<title>Portsnap を利用する方法</title>
<para><application>Portsnap</application> は Ports Collection
を取得するための速くて使いやすく、
多くのユーザに推奨されるツールです。
<application>Portsnap</application> の機能についての詳細は
<link linkend="updating-upgrading-portsnap">Portsnap を使う</link>
の節を参照してください。</para>
<step>
<para>圧縮された Ports Collection のスナップショットを
<filename class="directory">/var/db/portsnap</filename>
にダウンロードしてください。</para>
<screen>&prompt.root; <userinput>portsnap fetch</userinput></screen>
</step>
<step>
<para>初めて <application>Portsnap</application> を使う時は、
スナップショットをまず <filename
class="directory">/usr/ports</filename> に展開してください。</para>
<screen>&prompt.root; <userinput>portsnap extract</userinput></screen>
<para>上で示した <application>Portsnap</application>
を初めて利用する際に行うコマンドを実行した後は、
以下のコマンドで
<filename class="directory">/usr/ports</filename>
をアップデートできます。</para>
<screen>&prompt.root; <userinput>portsnap update</userinput></screen>
</step>
</procedure>
<procedure>
<title>Subversion を用いる方法</title>
<para>たとえば、ローカルで変更点をメンテナンスする状況のように、
ports ツリーの管理が必要な場合には、
<application>Subversion</application> を使って
Ports Collection を取得する方法があります。
<application>Subversion</application> のより詳細な説明については、
<ulink
url="&url.articles.committers-guide;/subversion-primer.html">
Subversion Primer</ulink> を参照してください。</para>
<step>
<para><application>Subversion</application>
を使って ports ツリーをチェックアウトする前に、
<application>Subversion</application>
をインストールしておく必要があります。
ports ツリーがすでにインストールされていれば、
以下のようにして <application>Subversion</application>
をインストールできます。</para>
<screen>&prompt.root; <userinput>cd /usr/ports/devel/subversion</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
<para>ports ツリーがなければ、package から
<application>Subversion</application> をインストールできます。</para>
<screen>&prompt.root; <userinput>pkg_add -r subversion</userinput></screen>
<para>package の管理に <application>pkgng</application>
を使っているのであれば、代わりに以下のようにして
<application>Subversion</application> をインストールできます。</para>
<screen>&prompt.root; <userinput>pkg install subversion</userinput></screen>
</step>
<step>
<para>ports ツリーをチェックアウトしてください。
パフォーマンスを良くするため、以下のコマンドにおいて、
<replaceable>svn.FreeBSD.org</replaceable><ulink
url="&url.books.handbook;/mirrors-svn.html">Subversion
ミラー</ulink>
の中から地理的に近い場所にあるミラーに置き換えてください。
コミッタの方々は、最初に <ulink
url="&url.articles.committers-guide;/subversion-primer.html">Subversion
Primer</ulink> を読んで、適切なプロトコルを選択してください。</para>
<screen>&prompt.root; <userinput>svn checkout svn://<replaceable>svn.FreeBSD.org</replaceable>/ports/head /usr/ports</userinput></screen>
</step>
<step>
<para><application>Subversion</application>
でチェックアウトした後、
<filename class="directory">/usr/ports</filename>
をアップデートするには、以下を実行してください。</para>
<screen>&prompt.root; <userinput>svn update /usr/ports</userinput></screen>
</step>
</procedure>
<procedure>
<title>CVSup を利用する方法</title>
<warning>
<para>CVSup を用いて Ports Collection を取得したり同期する方法は、
Subversion への移行のため廃止に向かっています。
現在もサポートされていますが、
2013 年 2 月 28 日にサービスを停止する予定です。</para>
</warning>
<para>ここでは、<application>CVSup</application> プロトコルを利用して
Ports Collection をインストールする方法や最新の状態に保つ方法を簡単に説明します。
<application>CVSup</application> についてもっと知りたいのであれば、
@ -719,43 +830,6 @@ docbook =
</step>
</procedure>
<procedure>
<title>Portsnap を利用する方法</title>
<para><application>Portsnap</application> は Ports Collection
を配布するための新しいシステムです。
<application>Portsnap</application> の機能についての詳細は
<link linkend="updating-upgrading-portsnap">Portsnap を使う</link>
を参照してください。</para>
<step>
<para>圧縮された Ports Collection のスナップショットを
<filename class="directory">/var/db/portsnap</filename>
にダウンロードしてください。
この作業が終われば、ネットワークへの接続を終了してもかまいません。</para>
<screen>&prompt.root; <userinput>portsnap fetch</userinput></screen>
</step>
<step>
<para>初めて <application>Portsnap</application> を使う時は、
スナップショットをまず <filename
class="directory">/usr/ports</filename> に展開してください。
</para>
<screen>&prompt.root; <userinput>portsnap extract</userinput></screen>
<para>すでに <filename
class="directory">/usr/ports</filename> が用意されていて、
アップデートだけを行ないたいのであれば、
代わりに以下のコマンドを実行してください。
</para>
<screen>&prompt.root; <userinput>portsnap update</userinput></screen>
</step>
</procedure>
<procedure>
<title>sysinstall を利用する方法</title>
@ -1321,50 +1395,6 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>
詳細は &man.portupgrade.1; を参照してください。</para>
</sect3>
<sect3 id="portmanager">
<title>Portmanager を用いた ports のアップグレード</title>
<indexterm>
<primary>portmanager</primary>
</indexterm>
<para>インストールした ports
のアップグレードを簡単に行なうためのもうひとつのユーティリティが
<application>Portmanager</application> です。
<filename role="package">ports-mgmt/portmanager</filename> port
から利用できます。</para>
<screen>&prompt.root; <userinput>cd <filename class="directory">/usr/ports/ports-mgmt/portmanager</filename></userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
<para>インストールされているすべての ports
を次のような簡単なコマンドでアップグレードできます。</para>
<screen>&prompt.root; <userinput>portmanager -u</userinput></screen>
<para><application>Portmanager</application>
の作業を確認しながら行いたい場合には、
<option>-ui</option> フラグを追加して上記のコマンドを実行
(<userinput>portmanager -u -ui</userinput>)
してください。
<application>Portmanager</application> を使って、
システムに新しい ports をインストールすることもできます。
通常の <command>make <maketarget>install clean</maketarget></command> コマンドと異なり、
選択した port をビルドしインストールする前に、
依存している port をすべてアップグレードします。</para>
<screen>&prompt.root; <userinput>portmanager <replaceable>x11/gnome2</replaceable></userinput></screen>
<para>選択した port の依存関係について問題が発生した場合には、
<application>Portmanager</application>
を使って修復することができます。
修正が終ったら、問題を含んでいた port は再構築されます。</para>
<screen>&prompt.root; <userinput>portmanager <replaceable>graphics/gimp</replaceable> -f</userinput></screen>
<para>詳細については &man.portmanager.1; を参照してください。</para>
</sect3>
<sect3 id="portmaster">
<title>Portmaster を用いた ports のアップグレード</title>