git: ca9131b72975 - main - UPDATING: Strengthen recommendations

From: Alexander Ziaee <ziaee_at_FreeBSD.org>
Date: Mon, 05 May 2025 16:38:23 UTC
The branch main has been updated by ziaee:

URL: https://cgit.FreeBSD.org/src/commit/?id=ca9131b729757959cb0fd4721603466284cfc6fe

commit ca9131b729757959cb0fd4721603466284cfc6fe
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2025-05-03 22:43:10 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2025-05-05 16:37:23 +0000

    UPDATING: Strengthen recommendations
    
    Strengthen recommendations for ports_modules by adding a separate note.
    Use the unused [2] to add a note about creating backups.
    
    MFC after:              3 days
    Reviewed by:            brooks, mhorne
    Approved by:            mhorne (mentor)
    Differential Revision:  https://reviews.freebsd.org/D50126
---
 UPDATING | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/UPDATING b/UPDATING
index 2a81fe2c27a8..7678c65b3761 100644
--- a/UPDATING
+++ b/UPDATING
@@ -2154,10 +2154,11 @@ COMMON ITEMS:
 	# Note: sometimes if you are running current you gotta do more than
 	# is listed here if you are upgrading from a really old current.
 
-	<make sure you have good level 0 dumps>
+	<make sure you have good level 0 dumps>		[2]
 	make buildworld
+	<make sure any needed PORTS_MODULES are set>	[1]
 	make buildkernel KERNCONF=YOUR_KERNEL_HERE
-	make installkernel KERNCONF=YOUR_KERNEL_HERE	[1]
+	make installkernel KERNCONF=YOUR_KERNEL_HERE
 	<reboot in single user>				[3]
 	etcupdate -p					[5]
 	make installworld
@@ -2191,10 +2192,11 @@ COMMON ITEMS:
 
 	To upgrade in-place from stable to current
 	----------------------------------------------
-	<make sure you have good level 0 dumps>
+	<make sure you have good level 0 dumps>		[2]
 	make buildworld					[9]
+	<make sure any needed PORTS_MODULES are set>	[1]
 	make buildkernel KERNCONF=YOUR_KERNEL_HERE	[8]
-	make installkernel KERNCONF=YOUR_KERNEL_HERE	[1]
+	make installkernel KERNCONF=YOUR_KERNEL_HERE
 	<reboot in single user>				[3]
 	etcupdate -p					[5]
 	make installworld
@@ -2227,6 +2229,11 @@ FOOTNOTES:
 	and effective, eg:
 	     PORTS_MODULES+=graphics/drm-kmod graphics/nvidia-drm-kmod
 
+	[2] To make complete dumps on zfs(4), use bectl(8), which
+	creates bootable snapshots of configurable depth that are
+	selectable via the bootloader. For ufs(4), use dump(8) and
+	restore(8).
+
 	[3] From the bootblocks, boot -s, and then do
 		fsck -p
 		mount -u /