4af923cfaa24433c80ffd32847f2a5a13f399825
[unifont.git] / man / unigencircles.1
1 .TH UNIGENCIRCLES 1 "2013 Sep 28"
2 .SH NAME
3 unigencircles \- Add dashed combining circles to a unifont.hex file
4 .SH SYNOPSIS
5 .br
6 .B unigencircles
7 .I combining.txt nonprinting.hex
8 \\
9 .br
10 < unifont.hex > unifont-circles.hex
11 .SH DESCRIPTION
12 .B unigencircles
13 reads a unifont.hex file from stdin, adds dashed combining
14 circles to the hex strings for code points listed in "combining.txt"
15 but not listed in "nonprinting.hex", and writes the revised set of glyphs
16 in unifont.hex format to stdout.  The resulting combining character glyphs
17 show the dashed combining circles that appear in The Unicode Standard
18 code charts.
19 .PP
20 For each code point listed in the "combining.txt" file but not listed
21 in the "nonprinting.hex" file,
22 .B unigencircles
23 will superimpose a single-width dashed circle in glyphs that are
24 single-width (i.e., their hex glyph strings are 32 characters long)
25 and will superimpose a double-width dashed circle in glyphs that
26 are double-width (i.e., their hex glyph strings are 64 characters long).
27 .SH EXAMPLE
28 .PP
29 .RS
30 unigencircles combining.txt nonprinting.hex \\
31 .br
32 < unifont.hex > unifont-circles.hex
33 .RE
34 .SH FILES
35 *.hex files for Unifont glyph data
36 .PP
37 .B font/ttfsrc/combining.txt
38 for combining code points
39 .PP
40 .B font/hexsrc/nonprinting.hex
41 for non-printing code points
42 .SH SEE ALSO
43 .BR bdfimplode (1),
44 .BR hex2bdf (1),
45 .BR hex2sfd (1),
46 .BR hexbraille (1),
47 .BR hexdraw (1),
48 .BR hexmerge (1),
49 .BR johab2ucs2 (1),
50 .BR unibdf2hex (1),
51 .BR unifontpic (1),
52 .BR unibmp2hex (1),
53 .BR unicoverage (1),
54 .BR unidup (1),
55 .BR unifontcjhojung (1),
56 .BR unifontksx (1),
57 .BR unigenwidth (1),
58 .BR unihex2bmp (1),
59 .BR unihexgen (1),
60 .BR unipagecount (1),
61 .BR uniunmask (1)
62 .SH AUTHOR
63 .B unigencircles
64 was written by Paul Hardy.
65 .SH LICENSE
66 .B unigencircles
67 is Copyright \(co 2013 Paul Hardy, and is released under version 2 of
68 the GNU General Public License, or (at your option) a later version.
69 .SH BUGS
70 No known real bugs exist, except that this software does not perform
71 extensive error checking on its input files.