1Contents:
  2
  31. About.
  41.1. Quick installation.
  51.2. Legend.
  61.3. Variants.
  71.4. Notes.
  8
  92. Linux console.
 102.1. consoletools.
 112.2. kbd.
 122.3. Quick reference.
 132.4. Legend.
 142.5. Notes.
 15
 163. UNIX console.
 173.1. bsd-pcvt.
 183.2. Legend.
 193.3. Notes.
 20
 214. X11 Window System.
 224.1. Installation.
 234.2. Notes.
 24
 255. Frequently Asked Questions.
 26
 276. Legal information.
 286.1. Licenses.
 296.2. Copyright.
 30
 31
 321. About.
 33
 34This archive contains source code for generating and installing Terminus
 35Font for Linux console, BSD console and X11 Window System.
 36
 37- version	4.38
 38- sizes		6x12, 8x14, 8x16, 10x18, 10x20, 11x22, 12x24, 14x28, 16x32
 39- styles	normal, bold, EGA/VGA bold
 40- characters	879
 41- format	Bitmap Distribution Format (BDF) version 2.1
 42
 43The character set covers about 120 language sets and supports ISO8859-1/2/5/
 447/9/13/15/16, Paratype-PT154/PT254, KOI8-R/U/E/F, Esperanto and many IBM,
 45Windows and Macintosh code pages, as well as the IBM VGA, vt100 and xterm
 46pseudographic characters.
 47
 481.1. Quick installation.
 49
 50The commands:
 51
 52$ ./configure [--prefix=PREFIX]
 53$ make
 54# make install fontdir
 55
 56compile and install the Linux console and X11 Window System fonts.
 57The default PREFIX is /usr/local.
 58
 591.2. Legend.
 60
 61The file names are structured as follows:
 62
 63ter-u<SIZE><STYLE>.bdf
 64
 65where <SIZE> is the font height, and <STYLE> is n for normal (all sizes), b
 66for bold (all sizes except 6x12) and v for EGA/VGA bold (8x14 and 8x16 only,
 67makes use of the eight character matrix column).
 68
 691.3. Variants.
 70
 71Some characters are implemented in two variants. To use the alternate
 72variant, execute:
 73
 74$ patch -p1 -i alt/<NAME>.diff
 75
 76before installation. See the font page for examples about the differences.
 77If you want to combine hi2 with dv1 and/or ka2, apply hi2 and then hi2-dv1
 78and/or hi2-ka2.
 79
 801.4. Notes.
 81
 82The commands marked with $ can be executed by a regular user.
 83The configure commands are optional.
 84The make commands require GNU make.
 85
 86A lot of characters are available only under X11/ISO10646-1 (UTF+8/Unicode).
 87
 88Sizes 6x12, 11x22, 14x28-bold and 16x32-normal are worse than the others.
 89Avoid them.
 90
 91210E and 210F are not italic.
 92
 93
 942. Linux console.
 95
 96- sizes		all available, see "About"
 97- styles	normal, bold, framebuffer-bold
 98- code pages	ISO8859-1/ISO8859-15/Windows-1252, ISO8859-2/Windows-1250,
 99		Windows-1251/ISO8859-5, ISO8859-9/Windows-1254, ISO8859-16,
