Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 4 Oct 2023 11:23:51 GMT
From:      Mateusz Piotrowski <0mp@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org
Subject:   git: 24319ec19e1c - stable/13 - vtfontcvt.8: Improve synopsis and -f documentation
Message-ID:  <202310041123.394BNpHt084989@gitrepo.freebsd.org>

next in thread | raw e-mail | index | archive | help
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.



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202310041123.394BNpHt084989>