The branch main has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=a97ed3a39c1044dd1b8056d68a76de74821f2bff
commit a97ed3a39c1044dd1b8056d68a76de74821f2bff Author: Alexander Ziaee <[email protected]> AuthorDate: 2026-02-01 00:16:34 +0000 Commit: Alexander Ziaee <[email protected]> CommitDate: 2026-02-01 15:52:54 +0000 vt.4: Sprinkle mdoc macros Now that we have angle bracket characters for all common display sizes, sprinkle in the correct macros for the structures in this page. While here, fix a mdoc typo, a linter warning, and switch a parenthetical to a much smoother appositive. MFC after: 3 days Fixes: 7cd6da268a8f (vt.4: Style pass) --- share/man/man4/vt.4 | 70 ++++++++++++++++++++++++++--------------------------- 1 file changed, 35 insertions(+), 35 deletions(-) diff --git a/share/man/man4/vt.4 b/share/man/man4/vt.4 index 1acd4e7c63e0..5454fe0a48e6 100644 --- a/share/man/man4/vt.4 +++ b/share/man/man4/vt.4 @@ -32,38 +32,38 @@ .Nm vt .Nd virtual terminal system video console driver .Sh SYNOPSIS -.Cd "options TERMINAL_KERN_ATTR=<attribute>" -.Cd "options TERMINAL_NORM_ATTR=<attribute>" -.Cd "options VT_MAXWINDOWS=<N>" -.Cd "options VT_ALT_TO_ESC_HACK=1" -.Cd "options VT_TWOBUTTON_MOUSE" -.Cd "options VT_FB_MAX_WIDTH=<X>" -.Cd "options VT_FB_MAX_HEIGHT=<Y>" -.Cd "options SC_NO_CUTPASTE" -.Cd "device vt" +.Cd options TERMINAL_KERN_ATTR= Ns Ao Ar attribute Ac +.Cd options TERMINAL_NORM_ATTR= Ns Ao Ar attribute Ac +.Cd options VT_MAXWINDOWS= Ns Ao Ar N Ac +.Cd options VT_ALT_TO_ESC_HACK= Ns Ar 1 +.Cd options VT_TWOBUTTON_MOUSE +.Cd options VT_FB_MAX_WIDTH= Ns Ao Ar X Ac +.Cd options VT_FB_MAX_HEIGHT= Ns Ao Ar Y Ac +.Cd options SC_NO_CUTPASTE +.Cd device vt .Pp In .Xr loader.conf 5 : -.Cd "hw.vga.textmode=1" -.Cd "hw.vga.acpi_ignore_no_vga=1" -.Cd "kern.vty=vt" -.Cd "kern.vt.color.<colornum>.rgb=<colorspec>" -.Cd "kern.vt.fb.default_mode=<X>x<Y>" -.Cd "kern.vt.fb.modes.<connector>=<X>x<Y>" -.Cd "kern.vt.slow_down=<delay>" -.Cd "screen.font=<X>x<Y>" +.Cd hw.vga.textmode= Ns Ar 1 +.Cd hw.vga.acpi_ignore_no_vga= Ns Ar 1 +.Cd kern.vty= Ns Ar vt +.Cd kern.vt.color. Ns Ao Ar colornum Ac Ns .rgb= Ns Ao Ar colorspec Ac +.Cd kern.vt.fb.default_mode= Ns Ao Ar X Ac Ns x Ns Ao Ar Y Ac +.Cd kern.vt.fb.modes. Ns Ao Ar connector Ac Ns = Ns Ao Ar X Ac Ns x Ns Ao Ar Y Ac +.Cd kern.vt.slow_down= Ns Ao Ar delay Ac +.Cd screen.font= Ns Ao Ar X Ac Ns x Ns Ao Ar Y Ac .Pp In .Xr loader.conf 5 or .Xr sysctl.conf 5 : -.Cd kern.consmute=1 -.Cd kern.vt.kbd_halt=1 -.Cd kern.vt.kbd_poweroff=1 -.Cd kern.vt.kbd_reboot=1 -.Cd kern.vt.kbd_debug=1 -.Cd kern.vt.kbd_panic=0 -.Cd kern.vt.enable_altgr=0 -.Cd kern.vt.enable_bell=1 +.Cd kern.consmute= Ns Ar 1 +.Cd kern.vt.kbd_halt= Ns Ar 1 +.Cd kern.vt.kbd_poweroff= Ns Ar 1 +.Cd kern.vt.kbd_reboot= Ns Ar 1 +.Cd kern.vt.kbd_debug= Ns Ar 1 +.Cd kern.vt.kbd_panic= Ns Ar 0 +.Cd kern.vt.enable_altgr= Ns Ar 0 +.Cd kern.vt.enable_bell= Ns Ar 1 .Sh DESCRIPTION The .Nm @@ -130,8 +130,8 @@ These kernel options control the .Nm driver. .Bl -tag -width MAXCONS -.It Dv TERMINAL_NORM_ATTR=<attribute> -.It Dv TERMINAL_KERN_ATTR=<attribute> +.It Dv TERMINAL_NORM_ATTR= Ns Ao Ar attribute Ac +.It Dv TERMINAL_KERN_ATTR= Ns Ao Ar attribute Ac These options change the default colors used for normal and kernel text. Available colors are defined in @@ -139,11 +139,11 @@ Available colors are defined in See .Sx EXAMPLES below. -.It Dv VT_MAXWINDOWS=<N> +.It Dv VT_MAXWINDOWS= Ns Ao Ar N Ac Set the number of virtual terminals to be created to .Fa N . The value defaults to 12. -.It Dv VT_ALT_TO_ESC_HACK=1 +.It Dv VT_ALT_TO_ESC_HACK= Ns Ar 1 When the Alt key is held down while pressing another key, send an ESC sequence instead of the Alt key. .It Dv VT_TWOBUTTON_MOUSE @@ -152,10 +152,10 @@ In effect, this makes the right-hand mouse button perform a paste. These options are checked in the order shown. .It Dv SC_NO_CUTPASTE Disable mouse support. -.It VT_FB_MAX_WIDTH=<X> +.It VT_FB_MAX_WIDTH= Ns Ao Ar X Ac Set the maximum width to .Fa X . -.It VT_FB_MAX_HEIGHT=<Y> +.It VT_FB_MAX_HEIGHT= Ns Ao Ar Y Ac Set the maximum height to .Fa Y . .El @@ -206,7 +206,7 @@ BIOS boot. Features that require graphics mode, like loadable fonts, will be disabled. .Pp -If a KMS driver is loaded the console will switch to (and remain in) +If a KMS driver is loaded the console will switch to, and remain in, graphics mode. Moreover this tunable has no effect with .Xr UEFI 8 @@ -234,9 +234,9 @@ Note that is not compatible with .Xr UEFI 8 boot. -.It Va kern.vt.color. Ns Ar colornum Ns . Ns Va rgb +.It Va kern.vt.color . Ns Ar colornum . Ns Va rgb Set this value to override default palette entry for color -.Pa colornum +.Ar colornum which should be in a range from 0 to 15 inclusive. The value should be either a comma-separated triplet of red, green, and blue values in a range from 0 to 255 or @@ -256,7 +256,7 @@ The mode is applied to all output connectors. This is currently only supported by the .Cm vt_fb backend when it is paired with a KMS video driver. -.It Va kern.vt.fb.modes.<connector_name> +.It Va kern.vt.fb.modes . Ns Ao Ar connector_name Ac Set this value to a graphic mode to override the default picked by the .Nm backend.
