mlterm man page on OpenSuSE

Man page or keyword search:  
man Server   25941 pages
apropos Keyword Search (all sections)
Output format
OpenSuSE logo
[printable version]

MLTERM(1)							     MLTERM(1)

NAME
       mlterm - Multi Lingual TERMinal emulator on X

SYNOPSIS
       mlterm [options]

DESCRIPTION
       mlterm is a multi-lingual terminal emulator written from scratch, which
       supports various character sets and encodings in the world and  complex
       characters  such	 as  double  width for East Asian, combining for Thai,
       Vietnamese, and so on, and bi-direction for Arabic and  Hebrew.	 Indic
       scripts	are experimentally supported.  It also supports various unique
       feature such as anti-alias using FreeType, multiple XIM, multiple  win‐
       dows,  scrollbar	 API,  scroll  by  mouse wheel, automatic selection of
       encoding, daemon mode, and so on.

       Supported encodings  are:  ISO-8859-[1-11],  ISO-8859-[13-16],  TIS-620
       (same  as  ISO-8859-11), KOI8-R, KOI8-U, KOI8-T, GEORGIAN-PS, TCVN5712,
       ISCII_(ASSAMESE|BENGALI|GUJARATI|    HINDI|KANNADA|MALAYALAM|ORIYA|PUN‐
       JABI|ROMAN|TAMIL|TELUGU),   VISCII,  CP125[0-8],	 CP874,	 EUC-JP,  EUC-
       JISX0213, Shift_JIS,  Shift_JISX0213,  ISO-2022-JP[1-3],	 EUC-KR,  UHC,
       JOHAB,  ISO-2022-KR,  GB2312  (EUC-CN),	GBK, GB18030, ISO-2022-CN, HZ,
       EUC-TW, BIG5, BIG5HKSCS, and UTF-8.  If you  have  already  set	locale
       (for example LANG variable; see locale(7) for detail) mlterm will auto‐
       matically select proper encoding.

