unifont-7.0.06.tar.gz
[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 functions
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 .BR wcwidth(3)
14 and
15 .BR wcswidth(3)
16 functions.  The format of these definitions is based upon
17 POSIX 1003.1-2008 System Interfaces, pages 2251 and 2241, respectively.
18 .SH EXAMPLE
19 .PP
20 Sample usage:
21 .PP
22 .RS
23 unigenwidth unifont.hex combining.txt > wccode.c
24 .RE
25 .SH FILES
26 *.hex files for Unifont glyph data; combining.txt for combining code points.
27 .SH SEE ALSO
28 .BR bdfimplode(1),
29 .BR hex2bdf(1),
30 .BR hex2sfd(1),
31 .BR hexbraille(1),
32 .BR hexdraw(1),
33 .BR hexkinya(1),
34 .BR hexmerge(1),
35 .BR johab2ucs2(1),
36 .BR unibdf2hex(1),
37 .BR unibmp2hex(1),
38 .BR unicoverage(1),
39 .BR unidup(1),
40 .BR unifont(5),
41 .BR unifont-viewer(1),
42 .BR unifontchojung(1),
43 .BR unifontksx(1),
44 .BR unifontpic(1),
45 .BR unigencircles(1),
46 .BR unihex2bmp(1),
47 .BR unihex2png(1),
48 .BR unihexfill(1),
49 .BR unihexgen(1),
50 .BR unipagecount(1),
51 .BR unipng2hex(1)
52 .SH AUTHOR
53 .B unigenwidth
54 was written by Paul Hardy.
55 .SH LICENSE
56 .B unigenwidth
57 is Copyright \(co 2013 Paul Hardy.
58 .PP
59 This program is free software; you can redistribute it and/or modify
60 it under the terms of the GNU General Public License as published by
61 the Free Software Foundation; either version 2 of the License, or
62 (at your option) any later version.
63 .SH BUGS
64 No known real bugs exist, except that this software does not perform
65 extensive error checking on its input files.