Index: chapter.sgml
===================================================================
RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml,v
retrieving revision 1.233
diff -u -r1.233 chapter.sgml
--- chapter.sgml	24 Dec 2008 21:47:59 -0000	1.233
+++ chapter.sgml	26 Dec 2008 03:19:33 -0000
@@ -424,6 +424,16 @@
 &prompt.root; <userinput>rm /var/db/pkg/pkgdb.db /usr/ports/INDEX-*.db</userinput>
 &prompt.root; <userinput>portupgrade -af</userinput></screen>
 
+      <note>
+	<para>Since <application>portupgrade</application> depends on
+	  installed ports, users may wish to consider using <filename
+	    role="package">ports-mgmt/portmaster</filename>.
+	  <application>Portmaster</application> provides similar
+	  functionality, but is much more compact and has no additional
+	  port dependencies.  For more information, see <link
+	    linkend="portmaster">the section about <application>Portmaster</application></link>.</para>
+      </note>
+
       <para>Once this has completed, finish the upgrade process with a
 	final call to <command>freebsd-update</command>.  Issue the
 	following command to tie up all loose ends in the upgrade