From nobody Wed Oct 04 11:23:51 2023 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 4S0slC6ySwz4vkHq; Wed, 4 Oct 2023 11:23:51 +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 4S0slC46RYz4cP6; Wed, 4 Oct 2023 11:23:51 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1696418631; 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=PAonIyeDXBBYyxq3mHdy6CSNxjZdIrp/sHtEVW5K8CQ=; b=TcwSG4Jp8mVl6LlB5rI4Ggdt8EiEu0LbnwlJNOIwCz0jhwgmpJWlvgX3eSjOV1S/+/AHnM O8LsZzxj6LxQBtdN5qKfU/H25hh8T4m5IriIu+QAOb7NNklCDgC1qe6s0irykZf0qVqRF1 +EDuJaTP+YGVInvLE85kjW41SYZuOwTKBRN9U6L9tGWd5nGeRZT0S/4Q2UigVNU3QyJ5lN WyBTtbHrSZ0BW0ryUJF2Z+4JNbQCdXcKLyEWl9UvPXCvjjSk68RCnkLyoNHOOsz/0r0mtE KcMebIrCdM23jWANV9O5xPC4s+sysqXvyO/moSumpLWGH3NaDH4A4Iv8pP2vkQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1696418631; a=rsa-sha256; cv=none; b=P6vsfrbGiZ1rPQnwg+Q+uZBCC51/F8gqxW7sOZcZJldboz1GPHmvRPONpsBeAiu/j8p7vC LnkUI8a81TES55SDQDY5cPSYbQdXLM3BSQcy0nX3scxCHbhqd4Hg5Jreq3nl5LfAo5F/hh wr+Iw16URthEgjI3H4kTEEGa/8GWeUEMYW89rdf8i8kCXRgojARj5TzWJ7TICK630GXjED nC6y4UT0B40T64+ViAHq8h+ZJPSVezfGf8IBPoMX/hr7QRvmOVed+a5wDx+k1JseFfFr78 3QAx92Mj0Dfa5cYfTE1PETL0eTCp3VTf1QQs+FfdIeMllH2Vqnd2Equh04pE/Q== 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=1696418631; 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=PAonIyeDXBBYyxq3mHdy6CSNxjZdIrp/sHtEVW5K8CQ=; b=gBu8bCWmORTlsiyeiLqFUhX2Pxyf2pk2EvTyYQ0d260vZ5+HlScmUYQCyTIRiWbiDwMTLE wdwsnqlfx5gjBfj1gGrpdsnTIJ9WP9q09ynP0WclBnn0Nb/TaLlGLpT5JNzvfeEQNlyRXf ex9vyUi/8/sZ09LlA4W04P1+4if5yd1ie8a2CWV+O/tEwIB2lxylMcDdiT0MEFzeLDPud6 r1wiFo+eJEe3lFyMNoqwqbvdt4NpbMt2qhJRGvyeyZso/RX51guhOdWJxLeprmoAHZxMiQ c37SFGlcjyX+cQMU1WIyaghTF765pwWgQrdj5hfx0FM4BhCV46RHN7cPKoaumA== 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 4S0slC2wzfzbY4; Wed, 4 Oct 2023 11:23:51 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 394BNpUA084992; Wed, 4 Oct 2023 11:23:51 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 394BNpHt084989; Wed, 4 Oct 2023 11:23:51 GMT (envelope-from git) Date: Wed, 4 Oct 2023 11:23:51 GMT Message-Id: <202310041123.394BNpHt084989@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 24319ec19e1c - stable/13 - 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/stable/13 X-Git-Reftype: branch X-Git-Commit: 24319ec19e1c44637d836f757b79aac5a29e4298 Auto-Submitted: auto-generated The branch stable/13 has been updated by 0mp: URL: https://cgit.FreeBSD.org/src/commit/?id=24319ec19e1c44637d836f757b79aac5a29e4298 commit 24319ec19e1c44637d836f757b79aac5a29e4298 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-07-19 14:28:22 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2023-10-04 11:14:05 +0000 vtfontcvt.8: Improve synopsis and -f documentation MFC after: 2 weeks (cherry picked from commit b38e3722f5df6260a4ec70c9c3cbc00ecf169129) --- 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 1c007d344650..427afb0645d3 100644 --- a/usr.bin/vtfontcvt/vtfontcvt.8 +++ b/usr.bin/vtfontcvt/vtfontcvt.8 @@ -22,7 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd August 2, 2020 +.Dd July 19, 2022 .Dt VTFONTCVT 8 .Os .Sh NAME @@ -31,7 +31,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 @@ -42,22 +42,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.