(1) How to start.

(1-A) Installation from source package

  .Melt gxe-v.rr.tar.gz file on PC(v.rr:version). ex) "tar -xvzf gxe-1.23.tar.gz".
    In the top directory expanded,
      ./configure        (generate Makefile)
      make               (compile & link)
        (See README in the top dir for installation troubles)
      directory structure is as following.
        topdir--README
               +src-                           gxe,gxeDebug
                   +--xe                       xe,xeDebug,xe3270,xe3270Debug
                   +--xsub                     command line tools such as xfc.
                   +--xp                       xprint
                   +--sample
               +--doc-
                   +--en                       flat file document(English)
                   +--jp                       flat file document(Japanese,SJIS and EUC)
                   +--xehelp                   Html documents used by help command and help menu selection.
                                               Icon image wxe.png is here.

      (See also (2) about doc files)
  .You can install some objects including wxe.png to the default directory using "make install".
    (root permission is required)
     gxe,xe,xprint,xfc -->/usr/local/bin                     (this can be changed by --bindir option for make)
     xehelp            -->/usr/local/share/gnome/help/gxe    (packagehelpdir variable of configure.in)
     wxe.png           -->/usr/local/share/pixmaps/gxe
     move binaries what you want to the directory on the PATH.
     xxxDebug is binary compiled with -g option.
     Install other executable manualy such as tool in xsub directory.

(1-B) Installation from binary package

        (src package only from v1.27.)

(1-C) Execution.

#ifdef XXE

   Enter "gxe [filename]" on terminal emulator.
   Or, create shortcut icon on desktop using wxe.png.

#else
  .Start xe by "xe [filename]".

   Command line parm is displayed by "xe --h"(help only for Linux)
   or "xe -h"(common help).

  (Note)-xe works in console mode(run-level=3) and on terminal emulator
         on X(run-level=5).
         X setup is required when work on xterm/kterm/gnome-terminal. See (4)
         See (5) for mouse operation.
         Use Ctrl+Alt+Fn(n:1-->6) to switch to console n.
         Console that startx is issued is not avail,usualy it is
         console 1.
         Use Ctrl+Alt+F7 to switch back to X.
         Unlike console mode,terminal emulator's key-binding is limited.
         To utilize more function key on terminal emulator,
         X setup such as key-binding is required.
         See (4) for setup X, (5) for mouse operation.

        -When use xe on puTTY(**), use puTTY with patch to enable key remapping.
         There is no need to set X environment and to consider what type of terminal emulator
         on which xe works.
         (**) puTTY:free open source telnet client program by Mr. Simon Tatham.
              My patch is to enable general key remapping for xe to utilize
              all shift modifier key conbination.
              Download puttykm.tgz from //www.geocities.jp/sakachin2/index.htm.
              It may be more convenient to run xe on puTTY localy
              than on terminal emulator directly such as gnome-teminal
              with xelnxkey.xxx.
              See also description in (6)Sample file-(i)puTTY.xekeymap.
#endif

  (Note)-Work directory xe_wdnnnnn and xe_undel_nnnnn(nnnnn:UserID)
         are created in ~/(HOME) or /tmp if HOME is / (root).
         Work directory is set to any name if you need ,specifying it
         by env-variable(export xe=xxxx) or -wxxx command line parameter.
         Or env-variable(export xe_undel=xxxx for undo linecmd on dir-list.
#endif
        -Under KDE environment,start may fail by "error loading shared libraries:..."
         for libgnomevfs, libnomeprint etc.(Case of binary package installation)
         To fix this error,install another gnome application using installer.
         For Kubuntu 6.10,I installed "GNU paint" and "Glade" using "Adept installer"
         with "Any suite" selected.

        -When xe or gxe is hunged.
         Kill the process on the console mode screen.
         X mode is changed to console mode by Ctl+Alt+Fn(n is from 2 to 6),
         and use Ctl+Alt+F7 to back to X mode.
         To kill process,get processId by
           ps -ef|grep xe
         Then enter kill command.(nnnn is processId)
           kill -9 nnnn

        -Adjustment of keyboard rate.
         For Console mode,set "kbdrate -r 6 -d 250" in /etc/rc.local.
         (6:characters per second when repeat. 250:wait 250ms to generate repeated char)
         For X(gterm etc),Open keyboard rate panel by Desktop->Personal->Keyboard.
         Adjust cps and delay parameter testing on TextBox bellow.

        -If WindowManager reacts to the key operation or if xe dose not react,
         adjust system defined shortcut keys and xe key assignments.
         Especially many short cut keys are defined on Kubuntu edgy.
         To change shortcut key definition,
         System->Preference->keyboard shortcut for FC5,
         SystemSettings->Computer Administrations->Keyboard & Mouse->keyboard shortcuts for Kubuntu edgy.
         for openSUSE10:
           Configure Desktop Personal Settings->Regional & Accessibility
           ->keyboard Shortcuts.
           F12 popup Kerry Beagle Search as default.
           To disable F12,push "Open configuration dialog".
           Select "Show Search Dialog" then push "Custom" radio button.
           Reboot is required.