OPTIONS
       Note that bool is to be substituted by true or false.

       -A, --aa(=bool)
	      Use anti-aliased fonts. This option works only with Xft or cairo
	      for now.	The default is false.

       -B, --sbbg=color
	      Specify  a  background  color of a scrollbar.  A valid value for
	      color is a color name or a RGB value.  The color name should  be
	      defined  in  rgb.txt  or	"color"	 configuration	file.  The RGB
	      value's format should be "#RRGGBB", "#RRGGBBAA",	"rgb:RR/GG/BB"
	      or "rgba:RR/GG/BB/AA".

       -C, --ind(=bool)
	      Enable  indic  rendering.	 The default is false. (Note that this
	      option is avaialable only if --bi option is disabled.)

       -D, --bi(=bool)
	      Enable BiDi (bi-directional) processing on UTF8 encoding to sup‐
	      port  RTL	 (right-to-left)  languages such as Arabic and Hebrew.
	      The default is true.

       -E, --km=encoding
	      Specify encoding.	 Valid encodings  are  listed  in  DESCRIPTION
	      section above in this man page.  AUTO makes mlterm determine the
	      according according to the current locale (default AUTO).

       -F, --sbfg=color
	      Specify a foreground color of a scrollbar.   See	--sbbg	option
	      for valid values.

       -G, --vertical=mode
	      Specify vertical writing mode.  cjk for RTL vertical writing and
	      mongol for LTR one.  The default is none which means  horizontal
	      writing mode.

       -H, --bright=value
	      Brightness  of  background images in percent.  See -p option for
	      details of background images.  The default is 100	 (keep	origi‐
	      nal).

       -I, --icon=name
	      Specify  a  name	to  be used when a mlterm window is iconified.
	      The default is "mlterm".

       -J, --dyncomb(=bool)
	      Enable dynamic character combining.  "Dynamic" means  that  com‐
	      bining  characters  are stored in without combining but they are
	      displayed using combined form.  This affects calculation of col‐
	      umn position, i.e., a pair of base character and combining char‐
	      acter is counted to be two columns in this  mode,	 while	it  is
	      counted to be one column in the normal mode.  Under this option,
	      a (logical) column number and a character one-to-one  correspon‐
	      dence.   even for combining characters (though not for fullwidth
	      characters; see -Z/--multicol option for handling	 of  fullwidth
	      characters).  Thus, this mode enables you to use combining char‐
	      acters with software which does not  support  combining  charac‐
	      ters.  The default is false.

       -K, --metakey=value
	      Specify  a  key  to  be interpreted as a META key.  Valid values
	      are: alt, meta, hyper, super, mod1, mod2, mod3, mod4, and	 none.
	      The default is none.

	      See -k option also.

       -L, --ls(=bool)
	      Whether to use login shell or not.  The default is false.

       -M, --im= input method : [ arguments ... ]
	      Specify an input method.

	      Examples:

	      --im=xim
		     Use XIM with the default XIM server specified by standard
		     way (i.e., XMODIFIERS environmental variable).

	      --im=xim:Ami
		     Use XIM with Ami on the system locale.

	      --im=xim:kinput2:ja_JP.EUC-JP
		     Use XIM with kinput2 on ja_JP.EUC-JP locale.

	      --im=kbd:arabic
		     Use keyboard mapping input method in Arabic.

	      --im=kbd:hebrew
		     Use keyboard mapping input method in Hebrew.

	      --im=kbd:isciixxx
		     Use keyboard mapping input method in Indic.

	      --im=uim
		     Use uim with the default conversion engine.

	      --im=uim:prime
		     Use uim with prime conversion engine.

	      --im=m17nlib:ru
		     Use m17n library in Russian.

	      --im=m17nlib:or:itrans
		     Use m17n library in Oriya using ITRANS method.

	      --im=scim
		     Use SCIM.

	      --im=ibus
		     Use IBus.

	      --im=none
		     Don't use input method.

       -N, --name=name
	      Specify application name.	 The default is "mlterm".

       -O, --sbmod=value
	      Specify the side to show a scrollbar.  left for  left  side  and
	      right  for  right	 side.	 The  default  is none which turns off
	      scrollbar.

       -P, --clip(=bool)
	      Whether to enable CLIPBOARD (not only PRIMARY)  selection.   The
	      default is false.

       -Q, --vcur(=bool)
	      Change  interpretation  of cursor keys to be natural in vertical
	      writing mode.  This means	 that  up  and	down  arrow  keys  are
	      treated  as  backward (left arrow in horizontal LTR) and forward
	      (right arrow in horizontal LTR), respectively.  In cjk -G/--ver‐
	      tical  mode,  left and right arrow keys are also treated as next
	      line (down arrow in horizontal LTR) and previous line (up	 arrow
	      in  horizontal  LTR),  respectively,  while vice versa in mongol
	      mode.  The default is false.

       -R, --fsrange=range
	      Set acceptable range of font size.  The format is	 "minsize-max‐
	      size",  where  minsize  and  maxsize  are	 font  sizes  in pixel
	      (default 6-30).  The GUI configurator and other means  for  set‐
	      ting fontsize should honor the range.

       -S, --sbview=name
	      Select  a	 type  of  scrollbar.  See SCROLLBAR section below for
	      details.	The default is "simple" which means the built-in  sim‐
	      ple scrollbar.

       -T, --title=name
	      Specify a title for a mlterm window.  The default is "mlterm".

       -U, --viaucs(=bool)
	      Force  to	 convert  a  selection	(i.e., copy-and-paste strings)
	      whose type is not UTF8_STRING to the current mlterm encoding via
	      Unicode.	 See  SELECTION section below for detail.  The default
	      is false.

       -V, --varwidth(=bool)
	      Use variable column width.  You may want to use this option when
	      you use proportional fonts.  The default is false.

       -W, --sep=characterlist
	      Delimiter	 characters  used  for	word selection, which are con‐
	      sulted when you double-clicked mlterm, to define what is a word.
	      The  default  is	"  ,.:;/|@()[]{}")  -X, --alpha=value Alpha in
	      pseudo or true transparent.  The default is 255.

       -Y, --decsp(=bool)
	      Use dynamically composed line drawing character set of DEC  spe‐
	      cial.   The  default  is	false.	 This overrides DEC_SPECIAL in
	      "font" configuration file, while DEC_SPECIAL  in	"aafont"  (for
	      Xft or cairo) is always overridden.

       -Z, --multicol(=bool)
	      Treat fullwidth characters (east Asian characters in most cases;
	      which occupies two columns on the screen)	 as  they  occupy  two
	      logical  columns.	  It  is  the  de-facto standard way to handle
	      fullwidth characters in east Asian terminal  emulators  (XFree86
	      xterm  and   kterm, cxterm, hanterm, rxvt, eterm) and other sys‐
	      tems such as MS-DOS, PC-9801, and so on.	 In  most  fonts,  the
	      glyphs  of fullwidth characters are designed assuming that their
	      width are twice of normal characters and won't display correctly
	      without this option.  The default is true.

       -0, --crbg=color
	      Specify  background  color  for cursor (default is same to fore‐
	      ground color).  Valid values for color are color	names  defined
	      in  rgb.txt  and	color  rgb  string  whose format is "#RRGGBB",
	      "#RRGGBBAA", "rgb:RR/GG/BB" or "rgba:RR/GG/BB/AA".

       -1, --wscr=value
	      Specify actual window width, by  percentage  against  calculated
	      value  by multiplying font width by column number.  This is use‐
	      ful when you use a proportional font which includes some	glyphs
	      with  exceptionally  large  width,  i.e.,	 much  larger "maximum
	      width" than your expectation.  The default is 100.

       -2, --hscr=value
	      Specify actual screen height, like  -1/--wscr  does  for	width.
	      The default is 100.

       -3, --contrast=value)
	      Contrast	of  background	image  in  percent.  See -p option for
	      details of background image.  The default is 100.

       -4, --gamma=value)
	      Gamma of background image in percent.  See -p option for details
	      of background image.  The default is 100.

       -5, --big5bug(=bool)
	      Enable  a workaround for Big5 CTEXT bugs (which had been existed
	      until XFree86 4.1.0).  This affects Big5 selections (i.e., copy-
	      and-paste	 strings)  in COMPOUND_TEXT format which mlterm sends.
	      The default is false.

       -6, --stbs(=bool)
	      Don't exit backscroll  mode  when	 console  applications	output
	      something.  The default is false.

       -7, --bel=mode
	      Behavior	when  BEL  (0x07) is received. sound for beep , visual
	      for blanking screen and sound|visual for the both.  The  default
	      is none which ignores BEL.

       -8, --88591(=bool)
	      Use ISO8859-1 fonts for US-ASCII part of various encodings.

       -9, --crfg=color
	      Specify  foreground  color  for cursor (default is same to back‐
	      ground color).  Valid values for color are color	names  defined
	      in  rgb.txt  and	color  rgb  string  whose format is "#RRGGBB",
	      "#RRGGBBAA", "rgb:RR/GG/BB" or "rgba:RR/GG/BB/AA".

       -$, --mc=value
	      Doubleclick/tripleclick interval in millisecond.	The default is
	      250.

       -%, --logseq(=bool)
	      Enable  logging.	Contents  of stream received by mlterm will be
	      logged under ~/.mlterm/.	This option is mainly intended	to  be
	      used for debugging purposes.  The default is false.  Note that %
	      should be escaped to be supplied as a  command  line  option  on
	      most shells.

       -&, --borderless(=bool)
	      Asks  the	 window manager to use no decorations at all. Warning:
	      You will not be able to resize the window. You probably want  to
	      use --geometry as well.  The default is false.

       -@, --screens=value
	      Specify  number  of  screens  (sessions) to be used in start up.
	      The default is 1.	 Note that  when  one  of  these  screens  are
	      closed,  sessions	 which	were  connected	 to the screens do not
	      immediately killed.

	      See MULTIPLE PTY section for details.

       -*, --type=value
	      Specify the rendering engine to be used to draw fonts.  xcore is
	      conventional  X11	 core font mechanism.  xft means Xft mechanism
	      and cairo means cairo mechanism.	The default is xcore.

       -#, --initstr=value
	      Specify a string to be automatically sent	 after	initialization
	      of  session.  The value normally will be parsed by a shell.  See
	      -e option to execute other application at start-up time.

       -a, --ac=value
	      Specify number of columns to be occupied by a  Unicode's	"East‐
	      AsianAmbiguous"  character.  The default is 1 except "ja" locale
	      where the default is 2. Some of asian people may want to specify
	      2.   See Unicode Standard Annex (UAX) #11 East Asian Width found
	      at Unicode web site for details.

       -b, --bg=color
	      Specify background color	(default  white).   Valid  values  for
	      color  are  color	 names defined in rgb.txt and color rgb string
	      whose  format  is	 "#RRGGBB",  "#RRGGBBAA",  "rgb:RR/GG/BB"   or
	      "rgba:RR/GG/BB/AA".

       -c, --cp932(=bool)
	      Use  CP932  mapping  table to convert from JIS X 0208 to Unicode
	      when displaying JIS X 0208 characters using Unicode font in  Xft
	      or cairo mode.  This is useful when you use proprietary Japanese
	      true type fonts which are intended to  be	 used  with  Microsoft
	      Windows,	with mlterm with encodings (such as EUC-JP, Shift_JIS,
	      ISO-2022-JP, and so on) which contain JIS	 X  0208  as  a	 coded
	      character set.

	      The  reason  is, such proprietary fonts may have glyphs only for
	      Unicode code points into which JIS X 0208 code points  are  con‐
	      verted  using  CP932 mapping table.  (CP932 is a name of mapping
	      table which is used by Microsoft to convert from Shift_JIS [plus
	      Microsoft	 private  extended  characters] into Unicode.  In Uni‐
	      code's point of view, CP932 is a name of encoding which is simi‐
	      lar  to  Shift_JIS  and is used by Japanese version of Microsoft
	      Windows.)	 If you use such fonts for encodings  such  as	EUC-JP
	      and Shift_JIS with JIS0208.TXT mapping table which mlterm adopts
	      as the standard, a few characters are mapped into	 Unicode  code
	      points where the fonts don't have glyphs.

	      Both of CP932.TXT and JIS0208.TXT mapping tables are supplied by
	      Unicode Consortium, though they are regarded to be obsolete.

	      The default is true.

       -d, --display=string
	      Specify X display to connect with.

       -e program [ arguments ... ]
	      Invoke the command in the mlterm window.	This  option  must  be
	      the last option on the command line.

       -f, --fg=color
	      Foreground  color	 (default  black).  Valid values for color are
	      color names defined in rgb.txt and color rgb string whose format
	      is "#RRGGBB", "#RRGGBBAA", "rgb:RR/GG/BB" or "rgba:RR/GG/BB/AA".

       -g, --geometry=geometry
	      Specify size and position of the window; see X(7).

       -h, --help(=bool)
	      Show help messages.

       -i, --xim(=bool)
	      Whether  to  use	XIM  (X Input Method).	Most east Asian people
	      will want to enable this option.	Other people can  also	safely
	      enable  this.   The default is true.  The name of the XIM server
	      to be connected is specified by standard way  (i.e.,  XMODIFIERS
	      environmental variable).

       -j, --daemon=value
	      Start  as	 a  daemon  process.  Possible =values are "blend" and
	      "genuine".  See the chapter of DAEMON MODE for details.

       -k, --meta=mode
	      Behavior of META key.  esc for sending ESC and none for ignoring
	      META  key.   The default is 8bit which sets the most significant
	      bit.

	      See -K option also.

       -l, --sl=value
	      Specify number of lines of backlog.  The default is 128.

       -m, --comb(=bool)
	      Enable combining characters by overstriking glyphs  (recommended
	      for  TIS-620,  TCVN5712, and UTF-8).  Note that fonts which con‐
	      tain combining characters which extend backward cannot be	 used,
	      since  mlterm does combine characters by controlling the writing
	      positions.  This option is automatically turned  on  when	 using
	      ISCII  or	 UTF-8	encoding  with	indic  rendering  or --dyncomb
	      option.  The default is true.

       -n, --noucsfont(=bool)
	      Use non-Unicode fonts even when mlterm encoding is UTF-8.	  Use‐
	      ful  when	 you  don't  have ISO10646-1 fonts and you want to use
	      UTF-8 encoding.  The default is false.

       -o, --lsp(=value)
	      Specify number of extra pixels between lines.  The default is 0.

       -p, --pic=path
	      Path for a wallpaper (background) image.	Note that the  wallpa‐
	      per cannot be used with transparent background.

       -q, --extkey(=bool)
	      Enable extended keys for backscroll mode.	 The default is false.
	      Extended scroll keys are	SCROLL_UP,  up	arrow,	and  "k"  (for
	      scrolling	 one  line  backward) and SCROLL_DOWN, down arrow, and
	      "j" (for scrolling one line forward).  Please note that concrete
	      keys  for	 symbols of SCROLL_UP and SCROLL_DOWN are specified in
	      key configuration file.  Only  keys  of  PAGE_UP	and  PAGE_DOWN
	      (which are specified in key configuration file) are available by
	      default.

       -r, --fade=ratio
	      Specify fading ratio for unfocused windows.  100 means no fading
	      and 0 means darkest.  The default is 100

       -s, --sb(=bool)
	      Whether to use a scrollbar.  The default is true.

       -t, --transbg(=bool)
	      Whether  to  enable  pseudo  transparent	background.  Note that
	      transparent background  cannot  be  used	with  wallpaper.   The
	      default is false.

       -u, --onlyucsfont(=bool)
	      Use  Unicode fonts even when mlterm encoding is not UTF-8.  Use‐
	      ful when you have ISO10646 fonts but you don't have other	 fonts
	      and  want	 to  use non-UTF-8 encodings.  Note that conversion to
	      Unicode is lossy.	 i.e. if mlterm encoding is not	 a  subset  of
	      Unicode  like  ISO-2022-JP-2  or	EUC-TW,	 characters  which are
	      regarded as a same character in Unicode will be  displayed  with
	      the same glyph and cannot be distinguished.

	      The default is false.

       -v, --version
	      Show version information.

       -w, --fontsize=value
	      Specify font size in pixel.  The default is 16.

       -x, --tw=value
	      Specify tab width.  The default is 8.

       -y, --term=string
	      Specify terminal type, i.e., the value of TERM variable.	Corre‐
	      sponding definition must be exist in  terminfo/termcap  database
	      and  the	contents should fits to the behavior of mlterm.	 Since
	      mlterm is designed to generally behave like kterm, values	 which
	      works for kterm may be used.  The default is xterm.

	      To  use  full  features of term, it's recommended to install the
	      definition of mlterm which distributed with  source  and	choose
	      "mlterm" as a value of TERM.

       -z, --largesmall=size
	      Specify  the step of changing font size in pixel when you pushed
	      "Font size larger" or "Font size smaller" button on GUI configu‐
	      rator.  The default is 1.

       --altbuf=value
	      Whether to enable alternate screen buffer.  This option is simi‐
	      lar to "titeInhibit" of xterm.

       --bd=value
	      Specify the color to use to display bold characters.

       --bdfont(=bool)
	      Use bold font for	 characters  with  the	bold  attribute.   The
	      default is true.

       --bimode=value
	      Specify  bidi  mode.  Valid values are: normal, cmd_l and cmd_r.
	      The default is normal.
		      +---------------------+
	      logical |$ ls -l ABC DEF	    |
	      normal  |$ ls -l FED CBA	    |
	      cmd_l   |$ ls -l CBA FED	    |
	      cmd_r   |	     FED CBA -l ls $|
		      +---------------------+
		      (Upper case characters represent RTL ones.)

       --blink(=bool)
	      Blink cursor. The default is false.

       --border=value
	      Specify inner border width. The default is 2.  The maximum value
	      is 224.

       --boxdraw=value
	      Use  either  unicode  font  or DEC Special font forcibly to draw
	      box-drawing characters.  unicode for unicode font and decsp  for
	      DEC special font.	 The default is noconv which draw them as they
	      are.

       --colors(=bool)
	      Whether to recognize ANSI color change  escape  sequences.   The
	      default is true.

       --csp=value
	      Specify  number  of  extra pixels between lines. (ignored if you
	      specify --V option.)  The default is 0.

       --ciphlist=value
	      Specify ciphers (comma separated list) for  encrypting  the  ssh
	      session.

       --depth=value
	      Specify  visual  depth.  (8,16,24,32)  If	 depth	is 32, you can
	      enable semi-transparency by specifying opacity as the  value  of
	      --alpha  option  or  "rgba:RR/GG/BB/AA"  as  the	value  of --bg
	      option.

       --exitbs(=bool)
	      Whether to exit backscroll mode on receiving data from pty.  The
	      default is false.

       --iconpath=path
	      Specify the file to be used as a window icon.

       --keepalive(=value)
	      Specify  interval	 seconds  to  send  keepalive  message	to ssh
	      server.  The default is 0.

       --logmsg(=bool)
	      Enable logging messages of  mlterm  to  ~/.mlterm/msg.log.   The
	      default is true.

       --loecho(=bool)
	      Whether to use local echo mode or not. The default is false.

       --maxptys=value
	      Specify  maximum number of ptys (sessions) to be opened simulta‐
	      neously.	It should be multiple of 32.  The default is 32.

	      See MULTIPLE PTY section for detail.

       --noul(=bool)
	      Don't draw underline.  The default is false.

       --osc52(=bool)
	      Allow access to clipboard(selection) by OSC  52  sequence.   The
	      default is false.

       --parent=value
	      Specify parent Window ID.	 The default is 0.

       --serv=value
	      Specify  a host you want to connect via ssh etc.	This option is
	      enabled only if mlterm is	 built	with  MinGW  or	 --enable-ssh2
	      option.

	      Value format: (<protocol>://)(<user>@)<server>(:<port>)(:<encod‐
	      ing>)

	      e.g.) mlterm --serv ssh://user@host:22:eucjp

       --pubkey=value
	      Specify public key file for  ssh	connection.   The  default  is
	      ~/.ssh/id_rsa.pub(%HOMEPATH%termid_rsa.pub in win32).

       --privkey=value
	      Specify  private	key  file  for ssh connection.	The default is
	      ~/.ssh/id_rsa(%HOMEPATH%termid_rsa in win32).

       --restart=value
	      Whether to restart mlterm with all opened	 ptys  except  ssh  if
	      SIGSEGV,	SIGBUS,	 SIGFPE or SIGILL is received.	The default is
	      true.

       --shortcut(=bool)
	      Whether to allow dynamic change of shortcut  keys	 by  OSC  5379
	      set_shortcut sequence.  The default is false.

       --ul=value
	      Specify the color to use to display underlined characters.

       --ucsprop(=bool)
	      Use  unicode  properties	in  encodings  excepting  UTF-8.   The
	      default is false.

       --urgent(=bool)
	      Draw the user's attention when making a bell sound in the	 unfo‐
	      cused window.  The default is false.

       --x11(=bool)
	      Enable x11 forwarding for ssh connection.	 The default is false.

