diff --git a/en_US.ISO8859-1/books/handbook/ports/chapter.sgml b/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
index d681942e68..1a3b23a55b 100644
--- a/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
@@ -1163,10 +1163,20 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>
 	<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 <envar>PKG_PATH</envar>, or
+	fetches packages from remote site if it is not found locally.
+	If packages can not be found locally or 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
+	<option>-P</option> is specified) without building or
+	installing anything, use <option>-F</option>.
 	For further information see &man.portupgrade.1;.</para>
 
       <note>