unifont-7.0.06.tar.gz
[unifont.git] / man / unipagecount.1
index 3ec3933fbb07cfd0323151cecd04cc48796b2ef9..25aa5aabdb4a980b58bdc317f4a5c776010091ab 100644 (file)
@@ -7,12 +7,17 @@ unipagecount \- Count the assigned code points in a GNU Unifont .hex file
 [-ppagenum] [-h|-l]
 .SH DESCRIPTION
 .B unipagecount
-reads a GNU Unifont .hex file from stdin and prints a 16 by 16 grid of the
-number of defined code points in each 256 character block to stdout.
-Code points proceed from left to right, then top to bottom.
-.PP
+reads a GNU Unifont .hex file from STDIN and prints a 16 by 16 grid of the
+number of defined code points in each 256 character block within a Unicode
+plane to STDOUT.  Code points proceed from left to right, then top to bottom.
+In all planes, code points U+*FFFE and U+*FFFF are not expected in the input
+hex file; they are reserved and always counted as being present in a plane.
 .SH OPTIONS
 .TP 12
+-Pplanenum
+Select a Unicode plane, from 0 through 16, inclusive.  If not specified,
+.B unipagecount
+defaults to Plane 0 (the Basic Multilingual Plane).
 .TP
 -ppagenum
 Just print information on one 256 code point "page" rather than
@@ -24,40 +29,49 @@ Print an HTML table with color-coded cell background colors
 instead of a plain text table.
 .TP
 -l
-[The letter "l" ]: Print hyperlink to font bitmaps in the HTML table.
-To create the bitmaps themselves, use the unihex2bmp program.
-The bitmaps are assumed to be in the directory "bmp/".
+[The letter "l"]: Print hyperlinks to font bitmaps in the HTML table.
+To create the bitmaps themselves, use the
+.B unihex2bmp
+program.  The bitmaps are assumed to be in the directory "bmp/".
 .SH FILES
-.TP 15
 *.hex GNU Unifont font files
 .SH SEE ALSO
-.BR bdfimplode (1),
-.BR hex2bdf (1),
-.BR hex2sfd (1),
-.BR hexbraille (1),
-.BR hexdraw (1),
-.BR hexmerge (1),
-.BR johab2ucs2 (1),
-.BR unibdf2hex (1),
-.BR unifontpic (1),
-.BR unibmp2hex (1),
-.BR unicoverage (1),
-.BR unidup (1),
-.BR unifontchojung (1),
-.BR unifontksx (1),
-.BR unigencircles (1),
-.BR unigenwidth (1),
-.BR unihex2bmp (1),
-.BR unihexgen (1),
-.BR uniunmask (1)
+.BR bdfimplode(1),
+.BR hex2bdf(1),
+.BR hex2sfd(1),
+.BR hexbraille(1),
+.BR hexdraw(1),
+.BR hexkinya(1),
+.BR hexmerge(1),
+.BR johab2ucs2(1),
+.BR unibdf2hex(1),
+.BR unibmp2hex(1),
+.BR unicoverage(1),
+.BR unidup(1),
+.BR unifont(5),
+.BR unifont-viewer(1),
+.BR unifontchojung(1),
+.BR unifontksx(1),
+.BR unifontpic(1),
+.BR unigencircles(1),
+.BR unigenwidth(1),
+.BR unihex2bmp(1),
+.BR unihex2png(1),
+.BR unihexfill(1),
+.BR unihexgen(1),
+.BR unipng2hex(1)
 .SH AUTHOR
 .B unipagecount
 was written by Paul Hardy.
 .SH LICENSE
 .B unipagecount
-is Copyright \(co 2007 Paul Hardy, and is released under version 2 of
-the GNU General Public License, or (at your option) a later version.
+is Copyright \(co 2007, 2014 Paul Hardy.
+.PP
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2 of the License, or
+(at your option) any later version.
 .SH BUGS
 No known real bugs exist, except that this software does not perform
 extensive error checking on its input files.  If they're not in the
-format of the original GNU Unifont hex file, all bets are off.
+format of the original GNU Unifont .hex file, all bets are off.