git: 1bcd2e2f8311 - main - build.7: Explain packaging a custom kernel

The branch main has been updated by ziaee:

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

commit 1bcd2e2f8311b737170e4bae8381dcb7de2c4413
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2026-04-22 17:26:45 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2026-04-22 17:26:46 +0000

    build.7: Explain packaging a custom kernel
    
    MFC after:              3 days (to 15 only)
    Requested by:           vermaden
    Discussed with:         emaste, ivy, Mark Millard <markmi_dsl-only.net>
    Differential Revision:  https://reviews.freebsd.org/D56217
---
 share/man/man7/build.7 | 19 +++++++++++++++----
 1 file changed, 15 insertions(+), 4 deletions(-)

diff --git a/share/man/man7/build.7 b/share/man/man7/build.7
index d03a1fd7b911..7d1cb31fea1f 100644
--- 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 April 6, 2026
+.Dd April 13, 2026
 .Dt BUILD 7
 .Os
 .Sh NAME
@@ -1032,7 +1032,7 @@ After testing the new system and verifying that your applications do not
 depend on them, delete the old libraries:
 .Pp
 .Dl make delete-old-libs
-.Ss Example 2: Build and upgrade a custom kernel in place
+.Ss Example 2: Build and upgrade a custom kernel
 Create a custom kernel configuration,
 .Va MYKERNEL ,
 by including an existing configuration and using
@@ -1050,7 +1050,7 @@ EOF
 .Ed
 .Pp
 After creating the new kernel configuration, build a fresh toolchain,
-build the kernel, and install it, moving the old kernel to
+build the kernel, and install it directly, moving the old kernel to
 .Pa /boot/kernel.old/ :
 .Bd -literal -offset indent
 make kernel-toolchain
@@ -1059,7 +1059,18 @@ make -DALWAYS_CHECK_MAKE installkernel KERNCONF=MYKERNEL
 shutdown -r now
 .Ed
 .Pp
-To build the kernel to an alternate location, use the
+To package the kernel into a
+.Xr freebsd-base 7
+package instead of installing it directly, use
+.Cm update-packages
+instead of
+.Cm installkernel :
+.Bd -literal -offset indent
+make buildworld buildkernel KERNCONF=MYKERNEL
+make update-packages KERNCONF=MYKERNEL
+.Ed
+.Pp
+To install the kernel directly to an alternate location, use the
 .Va INSTKERNNAME
 variable and boot it once to test via
 .Xr nextboot 8 :