git: bba78121411a - releng/15.0 - loader manuals: Clarify console and boot_serial

From: Colin Percival <cperciva_at_FreeBSD.org>
Date: Sun, 23 Nov 2025 16:39:08 UTC
The branch releng/15.0 has been updated by cperciva:

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

commit bba78121411a6ffe04e30960f8e8072a60d788cf
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2025-11-14 14:41:57 +0000
Commit:     Colin Percival <cperciva@FreeBSD.org>
CommitDate: 2025-11-23 16:38:41 +0000

    loader manuals: Clarify console and boot_serial
    
    console=comconsole is for the loader and boot_serial is for the kernel.
    
    I think we should centralize documentation on the loader settings in one
    manual, such a loader.8. The current proliferation is not obvious where
    to find the documentation. To the user, these are all set in loader.conf
    or at the loader prompt.
    
    Approved by:    re (cperciva)
    MFC after:              3 days
    Differential Revision:  https://reviews.freebsd.org/D53695
    
    (cherry picked from commit 09ffaa4e07d749c83cc1db13829505f21b025f29)
    (cherry picked from commit 3035855815c2fdbe27b65b9ec0374f4583ceb3f5)
---
 stand/defaults/loader.conf.5 | 3 +++
 stand/man/loader_simp.8      | 4 ++--
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/stand/defaults/loader.conf.5 b/stand/defaults/loader.conf.5
index b1661e8c1101..8c43bb62a135 100644
--- a/stand/defaults/loader.conf.5
+++ b/stand/defaults/loader.conf.5
@@ -343,6 +343,9 @@ selects the video console which prevents any input and hides all output
 replacing it with
 .Dq spinning
 character (useful for embedded products and such).
+This setting is for the
+.Xr loader 8
+only and does not set the kernel output.
 .It Va screen.font
 Set font size for framebuffer mode.
 The default font size is selected based on screen resolution.
diff --git a/stand/man/loader_simp.8 b/stand/man/loader_simp.8
index 683ca8b2da5d..52cb598fdd89 100644
--- a/stand/man/loader_simp.8
+++ b/stand/man/loader_simp.8
@@ -358,8 +358,8 @@ in
 .Xr kenv 1 ,
 not for any particular value.
 .It Va boot_serial
-Force the use of a serial console even when an internal console
-is present.
+Force the use of a serial console for the kernel
+even when an internal console is present.
 .It Va boot_single
 Prevents the kernel from initiating a multi-user startup; instead,
 a single-user mode will be entered when the kernel has finished