git: b38e3722f5df - main - vtfontcvt.8: Improve synopsis and -f documentation
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Tue, 19 Jul 2022 14:37:11 UTC
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.