(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 comman 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
.Melt xelnx___.tgz file on PC(___:version). ex) "tar -xvzf xelnx107.tgz".
Then copy files in xe___ dir to the directory in the PATH.
Binary are compiled on RedHat9.
Linux may have incompatibility of glibc version(shared lib).
Check version by .ver file in the bin dir or see note of (2).)
directory structure is as following.
topdir +lnx
+--bin
+--doc
+--sample
+--xehelp
.Set symbolic link for help command.
html for help is searched as following sequence.
dir specified by "-hd" command line parameter
dir specified by "xehelp" environment variable.
xehelp on workdir(~/xe_wdnnnnn)
/usr/local/share/gnome/help/xxe (This can be changed by modifying packagehelpdir variable of configure.in)
~/xehelp
/usr/local/share/gnome/help/xxe
/usr/local/share/doc/xxe
/usr/share/doc/xxe
set symbolic link.
ex)
ln -s /d/mydoc/xehelp /usr/local/share/gnome/help/xxe
ln -s /d/mydoc/xehelp ~/xehelp (home dir).
(assumed that html files area in the dir /d/mydoc/xehelp)
.Copy wxe.png appended to /usr/local/share/pixmaps/gxe
after mkdir the dir.
(1-C) Execution.
#ifdef XXE
Enter "gxe [filename]" on terminal emulator.
Or, create shortcut icon on desctop 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.
Especialy 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 dislaog".
Select "Show Search Dialog" then push "Custom" radio button.
Reboot is required.