This package contains the executables required to run the X2 editor under the
Linux operating system.  This version was compiled with RedHat 8.0 and IBM
Object Rexx 2.0.  The curses version was compiled with ncurses version 5.2.

The Unix OS presents certain challenges in porting an Intel based editor,
particularly in the keyboard support.  The known problems with this release
are:

  -  The ctrl-arrow, ctrl-enter, and ctrl-keypad keys are dead, at least on
     my system
  -  Ctrl-F keys are interpreted as the base F keys
  -  The Alt F keys are intercepted by the OS
  -  There seems to be no support for a big cursor, so the cursor is the same
     whether in Insert or Replace mode.  You need to check the Ins/Rep
     indicator in the top right corner.
  -  Linux only provides 8 colours (black, red, green, yellow, blue,
     magenta, cyan, and white) for foreground and background, so the light
     colours have been translated to their base counterparts.  Care should be
     taken with the TERM environment variable if you want colour with the
     curses version.  TERM=xterm does not seem to support colour, at least
     on my system, while TERM=linux seems better.
  -  Displaying characters with a value of 0x80 or higher causes a flashing
     string of characters to be shown

Most of the above problems do not appear if you are running the X-Windows
version, so I recommend you use that whenever possible.  REXX support is now
included in both the curses and X-Windows versions; if you don't have REXX
installed on your system, the editor should still work, but will complain if
you try to invoke a macro.

This package contains the following files:

  -  x		   - The main executable for fullscreen (curses) sessions
  -  xx		   - The main executable for X-Windows sessions
  -  xprofile      - The profile generation program
  -  xprofile.def  - The base profile
  -  xprofile.unx  - Profile overrides for Unix systems
  -  xutils.so     - The utilities shared library
  -  xunix.hlp     - A quick help file, with all code points of 0x80 or higher
		     removed
  -  x2install     - A bash-based shell script to assist with installation.  Read
		     this program before running it!
  -  README	   - This documentation file

To install it, unpack the files with "tar -zxvf" (alternatively you may use
GUNZIP and TAR -XVF), and generate your profile with the xprofile program.
Set your X2PATH environment variable according to your current shell.  Place
xutils.so on your LD_LIBRARY_PATH.  The shell script X2INSTALL may help with
this.

Note that there has been a change in the location of the terminfo data base;
it was in /usr/share/terminfo but now it's in /usr/lib/terminfo.

You should be able to fix it by either setting the TERMINFO environment
variable to say exactly where your terminfo database is (try "EXPORT
TERMINFO=/usr/lib/terminfo") or making a symbolic link between
/usr/lib/terminfo and /usr/share/terminfo.

Version 2.00.7 fullscreen was compiled with the ncurses 5.2 libraries and
includes a re-worked keyboard interface.  Please let me know if you find keys
that used to work but are now dead or misbehaving.

If you're running KDE on RedHat 7.0 you might be interested in the following
information which was submitted by a user.

  To fix the F keys from KDE on Linux 7.0, go into the Control Center, Look
  and Feel, Key Bindings.  Look at the keys mappings for the other virtual
  desktops (2 to 20 or so).  Many of these are mapped to c-F<somehting>.
  Either remap these keys (I like shift-cntl-F<x> since X2 does not use
  shift-cntl).  Apparently X/KDE grabs Alt-whatever amd ctrl-whatever before
  they get to the applications.  So, you may also have to change the mapping
  of alt-F12 (default is MOUSE MOTIONS).

  Also in key mappings, look at the application mappings.  There are a couple
  of these that steal keys X2 uses, but I don't think it inter- feres with
  normal operation.  This is something to fix if after making the changes
  above something still isn't working.

  I have also had key mappings just go crazy and things like alt-L stops
  working.  I solved this by logging out and back in.  Be sure to NOT save
  your session as you logout.  I also discovered that the scroll-lock can
  cause this behavior.  Try toggling scroll-lock even if you think it's set
  right.  Especially true if you are using a KVM switch.

  One fix:  NumLock off then shift-keypad will generate the numbers.

Version 2.01.2 will look for Regina Rexx if it can't find IBM Object Rexx.
Note that the libregina.so library, version 2.2, will not load if you don't
have the crypt module available.  I downloaded the source and undefined the
HAVE_CRYPT variable in config.h before re-compiling.

Please report all bugs and suggestions to me at blair@tangbu.com.

Blair Thompson, August 17, 2003
