jfbterm.conf--5

JFBTERM.CONF(5)                                                JFBTERM.CONF(5)



NAME
       jfbterm.conf - configuration file for jfbterm(1)

DESCRIPTION
       This  manual page documents briefly the jfbterm.conf configuration file
       that is used in jfbterm(1) 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 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 "encod-
              ings".  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 con-
              tains  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  speci-
              fies  another charsetName, which means that the character set of
              charsetName will use the same font to the character set of font-
              name.

              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 avail-
              able 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 encoding-
              Name  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 encod-
              ingName (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 ini-
              tial 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  desig-
              nated 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-encoding-
              Name 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.encoding-
              Name  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.


FILES
       /etc/jfbterm.conf
              Configuration file for jfbterm(1).

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

AUTHOR
       This manual page was written by Fumitoshi UKAI <ukai AT debian.jp>.



                                 Aug 30, 2003                  JFBTERM.CONF(5)