From nobody Thu Feb 5 21:51:31 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 4f6WBr00btz6RG2S for ; Thu, 05 Feb 2026 21:51:32 +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 4f6WBq4v71z3Kdy for ; Thu, 05 Feb 2026 21:51:31 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1770328291; 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=3Y8xgxYEkhrYmRkvg+L5Ksek9qAFytdxdQg2VAmaEbA=; b=pMFPbixbQQvcWb9k49eZXi41DtjA2x+H+4/2NQC07qfcxtyckH742EPosPQwYa87mspEbU OjlqoKMsV+zwHAiM+gSvCEmvFInyl7leF5gc6NfTshPBmiENxNhis2RrPnEdDbS7iPLpWP T7cDh7etHRQc83wdNxYeOz4W8ymhTzmjvVNbTfbwP4IrshPrD6tIq/8Qk3BmftjfUoHOUS wLgHt9wxgfpD58QR3NLrjvzadSa9yOlv8kod9vqHFMXpp7eqi3gNdLw758vEyJIVt1dUfB g0ADTNmEJnX46cOveF0wzrq3u7ZctgFIM9G6ERowkEhynlpMQgBMxi9f/kE63g== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1770328291; a=rsa-sha256; cv=none; b=q8VToWFu1rg+AH8+pHo3yacXONDOe/KemTSCLLv1ocoIv8CxQAf9ABIpCQcGj38fEuJ7JD Bn3sqEB9gx78W/5EffKn5Nb/rnJpYU1K1cKPxnhQcS6cXJLgMA6jWWMR0vkaKo4UTPswKJ djscSI+47ePLj7cl1B9pZDhOuHYgesjhTO7tnxtMlQsiDYldJTMj990elkYnNdrzCr6fer khZEaykDNkoI8ZDYEK5o24wkwKxY7H6CurwX50IPVJkaZAOFGiKGz6yyMiL9TXzwYUQfQH TsIB8hjFfH/oOLOOn4pNS1hMUOot/58/6TOfpKk5OmT6nW2zQW0xCjH2uFXZnQ== 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=1770328291; 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=3Y8xgxYEkhrYmRkvg+L5Ksek9qAFytdxdQg2VAmaEbA=; b=WKIo3xVvOKibCqyVRmO1JoL/DMVGpaJPrbClFyrq/AoK5rOjZ6EZslSJ/nfbWhmprF69Zs vxERHOjzyW7vvFhxIhdvd1pb6JUf37jp+QHxo0GgR/jE8nh2Aygt5Y3cSJTyOKNhVcvLTk FTu1A5CUlgxHIGSu/Aqme7cdc1Fp/wKKg7MrU9LDTSgvN/AnT1NGTFtH25yYB4UNnFMrlF RddcTJt3xkqJDiHdjKIKLPe0TEgWUTo5vlh7R01rc6vPHe6DDVD4v+0JYvF4UrStQRfY86 1zc/ophv+AV8bnM6ZVE3Q4CET7BQZXucYiyzS1gGeoW2qgWTZGjiORObxm9nMA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4f6WBq4MDPznvd for ; Thu, 05 Feb 2026 21:51:31 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 18fab by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Thu, 05 Feb 2026 21:51:31 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Alexander Ziaee Subject: git: 51cb927eb716 - stable/15 - 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/stable/15 X-Git-Reftype: branch X-Git-Commit: 51cb927eb71682f5dfcebdaa56b6f95623b6038a Auto-Submitted: auto-generated Date: Thu, 05 Feb 2026 21:51:31 +0000 Message-Id: <698510e3.18fab.37b28069@gitrepo.freebsd.org> The branch stable/15 has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=51cb927eb71682f5dfcebdaa56b6f95623b6038a commit 51cb927eb71682f5dfcebdaa56b6f95623b6038a Author: Alexander Ziaee AuthorDate: 2026-02-01 00:16:34 +0000 Commit: Alexander Ziaee CommitDate: 2026-02-05 21:50:46 +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) (cherry picked from commit a97ed3a39c1044dd1b8056d68a76de74821f2bff) --- 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.