GUI CONFIGURATOR
       Pushing control key and mouse button 3 invokes GUI configurator (mlcon‐
       fig).  It can modify encoding, foreground  and  background  color,  tab
       size, backlog size, font size, usage of combining character, and so on.

       GUI configurator has five pages (Encoding, Font, Background, Scrollbar,
       and Others), OK/Apply/Cancel buttons, and three special buttons.

       Note this feature needs GTK+ 2.x or later.

   Encoding page
       Encoding-related configurations are located in this  page.   Note  that
       configurations will be enabled when you push Apply button.

       Encoding
	      Specify encoding.	 (-E, --km)

       Input Method
	      Specify which input method to be used. (-M, --im)

	      XIM:

	      XIM Server
		     Specify  the name of XIM server to be connected.  You can
		     input from your keyboard or you can choose one of	regis‐
		     tered  XIM servers.  This doesn't have equivalent command
		     option.  See the section of XIM  Configuration  File  for
		     registration of XIM servers.

	      XIM locale
		     Specify  the name of the locale to be used for connection
		     to the XIM server.	  Popular  XIM	servers	 usually  have
		     acceptable	 locales  to  be  used for connection.	If you
		     choose registered XIM server in Input Method,  this  will
		     be set automatically.  You can also input the locale name
		     from your keyboard.

	      keyboard:

	      Option Specify the name of key mapping table. When  using	 ISCII
		     encoding,	Indic  key  mapping  is used automatically. In
		     other encodings,  this  will  be  automatically  selected
		     according to the current locale.

	      uim:

	      Option Specify  the name of the conversion engine to be used. If
		     you choose auto, the conversion engine will be  automati‐
		     cally selected according to the current locale.

	      Note this feature needs uim library.

	      m17n library:

	      Option Specify  the language and the input method to be used. If
		     you choose auto, the language and input  method  will  be
		     automatically selected according to the current locale.

	      Note this feature needs m17n library and m17n-db.

	      SCIM:

	      No option

       Bidi (UTF-8 only)
	      Whether to support BiDi (bi-direction).  (-D, --bi)

       Combining
	      Whether  to  support  combining characters by overstriking. (-m,
	      --comb)

       Process received strings via Unicode
	      When you paste some strings into mlterm, the  strings  are  con‐
	      verted into Unicode and then to mlterm encoding.	(-U, --viaucs)

   Font page
       Configurations related to appearance (or look&feel) are located in this
       page.

       Font size
	      Font size in pixel. (-w, --fontsize)

       Xft    Use xft for rendering engine. (-*, --type)

       Cairo  Use cairo for rendering engine. (-*, --type)

       Anti alias
	      Use anti-alias fonts by using Xft or cairo. (-A, --aa)

       Variable column width
	      Use variable column width. (-V, --varwidth)

       Vertical mode
	      Vertical writing mode. (-G, --vertical) Line space Specify  num‐
	      ber of extra dots between lines. (-o, --lsp)

       Font name
	      Specify  XLFD,  Xft  or cairo font for character sets.  "Select"
	      button shows a dialog to choose it.

       Line space
	      Line space in pixel. (-o, --lsp)

       Letter space
	      Letter space in pixel. (--csp)

       Width ratio
	      Specify actual screen width. (-1, --wscr)

       Height ratio
	      Specify actual screen height. (-2, --hscr)

       Foreground color
	      Foreground color for letters. (-f, --fg)

   Background page
       Configurations related to color and  background	are  located  in  this
       page.

       Background color
	      Background color. (-b, --bg)

       Picture
	      Specify  the  image  file to be used for background image.  (-p,
	      --pic)

       Transparent
	      Transparent background. (-t, --transbg)

       Picture/Transparent Brightness, Contrast and Gamma.
	      Brightness, contrast and gamma of the  background	 image.	  (-H,
	      --bright) (-3, --contrast) (-4, --gamma)

       Fade ratio on unfocus
	      Fading ratio when window is unfocused. (-r, --fade)

   Scrollbar page
       Configurations related to scrollbar are located in this page.

       Position
	      Specify scrollbar position. (-O, --sbmod)

       View   Specify name of scrollbar. (-S, --sbview)

       Foreground color
	      Specify foreground color of scrollbar. (-F, --sbfg)

       Background color
	      Specify background color of scrollbar. (-B, --sbbg)

   Others page
       Other configurations are located in this page.

       Tab size
	      Column number of tab. (-x, --tw)

       Backlog size
	      Number of lines of backlog. (-l, --sl)

       Meta key outputs
	      Behavior of META key. (-k, --meta)

       Bel mode
	      Behavior when mlterm receives BEL (0x07) code.  (-7, --bel)

       Combining = 1 (or 0) logical column(s)
	      Processing  combining  characters	 as  if it occupies one column
	      logically while it occupies zero column  on  the	screen.	  (-J,
	      --dyncomb)

       Fullwidth = 2 (or 1) logical column(s)
	      Processing  CJK  fullwidth characters as it occupies two columns
	      logically since it occupies two columns  on  the	screen.	  (-Z,
	      --multicol)

       Ambiguouswidth = fullwidth (UTF8 only)
	      Processing  Unicode  characters with EastAsianAmbiguous property
	      as fullwidth.  (-a, --ac)

   Buttons
       There are buttons which is independent from OK/Apply/Cancel buttons.

       OK/Apply/Cancel
	      OK button applies the  modified  configuration  to  the  current
	      mlterm session, saves it to "~/.mlterm/main" configuration file,
	      and quits the GUI Configurator.  Apply button just  applies  the
	      modified configuration to the current mlterm session.

       Font size (Larger and Smaller)
	      Change font size.

       PTY List
	      One  process  of	mlterm may have multiple sessions and screens.
	      The sessions may or may not have corresponding screen, i.e., the
	      number of sessions can be more than the number of screens.  Such
	      situation can be achieved by closing a part of multiple  screens
	      from -@/--screens option.	 In such case, the screen-less session
	      can be designated to one of  screens  by	choosing  the  session
	      (pty) from this list and push "select" button.

       Full reset
	      Reset internal status.

