docs/147946: Something strange in the updating/upgrading section of the handbook.

[Anonymous]

>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: