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