vt.4: Style pass

Outstanding: I'm not sure kernel configuration declarations are defined
variables. Dv does not allow arguments, but some why allowed paths, so
non-path arguments were being incorrectly marked up as paths.

MFC after:		3 days
Reviewed by:		0mp, emaste
Differential Revision:	https://reviews.freebsd.org/D49565
This commit is contained in:
Alexander Ziaee
2025-08-07 13:01:29 -04:00
parent e4bfe8e966
commit 7cd6da268a
+25 -25
View File
@@ -1,4 +1,4 @@
.\"- .\"
.\" SPDX-License-Identifier: BSD-2-Clause .\" SPDX-License-Identifier: BSD-2-Clause
.\" .\"
.\" Copyright (c) 2014 Warren Block .\" Copyright (c) 2014 Warren Block
@@ -26,32 +26,32 @@
.\" SUCH DAMAGE. .\" SUCH DAMAGE.
.\" .\"
.Dd July 7, 2024 .Dd July 7, 2024
.Dt "VT" 4 .Dt VT 4
.Os .Os
.Sh NAME .Sh NAME
.Nm vt .Nm vt
.Nd virtual terminal system video console driver .Nd virtual terminal system video console driver
.Sh SYNOPSIS .Sh SYNOPSIS
.Cd "options TERMINAL_KERN_ATTR=_attribute_" .Cd "options TERMINAL_KERN_ATTR=<attribute>"
.Cd "options TERMINAL_NORM_ATTR=_attribute_" .Cd "options TERMINAL_NORM_ATTR=<attribute>"
.Cd "options VT_MAXWINDOWS=N" .Cd "options VT_MAXWINDOWS=<N>"
.Cd "options VT_ALT_TO_ESC_HACK=1" .Cd "options VT_ALT_TO_ESC_HACK=1"
.Cd "options VT_TWOBUTTON_MOUSE" .Cd "options VT_TWOBUTTON_MOUSE"
.Cd "options VT_FB_MAX_WIDTH=X" .Cd "options VT_FB_MAX_WIDTH=<X>"
.Cd "options VT_FB_MAX_HEIGHT=Y" .Cd "options VT_FB_MAX_HEIGHT=<Y>"
.Cd "options SC_NO_CUTPASTE" .Cd "options SC_NO_CUTPASTE"
.Cd "device vt" .Cd "device vt"
.Pp .Pp
In In
.Xr loader.conf 5 : .Xr loader.conf 5 :
.Cd hw.vga.textmode=1 .Cd "hw.vga.textmode=1"
.Cd hw.vga.acpi_ignore_no_vga=1 .Cd "hw.vga.acpi_ignore_no_vga=1"
.Cd kern.vty=vt .Cd "kern.vty=vt"
.Cd kern.vt.color.<colornum>.rgb="<colorspec>" .Cd "kern.vt.color.<colornum>.rgb=<colorspec>"
.Cd kern.vt.fb.default_mode="<X>x<Y>" .Cd "kern.vt.fb.default_mode=<X>x<Y>"
.Cd kern.vt.fb.modes.<connector>="<X>x<Y>" .Cd "kern.vt.fb.modes.<connector>=<X>x<Y>"
.Cd kern.vt.slow_down=<delay>" .Cd "kern.vt.slow_down=<delay>"
.Cd screen.font="<X>x<Y>" .Cd "screen.font=<X>x<Y>"
.Pp .Pp
In In
.Xr loader.conf 5 or .Xr loader.conf 5 or
@@ -130,8 +130,8 @@ These kernel options control the
.Nm .Nm
driver. driver.
.Bl -tag -width MAXCONS .Bl -tag -width MAXCONS
.It Dv TERMINAL_NORM_ATTR= Ns Pa attribute .It Dv TERMINAL_NORM_ATTR=<attribute>
.It Dv TERMINAL_KERN_ATTR= Ns Pa attribute .It Dv TERMINAL_KERN_ATTR=<attribute>
These options change the default colors used for normal and kernel These options change the default colors used for normal and kernel
text. text.
Available colors are defined in Available colors are defined in
@@ -139,7 +139,7 @@ Available colors are defined in
See See
.Sx EXAMPLES .Sx EXAMPLES
below. below.
.It Dv VT_MAXWINDOWS=N .It Dv VT_MAXWINDOWS=<N>
Set the number of virtual terminals to be created to Set the number of virtual terminals to be created to
.Fa N . .Fa N .
The value defaults to 12. The value defaults to 12.
@@ -152,10 +152,10 @@ In effect, this makes the right-hand mouse button perform a paste.
These options are checked in the order shown. These options are checked in the order shown.
.It Dv SC_NO_CUTPASTE .It Dv SC_NO_CUTPASTE
Disable mouse support. Disable mouse support.
.It VT_FB_MAX_WIDTH=X .It VT_FB_MAX_WIDTH=<X>
Set the maximum width to Set the maximum width to
.Fa X . .Fa X .
.It VT_FB_MAX_HEIGHT=Y .It VT_FB_MAX_HEIGHT=<Y>
Set the maximum height to Set the maximum height to
.Fa Y . .Fa Y .
.El .El
@@ -166,7 +166,7 @@ console device,
These options will be removed in a future These options will be removed in a future
.Fx .Fx
version. version.
.Bl -column -offset indent ".Sy vt VT_TWOBUTTON_MOUSE" ".Sy SC_TWOBUTTON_MOUSE" .Bl -column -offset indent "TERMINAL_KERN_ATTR" "SC_KERNEL_CONS_ATTR"
.It Sy vt Option Name Ta Sy sc Option Name .It Sy vt Option Name Ta Sy sc Option Name
.It Dv TERMINAL_KERN_ATTR Ta Dv SC_KERNEL_CONS_ATTR .It Dv TERMINAL_KERN_ATTR Ta Dv SC_KERNEL_CONS_ATTR
.It Dv TERMINAL_NORM_ATTR Ta Dv SC_NORM_ATTR .It Dv TERMINAL_NORM_ATTR Ta Dv SC_NORM_ATTR
@@ -230,7 +230,7 @@ Note that
is not compatible with is not compatible with
.Xr UEFI 8 .Xr UEFI 8
boot. boot.
.It Va kern.vt.color. Ns Ar colornum Ns Va .rgb .It Va kern.vt.color. Ns Ar colornum Ns . Ns Va rgb
Set this value to override default palette entry for color Set this value to override default palette entry for color
.Pa colornum .Pa colornum
which should be in a range from 0 to 15 inclusive. which should be in a range from 0 to 15 inclusive.
@@ -245,15 +245,15 @@ Note: The
.Nm .Nm
VGA hardware driver does not support palette configuration. VGA hardware driver does not support palette configuration.
.It Va kern.vt.fb.default_mode .It Va kern.vt.fb.default_mode
Set this value to a graphic mode to override the default mode picked by the Set this value to a graphic mode to override the default picked by the
.Nm .Nm
backend. backend.
The mode is applied to all output connectors. The mode is applied to all output connectors.
This is currently only supported by the This is currently only supported by the
.Cm vt_fb .Cm vt_fb
backend when it is paired with a KMS video driver. backend when it is paired with a KMS video driver.
.It Va kern.vt.fb.modes. Ns Pa connector_name .It Va kern.vt.fb.modes.<connector_name>
Set this value to a graphic mode to override the default mode picked by the Set this value to a graphic mode to override the default picked by the
.Nm .Nm
backend. backend.
This mode is applied to the output connector This mode is applied to the output connector