Bug 217919

Summary:	Handbook: 23.2.3.2 expects 'portmaster' to be installed.
Product:	Documentation	Reporter:	eekee57 <eekee57>
Component:	Books & Articles	Assignee:	Chris Rees <crees>
Status:	Closed Overcome By Events
Severity:	Affects Many People	CC:	crees, linimon
Priority:	---
Version:	Latest
Hardware:	Any
OS:	Any

Description eekee57@fastmail.fm 2017-03-19 14:49:48 UTC

Handbook section 23.2.3.2, Upgrading Packages After a Major Version Upgrade, tells the user to use the following command to upgrade ports after a major install, with no alternative given:
portmaster -af

On my 11.0-RELEASE-p8 installation, a fresh install with just a few packages added, portmaster doesn't exist. Should some portsnap command be there instead? portsnap is installed, and section 4.5 repeatedly gives examples of portsnap usage.

Section 23.2.3.2 is on this page:
https://www.freebsd.org/doc/handbook/updating-upgrading-freebsdupdate.html

Perhaps related to bug #214679

Comment 1 Chris Rees freebsd_committer

2018-12-24 20:14:55 UTC

Thank you for your report.  The docs now show pkg-static upgrade, which is the preferred option nowadays.  I agree that at the time this was submitted, more alternative options would have been helpful, so I'm sorry this was missed.