jfbterm.conf - configuration file for jfbterm(1)

This manual page documents briefly the jfbterm.conf configuration file that is used in jfbterm(1) command.

The format of an entry for this file is:

entryName : value

If `+' is at beginning of the line, value is added to entryName as an array. This means that one entryName can have multiple values.

A summary of configrations is included below.

term TERM environment variable's value for a program that runs in jfbterm(1). The default is jfbterm.

fontset This assigns a font for each character set. A term "character set" means a set of characters and is an element for "encodings". In other words, an encoding consists from one or more character sets. In jfbterm, most of character sets are assumed to have ISO-2022-compliant structure, i.e., a character set contains 94 characters, 96 characters, 94^N characters, or 96^N characters. iso10646.1 is the only exception.

The format of fontset value is:

charsetName,type,side,fontname

You can see a list of available charsetNames by running "jfbterm --help".

type specifies "pcf" or "alias". If type is "pcf", fontname is a pathname of a font file. If type is "alias", fontname specifies another charsetName, which means that the character set of charsetName will use the same font to the character set of fontname.

side specifies in which side (GL or GR) the font has glyphs for the character set, in terms of ISO-2022. L means GL (0x20-0x7f) and R means GR (0xa0-0xff). A unique specification, U, is used only for iso10646.1.

For example, iso8859.1-1987 is a character set which contains 96 characters. The glyphs for iso8859.1-1987 characters are available in GR side of *-iso8859-1 fonts.

encoding This defines an encoding. An encoding is what you really use to express texts and consists from one or more character sets. In jfbterm, most of encodings are defined as ISO-2022's initial state and jfbterm can change character sets by using ISO-2022 escape sequences. However, non-ISO-2022-compliant encodings such as Big5 and KOI8-R are also supported via iconv(3).

The format of encoding value is

locale or encodingName or GL,GR,G0,G1,G2,G3

If encoding value is "locale" (the first case), then encodingName value is initialized by the current LC_CTYPE locale ("locale -k charmap") and falling into the second case.

If no `,' is found in encoding value, it is recognized as encodingName (the second case). If the encodingName matches one of encoding.encodingName which is explained below, this definition is used. Otherwise, if the encodingName matches one of valid encoding names for iconv(1) or iconv_open(3), jfbterm will work in UTF-8 mode internally. This means that the font defined by fontset:iso10646.1 line will be used and iconv(3) will be used to emulate the given encodingName. This behavior is just as if there is a line:

encoding.encodingName : other,encodingName,iconv,UTF-8

This mechanism enables jfbterm to support various encodings which are not ISO-2022-compliant.

If a `,' is found in encoding value, it is recognized as the third case. This format defines an encoding as an ISO-2022 initial state. GL and GR specifies a slot (one of G0, G1, G2, or G3) which is invoked into GL (0x20-0x7F) and GR (0xA0-0xFF). G0, G1, G2, and G3 specifies the character set which is designated into the corresponding slot.

The default is "locale".

encoding.encodingName This defines an encoding of encodingName as an ISO-2022 initial state, like the third case of encoding item which is explained already. The format is like following:

GL,GR,G0,G1,G2,G3 or UTF-8,iso10646.1 or other,encodingName,iconv,internal-encodingName

The first case is just same as explained in the third case of encoding item.

The second case means that the encoding is UTF-8. This is a special case.

The third case defines an encoding as a conversion of an other encoding. jfbterm will use the encoding of internal-encodingName internally and will use iconv(3) for conversion.

Note that, in the third case, internal-encodingName must be a valid encoding name which is defined in other encoding.encodingName line (which has the first or second format). Both of internal-encodingName and encodingName must be valid encoding names for iconv(1) or iconv_open(3). Also, Both encodingNames (one is a part of encoding.encodingName and the another appears next to "other,") must be same.

color.gamma Color gamma value. The default is 1.7.

/etc/jfbterm.conf

Configuration file for jfbterm(1).

jfbterm(1), locale(1), iconv(3).

This manual page was written by Fumitoshi UKAI <ukai@debian.or.jp>.