From owner-freebsd-doc@FreeBSD.ORG Mon Aug 11 10:00:23 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 B82FA37B401 for ; Mon, 11 Aug 2003 10:00:23 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 46EA943F93 for ; Mon, 11 Aug 2003 10:00:23 -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 h7BH0NUp074059 for ; Mon, 11 Aug 2003 10:00:23 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h7BH0MDQ074058; Mon, 11 Aug 2003 10:00:22 -0700 (PDT) Date: Mon, 11 Aug 2003 10:00:22 -0700 (PDT) Message-Id: <200308111700.h7BH0MDQ074058@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: underway@comcast.net (Gary W. Swearingen) Subject: Re: 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: "Gary W. Swearingen" List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 11 Aug 2003 17:00:24 -0000 The following reply was made to PR docs/55458; it has been noted by GNATS. From: underway@comcast.net (Gary W. Swearingen) To: Josef El-Rayes Cc: FreeBSD-gnats-submit@FreeBSD.org Subject: Re: docs/55458: [patch] add useful content & hints to portupgrade section Date: Mon, 11 Aug 2003 09:50:51 -0700 Just some kibitzing here. If it's not welcome, let me know so I can better decide how to entertain myself. Josef El-Rayes writes: > --- 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, INDEX file and then > portupgrade will begin to download, build, download, build, COMMENT: If using "portupgrade" there, it looks more like an , if I understand the fine distinction. > 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 The utility comes with many options for different > + use cases, the most important ones will be presented below: uses. Two important ones follow. > + > + If you want to upgrade only a certain application, not the complete database, To upgrade only one package, and not the complete database, OR: To upgrade only one package, > + use portupgrade pkgname, use portupgrade pkgname. > + include the flags -r Include the flag -r > + if portupgrade should act on all those packages to also act on the packages > + depending on the given package as well, and -R to act on that depend on the given package, and include -R to also act on > + all packages required by the given packages as well. the packages that are required by the given package. > + To use packages instead of ports for installation, provide -P To use packages instead of ports for installation, include -P. > + and to just fetch distfiles without building or installing anything, use To only fetch the distfiles, without building or installing anything, include COMMENT: I'm guessing that "distfiles" should have some markup like , but I don't know. > + -F. For further information see &man.portupgrade.1; > + > + It is important to regularly update the package database using COMMENT: If it's really important, then "regularly" should be defined. I doubt if anyone can do so. It would be better, IMO, to leave the advice out until complaints get the software fixed. We probably cannot remove the fuzzy advice from the utility's manpage, but we needn't propagate it in the FDP. > + pkgdb -F to fix inconsistencies, especially when > + portupgrade asks you to. Do not abort COMMENT: That advice is OK, of course. > + portupgrade while it is updating the package database, portupgrade while it is updating the package database; > + this will leave you a inconsistent database. this will leave you a inconsistent database. > + > + Other utilities exist which will do this, check out the There are more package and ports utilities; check out the > ports/sysutils directory and see what you ports/sysutils directory. > > --- chapter.sgml.diff ends here ---