From nobody@FreeBSD.org  Thu Jun 17 17:49:58 2010
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 1CF041065672
	for <freebsd-gnats-submit@FreeBSD.org>; 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 <freebsd-gnats-submit@FreeBSD.org>; 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 <freebsd-gnats-submit@FreeBSD.org>; 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 <prdeltoid@gmx.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Something strange in the updating/upgrading section of the handbook.
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         147946
>Category:       docs
>Synopsis:       Something strange in the updating/upgrading section of the handbook.
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    dru
>State:          closed
>Quarter:        
>Keywords:       handbook
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jun 17 17:50:07 UTC 2010
>Closed-Date:    Tue May 06 15:25:09 UTC 2014
>Last-Modified:  Tue May 06 15:25:09 UTC 2014
>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:

From: Johann Kois <jkois@FreeBSD.org>
To: bug-followup@FreeBSD.org, prdeltoid@gmx.com, trhodes@FreeBSD.org
Cc:  
Subject: Re: docs/147946: Something strange in the updating/upgrading section
 of the handbook.
Date: Sun, 04 Jul 2010 20:22:47 +0200

 -----BEGIN PGP SIGNED MESSAGE-----
 Hash: SHA1
 
 I did not write this section of the handbook, but I think the word
 "test" is the problem here.  It should just go away.
 
 Then the section basically says "... during an upgrade all installed
 ports should be removed and reinstalled.  This is done by issuing a
 "portupgrading -af" ..."
 
 Otherwise the next paragraph would not make any sense.  I think some
 feedback from the author of this section is needed here.
 
 
 Johann Kois
 
 - -- 
  Johann Kois
  jkois(at)FreeBSD.org
  FreeBSD Documentation Project
  FreeBSD German Documentation Project - https://doc.bsdgroup.de
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v2.0.14 (FreeBSD)
 Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/
 
 iEYEARECAAYFAkww0XcACgkQ/rDr791hwthvqwCffkShLPyslnJW2MlYcVzNL0xF
 SFcAn3I4KApd5WsDrtvb2pe+edgJzwrT
 =pna8
 -----END PGP SIGNATURE-----
Responsible-Changed-From-To: freebsd-doc->trhodes  
Responsible-Changed-By: jkois 
Responsible-Changed-When: Fri Jul 23 16:20:14 UTC 2010 
Responsible-Changed-Why:  
Reassign this to original author of this handbook section. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=147946 
Responsible-Changed-From-To: trhodes->dru 
Responsible-Changed-By: dru 
Responsible-Changed-When: Tue May 6 15:23:44 UTC 2014 
Responsible-Changed-Why:  
I'll take 

http://www.freebsd.org/cgi/query-pr.cgi?pr=147946 
State-Changed-From-To: open->closed 
State-Changed-By: dru 
State-Changed-When: Tue May 6 15:24:08 UTC 2014 
State-Changed-Why:  
This section has been updated for portmaster and includes the 
switch which disables the config screens. Refer to r44772. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=147946 
>Unformatted:
