unifont-7.0.06.tar.gz
[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 .I unifont.hex
10 >
11 .I unifont-circles.hex
12 .SH DESCRIPTION
13 .B unigencircles
14 reads a unifont.hex file from STDIN, adds dashed combining
15 circles to the hex strings for code points listed in "combining.txt"
16 but not listed in "nonprinting.hex", and writes the revised set of glyphs
17 in unifont.hex format to STDOUT.  The resulting combining character glyphs
18 show the dashed combining circles that appear in The Unicode Standard
19 code charts.
20 .PP
21 For each code point listed in the "combining.txt" file but not listed
22 in the "nonprinting.hex" file,
23 .B unigencircles
24 will superimpose a single-width dashed circle in glyphs that are
25 single-width (i.e., their hex glyph strings are 32 characters long)
26 and will superimpose a double-width dashed circle in glyphs that
27 are double-width (i.e., their hex glyph strings are 64 characters long).
28 .SH EXAMPLE
29 .PP
30 .RS
31 unigencircles combining.txt nonprinting.hex < unifont.hex > unifont-circles.hex
32 .RE
33 .SH FILES
34 *.hex files for Unifont glyph data
35 .PP
36 .B font/ttfsrc/combining.txt
37 for combining code points
38 .PP
39 .B font/plane00/nonprinting.hex
40 for non-printing code points
41 .SH SEE ALSO
42 .BR bdfimplode(1),
43 .BR hex2bdf(1),
44 .BR hex2sfd(1),
45 .BR hexbraille(1),
46 .BR hexdraw(1),
47 .BR hexkinya(1),
48 .BR hexmerge(1),
49 .BR johab2ucs2(1),
50 .BR unibdf2hex(1),
51 .BR unibmp2hex(1),
52 .BR unicoverage(1),
53 .BR unidup(1),
54 .BR unifont(5),
55 .BR unifont-viewer(1),
56 .BR unifontchojung(1),
57 .BR unifontksx(1),
58 .BR unifontpic(1),
59 .BR unigenwidth(1),
60 .BR unihex2bmp(1),
61 .BR unihex2png(1),
62 .BR unihexfill(1),
63 .BR unihexgen(1),
64 .BR unipagecount(1),
65 .BR unipng2hex(1)
66 .SH AUTHOR
67 .B unigencircles
68 was written by Paul Hardy.
69 .SH LICENSE
70 .B unigencircles
71 is Copyright \(co 2013 Paul Hardy.
72 .PP
73 This program is free software; you can redistribute it and/or modify
74 it under the terms of the GNU General Public License as published by
75 the Free Software Foundation; either version 2 of the License, or
76 (at your option) any later version.
77 .SH BUGS
78 No known real bugs exist, except that this software does not perform
79 extensive error checking on its input files.