--- name: "jfbterm.conf" section: "5" platform: "linux" package: "jfbterm" version: "0.4.7-8" release: "Debian 6.0 (Squeeze)" platforms: ["linux"] url: "https://new.carta.tech/jfbterm.conf" --- # jfbterm.conf(5) configuration file for jfbterm(1) ## NAME jfbterm.conf - configuration file for [jfbterm(1)](/jfbterm/1.md) ## DESCRIPTION This manual page documents briefly the **jfbterm.conf** configuration file that is used in [**jfbterm**(1)](/jfbterm/1.md) command. ## CONFIGURATIONS 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 *value*s. A summary of configrations is included below. - **term** TERM environment variable's value for a program that runs in [**jfbterm**(1)](/jfbterm/1.md). 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 *charsetName*s 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)](/iconv/3.md). - 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)](/iconv/1.md) or [**iconv\_open**(3)](/iconv_open/3.md), **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)](/iconv/3.md) 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)](/iconv/3.md) 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)](/iconv/1.md) or [**iconv\_open**(3)](/iconv_open/3.md). Also, Both *encodingName*s (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. ## FILES - */etc/jfbterm.conf* Configuration file for [**jfbterm**(1)](/jfbterm/1.md). ## SEE ALSO [**jfbterm**(1)](/jfbterm/1.md), [**locale**(1)](/locale/1.md), [**iconv**(3)](/iconv/3.md). ## AUTHOR This manual page was written by Fumitoshi UKAI \.