Index: ports/chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/ports/chapter.sgml,v
retrieving revision 1.229
diff -u -r1.229 chapter.sgml
--- ports/chapter.sgml	29 Nov 2004 21:43:37 -0000	1.229
+++ ports/chapter.sgml	9 Dec 2004 10:49:57 -0000
@@ -1163,10 +1163,19 @@
 	<application>portupgrade</application> should act on all
 	those packages depending on the given package as well, and
 	<option>-R</option> to act on all packages required by
-	the given packages.
-	To use packages instead of ports for installation, provide
-	<option>-P</option> and to just fetch distfiles without
-	building or installing anything, use <option>-F</option>.
+	the given packages.</para>
+
+      <para>To use packages instead of ports for installation, provide
+	<option>-P</option>.  With this option
+	<application>portupgrade</application> searches
+	the local directories listed in PKG_PATH, or fetch packages
+	from remote site if it is not found locally.  If
+	packages can not be fetched remotely,
+	<application>portupgrade</application> will use ports.
+	To avoid using ports, specify <option>-PP</option>.</para>
+
+      <para>To just fetch distfiles (or packages, if -P is specified)
+	without building or installing anything, use <option>-F</option>.
 	For further information see &man.portupgrade.1;.</para>
 
       <note>
