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: 7cd6da268a (vt.4: Style pass)
This commit is contained in:
+35
-35
@@ -32,38 +32,38 @@
|
|||||||
.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= Ns Ao Ar attribute Ac
|
||||||
.Cd "options TERMINAL_NORM_ATTR=<attribute>"
|
.Cd options TERMINAL_NORM_ATTR= Ns Ao Ar attribute Ac
|
||||||
.Cd "options VT_MAXWINDOWS=<N>"
|
.Cd options VT_MAXWINDOWS= Ns Ao Ar N Ac
|
||||||
.Cd "options VT_ALT_TO_ESC_HACK=1"
|
.Cd options VT_ALT_TO_ESC_HACK= Ns Ar 1
|
||||||
.Cd "options VT_TWOBUTTON_MOUSE"
|
.Cd options VT_TWOBUTTON_MOUSE
|
||||||
.Cd "options VT_FB_MAX_WIDTH=<X>"
|
.Cd options VT_FB_MAX_WIDTH= Ns Ao Ar X Ac
|
||||||
.Cd "options VT_FB_MAX_HEIGHT=<Y>"
|
.Cd options VT_FB_MAX_HEIGHT= Ns Ao Ar Y Ac
|
||||||
.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= Ns Ar 1
|
||||||
.Cd "hw.vga.acpi_ignore_no_vga=1"
|
.Cd hw.vga.acpi_ignore_no_vga= Ns Ar 1
|
||||||
.Cd "kern.vty=vt"
|
.Cd kern.vty= Ns Ar vt
|
||||||
.Cd "kern.vt.color.<colornum>.rgb=<colorspec>"
|
.Cd kern.vt.color. Ns Ao Ar colornum Ac Ns .rgb= Ns Ao Ar colorspec Ac
|
||||||
.Cd "kern.vt.fb.default_mode=<X>x<Y>"
|
.Cd kern.vt.fb.default_mode= Ns Ao Ar X Ac Ns x Ns Ao Ar Y Ac
|
||||||
.Cd "kern.vt.fb.modes.<connector>=<X>x<Y>"
|
.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=<delay>"
|
.Cd kern.vt.slow_down= Ns Ao Ar delay Ac
|
||||||
.Cd "screen.font=<X>x<Y>"
|
.Cd screen.font= Ns Ao Ar X Ac Ns x Ns Ao Ar Y Ac
|
||||||
.Pp
|
.Pp
|
||||||
In
|
In
|
||||||
.Xr loader.conf 5 or
|
.Xr loader.conf 5 or
|
||||||
.Xr sysctl.conf 5 :
|
.Xr sysctl.conf 5 :
|
||||||
.Cd kern.consmute=1
|
.Cd kern.consmute= Ns Ar 1
|
||||||
.Cd kern.vt.kbd_halt=1
|
.Cd kern.vt.kbd_halt= Ns Ar 1
|
||||||
.Cd kern.vt.kbd_poweroff=1
|
.Cd kern.vt.kbd_poweroff= Ns Ar 1
|
||||||
.Cd kern.vt.kbd_reboot=1
|
.Cd kern.vt.kbd_reboot= Ns Ar 1
|
||||||
.Cd kern.vt.kbd_debug=1
|
.Cd kern.vt.kbd_debug= Ns Ar 1
|
||||||
.Cd kern.vt.kbd_panic=0
|
.Cd kern.vt.kbd_panic= Ns Ar 0
|
||||||
.Cd kern.vt.enable_altgr=0
|
.Cd kern.vt.enable_altgr= Ns Ar 0
|
||||||
.Cd kern.vt.enable_bell=1
|
.Cd kern.vt.enable_bell= Ns Ar 1
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
@@ -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=<attribute>
|
.It Dv TERMINAL_NORM_ATTR= Ns Ao Ar attribute Ac
|
||||||
.It Dv TERMINAL_KERN_ATTR=<attribute>
|
.It Dv TERMINAL_KERN_ATTR= Ns Ao Ar attribute Ac
|
||||||
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,11 +139,11 @@ Available colors are defined in
|
|||||||
See
|
See
|
||||||
.Sx EXAMPLES
|
.Sx EXAMPLES
|
||||||
below.
|
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
|
Set the number of virtual terminals to be created to
|
||||||
.Fa N .
|
.Fa N .
|
||||||
The value defaults to 12.
|
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
|
When the Alt key is held down while pressing another key, send an ESC
|
||||||
sequence instead of the Alt key.
|
sequence instead of the Alt key.
|
||||||
.It Dv VT_TWOBUTTON_MOUSE
|
.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.
|
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= Ns Ao Ar X Ac
|
||||||
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= Ns Ao Ar Y Ac
|
||||||
Set the maximum height to
|
Set the maximum height to
|
||||||
.Fa Y .
|
.Fa Y .
|
||||||
.El
|
.El
|
||||||
@@ -206,7 +206,7 @@ BIOS boot.
|
|||||||
Features that require graphics mode, like loadable fonts, will be
|
Features that require graphics mode, like loadable fonts, will be
|
||||||
disabled.
|
disabled.
|
||||||
.Pp
|
.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.
|
graphics mode.
|
||||||
Moreover this tunable has no effect with
|
Moreover this tunable has no effect with
|
||||||
.Xr UEFI 8
|
.Xr UEFI 8
|
||||||
@@ -234,9 +234,9 @@ 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 . Ns Va rgb
|
.It Va kern.vt.color . Ns Ar colornum . 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
|
.Ar colornum
|
||||||
which should be in a range from 0 to 15 inclusive.
|
which should be in a range from 0 to 15 inclusive.
|
||||||
The value should be either a comma-separated triplet of
|
The value should be either a comma-separated triplet of
|
||||||
red, green, and blue values in a range from 0 to 255 or
|
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
|
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.<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
|
Set this value to a graphic mode to override the default picked by the
|
||||||
.Nm
|
.Nm
|
||||||
backend.
|
backend.
|
||||||
|
|||||||
Reference in New Issue
Block a user