diff --git a/en_US.ISO8859-1/books/handbook/ports/chapter.sgml b/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
index b73de24947..64393aaf09 100644
--- a/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
@@ -1103,9 +1103,6 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>
     <sect2 id="ports-upgrading">
       <title>Upgrading Ports</title>
 
-      <indexterm>
-	<primary>portupgrade</primary>
-      </indexterm>
       <indexterm>
 	<primary>ports</primary>
 	<secondary>upgrading</secondary>
@@ -1123,6 +1120,13 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>
 	  encounter and need to perform when updating a port.</para>
       </note>
 
+      <sect3 id="portupgrade">
+	<title>Upgrading Ports using Portupgrade</title>
+
+	<indexterm>
+	  <primary>portupgrade</primary>
+	</indexterm>
+
       <para>The <application>portupgrade</application> utility is designed
 	to easily upgrade installed ports.  It is available from the <filename
 	role="package">sysutils/portupgrade</filename> port.  Install it like
@@ -1168,6 +1172,47 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>
 	<option>-P</option> is specified) without building or
 	installing anything, use <option>-F</option>.
 	For further information see &man.portupgrade.1;.</para>
+      </sect3>
+
+      <sect3 id="portmanager">
+	<title>Upgrading Ports using Portmanager</title>
+
+	<indexterm>
+	  <primary>portmanager</primary>
+	</indexterm>
+
+	<para><application>Portmanager</application> is another utility for
+	  easy upgrading of installed ports.  It is available from the
+	  <filename role="package">sysutils/portmanager</filename> port:</para>
+
+	<screen>&prompt.root; <userinput>cd <filename role="directory">/usr/ports/sysutils/portmanager</filename></userinput>
+&prompt.root; <userinput>make install clean</userinput></screen>
+
+	<para>All the installed ports can be upgraded using this simple
+	  command:</para>
+
+	<screen>&prompt.root; <userinput>portmanager -u</userinput></screen>
+
+	<para>You can add the <option>-ui</option> flag to get asked for
+	  confirmation of every step <application>Portmanager</application>
+	  will perform.  <application>Portmanager</application> can also be
+	  used to install new ports on the system.  Unlike the usual
+	  <command>make install clean</command> command, it will upgrade all
+	  the dependencies prior to building and installing the
+	  selected port.</para>
+
+	<screen>&prompt.root; <userinput>portmanager <replaceable>x11/gnome2</replaceable></userinput></screen>
+
+	<para>If there are any problems regarding the dependencies for the
+	  selected port, you can use <application>Portmanager</application> to
+	  rebuild all of them in the correct order.  Once finished, the
+	  problematic port will be rebuilt too.</para>
+
+	<screen>&prompt.root; <userinput>portmanager <replaceable>graphics/gimp</replaceable> -f</userinput></screen>
+
+	<para>For more information see
+	  <application>Portmanager</application>'s manual page.</para>
+      </sect3>
     </sect2>
 
     <sect2 id="ports-disk-space">