THE INSTALL INSTRUCTIONS FOR XPEXESO PROGRAM
           ============================================
           July 1999                          Petr Olsak

You can install the program using the following commands:

$ zcat xpexeso.tar.gz | tar xvf -
$ cd xpexeso
$ xmkmf
$ make depend; make
$ su
# make install

This way installs the program localized for Czech language. The data
files are installed in /usr/local/lib/xpexeso and the xpexeso binary
in /usr/local/bin. If you disagree with this policy, you have to edit
the Imakefile and config.h before xmkmf command.

The rules of this game are described in help instructions files, see
pexdoc-cz or pexdoc-eng.

The files pexset-eng or pexset-cz are important for program
functionality. They are text files with information where
data of pictures are stored. If you has no right for "make install" 
or you want only to try the program, you have to tell the program 
about the pexset-eng file location. For example, you can run the
program by the following way:

./xpexeso -set pexset-cz -doc pexdoc-cz

The files Xpexeso-cz and Xpexeso-eng include the default values of
attributes. You can change the "look" of the program by changing these
values. You need not install these files because these defaults are
compiled into program (see attribs-*.h files). If you want to change some
value, copy the Xpexeso-cz or Xpexeso-eng file into your home directory or
X11/lib/app-defaults and rename it to Xpexeso.

Possible problems
-----------------

If some problem occurs, you can run the program with  -log -  option
and read the detail program output. The frequently problem may be with
reading the xpm files. The error with "XpmReadFile" code is reported
in such case. There are four different codes:

-1 ... The xpm file is unable to open. You can check the access
       permissions to the file and you can test if the gunzip program
       is installed correctly. All pictures data are distributed with
       gzip compression. If our system does not support it, you can
       gunzip all xpm files (may be on different OS) and edit the
       pexset-eng file (change the extension form ".xpm.gz" to ".xpm").
-2 ... The xpm file is corrupted.
-3 ... No more memory in X server. Stop some another programs or X
       sessions on another diplay number and try again.
-4 or 1 ... the Color problem. This error is possible on X servers
       with 8 bit color depth (256 colors only). You can try to quit
       some color expensive applications (Netscape, photo on desktop,
       ...) and try again. The default pic-set allocates only 23
       colors, but another pic-sets may allocate more colors. If you
       has switched between picture sets, colors may be exhausted.
       You can try to restart xpexeso and to switch to desired picture
       set only. The another solution of this problem is to buy the
       modern X server with more color depth.

The modifications of the program
--------------------------------

You can insert his own picture set. Make 33 pictures (one for back
side) with the same pixel dimension (80x80 is recommended). Use the
minimal color palette due to problems with poor color X servers. Next
edit the pexset-eng file and try. The -log - parameter is recommended
while trying.

If you want to make the new language variant of the program, you need to
translate the following files:

attribs-eng.h  ... default values of attributes
Xpexeso-eng    ... the attrib file for users experiments
phrases-eng.h  ... the texts used by printf in program (you can use
                   catalogues from locales, but it is not necessary).
pexdoc-eng     ... the documentation and help information
INSTALL-eng    ... this file