CONFIGURABLE MENU
       Pushing	control	 key and mouse button 1 invokes configurable menu dis‐
       player (mlterm-menu).  It displays a menu with items  such  as  "Larger
       Font"  or  "UTF-8  encoding".  Though a default menu definition is sup‐
       plied, you can freely define menu items by writing a menu configuration
       file.  See Menu Configuration File section for detail.

       Note this feature needs GTK+ 2.x or later.

MULTIPLE XIM
       mlterm  can use multiple XIM (X Input Method) servers.  The current XIM
       is specified by the GUI configurator.  Using this feature you can input
       multiple	 complex  languages such as Japanese and Korean.  Locale to be
       used for communication with XIM can also be specified for each XIM.  In
       the  GUI configurator, you can choose one of registered pair of XIM and
       its locale or you can input your favorite XIM and its locale.

       The locale for XIM is only used for communication with the XIM  and  is
       not related to the current mlterm locale.  You have to properly config‐
       ure the XIM locale only when your XIM has preference on the  locale  of
       XIM  client  (i.e., mlterm in this case).  mlterm automatically convert
       the inputed string into proper encoding and  you	 don't	have  to  care
       about it.

       Of  course  the	initial XIM is chosen by using standard configuration,
       i.e., using XMODIFIERS environmental variable.  See X(7) for detail  on
       XIM and XMODIFIERS variable.

