Contents:

1. About.
1.1. Quick installation.
1.2. Legend.
1.3. Notes.

2. Linux console.
2.1. consoletools.
2.2. kbd.
2.3. Quick reference.
2.4. Legend.
2.5. Notes.

3. UNIX console.
3.1. bsd-pcvt.
3.2. Legend.
3.3. Notes.

4. X11 Window System.
4.1. Installation.
4.2. Notes.
4.3. Recommended display modes and monitor sizes.

5. Legal information.
5.1. License.
5.2. Copyright.
5.3. Translation.


1. About.

This archive contains source code for generating and installing Terminus
Font for Linux console, UNIX console and X11 Window System.

- version	4.05
- sizes		8x14, 8x16, 10x20, 12x24, 14x28
- styles	normal, bold, EGA/VGA bold
- code pages	ISO10646-1
- characters	564
- format	Bitmap Distribution Format (BDF) version 2.1

The character set covers ISO8859-1/2/5/9/13/15/16, IBM-437/852/855/866,
Windows-1250/1251/1252/1254/1257, KOI8-R/U/E/F, Paratype-PT154/PT254,
Bulgarian-MIK and Macintosh-Ukrainian plus vt100 and xterm pseudographic
characters.

1.1. Quick installation.

$ ./configure [--prefix=PREFIX]
$ make
# make install

Compiles and installs the Linux console and X11 Window System fonts.

1.2. Legend.

The file names are structured as follows:

ter-u<SIZE><STYLE>.bdf

where <SIZE> is 14, 16, 20, 24 or 28, and <STYLE> is n for normal, b for bold
and v for EGA/VGA bold. The last style is for 8x14 and 8x16 only and makes
use of the eigth character matrix column.

1.3. Notes.

The commands marked with $ can be executed by a regular user.
The configure commands and are optional.


2. Linux console.

- sizes		8x14, 8x16
- styles	normal, bold, framebuffer-bold
- code pages	ISO8859-1/ISO8859-15/Windows-1252, ISO8859-2/Windows-1250,
		Windows-1251/ISO8859-5, ISO8859-9/Windows-1254, ISO8859-16,
		ISO8859-13/Windows-1257, IBM-437, KOI8-R, Bulgarian-MIK,
		Paratype-PT154, combined
- characters	555
- format	PC Screen Font (PSF) with unicode data

2.1. consoletools.

$ ./configure [--prefix=PREFIX | --psfdir=DIRECTORY]
$ make psf
# make install-psf

The files are compressed with gzip and installed in DIRECTORY. If DIRECTORY
does not exist, it is created. The default PREFIX is /usr. The default
DIRECTORY is PREFIX/share/consolefonts. Requires Perl.

If you do not have mappings for Windows-1252/1250/1251/1254/1257, ISO8859-16,
IBM-437, KOI8-R, Bulgarian-MIK or Paratype-PT154/PT254, also run:

$ ./configure [--prefix=PREFIX | --acmdir=DIRECTORY]
$ make txt
# make install-acm

The default DIRECTORY is PREFIX/share/consoletrans. Requires awk. 
Uninstallation of the mappings is not supported. To load a font:

$ consolechars -f ter-<X><SIZE><STYLE> -m MAPPING

2.2. kbd.

$ ./configure [--psfdir=DIRECTORY]
$ make psf
# make install-psf

where DIRECTORY should be either PREFIX/lib/kbd/consolefonts or
PREFIX/share/kbd/consolefonts, depending on kbd version, and PREFIX is usualy
/usr. The missing mappings are installed with:

$ ./configure [--prefix=PREFIX | --unidir=DIRECTORY]
$ make txt
# make install-uni

The default DIRECTORY is PREFIX/share/kbd/consoletrans. Requires awk. To load
a font:

$ setfont ter-<X><SIZE><STYLE> -m MAPPING

2.3. Quick reference.

$ ./configure [--prefix=PREFIX | --psfdir=DIRECTORY | --ref=FILENAME]
# make install-ref

Installs the text from p.2.4. as FILENAME (the default is README.terminus) in
DIRECTORY.

2.4. Legend.

names	mappings		covered codepage(s)

ter-1*	iso01, iso15, cp1252	ISO8859-1, ISO8859-15, Windows-1252
ter-2*	iso02, cp1250		ISO8859-2, Windows-1250
ter-9*	iso09, cp1254		ISO8859-9, Windows-1254
ter-c*	cp1251, iso05		Windows-1251, ISO8859-5
ter-d*	iso13, cp1257		ISO8859-13, Windows-1257
ter-g*	iso16			ISO8859-16
ter-i*	cp437			IBM-437
ter-k*	koi8r			KOI8-R
ter-m*	mik			Bulgarian-MIK
ter-p*	pt154			Paratype-PT154
ter-v*	all listed above,	all listed above, Paratype-PT254,
	pt254 etc. (if you	Macintosh-Ukrainian, KOI8-U/E/F and
	have them)		IBM-852/855/866, 8 foreground colors

