bba2384d3b2422835e5e7bfde118387208fcc143
[unifont.git] / man / unigenwidth.1
1 .TH UNIGENWIDTH 1 "2013 Sep 10"
2 .SH NAME
3 unigenwidth \- Generate C code for POSIX wcwidth() and wcswidth()
4 .SH SYNOPSIS
5 .br
6 .B unigenwidth
7 .I unifont.hex combining.txt
8 .SH DESCRIPTION
9 .B unigenwidth
10 reads a collection of glyphs in Unifont's .hex format,
11 then reads a list of combining characters as a hexadecimal list.
12 From these two files, it produces C code to implement the POSIX
13 wcwidth(3) and wcswidth(3) functions.  The format of these definitions
14 is based upon POSIX 1003.1-2008 System Interfaces, pages 2251 and 2241,
15 respectively.
16 .SH EXAMPLE
17 .PP
18 Sample usage:
19 .PP
20 .RS
21 unigenwidth unifont.hex combining.txt > wccode.c
22 .RE
23 .SH FILES
24 .TP 15
25 *.hex files for Unifont glyph data; combining.txt for combining code points.
26 .SH SEE ALSO
27 .BR bdfimplode (1),
28 .BR hex2bdf (1),
29 .BR hex2sfd (1),
30 .BR hexbraille (1),
31 .BR hexdraw (1),
32 .BR hexmerge (1),
33 .BR johab2ucs2 (1),
34 .BR unibdf2hex (1),
35 .BR unifontpic (1),
36 .BR unibmp2hex (1),
37 .BR unicoverage (1),
38 .BR unidup (1),
39 .BR unifontcjhojung (1),
40 .BR unifontksx (1),
41 .BR unigencircles (1),
42 .BR unihex2bmp (1),
43 .BR unihexgen (1),
44 .BR unipagecount (1),
45 .BR uniunmask (1)
46 .SH AUTHOR
47 .B unigenwidth
48 was written by Paul Hardy.
49 .SH LICENSE
50 .B unigenwidth
51 is Copyright \(co 2013 Paul Hardy, and is released under version 2 of
52 the GNU General Public License, or (at your option) a later version.
53 .SH BUGS
54 No known real bugs exist, except that this software does not perform
55 extensive error checking on its input files.