unifont-7.0.06.tar.gz
[unifont.git] / doc / unihexgen.texi
1 @comment TROFF INPUT: .TH UNIHEXGEN 1 "2013 Sep 03"
2
3 @node unihexgen
4 @section unihexgen
5 @c DEBUG: print_menu("@section")
6
7 @menu
8 * unihexgen NAME::
9 * unihexgen SYNOPSIS::
10 * unihexgen DESCRIPTION::
11 * unihexgen OPTIONS::
12 * unihexgen FILES::
13 * unihexgen EXAMPLE::
14 * unihexgen SEE ALSO::
15 * unihexgen AUTHOR::
16 * unihexgen LICENSE::
17 * unihexgen BUGS::
18
19 @end menu
20
21
22 @comment TROFF INPUT: .SH NAME
23
24 @node unihexgen NAME
25 @subsection unihexgen NAME
26 @c DEBUG: print_menu("unihexgen NAME")
27
28 unihexgen @minus{} Generate Unifont 4- or 6-digit hexadecimal glyphs
29 @comment TROFF INPUT: .SH SYNOPSIS
30
31 @node unihexgen SYNOPSIS
32 @subsection unihexgen SYNOPSIS
33 @c DEBUG: print_menu("unihexgen SYNOPSIS")
34
35 @comment TROFF INPUT: .br
36 @comment .br
37 @comment TROFF INPUT: .B unihexgen
38 @b{unihexgen}
39 @comment TROFF INPUT: .I startpoint endpoint
40 @i{startpoint endpoint}
41 @comment TROFF INPUT: .SH DESCRIPTION
42
43 @node unihexgen DESCRIPTION
44 @subsection unihexgen DESCRIPTION
45 @c DEBUG: print_menu("unihexgen DESCRIPTION")
46
47 @comment TROFF INPUT: .B unihexgen
48 @b{unihexgen}
49 produces unifont.hex entries in the Unicode code point range
50 @comment TROFF INPUT: .I startpoint
51 @i{startpoint}
52 to
53 @comment TROFF INPUT: .I endpoint
54 @i{endpoint}
55 (specified as the two command-line arguments).
56 Output is to STDOUT.  If a codepoint is less than or equal to
57 "FFFF" (i.e., 0xFFFF), a four-digit hexadecimal number is encoded
58 within the corresponding Unifont glyph as two digits on each of
59 two rows.  Otherwise, a six-digit hexadecimal number is encoded as
60 three digits on each of two rows.
61 @comment TROFF INPUT: .SH OPTIONS
62
63 @node unihexgen OPTIONS
64 @subsection unihexgen OPTIONS
65 @c DEBUG: print_menu("unihexgen OPTIONS")
66
67 There are no options.
68 @comment TROFF INPUT: .SH FILES
69
70 @node unihexgen FILES
71 @subsection unihexgen FILES
72 @c DEBUG: print_menu("unihexgen FILES")
73
74 *.hex as output.
75 @comment TROFF INPUT: .SH EXAMPLE
76
77 @node unihexgen EXAMPLE
78 @subsection unihexgen EXAMPLE
79 @c DEBUG: print_menu("unihexgen EXAMPLE")
80
81 To generate the Private Use Area glyphs in the Unicode range
82 U+E000..U+F8FF, invoke unihexgen with these arguments:
83 @comment TROFF INPUT: .PP
84
85 @comment TROFF INPUT: .RS
86
87 @c ---------------------------------------------------------------------
88 @quotation
89 @comment TROFF INPUT: .B unihexgen
90 @b{unihexgen}
91 e000 f8ff
92 @comment TROFF INPUT: .RE
93
94 @end quotation
95
96 @c ---------------------------------------------------------------------
97 @comment TROFF INPUT: .SH SEE ALSO
98
99 @node unihexgen SEE ALSO
100 @subsection unihexgen SEE ALSO
101 @c DEBUG: print_menu("unihexgen SEE ALSO")
102
103 @comment TROFF INPUT: .BR bdfimplode(1),
104 @b{bdfimplode(1),}
105 @comment TROFF INPUT: .BR hex2bdf(1),
106 @b{hex2bdf(1),}
107 @comment TROFF INPUT: .BR hex2sfd(1),
108 @b{hex2sfd(1),}
109 @comment TROFF INPUT: .BR hexbraille(1),
110 @b{hexbraille(1),}
111 @comment TROFF INPUT: .BR hexdraw(1),
112 @b{hexdraw(1),}
113 @comment TROFF INPUT: .BR hexkinya(1),
114 @b{hexkinya(1),}
115 @comment TROFF INPUT: .BR hexmerge(1),
116 @b{hexmerge(1),}
117 @comment TROFF INPUT: .BR johab2ucs2(1),
118 @b{johab2ucs2(1),}
119 @comment TROFF INPUT: .BR unibdf2hex(1),
120 @b{unibdf2hex(1),}
121 @comment TROFF INPUT: .BR unibmp2hex(1),
122 @b{unibmp2hex(1),}
123 @comment TROFF INPUT: .BR unicoverage(1),
124 @b{unicoverage(1),}
125 @comment TROFF INPUT: .BR unidup(1),
126 @b{unidup(1),}
127 @comment TROFF INPUT: .BR unifont(5),
128 @b{unifont(5),}
129 @comment TROFF INPUT: .BR unifont-viewer(1),
130 @b{unifont-viewer(1),}
131 @comment TROFF INPUT: .BR unifontchojung(1),
132 @b{unifontchojung(1),}
133 @comment TROFF INPUT: .BR unifontksx(1),
134 @b{unifontksx(1),}
135 @comment TROFF INPUT: .BR unifontpic(1),
136 @b{unifontpic(1),}
137 @comment TROFF INPUT: .BR unigencircles(1),
138 @b{unigencircles(1),}
139 @comment TROFF INPUT: .BR unigenwidth(1),
140 @b{unigenwidth(1),}
141 @comment TROFF INPUT: .BR unihex2bmp(1),
142 @b{unihex2bmp(1),}
143 @comment TROFF INPUT: .BR unihex2png(1),
144 @b{unihex2png(1),}
145 @comment TROFF INPUT: .BR unihexfill(1),
146 @b{unihexfill(1),}
147 @comment TROFF INPUT: .BR unipagecount(1),
148 @b{unipagecount(1),}
149 @comment TROFF INPUT: .BR unipng2hex(1)
150 @b{unipng2hex(1)}
151 @comment TROFF INPUT: .SH AUTHOR
152
153 @node unihexgen AUTHOR
154 @subsection unihexgen AUTHOR
155 @c DEBUG: print_menu("unihexgen AUTHOR")
156
157 @comment TROFF INPUT: .B unihexgen
158 @b{unihexgen}
159 was written by Paul Hardy.
160 @comment TROFF INPUT: .SH LICENSE
161
162 @node unihexgen LICENSE
163 @subsection unihexgen LICENSE
164 @c DEBUG: print_menu("unihexgen LICENSE")
165
166 @comment TROFF INPUT: .B unihexgen
167 @b{unihexgen}
168 is Copyright @copyright{} 2013 Paul Hardy.
169 @comment TROFF INPUT: .PP
170
171 This program is free software; you can redistribute it and/or modify
172 it under the terms of the GNU General Public License as published by
173 the Free Software Foundation; either version 2 of the License, or
174 (at your option) any later version.
175 @comment TROFF INPUT: .SH BUGS
176
177 @node unihexgen BUGS
178 @subsection unihexgen BUGS
179 @c DEBUG: print_menu("unihexgen BUGS")
180
181 No known real bugs exist, except that this software does not perform
182 extensive error checking on its command-line arguments.  If they're not
183 in the format of the original bitmapped output from
184 @comment TROFF INPUT: .B unihexgen,
185 @b{unihexgen,}
186 all bets are off.