From owner-svn-doc-head@FreeBSD.ORG Wed Oct 3 11:09:35 2012
Return-Path: <owner-svn-doc-head@FreeBSD.ORG>
Delivered-To: svn-doc-head@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
by hub.freebsd.org (Postfix) with ESMTP id 7F174106566B;
Wed, 3 Oct 2012 11:09:35 +0000 (UTC)
(envelope-from ryusuke@FreeBSD.org)
Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c])
by mx1.freebsd.org (Postfix) with ESMTP id 6975B8FC16;
Wed, 3 Oct 2012 11:09:35 +0000 (UTC)
Received: from svn.freebsd.org (localhost [127.0.0.1])
by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id q93B9ZQW016249;
Wed, 3 Oct 2012 11:09:35 GMT (envelope-from ryusuke@svn.freebsd.org)
Received: (from ryusuke@localhost)
by svn.freebsd.org (8.14.4/8.14.4/Submit) id q93B9ZPs016247;
Wed, 3 Oct 2012 11:09:35 GMT (envelope-from ryusuke@svn.freebsd.org)
Message-Id: <201210031109.q93B9ZPs016247@svn.freebsd.org>
From: Ryusuke SUZUKI <ryusuke@FreeBSD.org>
Date: Wed, 3 Oct 2012 11:09:35 +0000 (UTC)
To: doc-committers@freebsd.org, svn-doc-all@freebsd.org,
svn-doc-head@freebsd.org
X-SVN-Group: doc-head
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Cc:
Subject: svn commit: r39648 - head/ja_JP.eucJP/books/handbook/ports
X-BeenThere: svn-doc-head@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: SVN commit messages for the doc tree for head
<svn-doc-head.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-head>,
<mailto:svn-doc-head-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-head>
List-Post: <mailto:svn-doc-head@freebsd.org>
List-Help: <mailto:svn-doc-head-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-head>,
<mailto:svn-doc-head-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 03 Oct 2012 11:09:35 -0000
Author: ryusuke
Date: Wed Oct 3 11:09:34 2012
New Revision: 39648
URL: http://svn.freebsd.org/changeset/doc/39648
Log:
- Merge the following from the English version:
r39474 -> r39642 head/ja_JP.eucJP/books/handbook/ports/chapter.sgml
Modified:
head/ja_JP.eucJP/books/handbook/ports/chapter.xml
Modified: head/ja_JP.eucJP/books/handbook/ports/chapter.xml
==============================================================================
--- head/ja_JP.eucJP/books/handbook/ports/chapter.xml Wed Oct 3 00:32:01 2012 (r39647)
+++ head/ja_JP.eucJP/books/handbook/ports/chapter.xml Wed Oct 3 11:09:34 2012 (r39648)
@@ -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>
+
+ <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>
- <para>FreeBSD のシステムインストール時に、
- <application>sysinstall</application>
- が Ports Collection をインストールするかどうかを尋ねてきたはずです。
- No を選んだ場合、以下の作業をおこない
- Ports Collection をインストールしてください。</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> についてもっと知りたいのであれば、
@@ -720,43 +831,6 @@ docbook =
</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>
<para>ここでは、<application>sysinstall</application>
@@ -1321,50 +1395,6 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/
詳細は &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>