From owner-freebsd-doc@FreeBSD.ORG  Thu Dec  9 11:09:00 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 E462F16A4CE; Thu,  9 Dec 2004 11:09:00 +0000 (GMT)
Received: from abigail.blackend.org (blackend.org [212.11.35.229])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id D932243D4C; Thu,  9 Dec 2004 11:08:59 +0000 (GMT)
	(envelope-from marc@blackend.org)
Received: from abigail.blackend.org (localhost [127.0.0.1])
	iB9B6Jkh060205;	Thu, 9 Dec 2004 12:06:19 +0100 (CET)
	(envelope-from marc@abigail.blackend.org)
Received: (from marc@localhost)
	by abigail.blackend.org (8.12.11/8.12.11/Submit) id iB9B6JqH060204;
	Thu, 9 Dec 2004 12:06:19 +0100 (CET)
	(envelope-from marc)
Date: Thu, 9 Dec 2004 12:06:18 +0100
From: Marc Fonvieille <blackend@FreeBSD.org>
To: Denis Peplin <den@FreeBSD.org>
Message-ID: <20041209110618.GA59657@abigail.blackend.org>
References: <41B8302B.6020001@FreeBSD.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <41B8302B.6020001@FreeBSD.org>
User-Agent: Mutt/1.4.2.1i
X-Useless-Header: blackend.org
X-Operating-System: FreeBSD 4.10-PRERELEASE
cc: freebsd-doc@FreeBSD.org
Subject: Re: 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:09:01 -0000

On Thu, Dec 09, 2004 at 01:59:55PM +0300, Denis Peplin wrote:
> Hello!
> 
> Please, look at patch atached and note me if
> some grammar errors found.
> 
> Thanks!

> 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

				<envar>PKG_PATH</envar>

> +	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)

						<option>-P</option>

> +	without building or installing anything, use <option>-F</option>.
>  	For further information see &man.portupgrade.1;.</para>
>  
>        <note>

Marc