100		ISO8859-7/Windows-1253, ISO8859-13/Windows-1257, IBM-437,
101		Bulgarian-MIK, KOI8-R, KOI8-U, Paratype-PT154, combined
102- format	PC Screen Font (PSF) with unicode data
103
1042.1. consoletools.
105
106$ ./configure [--prefix=PREFIX | --psfdir=DIRECTORY]
107$ make psf
108# make install-psf
109
110The files are compressed with gzip and installed in DIRECTORY. The default
111DIRECTORY is PREFIX/share/consolefonts. Requires Perl.
112
113If you lack mappings for Windows-1252/1250/1251/1254/1253/1257, ISO8859-16,
114IBM-437, KOI8-R, Bulgarian-MIK or Paratype-PT154/PT254, also run:
115
116$ ./configure [--prefix=PREFIX | --acmdir=DIRECTORY]
117$ make txt
118# make install-acm
119
120The default DIRECTORY is PREFIX/share/consoletrans. Requires awk.
121Uninstallation of the mappings is not supported. To load a font:
122
123$ consolechars [-m MAPPING] -f ter-<X><SIZE><STYLE>
124
125where <X> is a character identifying the code page as listed in p.2.4.
126
1272.2. kbd.
128
129$ ./configure [--psfdir=DIRECTORY]
130$ make psf
131# make install-psf
132
133where DIRECTORY should be either PREFIX/lib/kbd/consolefonts or
134PREFIX/share/kbd/consolefonts, depending on kbd version. Missing mappings
135are installed with:
136
137$ ./configure [--prefix=PREFIX | --unidir=DIRECTORY]
138$ make txt
139# make install-uni
140
141The default DIRECTORY is PREFIX/share/kbd/consoletrans. Requires awk. To
142load a font:
143
144$ setfont [-m MAPPING] ter-<X><SIZE><STYLE>
145
146where <X> is a character identifying the code page as listed in p.2.4.
147
1482.3. Quick reference.
149
150The commands:
151
152$ ./configure [--prefix=PREFIX | --psfdir=DIRECTORY | --ref=FILENAME]
153# make install-ref
154
155install the text from p.2.4 as FILENAME (the default is README.terminus)
156in DIRECTORY.
157
1582.4. Legend.
159
160names	mappings		covered codepage(s)
161
162ter-1*	iso01, iso15, cp1252	ISO8859-1, ISO8859-15, Windows-1252
163ter-2*	iso02, cp1250		ISO8859-2, Windows-1250
164ter-7*	iso07, cp1253		ISO8859-7, Windows-1253
165ter-9*	iso09, cp1254		ISO8859-9, Windows-1254
166ter-c*	cp1251, iso05		Windows-1251, ISO8859-5
167ter-d*	iso13, cp1257		ISO8859-13, Windows-1257
168ter-g*	iso16			ISO8859-16
169ter-i*	cp437			IBM-437
170ter-k*	koi8r			KOI8-R
171ter-m*	mik			Bulgarian-MIK
172ter-p*	pt154			Paratype-PT154
173ter-u*	koi8u			KOI8-U
174ter-v*	all listed above	all listed above and many others (about 110
175	and many others		language sets), 8 foreground colors
176
177names	style
178
179ter-*n	normal
180ter-*b	bold
181ter-*f	framebuffer-bold
182
1832.5. Notes.
184
185The combined code page is based on IBM-437 (character 0xFF is ogonek).
186The ISO8859-16 font also includes all letters and accents from Windows-1250.
187
188
1893. UNIX console.
190
191- sizes		8x14 and 8x16 only
192- styles	normal, bold, framebuffer-bold
193- code pages	ISO8859-1/Windows-1252, ISO8859-2, ISO8859-5, ISO8859-7,
194		ISO8859-9/Windows-1254, ISO8859-13, ISO8859-15, ISO8859-16,
195		Windows-1251, IBM-437, KOI8-R, KOI8-U, Paratype-PT154
196- format	raw data
197
1983.1. bsd-pcvt.
199
200$ ./configure [--prefix=PREFIX | --rawdir=DIRECTORY]
201$ make raw
202# make install.raw
203
204or, for file names with minus instead of period:
205
206# make install-raw
207
208The default DIRECTORY is PREFIX/share/misc/pcvtfonts. The fonts are
209installed uncompressed. Requires Perl. To load a font:
210
211$ loadfont -f /usr/share/misc/pcvtfonts/ter-<X><STYLE>.8<SIZE>
212
213or, for file names with minus instead of period:
214
215$ loadfont -f /usr/share/misc/pcvtfonts/ter-<X><STYLE>-8x<SIZE>
216
217where <X> is a character identifying the code page as listed in p.3.2.
218
2193.2. Legend.
220
221names	covered codepage(s)
222
223ter-1*	ISO8859-1, Windows-1252
224ter-2*	ISO8859-2
225ter-5*	ISO8859-5
226ter-7*	ISO8859-7
227ter-9*	ISO8859-9, Windows-1254
228ter-c*	Windows-1251
229ter-d*	ISO8859-13
230ter-f*	ISO8859-15
231ter-g*	ISO8859-16
232ter-i*	IBM-437
233ter-k*	KOI8-R
234ter-p*	Paratype-PT154
235ter-u*	KOI8-U
236
237names	style
238
239ter-*n	normal
240ter-*b	bold
241ter-*f	framebuffer-bold
242
2433.3. Notes.
244
245The RAW font contains data only and should be compatible with all UNIX
246systems. If any of the bold fonts doesn't look good try framebuffer-bold,
247or, if you are using an EGA/VGA adapter, program it to to clear column 8 of
248the character matrix (attribute controller register 0x10 bit 0x02).
249
250
2514. X11 Window System.
252
253- sizes		all available, see "About"
254- styles	normal, bold
255- code pages	ISO8859-1/Windows-1252, ISO8859-2, ISO8859-5, ISO8859-7,
256		ISO8859-9/Windows-1254, ISO8859-13, ISO8859-15, ISO8859-16,
257		Windows-1251, KOI8-R, KOI8-U, Paratype-PT154, ISO10646-1
258- format	Portable Compiled Font (PCF)
259
2604.1. Installation.
261
262$ ./configure [--prefix=PREFIX | --x11dir=DIRECTORY]
263$ make pcf
264# make install-pcf
265
266The files are compressed with gzip and installed in DIRECTORY. The default
267DIRECTORY is PREFIX/share/fonts/terminus. Requires Perl and bdftopcf.
268
269A copy of the normal 6x12 font is installed as "bold", because some X11
270libraries and applications substitute the missing bold fonts by shifting the
271normal fonts, and others do not recognize the bold style at all if the
272lowest font size lacks it. To install only the normal font, use "n12"
273instead of "pcf" in the above commands.
274
275To update the font cache in DIRECTORY after (un)installation, run:
276
277# make fontdir
278
279The configuration file which lists the font directories must contain
280DIRECTORY. If xfs or the X-server were active during the installation, they
281should be restarted so the font list can be updated.
282
2834.2. Notes.
284
285The ISO8859-1 and ISO8859-9 fonts contain the Windows Western characters and
286can be used as Windows-1252 and Windows-1254 respectively.
287
288
2895. Frequently Asked Questions.
290
291Q. Italic version?
292
293A. No. The quality is significantly lower, and preserving the font width
294requires overlapping characters, which are not handled very well by X11/Xft.
295If you need it than much, try mkitalic from FreeBSD or bdfslant from Debian.
296
297Q. Scalable version?
298
299A. Long story short, when the average display resolution becomes at least
300150 DPI. Prefferably 200.
301
302Q. How about some new characters?
303
304A. Contact me and be ready to help.
305
306Q. The bold 6x12 font...
307
308A. ...does not exist, there is no space for a bold font in a 6x12 matrix.
309However, the "normal" font is somewhere between.
310
311Q. The font works in X11/Motif, but not in GNOME/KDE/Xfce.
312
313A. Try adding 75-yes-terminus.conf to the Fontconfig configuration files.
314See also mkfontscale(1), mkfontdir(1), fc-cache(1), xorg.conf(5), xfs(1),
315xlsfonts(1), fonts-conf(5) etc.
316
317
3186. Legal information.
319
3206.1. Licenses.
321
322Terminus Font is licensed under the SIL Open Font License, Version 1.1.
323The license is included as OFL.TXT, and is also available with a FAQ at:
324http://scripts.sil.org/OFL
325
326The files configure, configure.help, bdftopsf.pl and ucstoany.pl are
327distributed under the GNU General Public License version 2.0 or (at your
328choice) any later version.
329
330
3316.2. Copyright.
332
333Terminus Font 4.38, Copyright (C) 2012 Dimitar Toshkov Zhekov.
334Report bugs to <dimitar.zhekov@gmail.com>
335
336
337Thanks to Anton Zinoviev, Tim Allen, Kir Koliushkin, Antonios Galanopoulos
338and all the others who helped.