DAEMON MODE
       When  invoked  with  -j/--daemon	 command line option, mlterm starts to
       listen on a unix domain socket and accept requests from mlclient.

       With blend  mlterm will exit when the final terminal window is  closed.
       But  with   genuine,  mlterm  will disconnect from X server windows and
       continues to work. In latter case, it's possible to stop and restart  a
       X server and revive the lasting sessions on mlterm.

SCROLLBAR
       mlterm  supports	 scrollbar  API	 so  that  users can develop scrollbar
       libraries with arbitrary look and feel.	The scrollbar libraries can be
       used by putting the libraries at the specified directory (determined on
       the compilation process) and invoke mlterm  with	 -s  -S	 name  option.
       Scrollbar libraries named "sample", "sample2", "athena", "motif", "moz‐
       modern", and "next" are supplied.

ANTI-ALIAS
       mlterm can use True Type fonts using -A	option	via  FreeType  library
       when it has been compiled with anti-alias option.

       Note  this  feature  needs XFree86 4.0.2 or above and FreeType 2.0.2 or
       above.

WALLPAPER
       mlterm can use background image	(as  known  as	wallpaper),  by	 using
       -p/--pic	 option.   You can also specify the brightness of the image by
       using -H/--bright option.

       Note this feature needs gdk-pixbuf.

MULTIPLE PTY
       This is one of most unique features of mlterm.  The number  of  windows
       can  be	specified  using -P option.  Typing control + F1 opens another
       window which shares the same process.  The maximum  number  of  windows
       can be specified using --maxptys option.

BACKSCROLL MODE
       mlterm  enters  into  backscroll	 mode  by typing Shift + up or Shift +
       PageUp key.  In the mode, you can use the following keys.

       j or Down
	      Scroll down one line.

       k or Up
	      Scroll up one line.

       d or PageDown
	      Scroll down one page.

       u or PageUp
	      Scroll up one page.

       Shift + space
	      Initialize XIM.

       Shift + Insert
	      Insert selection.

       Control + F1
	      Open a new pty window.

       keys defined in key configuration file
	      PAGE_UP, PAGE_DOWN, SCROLL_UP, and SCROLL_DOWN keys are  defined
	      in the file.

       other keys
	      Exit from the backscroll mode.

       Please  note that keys other than PAGE_UP and PAGE_DOWN in key configu‐
       ration file are	available  only	 when  you  used  -q/--extkey  command
       option.

SELECTION
       Selection is a mechanism to be used for copy-and-paste in X Window Sys‐
       tem.  Thus, this section describes on so-called copy-and-paste.

       There are many encodings in the	world.	 Though	 copy-and-paste	 needs
       sender  and receiver and each of them can use one of various encodings,
       mlterm is designed to be able to receive characters from various encod‐
       ings as much as possible.

       There  are  two	internationalized  types  of  selection.   One is COM‐
       POUND_TEXT  is  the   another   is   UTF8_STRING.    COMPOUND_TEXT   is
       ISO2022-based  and  can	distinguish  character	sets which a character
       belongs to.  However, the character sets which  COMPOUND_TEXT  supports
       are  limited  to ISO8859-* and East Asian character sets.  On the other
       hand, UTF8_STRING is Unicode-based and can express all characters  from
       Unicode	character set.	However, it cannot distinguish characters from
       different character sets which share one codepoint  in  Unicode,	 which
       can  be	a  problem  especially	for  CJK Han Ideogram (in other words,
       Kanji, Hanji, or Hanja).	 Note that UTF8_STRING is rather new  and  can
       be used only with XFree86.

       Though  the  receiver of copy-and-paste can request the preferable type
       of selection, the sender may not	 support  the  requested  type.	  Thus
       mlterm has to be able to process both of COMPOUND_TEXT and UTF8_STRING.

       On  the other hand, encodings supported by mlterm (see DESCRIPTION sec‐
       tion for detail) are classified into four categories;

       (a) Unicode itself
	      UTF-8.

       (b) subset of Unicode and ISO-2022-compliant
	      "Subset of Unicode" means that Unicode supports round-trip  com‐
	      patibility  for the encoding, i.e., the conversion of the encod‐
	      ing --> Unicode --> the encoding doesn't lose  any  information.
	      "ISO-2022-compliant"  means that the encoding can be regarded as
	      a subset of ISO-2022 where a part of ISO-2022 control codes  and
	      escape  sequences	 are  not  supported.	Many popular encodings
	      belong to this category such as ISO-8859-*, EUC-*,  ISO-2022-KR,
	      TIS-620, TCVN5712, and so on.

       (c) subset of Unicode and non-ISO-2022-compliant
	      Some of popular encodings such as Shift_JIS, Big5, GBK, GB18030,
	      Johab, and so on belongs to this category.

       (d) not subset of Unicode
	      ISO-2022-JP, ISO-2022-JP-2, ISO-2022-JP-3, EUC-TW,  and  so  on.
	      All of them are ISO-2022-compliant.

       Now the behavior of mlterm can be explained.

       -------------------------------------------------------
       encoding received selection  how to process?
       -------------------------------------------------------
	  a	COMPOUND_TEXT	    convert to Unicode
	  a	UTF8_STRING	    no need for conversion
	  b	COMPOUND_TEXT	    user preference *1
	  b	UTF8_STRING	    convert to the encoding *2
	  c	COMPOUND_TEXT	    user preference *1
	  c	UTF8_STRING	    convert to the encoding *2
	  d	COMPOUND_TEXT	    no need for conversion *3
	  d	UTF8_STRING	    convert to the encoding *2
       -------------------------------------------------------

       *1  Characters  from unsupported character sets (i.e., characters which
       cannot be expressed in the mlterm encoding) may appear in the selection
       (received  copy-and-paste  string).   If you want to receive characters
       which are equivalent to characters which are supported in  the  current
       mlterm  encoding	 (i.e.,	 characters  which share the same codepoint in
       Unicode), you can use -U (or --viaucs) option.  Otherwise, these	 char‐
       acters  are  pasted  into  mlterm  using ISO-2022 escape sequence (when
       mlterm encoding is category b).	Note such  ISO-2022  escape  sequences
       are illegal in the current mlterm encoding and the application software
       will need special feature to treat them properly,  though  it  is  dis‐
       played  well in mlterm.	When mlterm encoding is category c, such char‐
       acters are simply ignored (when -U option is not enabled).

       *2 Characters which cannot be converted into mlterm encoding are simply
       ignored.

       *3  Characters  from  unsupported  character  sets  will be pasted into
       mlterm using ISO-2022 escape sequence.

