diff --git a/share/man/man7/build.7 b/share/man/man7/build.7 --- a/share/man/man7/build.7 +++ b/share/man/man7/build.7 @@ -25,7 +25,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd September 25, 2025 +.Dd December 4, 2025 .Dt BUILD 7 .Os .Sh NAME @@ -1017,17 +1017,19 @@ .Ed .Pp For major version upgrades, boot into single-user mode. -After restarting, install userspace, and merge configurations. -After verifying that you do not need them, delete old files -and libraries: +After restarting, install userspace, and merge configurations: .Bd -literal -offset indent cd /usr/src etcupdate -p make installworld etcupdate -B -make delete-old delete-old-libs shutdown -r now .Ed +.Pp +After testing the new system and verifying that your applications do not +depend on them, delete old files and libraries: +.Pp +.Dl make delete-old delete-old-libs .Ss Example 2: Build and upgrade a custom kernel in place Create a custom kernel configuration, .Va MYKERNEL , @@ -1103,7 +1105,7 @@ .Bd -literal -offset indent cd /usr/src make TARGET_ARCH=aarch64 buildworld buildkernel -make TARGET_ARCH=aarch64 DESTDIR=/armclient installworld installkernel +make TARGET_ARCH=aarch64 DESTDIR=/client installworld installkernel .Ed .Pp Afterwards, to build and install a single piece of userspace, use: