unifont-6.3.20131215.tar.gz
[unifont.git] / man / unihex2bmp.1
index 347bff46d5b72b535cd7710d8ecb5b7e8296594d..91e902d23add4b59a5d9e0f53bb84c99c3698023 100644 (file)
@@ -4,16 +4,16 @@ unihex2bmp \- GNU Unifont .hex file to bitmap graphics file converter
 .SH SYNOPSIS
 .br
 .B unihex2bmp
-[-phexpage] [-iinput_file] [-ooutput_file] [-f] [-w]
+[-phexpage] [-iinput_file.hex] [-ooutput_file.bmp] [-f] [-w]
 .SH DESCRIPTION
 .B unihex2bmp
 reads a GNU Unifont .hex file Unicode page of 256 code points
 and converts the page into a Microsoft Windows Bitmap (.bmp) or
 Wireless Bitmap (.wbmp) file.  The bitmap file displays the glyphs
 of a Unicode block of 256 code points in a 32 by 32 pixel grid.
-The glyphs themselves must be 16 rows, and either 8 columns or
+The glyphs themselves must be 16 rows high, and either 8 columns or
 16 columns wide. The default page is 0; that is, the range
-U+0000 throught U+00FF.
+U+0000 through U+00FF.
 .PP
 The bitmap can be printed.  It can also be edited with a bitmap editor.
 An edited bitmap can then be re-converted into a GNU Unifont .hex file
@@ -32,10 +32,10 @@ Unicode term.  It refers to an output bitmap graphics page of
 16 by 16 code points.
 .TP
 -i
-Specify the input file. The default is stdin.
+Specify the input file. The default is STDIN.
 .TP
 -o
-Specify the output file. The default is stdout.
+Specify the output file. The default is STDOUT.
 .TP
 -f
 "Flip" (transpose) the grid so it matches the Unicode standard order.
@@ -43,39 +43,50 @@ Specify the output file. The default is stdout.
 -w
 Produce a Wireless Bitmap format file instead of a Microsoft Windows
 Bitmap file.
+.PP
+Sample usage:
+.PP
+.RS
+unihex2bmp -imy_input_file.hex -omy_output_file.bmp
+.RE
 .SH FILES
-.TP 15
 *.hex GNU Unifont font files
 .SH SEE ALSO
-.BR bdfimplode (1),
-.BR hex2bdf (1),
-.BR hex2sfd (1),
-.BR hexbraille (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 unihexgen (1),
-.BR unipagecount (1),
-.BR uniunmask (1)
+.BR bdfimplode(1),
+.BR hex2bdf(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 unihex2png(1),
+.BR unihexgen(1),
+.BR unipagecount(1),
+.BR unipng2hex(1)
 .SH AUTHOR
 .B unihex2bmp
 was written by Paul Hardy.
 .SH LICENSE
 .B unihex2bmp
-is Copyright \(co 2007 Paul Hardy, and is released under version 2 of
-the GNU General Public License, or (at your option) a later version.
+is Copyright \(co 2007 Paul Hardy.
+.PP
+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 real bugs exist, except that this software does not perform
 extensive error checking on its input files.  If they're not in the
-format of the original GNU Unifont hex file, all bets are off.
-Lines can be terminated either with carriage return, or
+format of the original GNU Unifont .hex file, all bets are off.
+Lines can be terminated either with line feed, or
 carriage return plus line feed.