From owner-freebsd-doc@FreeBSD.ORG  Thu Dec  9 11:00:12 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 6657716A4CE
	for <freebsd-doc@FreeBSD.org>; Thu,  9 Dec 2004 11:00:12 +0000 (GMT)
Received: from volginfo.ru (ns.volginfo.ru [217.23.84.100])
	by mx1.FreeBSD.org (Postfix) with ESMTP id A26F143D45
	for <freebsd-doc@FreeBSD.org>; Thu,  9 Dec 2004 11:00:11 +0000 (GMT)
	(envelope-from den@FreeBSD.org)
Received: from [192.168.1.32] (llp-13.vistcom.ru [217.23.84.68])
	by volginfo.ru (Postfix) with ESMTP id A30522013
	for <freebsd-doc@FreeBSD.org>; Thu,  9 Dec 2004 14:00:03 +0300 (MSK)
Message-ID: <41B8302B.6020001@FreeBSD.org>
Date: Thu, 09 Dec 2004 13:59:55 +0300
From: Denis Peplin <den@FreeBSD.org>
User-Agent: Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.7.2) Gecko/20041008
X-Accept-Language: ru, en-us, en
MIME-Version: 1.0
To: freebsd-doc@FreeBSD.org
Content-Type: multipart/mixed;
 boundary="------------000309050001080706020907"
Subject: Handbook (ports) portupgrade -PP
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 09 Dec 2004 11:00:12 -0000

This is a multi-part message in MIME format.
--------------000309050001080706020907
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit

Hello!

Please, look at patch atached and note me if
some grammar errors found.

Thanks!

--------------000309050001080706020907
Content-Type: text/plain;
 name="portupgrade-pp.diff"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline;
 filename="portupgrade-pp.diff"

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>

--------------000309050001080706020907--