- Merge the following from the English version:

r49828 -> r49829	head/ja_JP.eucJP/books/handbook/ports/chapter.xml

ja_JP.eucJP/books/handbook/ports/chapter.xml

@@ -3,7 +3,7 @@
      The FreeBSD Documentation Project
      The FreeBSD Japanese Documentation Project
 
-     Original revision: r49828
+     Original revision: r49829
      $FreeBSD$
 -->
 <chapter xmlns="http://docbook.org/ns/docbook"
@@ -423,7 +423,8 @@ Info:   Lists information about open files (similar to fstat(1))</screen>
 
     <para>しかしながら、
       ソースまたは自分自身で用意したリポジトリから構築したサイトでは、
-      <emphasis>port 管理ツール</emphasis> が別に必要となります。</para>
+      <link linkend="ports-upgrading-tools">port 管理ツール</link>
+      が別に必要となります。</para>
 
     <para><application>pkg</application> はバイナリ
       package のみを扱うので、
@@ -1235,9 +1236,32 @@ The deinstallation will free 229 kB
 	  アップグレードする際にはこれらの手順に従ってください。</para>
       </important>
 
-      <para>実際にアップグレードを行うには、
-	<application>Portmaster</application> もしくは
-	<application>Portupgrade</application> を使ってください。</para>
+      <sect3 xml:id="ports-upgrading-tools">
+	<title>ports のアップグレードおよび管理ツール</title>
+
+	<indexterm>
+	  <primary>ports</primary>
+	  <secondary>アップグレードツール</secondary>
+	</indexterm>
+
+	<para>Ports Collection には、
+	  実際にアップグレードを行うためのユーティリティがいくつか用意されています。
+	  それぞれのユーティリティは長所と短所を持っています。</para>
+
+	<para>歴史的に、最もインストールされ使われているのは、
+	  <application>Portmaster</application> または
+	  <application>Portupgrade</application> です。
+	  <application>Synth</application> は新しいユーティリティです。</para>
+
+	<note>
+	  <para>特定のシステムにおいて、
+	    どのツールを選択するとベストかについては、
+	    システム管理者によります。
+	    これらのどのツールでも、使う前には、
+	    データのバックアップをとることが推奨されます。</para>
+	</note>
+
+      </sect3>
 
       <sect3 xml:id="portmaster">
 	<title><application>portmaster</application>
@@ -1345,6 +1369,10 @@ The deinstallation will free 229 kB
 	  Ports Collection の場所を指定してください。</para>
 
 	<screen>&prompt.root; <userinput>portmaster <replaceable>shells/bash</replaceable></userinput></screen>
+
+	<para><package>ports-mgmt/portmaster</package>
+	  に関するより多くの情報は、<filename>pkg-descr</filename>
+	  にあります。</para>
       </sect3>
 
       <sect3 xml:id="portupgrade">
@@ -1354,13 +1382,11 @@ The deinstallation will free 229 kB
 	  <primary>portupgrade</primary>
 	</indexterm>
 
-	<para><application>Portupgrade</application> は、
+	<para><package>ports-mgmt/portupgrade</package> は、
 	  インストールした ports
 	  のアップグレードを行なうためのもう一つのユーティリティです。
-	  <package>ports-mgmt/portupgrade</package>
-	  package または port から利用できます。
 	  このユーティリティは ports
-	  を管理するために用いられるアプリケーションをインストールします。
+	  を管理するために用いられるアプリケーションのセットをインストールします。
 	  Ruby に依存します。
 	  port をインストールするには、以下を実行してください。</para>
 
@@ -1414,7 +1440,12 @@ The deinstallation will free 229 kB
 	<option>-F</option> オプションを指定してください。
 	利用可能なすべてのオプションについては、
 	&man.portupgrade.1; のマニュアルを参照してください。</para>
+
+	<para><package>ports-mgmt/portupgrade</package>
+	  に関するより多くの情報は、<filename>pkg-descr</filename>
+	  にあります。</para>
       </sect3>
+
     </sect2>
 
     <sect2 xml:id="ports-disk-space">