From nobody Tue Jul 19 14:37:11 2022 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 4LnLyH69gpz4TF0r; Tue, 19 Jul 2022 14:37:11 +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 "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4LnLyH5d4rz3gHZ; Tue, 19 Jul 2022 14:37:11 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1658241431; 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=4I84wK4n+ANysoRlPGTNIgkvw0qmckxlpdgFc6TNY+o=; b=aCF06Vns1RYYsmCdN71aJxZEetMj+TnOBcoAEVWhzaN9yIP0xhmM17xFrMQf6hD6RtoWxh s/CFv7BAG5XcxfwAC7Ob0oDdo1aLpCIjLXLF0Fy0NXro/IUGVqOVu8QB7gUFLURQetrVCn b4jZIBDazODqSDpEcwvaz8oszuKA6A8ydvAqAFkVk77ZxMfmuxymvJ2v39ulv3ytrihnFY facuRnatFa6oYbq0hr42yrxnV4bacozjw0htyIlbNU5QSyaXHzm71+BnGHN/8A2l0RPrvS QGGa/RDd8pnb8WFrebBmJvzSCxC+JJtlXhBqxEIKGX5F74BP8fSr1pDusVKn3w== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4LnLyH4hDDzMXg; Tue, 19 Jul 2022 14:37:11 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 26JEbBfU092383; Tue, 19 Jul 2022 14:37:11 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 26JEbB4a092382; Tue, 19 Jul 2022 14:37:11 GMT (envelope-from git) Date: Tue, 19 Jul 2022 14:37:11 GMT Message-Id: <202207191437.26JEbB4a092382@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: b38e3722f5df - main - vtfontcvt.8: Improve synopsis and -f documentation 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: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: b38e3722f5df6260a4ec70c9c3cbc00ecf169129 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1658241431; 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=4I84wK4n+ANysoRlPGTNIgkvw0qmckxlpdgFc6TNY+o=; b=G5EdUWn/ltsYB6mdNljYO9m1gPQkvNIcAc84JRuKWrHFMlfX2Hi7N5MZfKP1NrGcBbNqYn r8p56r9DvIJnIg3VbVwquhs/2lnCaWm1vMHgg6tQc5irNBCsdkPHq1UIgJrvE4J7Nj93dK wSSw3J4jYbnA3ST3HOGA0ko+NJA6TvbH2sPr44UpzFe5xbBEf4KWsw/P2eIs6Cqo2LfduG 4jXvwQ+1Wl3KxfMCevVkIlrDKd0Rx1zmysitUhr5HhchnBZGJg2WG5BSpTCLf2/hD2D6Rh EoUCFZQ5Ote1GK3De5AO3peolV9KodXsRHa4dammBWMYdqMTtrAY/aWp/zV77w== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1658241431; a=rsa-sha256; cv=none; b=pP5BZ+ei3RCwJ4D36r5FjpsLherhz06vaXdJDGlgI5l+K2Ck2UNkgOkOnFGC3FaNIjWntg KVwYS9tZMBULtC3fI1mUwCsBbqAJIg4MKd8Ru4Owv08HraSFjhgqfRvaNYQSnfounI7wHT n4umiZtGr82cTeWXYRR0k90y8MzUUq5IrgW10lczlViy3IPcngPaJdOrc7oxMz62Ru/YPr xXq8CQMRqe4vXlus10ZrBP43lHZuVFsF2XeigcJqDvQOiSgxz6Bkq2WO2d6AQJM6Ly7xXW WxruQE4ozttlaYj9x9AhT2cqujfPVeKeQUM4aXS2eswyLbkIhvYcCFusb5c+pw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by 0mp (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=b38e3722f5df6260a4ec70c9c3cbc00ecf169129 commit b38e3722f5df6260a4ec70c9c3cbc00ecf169129 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-07-19 14:28:22 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-07-19 14:35:48 +0000 vtfontcvt.8: Improve synopsis and -f documentation MFC after: 2 weeks --- usr.bin/vtfontcvt/vtfontcvt.8 | 41 +++++++++++++++++++++++++++-------------- 1 file changed, 27 insertions(+), 14 deletions(-) diff --git a/usr.bin/vtfontcvt/vtfontcvt.8 b/usr.bin/vtfontcvt/vtfontcvt.8 index a059f7589242..b913ac22485b 100644 --- a/usr.bin/vtfontcvt/vtfontcvt.8 +++ b/usr.bin/vtfontcvt/vtfontcvt.8 @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd August 2, 2020 +.Dd July 19, 2022 .Dt VTFONTCVT 8 .Os .Sh NAME @@ -33,7 +33,7 @@ .Sh SYNOPSIS .Nm .Op Fl n -.Op Fl f Ar font Ns | Ns Ar source Ns | Ns Ar compressed-source +.Op Fl f Ar format .Op Fl h Ar height .Fl o Ar output_file .Op Fl v @@ -44,22 +44,35 @@ The .Nm utility reads source font files in either BDF or Unifont HEX format and -outputs a binary font file, C source, or C source with font data compressed -by using LZ4 compression method. -The output in C source is intended to be used to embed the font into program -binary. -The binary font file is for use by -.Xr vt 4 . -HEX format files must have the file extension +outputs a file in one of the available output formats. +.Pp +HEX format files +.Po Ar normal_font +and +.Ar bold_font Pc +must have the file extension .Pa .hex . .Pp The following options are available: -.Bl -tag -width "12345678" -.It Fl f Ar font Ns | Ns Ar source Ns | Ns Ar compressed-source +.Bl -tag -width "-o output_file" +.It Fl f Ar format Specify the output format. -The default is binary -.Ar font -file. +Available formats are: +.Bl -tag -width "compressed-source" +.It Cm compressed-source +C source with font data compressed by using LZ4 compression method. +.It Cm font +A binary font file +.Pq default . +.It Cm source +C source. +.El +.Pp +The output in C source is intended to be used to embed the font into program +binary. +.Pp +The binary font file is for use by +.Xr vt 4 . .It Fl h Ar height Set font height. The default is 16.