Provided by: jfbterm_0.4.7-8_i386 bug

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
              "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.

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@debian.or.jp>.

                                 Aug 30, 2003                  JFBTERM.CONF(5)