CONFIGURATION
       mlterm loads configuration files of "main", "font",  "vfont",  "tfont",
       "aafont", "vaafont", "taafont", "color", "key", "termcap", and "xim" on
       start up.  "menu" configuration file is loaded by the configurable menu
       displayer  (mlterm-menu).   See	the  section  of CONFIGURABLE MENU for
       detail.

       Configuration files for one user are  to	 be  located  in  "~/.mlterm/"
       directory, while location for configuration files for all users depends
       on  the	compilation   option.	 Possible   locations	are   "/etc/",
       "/etc/X11/", "/usr/X11R6/lib/X11/mlterm/", and so on.

       The names and the roles of configuration files are:

       main   Main configuration items which can be overridden by command line
	      options.

       font   Configurations for ordinary X fonts.

       vfont  Configurations for ordinary X fonts of variable column width.

       tfont  Configurations for ordinary X fonts of vertical writing.

       aafont Configurations for Xft or cairo fonts.

       vaafont
	      Configurations for Xft or cairo fonts of variable column width.

       taafont
	      Configurations for Xft or cairo fonts of vertical writing.

       color  Designate concrete RGB values for color names.

       key    Key definitions for special features of mlterm.

       termcap
	      Define mlterm's behaviors which  affects	terminfo  and  termcap
	      definition.

       xim    Define preset locales for X Input Methods which are shown in the
	      GUI configurator.	 Of course you can input XIM names and locales
	      for the GUI configurator which are not listed in this configura‐
	      tion file.

       menu   Define menu items which is displayed by configurable  menu  dis‐
	      player.

       The  contents of these configuration files (other than menu) consist of
       lines of "key=value" format.  Lines beginning with "#" are ignored.

       Note that the configuration files are changed since version 1.9.44.

   Main Configuration File
       This file contains main configuration items which can be overridden  by
       command	line options.  The main configuration file "main" has the fol‐
       lowing keys.  Parentheses show the corresponding command-line  options.
       See the explanation on these command-line options for detail.

       allow_osc52=bool (--osc52)
	      Allow access to clipboard(selection) by OSC 52 sequence.

       allow_change_shortcut=bool (--shortcut)
	      Allow  dynamic  change of shortcut keys by OSC 5379 set_shortcut
	      sequence.

       alpha=name (-X, --alpha)
	      Alpha in pseudo or true transparent.

       app_name=name (-N, --name)
	      Application name.	 auto_restart=bool (--restart) Restart	mlterm
	      with  all	 opened	 ptys except ssh if SIGSEGV, SIGBUS, SIGFPE or
	      SIGILL is received.  If you want	to  get	 core  image,  specify
	      "false".

       bel_mode=mode (-7, --bel)
	      Behavior when BEL (0x07) is received.

       bd_color=value (--bd)
	      Specify the color to use to display bold characters.

       bg_color=color (-b, --bg)
	      Background color.

       bidi_mode=mode (--bimode)
	      Specify bidi mode.

       blink_cursor=bool (--blink)
	      Blink cursor.

       box_drawing_font=value (--boxdraw)
	      Use  either  unicode  font  or DEC Special font forcibly to draw
	      box-drawing characters.

       brightness=value (-H, --brightness)
	      Specify the amount of darkening  or  lightening  the  background
	      image.

       big5_buggy=bool (-5, --big5bug)
	      Support  Big5  CTEXT  bugs  (which  exist	 in  XFree86  4.1.0 or
	      before).

       borderless=bool (-&, --borderless)
	      Don't draw window decorations.

       cipher_list=value (--ciphlist)
	      Specify ciphers (comma separated list) for  encrypting  the  ssh
	      session.

       col_size_of_width_a=value (-a, --ac)
	      Number  of columns of Unicode characters with EastAsianAmbiguous
	      property.

       compose_dec_special_font=bool (-Y, --decsp)
	      Compose line drawing character set.

       contrast=value (-3, --contrast)
	      Contrast of background image in percent.

       cursor_bg_color=color (-0, --crbg)
	      Specify background color for cursor.

       cursor_fg_color=color (-9, --crfg)
	      Specify foreground color for cursor.

       exit_backscroll_by_pty=bool (--exitbs)
	      Exit backscroll mode on receiving data from pty.

       encoding=encoding (-E, --km)
	      Specify encoding.

       daemon_mode=mode (-j, --daemon)
	      Start as a daemon process.

       default_server=value (--serv)
	      Specify a host you want to connect via ssh etc.

       depth=value (--depth)
	      Specify visual depth.

       display=value (-d, --display)
	      Specify X server to connect.

       fade_ratio=ratio (-r, --fade_ratio)
	      Specify fading ratio when window is unfocused.

       fg_color=color (-f, --fg)
	      Foreground color.

       fontsize=value (-w, --fontsize)
	      Font size in pixel.

       font_size_range=range (-R, --fsrange)
	      Range of size of usable fonts.

       gamma=value (-4, --gamma)
	      Gamma of background image in percent.

       geometry=value (-g, --geometry)
	      Specify size and position of the window; see X(7).

       hide_underline=bool (--noul)
	      Don't draw underline.

       icon_name=name (-I, --icon)
	      Icon name.

       icon_path=path
	      Path for the image file to be used as window icon.

       inner_border=value (--border)
	      Specify inner border width.

       input_method= input method : [ arguments ... ] (-M, --im)
	      Specify input method.

       iso88591_font_for_usascii=bool (-8, --88591)
	      Use ISO8859-1 fonts for US-ASCII part of various encodings.

       letter_space=value (--csp)
	      Specify number of extra dots between letters.  (ignored  if  you
	      specify --V option.)  If you use multiple fonts whose widths are
	      different, adjust this option.

       line_space=value (-o, --lsp)
	      Specify number of extra dots between lines.  If you use multiple
	      fonts whose heights are different, adjust this option.

       logging_msg=bool (--logmsg)
	      Enable logging messages of mlterm to ~/.mlterm/msg[pid].log.

       logging_vt_seq=bool (--logseq)
	      Enable logging vt100 sequences to ~/.mlterm/[device].log.

       logsize=value (-l, --sl)
	      Specify number of lines of backlog.

       max_ptys=value (--maxptys)
	      Specify  maximum number of ptys (sessions) to be opened simulta‐
	      neously.

       mod_meta_mode=mode (-k, --meta)
	      Behavior of META key.

       mod_meta_key=value (-K, --metakey)
	      Specify a key to be regarded as META.

       not_use_unicode_font=bool (-n, --noucsfont)
	      Use non-Unicode fonts even when mlterm encoding is UTF-8.

       only_use_unicode_font=bool (-u, --onlyucsfont)
	      Use Unicode fonts even when mlterm encoding is not UTF-8.

       parent_window=value (--parent)
	      Specify parent Window ID.

       receive_string_via_ucs=bool (-U, --viaucs)
	      If the received  selection  (i.e.,  copy-and-paste  strings)  or
	      strings  received	 from  XIM is not UTF8_STRING type, convert it
	      into Unicode and then to the current mlterm encoding,  in	 order
	      to  identify equivalent characters (i.e., characters which share
	      the same codepoint in Unicode) from various character sets.  See
	      SELECTION section below for detail.

       sb_bg_color=color (-B, --sbbg)
	      Background color for scrollbar.

       sb_fg_color=color (-F, --sbfg)
	      Foreground color for scrollbar.

       screen_height_ratio=value (-1, --hscr)
	      Specify actual screen height.

       screen_width_ratio=value (-1, --wscr)
	      Specify actual screen width.

       scrollbar_mode=mode (-O, --sbmod)
	      Specify scrollbar position.

       scrollbar_view_name=name (-S, --sbview)
	      Specify name of scrollbar.

       ssh_keepalive_interval=value (--keepalive)
	      Specify  interval	 seconds  to  send  keepalive  message	to ssh
	      server.

       ssh_public_key=value (--pubkey)
	      Specify public key file for ssh connection.

       ssh_private_key=value (--privkey)
	      Specify private key file for ssh connection.

       ssh_x11_forwarding=bool (--x11)
	      Enable x11 forwarding for ssh connection.

       step_in_changing_font_size (-z, --largesmall)
	      Specify changing size when font size becomes larger or smaller.

       tabsize=value (-x, --tw)
	      Specify tab width.

       termtype=string (-y, --term)
	      Terminal type.

       title=name (-T, --title)
	      Title name.

       type_engine=value (-*, --type)
	      Rendering engine for drawing fonts.

       ul_color=value (--ul)
	      Specify the color to use to display underlined characters.

       use_alt_buffer=bool (--altbuf)
	      Use alternate screen buffer.

       use_ansi_colors=bool (--colors)
	      Recognize ANSI color change escape sequences.

       use_anti_alias=bool (-A, --aa)
	      Use anti alias font.

       use_bidi=bool (-D, --bi)
	      Use BiDi rendering on UTF8 encoding.

       use_bold_font=bool (--bdfont)
	      Use bold font for characters with the bold attribute.

       use_clipboard=bool (-P, --clip)
	      Use CLIPBOARD (not only PRIMARY) selection.

       use_combining=bool (-m, --comb)
	      Enable combining characters.

       use_cp932_ucs_for_xft=bool (-c, --cp932)
	      Use CP932 - UCS mapping for displaying JISX0208 by Xft or cairo.

       use_dynamic_comb=bool (-J, --dyncomb)
	      Enable dynamic character combining.

       use_extended_scroll_shortcut=bool (-q, --extkey)
	      Enable extended short cut keys for scrolling.

       use_ind=bool (-C, --ind)
	      Use indic rendering on UTF8 or ISCII encoding.

       use_local_echo=bool (--loecho)
	      Use local echo mode.

       use_login_shell=bool (-L, --ls)
	      Whether to use login shell or not.

       use_multi_column_char=bool (-Z, --multicol)
	      Process full width characters.

       use_scrollbar=bool (-s, --sb)
	      Use scrollbar.

       use_transbg=bool (-t, --transbg)
	      Use transparent background.

       use_unicode_property=bool (--ucsprop)
	      Use unicode properties in encodings excepting UTF-8.

       use_urgent_bell=bool (--urgent)
	      Draw the user's attention when making a bell sound in the	 unfo‐
	      cused window.

       use_variable_column_width=bool (-V, --varwidth)
	      Use variable column width.

       use_vertical_cursor=value (-Q, --vcur)
	      Use cursor movement for vertical writing.

       use_xim=bool (-i, --xim)
	      Use XIM (X Input Method).

       vertical_mode=value (-G, --vertical)
	      Use vertical writing.

       wall_picture=path (-p, --pic)
	      Path for wallpaper image.

       word_separators=characterlist (-W, --sep)
	      Delimiter characters used for word selection.

       static_backscroll_mode=bool (-6, --stbs)
	      Don't  exit  backscroll  mode  when  console applications output
	      something.

   Font Configuration Files
       The font configuration files "font", "vfont", "tfont", "aafont",	 "vaa‐
       font", and "taafont" have the following keys.

       DEFAULT=fonts
       DEC_SPECIAL=fonts
       ISO8859_n=fonts
       TIS620=fonts
       ISCII_HINDI=fonts
       ISCII_MALAYALAM=fonts
       ISCII_ASSAMESE=fonts
       ISCII_BENGALI=fonts
       ISCII_GUJARATI=fonts
       ISCII_KANNADA=fonts
       ISCII_MALAYALAM=fonts
       ISCII_ORIYA=fonts
       ISCII_PUNJABI=fonts
       ISCII_ROMAN=fonts
       ISCII_TAMIL=fonts
       ISCII_TELUGU=fonts
       VISCII=fonts
       KOI8_R=fonts
       KOI8_U=fonts
       TCVN5712=fonts
       JISX0201_ROMAN=fonts
       JISX0201_KATA=fonts
       JISX0208_1978=fonts
       JISX0208_1983=fonts
       JISX0208_1990=fonts
       JISX0213_2000_1=fonts
       JISX0213_2000_2=fonts
       KSX1001_1997=fonts
       UHC=fonts (not used)
       JOHAB=fonts (not used)
       GB2312_80=fonts
       GBK=fonts
       BIG5=fonts
       HKSCS=fonts
       CNS11643_1992_n=fonts
       ISO10646_UCS4_1=fonts
       ISO10646_UCS4_1_BIWIDTH=fonts
	      Specify  fonts  for corresponding character sets.	 The format is
	      different between "font", "vfont" "tfont"	 files	and  "aafont",
	      "vaafont" "taafont" files.

	      In  "font",  "vfont",  "tfont"  files,  "font"  is  specified in
	      "NAME:PERCENT;SIZE,NAME:PERCENT;SIZE,NAME:PERCENT;..."	format
	      where  "SIZE" is font size in pixel, and "NAME" is XLFD or alias
	      names of X fonts.	 If the first  "NAME"  contains	 "%d",	it  is
	      replaced by an appropriate font size number.  ":PERCENT" is mul‐
	      tiplied by font size and decides character width of a font.   If
	      ":PERCENT" is omitted, max font width is used for it.

	      In  "aafont", "vaafont", "taafont" files, "font" is specified in
	      "FAMILY WEIGHT  SLANT  SIZE-ENCODING:PERCENT;SIZE,FAMILY	WEIGHT
	      SLANT SIZE-ENCODING:PERCENT;SIZE,FAMILY WEIGHT SLANT SIZE-ENCOD‐
	      ING:PERCENT;..."	format.	 The first pair of FAMILY WEIGHT SLANT
	      SIZE and ENCODING specifies the default font and the others with
	      SIZE are for specific sizes.  ":PERCENT" is multiplied  by  font
	      size  and	 decides  character width of a font.  If ":PERCENT" is
	      omitted, 'W' width is used for it.

       charset_BOLD=fonts
	      Specify boldface fonts.

       charset_ITALIC=fonts
	      Specify italic fonts.

       charset_BOLD_ITALIC=fonts
	      Specify bold-italic fonts.

   Color Configuration File
       The color configuration file "color" has the following key.

       COLORNAME=RGB
	      Assign a concrete color for the name COLORNAME.  Default	colors
	      used  by	mlterm	are  black, red, green, yellow, blue, magenta,
	      cyan, and white.	and can be overridden here.

	      For hilighted colors, a name with "hl_" prefix will be automati‐
	      cally  searched.	 i.e.  for  bold  read	character, "hl_red" is
	      searched instead of "red".

	      17 - 230 and 232 - 255 in 256 colors can be also overridden.

	      The format of RGB is either "RRRR-GGGG-BBBB" (where RRRR,	 GGGG,
	      and  BBBB	 are  hexadecimal  value  from	0 to ffff), "#RRGGBB",
	      "#RRGGBBAA", "rgb:RR/GG/BB" or "rgba:RR/GG/BB/AA"(where RR,  GG,
	      and BB are hexadecimal value from 00 to ff).

	      If mlterm failed to parse a entry, the color will be regarded as
	      black.

   XIM Configuration File
       The X Input Methods configuration file "xim" has the following format

       XIM=locale

       where XIM is XIM name and locale is locale name used for	 communication
       with the XIM server.  For example,
       kinput2=ja_JP.eucJP
       Ami=ko_KR.eucKR
       xcin-zh_CN.GB2312=zh_CN.GB2312
       These settings are used to create list of XIMs by the GUI configurator.
       Though a XIM which is not listed in this file can't  be	selected  from
       the list, it can be selected by specifying its name directly.

   Feature Key Configuration File
       The feature key configuration file "key" has the following format.

       KEY=FEATURE

       Here, the format for KEY is "(MASK+)KEY", where MASK is one of Control,
       Shift, Mod1, Mod2, Mod3, Mod4, Mod5 and Mod.  You can specify  multiple
       "MASK+"s.   You	can search spellings of KEY by using xev(1) command or
       searching keysym macros	from  /usr/X11R6/include/X11/keysymdefs.h  (or
       the  equivalent file in your X11 include directory) and omit the prefix
       XK_.  Double quotation marks are not needed.  You can specify  Button1,
       Button2, Button3, Button4 or Button5 as KEY.

       FEATURE	is  one of IM_HOTKEY, EXT_KBD, OPEN_SCREEN, NEW_PTY, OPEN_PTY,
       NEXT_PTY,  PREV_PTY,  PAGE_UP,	PAGE_DOWN,   SCROLL_UP,	  SCROLL_DOWN,
       INSERT_SELECTION, SWITCH_OSC52, "STRING", or "proto:STRING".

       IM_HOTKEY
	      Switch  conversion  mode	of m17n library and kdb input methods.
	      (default UNUSED)

       EXT_KBD
	      Activate or deactivate kbd  input	 method.   (This  feature  was
	      obsoleted by IM_HOTKEY)

       OPEN_SCREEN
	      Open new pty in new screen (default Ctrl+F1).

       NEW_PTY
	      Same as OPEN_SCREEN (obsoleted).

       OPEN_PTY
	      Open new pty in current screen (default Ctrl+F2).

       NEXT_PTY
	      Switch to a next free pty (default Ctrl+F3).

       PREV_PTY
	      Switch to a previous free pty (default Ctrl+F4).

       PAGE_UP
	      Start   backscroll   mode	  and  scroll  up  one	page  (default
	      Shift+Prior).

       PAGE_DOWN
	      Scroll down one page.  (default Shift+Next).

       SCROLL_UP
	      Start backscroll	mode  and  scroll  up  by  one	line  (default
	      Shift+Up).   Note	 this  key  is	enabled	 only when -q/--extkey
	      option is used.

       SCROLL_DOWN
	      Scroll down one line (default Shift+Down).   Note	 this  key  is
	      enabled only when -q/--extkey option is used.

       INSERT_SELECTION
	      Insert selection (default Shift+Insert).

       SWITCH_OSC52
	      Allow  or forbid access to clipboard by OSC 52 sequence (default
	      UNUSED).

       "STRING"
	      The specified string is issued when  the	KEY  key  is  pressed.
	      Double  quotation	 marks	are  required around the STRING.  Note
	      that you cannot control the status of mlterm by sending terminal
	      control  codes such as "\x1b]5379;encoding=utf8\x0a" because the
	      code sequence will be caught by your shell (or something running
	      on  it).	 To  deliver control sequences to mlterm directly, use
	      "proto:STRING" instead.

       "proto:STRING"
	      The specified string is assumed  to  mlterm's  original  control
	      sequence.	 A  list of sequences should be found in doc/en/PROTO‐
	      COL.  For example, "proto:encoding=utf8" means changing the cur‐
	      rent character encoding to UTF-8.

       "exesel:STRING"
	      The specified string is assumed to a command to be executed with
	      selected strings as arguments.  For example, "exesel:mlclient -e
	      w3m" means executing "mlclient -e w3m [selected text]".

       "menu:STRING"
	      The specified string is assumed to a configuration program to be
	      executed.	  For  example,	 "menu:mlterm-menu"  means   executing
	      mlterm-menu.

   Terminal Behavior Configuration File
       This  configuration file determines the behaviors of mlterm that should
       match the definition of terminfo and termcap.  In principle, this  file
       should not be edited and, instead, you should choose a proper value for
       TERM variable (i.e., proper terminfo/termcap  definition)  which	 meets
       mlterm's	 behavior.  (Since mlterm' can behave as a xterm/kterm to some
       extent, TERM=kterm / TERM=xterm should give acceptable results.)	  How‐
       ever,  sometimes	 you  may  not want to edit your terminfo and termcap.
       Your software may don't understand terminfo nor termcap, or  your  ter‐
       minfo/termcap  entry is shared by several terminal emulators and chang‐
       ing it will break other terminals.  In such cases,  you	can  configure
       mlterm  so  that it works well on existing terminfo/termcap definitions
       on your systems.	 This is also useful  for  distributors	 of  operating
       systems	(like Debian) with strict policy of terminal emulators' behav‐
       iors.

       You can define the behaviors of mlterm for each value of TERM variable,
       so  that	 you  don't need to edit termcap file each time you login into
       other systems and use different value of TERM variable  by  -y  option.
       You can also specify the default behavior when TERM variable is differ‐
       ent from all of specified TERM names in the termcap file.

       The grammar of this configuration file is resemble to  the  grammar  of
       termcap	entries.  First, one or more name(s) of TERM is written.  Mul‐
       tiple names are connected with vertical line  character	'|'.   Special
       name  '*'  is  for default.  Then colon ':' comes, and keys are written
       separated by colons.  Configuration(s) for other TERM will follow after
       new line.

       Followings are available keys for each TERM value.

       kD=sequence
	      Specify  sequence	 to  be	 outputted  when  Delete key is pushed
	      (default \E[3~).

       kb=sequence
	      Specify sequence to be outputted when BackSpace  key  is	pushed
	      (default ^H).

       kh=sequence
	      Specify  sequence	 to  be	 outputted  when HOME key is pushed in
	      application cursor key mode.  (default \EOH).

       @7=sequence
	      Specify sequence to be outputted	when  END  key	is  pushed  in
	      application cursor key mode.  (default \EOF).

       k1=sequence
	      Specify  sequence to be outputted when F1 key is pushed (default
	      \EOP).

       k2=sequence
	      Specify sequence to be outputted when F2 key is pushed  (default
	      \EOQ).

       k3=sequence
	      Specify  sequence to be outputted when F3 key is pushed (default
	      \EOR).

       k4=sequence
	      Specify sequence to be outputted when F4 key is pushed  (default
	      \EOS).

       k5=sequence
	      Specify  sequence to be outputted when F5 key is pushed (default
	      \E[15~).

       ut     Specify the way how the screen is erased by control  codes.   If
	      ut  is written in the termcap file, charcells are painted by the
	      current background color when erased;  otherwise	the  charcells
	      are  painted by the initial background color.  Default is non-ut
	      behavior.

       The following special characters can be used  to	 specify  sequence  in
       keys of kD/kb/kh/@7.

       \E     ESC code (0x1b).

       ^?     DEL code (0x7f).

       ^A, ^B,...
	      Corresponding control code (0x01 - 0x1a).

   Menu Configuration File
       This  configuration file defines the menu displayed by the configurable
       menu displayer mlterm-menu.  See CONFIGURABLE MENU section for detail.

SEE ALSO
       Manual pages of	mlclient(1),  locale(7),  charsets(7),	UTF-8(7),  and
       X(7).

       README.sb for development of scrollbar library.

       PROTOCOL for mlterm's original control escape sequences.

       Mapping tables between Unicode and local character sets (and encodings)
       are found at Unicode Consortium web  site  (http://www.unicode.org/Pub‐
       lic/MAPPINGS/).	Note that mapping tables for East Asian character sets
       and encodings are moved to  OBSOLETE/EASTASIA  directory	 of  the  site
       since August 2001.

       For  BIG5  and BIG5HKSCS encodings, mapping tables for Unicode is taken
       from ftp://xcin.linux.org.tw/pub/xcin/i18n/charset/.

       Unicode Standard Annex (UAX) #11 East Asian Width, which explains  East
       Asian  Width  properties,  and  EastAsianWidth.txt, which defines East‐
       AsianAmbiguous characters in Unicode, are supplied by  Unicode  Consor‐
       tium (http://www.unicode.org).

FILES
       "main",	"font",	 "vfont",  "tfont",  "aafont",	"vaafont",  "taafont",
       "color", "key", "termcap", "xim", and "menu"
	      Configuration files.

CONTACT
       Subscribe	mlterm-dev-en	      ML	 (http://lists.source‐
       forge.net/lists/listinfo/mlterm-dev-en).

				  2013-08-06			     MLTERM(1)
[top]

List of man pages available for OpenSuSE

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net