From nobody Sun Feb 1 15:54:22 2026 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4f3vSb0xG7z6QZkn for ; Sun, 01 Feb 2026 15:54:23 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R13" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4f3vSb05R7z3dMB for ; Sun, 01 Feb 2026 15:54:23 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1769961263; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=Xoky8uN/GU5ldyGNkVJdfMPk7xU+vW/WSf4WKMYvzxs=; b=vqOYfENedXnIlwTTbWc9bNVbC//wgvysNlryk1bFEwgGt6CcYk9kRAFwHPrNOU8rK4NB5X ncGyFddXBCJA0wHWK1gCUdhvKml07hCpaVbp+X8H2qKryY2VNd0oOgWvQ0ytdTtsUMEDge i+S/8ni3w6oBAHMgOlO6QH+ZzOV75LsQkKxKchkevXBoquM4nP3xhTMvMXvBZ7Jj6Wc9SY Ogu97sETNfC0/k3zZ0VC3Rfw1LH2LjCjTHvQe525IpNrwUevNPH3KXj6ZDSwjCyKjIQdm8 WSzw48aa34/ptK7sLk5KQOztGkfAbotU+kgI3q78E4SqOPsT87ykrDkFNuFtxg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1769961263; a=rsa-sha256; cv=none; b=QnGEs8ETXFVo9gzXJvcs5CgyVQeN8HYvTi2Oy8YwABCejs3+TyQuxq5SvIGVT0ucAC52BD 1kO4AOM6drBKkKlU3oaahRP82OksMSIJSICiT68vgq7wKvlp2w+e1FnTcWdoiRRll4ex1Z wVXFqppwdil67UV3IRb/bAJhioilfJH6udZp6hFHP5e9YZJHIGDkh/2VQ1WsHC3Vu5zklz y76mvyf7VlyxioxwBrrpWZdKAUuM25wu+uWVh4di9lgkPzef2J9BYM1q0g3Ozta98ikEn9 LEVTOJUdYZenfnME6KBIgJZW34CggjA/OaYq+y/KMoYtNBdJw2s+8aHJpi8Tyw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1769961263; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=Xoky8uN/GU5ldyGNkVJdfMPk7xU+vW/WSf4WKMYvzxs=; b=IUW+c5tQ/g1+SCS9jvbC5bBoxZ9dPqUxCKzIQwkc/vI3dgzYAJi1RBhKl3h2OxSranXqyf 5LqPDqJrjUJY3osggnzU17K3ou29D2k9HU9mcFsVPS11P2o8zHSWwNnvnp6xZay4TpkhWc w4foRhx44RUfN7qPNQ8aFm9/Huv1StK82q4l1S5e30KAa6Eoc9BWMnS+4FeG0N6uzCE8Qj s0Dry5GeLKju7D67mZ98l/LqxBQ9uYIi+ZuUa+liRMvKlk4dHCN8Kf1hcrfr2Jq44KofH6 kRCL1D5ZNXLYoRvMSYkIjA8kkTuFbkXEkLdiAJJHvkXPh5zQ24lbxZVFFbUBbw== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4f3vSZ6n24znF5 for ; Sun, 01 Feb 2026 15:54:22 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 3fbd7 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Sun, 01 Feb 2026 15:54:22 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Alexander Ziaee Subject: git: a97ed3a39c10 - main - vt.4: Sprinkle mdoc macros List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ziaee X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: a97ed3a39c1044dd1b8056d68a76de74821f2bff Auto-Submitted: auto-generated Date: Sun, 01 Feb 2026 15:54:22 +0000 Message-Id: <697f772e.3fbd7.31b3f523@gitrepo.freebsd.org> The branch main has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=a97ed3a39c1044dd1b8056d68a76de74821f2bff commit a97ed3a39c1044dd1b8056d68a76de74821f2bff Author: Alexander Ziaee AuthorDate: 2026-02-01 00:16:34 +0000 Commit: Alexander Ziaee 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=" -.Cd "options TERMINAL_NORM_ATTR=" -.Cd "options VT_MAXWINDOWS=" -.Cd "options VT_ALT_TO_ESC_HACK=1" -.Cd "options VT_TWOBUTTON_MOUSE" -.Cd "options VT_FB_MAX_WIDTH=" -.Cd "options VT_FB_MAX_HEIGHT=" -.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..rgb=" -.Cd "kern.vt.fb.default_mode=x" -.Cd "kern.vt.fb.modes.=x" -.Cd "kern.vt.slow_down=" -.Cd "screen.font=x" +.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= -.It Dv TERMINAL_KERN_ATTR= +.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= +.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= +.It VT_FB_MAX_WIDTH= Ns Ao Ar X Ac Set the maximum width to .Fa X . -.It VT_FB_MAX_HEIGHT= +.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. +.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.