From owner-freebsd-doc@FreeBSD.ORG Thu Jun 17 17:50:08 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 216BC106568F for ; Thu, 17 Jun 2010 17:50:08 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id F38AB8FC14 for ; Thu, 17 Jun 2010 17:50:07 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id o5HHo7iO064280 for ; Thu, 17 Jun 2010 17:50:07 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id o5HHo7Sr064279; Thu, 17 Jun 2010 17:50:07 GMT (envelope-from gnats) Resent-Date: Thu, 17 Jun 2010 17:50:07 GMT Resent-Message-Id: <201006171750.o5HHo7Sr064279@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, Anonymous Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 1CF041065672 for ; Thu, 17 Jun 2010 17:49:58 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 0C5FF8FC0A for ; Thu, 17 Jun 2010 17:49:58 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o5HHnvkK088440 for ; Thu, 17 Jun 2010 17:49:57 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id o5HHnvrs088439; Thu, 17 Jun 2010 17:49:57 GMT (envelope-from nobody) Message-Id: <201006171749.o5HHnvrs088439@www.freebsd.org> Date: Thu, 17 Jun 2010 17:49:57 GMT From: Anonymous To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/147946: Something strange in the updating/upgrading section of the handbook. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 17 Jun 2010 17:50:08 -0000 >Number: 147946 >Category: docs >Synopsis: Something strange in the updating/upgrading section of the handbook. >Confidential: no >Severity: serious >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Thu Jun 17 17:50:07 UTC 2010 >Closed-Date: >Last-Modified: >Originator: Anonymous >Release: FreeBSD 7.2 >Organization: n/a >Environment: >Description: From http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/updating-upgrading-freebsdupdate.html: "24.2.3 Major and Minor Upgrades This process will remove old object files and libraries which will break most third party applications. It is recommended that all installed ports either be removed and re-installed or upgraded later using the ports-mgmt/portupgrade utility. Most users will want to run a test build using the following command: # portupgrade -af This will ensure everything will be re-installed correctly. Note that setting the BATCH environment variable to yes will answer yes to any prompts during this process, removing the need for manual intervention during the build process." How is runnning portupgrade -af running a test build? Is this supposed to say portupgrade -afn? If this is wrong, it's a very time-consuming and very wrong thing to do. >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted: