unifont-6.3.20131215.tar.gz

[unifont.git] / man / hex2bdf.1

diff --git a/man/hex2bdf.1 b/man/hex2bdf.1
index 717f5de0708054603e18271fc00a330cc22e95e9..62169f4ec2d3978dc3a1c420982650ce02a08c49 100644 (file)
--- a/man/hex2bdf.1
+++ b/man/hex2bdf.1
@@ -12,43 +12,72 @@ hex2bdf \- Convert a GNU Unifont .hex file into a BDF font
 .B hex2bdf
 reads a sorted GNU Unifont .hex file (sorted with the Unix
 .B sort
-utility) from stdin and writes a BDF version of the font
-to stdout.
+utility) from STDIN and writes a BDF version of the font
+to STDOUT.
+.SH OPTIONS
+.TP 12
+-f "font-name"
+Specify the target font name.  If omitted, the default
+font name "Unifont" is assigned.
+.TP
+-v "font-version"
+Specify the target font version.  If omitted, the default
+version "1.0" is assigned.
+.TP
+-c "font-copyright"
+Specify the target font copyright information.  The default
+is the null string.
+.TP
+-r <pixel-rows> 
+Specify how many pixel rows tall a glyph is.  The default
+is the traditional Unifont 16 rows of pixels.  This is an
+addition to support
+.B unihex2png(1)
+and
+.B unipng2hex(1),
+which allow designing glyphs that are 16, 24, or 32
+pixel rows tall.
+.SH EXAMPLE
+Sample usage:
 .PP
+.RS
+hex2bdf -f "Unifont" -c "(C) 2013..." unifont.hex > unifont.bdf
+.RE
 .SH FILES
-.TP 15
 *.hex GNU Unifont font files
 .SH SEE ALSO
-.BR bdfimplode (1),
-.BR hexbraille (1),
-.BR hex2sfd (1),
-.BR hexdraw (1),
-.BR hexmerge (1),
-.BR johab2ucs2 (1),
-.BR unibdf2hex (1),
-.BR unifontpic (1),
-.BR unibmp2hex (1),
-.BR unicoverage (1),
-.BR unidup (1),
-.BR unifontchojung (1),
-.BR unifontksx (1),
-.BR unigencircles (1),
-.BR unigenwidth (1),
-.BR unihex2bmp (1),
-.BR unihexgen (1),
-.BR unipagecount (1),
-.BR uniunmask (1)
+.BR bdfimplode(1),
+.BR hex2sfd(1),
+.BR hexbraille(1),
+.BR hexdraw(1),
+.BR hexmerge(1),
+.BR johab2ucs2(1),
+.BR unibdf2hex(1),
+.BR unibmp2hex(1),
+.BR unicoverage(1),
+.BR unidup(1),
+.BR unifont(5),
+.BR unifontchojung(1),
+.BR unifontksx(1),
+.BR unifontpic(1),
+.BR unigencircles(1),
+.BR unigenwidth(1),
+.BR unihex2bmp(1),
+.BR unihex2png(1),
+.BR unihexgen(1),
+.BR unipagecount(1),
+.BR unipng2hex(1)
 .SH AUTHOR
 .B hex2bdf
 was written by Roman Czyborra.
 .SH LICENSE
 .B hex2bdf
-is Copyright \(co 1998 Roman Czyborra, and is released under the following
-terms (taken from http://czyborra.com/):
+is Copyright \(co 1998 Roman Czyborra.
 .PP
-"All of my works you find here are freeware. You may freely copy, use, quote,
-modify or redistribute them as long as you properly attribute my contribution
-and have given a quick thought about whether Roman might perhaps be interested
-to read what you did with his stuff. Horizontal rules don't apply."
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2 of the License, or
+(at your option) any later version.
 .SH BUGS
-No known bugs exist.
+No known bugs exist.  Support for glyph heights other than 16 pixels is
+brand new and has not been extensively tested.