unifont-7.0.06.tar.gz
[unifont.git] / doc / unipagecount.texi
1 @comment TROFF INPUT: .TH UNIPAGECOUNT 1 "2007 Dec 31"
2
3 @node unipagecount
4 @section unipagecount
5 @c DEBUG: print_menu("@section")
6
7 @menu
8 * unipagecount NAME::
9 * unipagecount SYNOPSIS::
10 * unipagecount DESCRIPTION::
11 * unipagecount OPTIONS::
12 * unipagecount FILES::
13 * unipagecount SEE ALSO::
14 * unipagecount AUTHOR::
15 * unipagecount LICENSE::
16 * unipagecount BUGS::
17
18 @end menu
19
20
21 @comment TROFF INPUT: .SH NAME
22
23 @node unipagecount NAME
24 @subsection unipagecount NAME
25 @c DEBUG: print_menu("unipagecount NAME")
26
27 unipagecount @minus{} Count the assigned code points in a GNU Unifont .hex file
28 @comment TROFF INPUT: .SH SYNOPSIS
29
30 @node unipagecount SYNOPSIS
31 @subsection unipagecount SYNOPSIS
32 @c DEBUG: print_menu("unipagecount SYNOPSIS")
33
34 @comment TROFF INPUT: .br
35 @comment .br
36 @comment TROFF INPUT: .B unipagecount
37 @b{unipagecount}
38 [-ppagenum] [-h|-l]
39 @comment TROFF INPUT: .SH DESCRIPTION
40
41 @node unipagecount DESCRIPTION
42 @subsection unipagecount DESCRIPTION
43 @c DEBUG: print_menu("unipagecount DESCRIPTION")
44
45 @comment TROFF INPUT: .B unipagecount
46 @b{unipagecount}
47 reads a GNU Unifont .hex file from STDIN and prints a 16 by 16 grid of the
48 number of defined code points in each 256 character block within a Unicode
49 plane to STDOUT.  Code points proceed from left to right, then top to bottom.
50 In all planes, code points U+*FFFE and U+*FFFF are not expected in the input
51 hex file; they are reserved and always counted as being present in a plane.
52 @comment TROFF INPUT: .SH OPTIONS
53
54 @node unipagecount OPTIONS
55 @subsection unipagecount OPTIONS
56 @c DEBUG: print_menu("unipagecount OPTIONS")
57
58 @comment TROFF INPUT: .TP 12
59
60 @c ---------------------------------------------------------------------
61 @table @code
62 @item -Pplanenum
63 Select a Unicode plane, from 0 through 16, inclusive.  If not specified,
64 @comment TROFF INPUT: .B unipagecount
65 @b{unipagecount}
66 defaults to Plane 0 (the Basic Multilingual Plane).
67 @comment TROFF INPUT: .TP
68
69 @item -ppagenum
70 Just print information on one 256 code point "page" rather than
71 the entire Basic Multilingual Plane.  This prints a 16 by 16 table with
72 an asterisk in every code point that has an assigned glyph.
73 @comment TROFF INPUT: .TP
74
75 @item -h
76 Print an HTML table with color-coded cell background colors
77 instead of a plain text table.
78 @comment TROFF INPUT: .TP
79
80 @item -l
81 [The letter "l"]: Print hyperlinks to font bitmaps in the HTML table.
82 To create the bitmaps themselves, use the
83 @comment TROFF INPUT: .B unihex2bmp
84 @b{unihex2bmp}
85 program.  The bitmaps are assumed to be in the directory "bmp/".
86 @comment TROFF INPUT: .SH FILES
87
88 @end table
89
90 @c ---------------------------------------------------------------------
91
92 @node unipagecount FILES
93 @subsection unipagecount FILES
94 @c DEBUG: print_menu("unipagecount FILES")
95
96 *.hex GNU Unifont font files
97 @comment TROFF INPUT: .SH SEE ALSO
98
99 @node unipagecount SEE ALSO
100 @subsection unipagecount SEE ALSO
101 @c DEBUG: print_menu("unipagecount 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 unihexgen(1),
148 @b{unihexgen(1),}
149 @comment TROFF INPUT: .BR unipng2hex(1)
150 @b{unipng2hex(1)}
151 @comment TROFF INPUT: .SH AUTHOR
152
153 @node unipagecount AUTHOR
154 @subsection unipagecount AUTHOR
155 @c DEBUG: print_menu("unipagecount AUTHOR")
156
157 @comment TROFF INPUT: .B unipagecount
158 @b{unipagecount}
159 was written by Paul Hardy.
160 @comment TROFF INPUT: .SH LICENSE
161
162 @node unipagecount LICENSE
163 @subsection unipagecount LICENSE
164 @c DEBUG: print_menu("unipagecount LICENSE")
165
166 @comment TROFF INPUT: .B unipagecount
167 @b{unipagecount}
168 is Copyright @copyright{} 2007, 2014 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 unipagecount BUGS
178 @subsection unipagecount BUGS
179 @c DEBUG: print_menu("unipagecount BUGS")
180
181 No known real bugs exist, except that this software does not perform
182 extensive error checking on its input files.  If they're not in the
183 format of the original GNU Unifont .hex file, all bets are off.