man/unihexfill.1

   1 .TH UNIHEXFILL 1 "2014 Jun 30"
   2 .SH NAME
   3 unihexfill \- Generate range of Unifont 4- or 6-digit hexadecimal glyphs
   4 .SH SYNOPSIS
   5 .br
   6 .B unihexfill
   7 <
   8 .I unassigned-ranges.txt
   9 >
  10 .I filler-glyphs.hex
  11 .SH DESCRIPTION
  12 .B unihexfill
  13 is a shell script that reads a list of code point ranges from STDIN
  14 and produces filler glyphs of 4- or 6-digit code points on STDOUT.
  15 .P
  16 The format of the input file is a combination of comment lines,
  17 single code points on a line, and start/stop pairs of code points on
  18 a line separated by a space.  Comment lines start with a semicolon (';')
  19 by convention.  Start and stop code points are strings of hexadecimal
  20 digits, by convention either four or six digits.
  21 .P
  22 .B unihexfill
  23 invokes
  24 .B unihexgen
  25 for each non-comment line in its input file.  If a codepoint is less than
  26 or equal to "FFFF" (i.e., 0xFFFF), a four-digit hexadecimal number is encoded
  27 within the corresponding Unifont glyph as two digits on each of
  28 two rows.  Otherwise, a six-digit hexadecimal number is encoded as
  29 three digits on each of two rows.
  30 .SH OPTIONS
  31 There are no options.
  32 .SH FILES
  33 *.txt as input; *.hex as output.
  34 .SH EXAMPLE
  35 In the Unifont source package, the file font/plane01/Makefile generates
  36 Unicode Plane 1 hexadecimal filler glyphs of unassigned code points within
  37 assigned scripts with this single-line command:
  38 .PP
  39 .RS
  40 .B ../../bin/unihexfill
  41 < unassigned-ranges.txt > unassigned.hex
  42 .RE
  43 .SH SEE ALSO
  44 .BR bdfimplode(1),
  45 .BR hex2bdf(1),
  46 .BR hex2sfd(1),
  47 .BR hexbraille(1),
  48 .BR hexdraw(1),
  49 .BR hexkinya(1),
  50 .BR hexmerge(1),
  51 .BR johab2ucs2(1),
  52 .BR unibdf2hex(1),
  53 .BR unibmp2hex(1),
  54 .BR unicoverage(1),
  55 .BR unidup(1),
  56 .BR unifont(5),
  57 .BR unifont-viewer(1),
  58 .BR unifontchojung(1),
  59 .BR unifontksx(1),
  60 .BR unifontpic(1),
  61 .BR unigencircles(1),
  62 .BR unigenwidth(1),
  63 .BR unihex2bmp(1),
  64 .BR unihex2png(1),
  65 .BR unihexgen(1),
  66 .BR unipagecount(1),
  67 .BR unipng2hex(1)
  68 .SH AUTHOR
  69 .B unihexfill
  70 was written by Paul Hardy.
  71 .SH LICENSE
  72 .B unihexfill
  73 is Copyright \(co 2014 Paul Hardy.
  74 .PP
  75 This program is free software; you can redistribute it and/or modify
  76 it under the terms of the GNU General Public License as published by
  77 the Free Software Foundation; either version 2 of the License, or
  78 (at your option) any later version.
  79 .SH BUGS
  80 No known real bugs exist, except that this software does not perform
  81 extensive error checking on its input file.  Any line that appears to
  82 begin with a hexadecimal digit is fed to
  83 .B unihexgen.