From owner-freebsd-doc@FreeBSD.ORG Mon Aug 11 03:30:03 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7BDA037B401 for ; Mon, 11 Aug 2003 03:30:03 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4963D43FBF for ; Mon, 11 Aug 2003 03:30:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h7BAU2Up005013 for ; Mon, 11 Aug 2003 03:30:02 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h7BAU2v5005012; Mon, 11 Aug 2003 03:30:02 -0700 (PDT) Resent-Date: Mon, 11 Aug 2003 03:30:02 -0700 (PDT) Resent-Message-Id: <200308111030.h7BAU2v5005012@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Josef El-Rayes Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 852B537B401 for ; Mon, 11 Aug 2003 03:28:52 -0700 (PDT) Received: from lyra.enemy.org (lyra.enemy.org [62.116.11.42]) by mx1.FreeBSD.org (Postfix) with SMTP id 07EB543F85 for ; Mon, 11 Aug 2003 03:28:51 -0700 (PDT) (envelope-from shammer@satanii.enemy.org) Received: (qmail 6811 invoked from network); 11 Aug 2003 10:27:55 -0000 Received: from unknown (HELO satanii.enemy.org) (62.116.11.3) by lyra.enemy.org with SMTP; 11 Aug 2003 10:27:55 -0000 Received: from satanii.enemy.org (shammer@localhost [IPv6:::1]) by satanii.enemy.org (8.12.6p2/8.12.6) with ESMTP id h7BASo52037108 for ; Mon, 11 Aug 2003 12:28:50 +0200 (CEST) (envelope-from shammer@satanii.enemy.org) Received: (from shammer@localhost) by satanii.enemy.org (8.12.6p2/8.12.6/Submit) id h7BASnCK037107; Mon, 11 Aug 2003 12:28:49 +0200 (CEST) Message-Id: <200308111028.h7BASnCK037107@satanii.enemy.org> Date: Mon, 11 Aug 2003 12:28:49 +0200 (CEST) From: Josef El-Rayes To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/55458: [patch] add useful content & hints to portupgrade section X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Josef El-Rayes List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 11 Aug 2003 10:30:03 -0000 >Number: 55458 >Category: docs >Synopsis: [patch] add useful content & hints to portupgrade section >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Mon Aug 11 03:30:00 PDT 2003 >Closed-Date: >Last-Modified: >Originator: Josef El-Rayes >Release: FreeBSD 4.7-RELEASE alpha >Organization: >Environment: System: FreeBSD satanii.enemy.org 4.7-RELEASE FreeBSD 4.7-RELEASE #3: Sun Oct 13 23:53:31 CEST 2002 root@satanii.enemy.org:/usr/src/sys/compile/S2 alpha >Description: doc/en_US.ISO8859-1/books/handbook/ports/chapter.sgml: this patch adds some explanation on how to use portupgrade and gives some important hints to avoid inconsistencies. portupgrade(1) gets added to man-references >How-To-Repeat: >Fix: --- chapter.sgml.diff begins here --- --- chapter.sgml.orig Sun Aug 10 20:47:29 2003 +++ chapter.sgml Sun Aug 10 22:54:35 2003 @@ -1094,7 +1094,26 @@ INDEX file. Finally, portupgrade will begin to download, build, backup, install, and clean the ports which have been updated. - Other utilities exist which will do this, check out the + portupgrade comes with a lot of options for different + use cases, the most important ones will be presented below: + + If you want to upgrade only a certain application, not the complete database, + use portupgrade pkgname, + include the flags -r + if portupgrade should act on all those packages + depending on the given package as well, and -R to act on + all packages required by the given packages as well. + To use packages instead of ports for installation, provide -P + and to just fetch distfiles without building or installing anything, use + -F. For further information see &man.portupgrade.1; + + It is important to regularly update the package database using + pkgdb -F to fix inconsistencies, especially when + portupgrade asks you to. Do not abort + portupgrade while it is updating the package database, + this will leave you a inconsistent database. + + Other utilities exist which will do this, check out the ports/sysutils directory and see what you come up with. --- chapter.sgml.diff ends here --- --- man-refs.ent.diff begins here --- --- man-refs.ent.orig Fri Aug 8 17:57:30 2003 +++ man-refs.ent Sun Aug 10 22:58:01 2003 @@ -476,6 +476,7 @@ + --- man-refs.ent.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: