git: 09ffaa4e07d7 - main - loader manuals: Clarify console and boot_serial

From: Alexander Ziaee <ziaee_at_FreeBSD.org>
Date: Fri, 14 Nov 2025 14:48:30 UTC
The branch main has been updated by ziaee:

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

commit 09ffaa4e07d749c83cc1db13829505f21b025f29
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2025-11-14 14:41:57 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2025-11-14 14:45:14 +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.
    
    MFC after:              3 days
    Differential Revision:  https://reviews.freebsd.org/D53695
---
 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