Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 3 Oct 2012 11:09:35 +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: r39648 - head/ja_JP.eucJP/books/handbook/ports
Message-ID:  <201210031109.q93B9ZPs016247@svn.freebsd.org>

next in thread | raw e-mail | index | archive | help
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>
 



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201210031109.q93B9ZPs016247>