Bug 147946

Summary:	Something strange in the updating/upgrading section of the handbook.
Product:	Documentation	Reporter:	Anonymous <prdeltoid>
Component:	Books & Articles	Assignee:	Dru Lavigne <dru>
Status:	Closed FIXED
Severity:	Affects Only Me
Priority:	Normal
Version:	Latest
Hardware:	Any
OS:	Any

Description Anonymous 2010-06-17 18:50:07 UTC

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.

Comment 1 Johann Kois freebsd_committer

2010-07-04 19:22:47 UTC

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

Comment 2 Johann Kois freebsd_committer

2010-07-23 17:20:14 UTC

Responsible Changed
From-To: freebsd-doc->trhodes

Reassign this to original author of this handbook section.

Comment 3 Dru Lavigne freebsd_committer

2014-05-06 16:23:44 UTC

Responsible Changed
From-To: trhodes->dru

I'll take

Comment 4 Dru Lavigne freebsd_committer

2014-05-06 16:24:08 UTC

State Changed
From-To: open->closed

This section has been updated for portmaster and includes the 
switch which disables the config screens. Refer to r44772.