names	style

ter-*n	normal
ter-*b	bold
ter-*f	framebuffer-bold

2.5. Notes.

The combined code page is based on IBM-437 (character 0xFF is ogonek).
The ISO8859-16 font also includes all letters and accents from Windows-1250.


3. UNIX console.

- sizes		8x14, 8x16
- styles	normal, bold, framebuffer-bold
- code pages	ISO8859-1/Windows-1252, ISO8859-2, ISO8859-5, ISO8859-9,
		ISO8859-9/Windows-1254, ISO8859-13, ISO8859-15, ISO8859-16,
		IBM-437, KOI8-R, Paratype-PT154
- characters	542
- format	raw data

3.1. bsd-pcvt.

$ ./configure [--prefix=PREFIX | --rawdir=DIRECTORY]
$ make raw
# make install.raw

or, for file names with minus instead of period:

# make install-raw

The default DIRECTORY is PREFIX/share/misc/pcvtfonts. The fonts are installed
uncompressed. Requires Perl. To load a font:

$ loadfont -f /usr/share/misc/pcvtfonts/ter-<X><STYLE>.8<SIZE>

or, for file names with minus instead of period:

$ loadfont -f /usr/share/misc/pcvtfonts/ter-<X><STYLE>-8x<SIZE>

3.2. Legend.

names	covered codepage(s)

ter-1*	ISO8859-1, Windows-1252
ter-2*	ISO8859-2
ter-5*	ISO8859-5
ter-9*	ISO8859-9, Windows-1254
ter-c*	Windows-1251
ter-d*	ISO8859-13
ter-f*	ISO8859-15
ter-g*	ISO8859-16
ter-i*	IBM-437
ter-k*	KOI8-R
ter-p*	Paratype-PT154

names	style

ter-*n	normal
ter-*b	bold
ter-*f	framebuffer-bold

3.3. Notes.

The RAW fonts contains data only and should be compatible with all UNIX
systems. If any of the bold fonts doesn't look good try framebuffer-bold, or,
if you are using an EGA/VGA adapter, program it to to clear column 8 of the
character matrix (attribute controller register 0x10 bit 0x02).


4. X11 Window System.

- sizes		8x14, 8x16, 10x20, 12x24, 14x28
- styles	normal, bold
- code pages	ISO8859-1/Windows-1252, ISO8859-2, ISO8859-5,
		ISO8859-9/Windows-1254, ISO8859-13, ISO8859-15, ISO8859-16,
		Windows-1251, KOI8-R, Paratype-PT154, ISO10646-1
- characters	564
- format	Portable Compiled Font (PCF)

4.1. Installation.

$ ./configure [--prefix=PREFIX | --x11dir=DIRECTORY] [--mkindex=INDEX]
$ make pcf
# make install-pcf

The files are compressed with gzip and installed in DIRECTORY. If DIRECTORY
does not exist, it is created. The default PREFIX is /usr. The default
DIRECTORY is PREFIX/X11R6/lib/X11/fonts/local. On installation or
uninstallation, INDEX is run with DIRECTORY as an argument. The default INDEX
is mkfontdir. You can change it to echo to disable the update of fonts.dir in
DIRECTORY. Requires Perl, bdftopcf and INDEX.

The configuration file which lists the font directories must contain
DIRECTORY. If xfs or the X-server have been active during the installation,
they should be restarted so the font list can be updated.

See also mkfontdir(1), xset(1), XF86Config(4/5), xfs(1) and xlsfonts(1).

4.2. Notes.

The ISO8859-1 and ISO8859-9 fonts contain the Windows Western characters and
can be used as Windows-1252 and Windows-1254 respectively.

Size 14x28 contains normal style only. The weight is actually between normal
and bold, so it can be used with any lighting.

4.3. Recommended display modes and monitor sizes:

Font Size	Display Mode	Monitor Size
------------	------------	------------
8x14		640x400		14" or less
8x16		640x480		14"
10x20		800x600		15"
12x24		1024x768	17"
14x28		1152x864	19" or more


5. Legal information.

5.1. License.

You can use and distribute this archive freely and without charge under the
terms of the GNU General Public License version 2.0 or (at your choice) any
later version.

To avoid name conflicts with another products named "Terminus", the archive
should be distributed as "Terminus Font", not "Terminus".

5.2. Copyright.

The Terminus Font is developed by and is a property of Dimitar Toshkov Zhekov
<jimmy@is-vn.bg>.

5.3. Translation.

The English version of this document is an approximate translation of the
Bulgarian version. In case of unclear or ambiguous points, the Bulgarian
version is considered correct.
