diff --git a/en_US.ISO8859-1/books/faq/book.sgml b/en_US.ISO8859-1/books/faq/book.sgml
index 8220727ed3..fcf103cada 100644
--- a/en_US.ISO8859-1/books/faq/book.sgml
+++ b/en_US.ISO8859-1/books/faq/book.sgml
@@ -5049,10 +5049,14 @@ crw-rw-rw-  1 root  wheel   41,   1 Oct 15 22:14 spx</screen>
         </question>
 
         <answer>
-          <para>Unfortunately, there is no easy way to update installed
-            ports. The &man.pkg.version.1; command can be used
-            to generate a script that will update the installed ports with
-            a newer version in the ports tree:</para>
+          <para>FreeBSD does not include a port upgrading tool, but it
+            does have some tools to make the upgrade process somewhat
+            easier.  You can also install additional tools to simplify
+            port handling.</para>
+
+          <para>The &man.pkg.version.1; command can generate a script
+            that will update installed ports to the latest version in
+            the ports tree.</para>
 
           <screen>&prompt.root; <userinput>pkg_version <option>-c</option> > <replaceable>/tmp/myscript</replaceable></userinput></screen>
 
@@ -5068,6 +5072,16 @@ crw-rw-rw-  1 root  wheel   41,   1 Oct 15 22:14 spx</screen>
             version numbers, so the ports that used that library need to be
             rebuilt to use the new version.</para>
 
+          <para>If you have the disk space, you can use the
+            <command>portupgrade</command> tool to automate all of
+            this.  <command>portupgrade</command> includes various
+            tools to simplify package handling.  It is available under
+            <port>sysutils/portupgrade</port>.
+            Since it is written in Ruby,
+            <command>portupgrade</command> is an unlikely candidate for
+            integration with the main FreeBSD tree.  That shouldn't
+            stop anyone from using it, however.</para>
+
           <para>If your system is up full time, the &man.periodic.8 system
             can be used to generate a weekly list of ports that might need
             updating by setting