This is the directory where you configure, compile, and install Xcoral-3.42.
In the subdirectory Doc, you will find the complete User manual as a
Postscript document xcoral-3.42.ps and also xcoral-card.ps.
Preamble:
---------
Xcoral has been developped on Sun Solaris OS with MIT X11 R6
Window System and GNU gcc compiler. Now we compile and test it on
Linux system and Sun Solaris. Xcoral has been built on the top of Xlib.
We have compiled and tested Xcoral (a little) on other systems
(*BSD, Hpux, Aix and Irix).
To build Xcoral, you need only the X11 library (libX11). It's
better if you have the MIT X Window System distribution rather than
a proprietary X Window System. You can use your native cc compiler
(if it exists...), but it's better to use the GNU gcc compiler.
Linux, Solaris, FreeBSD, Hpux, Aix and Irix.
How To Compile And Install Xcoral:
----------------------------------
Basically the following commands built and install xcoral:
$ ./configure
$ make
$ make install
A/ Type "./configure". This runs a configuration script created by
GNU autoconf, which configures Xcoral for your system and creates
Makekiles. The configure script allows you to customize the
configuration for your site; for details on how you can do this,
type "./configure --help". The default installation directory is
"/usr/local". If you want to specify another directory we suggest
you to use "--prefix" option as follow :
$ mkdir /usr/local/xcoral
$ ./configure --prefix=/usr/local/xcoral
Another way to customize the configure script is to define
environment variables before running it :
MAKE ---> the command to run make
CC ---> the command to run C compiler
CFLAGS ---> the C compiler options
LDFLAGS ---> the linker options
LIBS ---> the linker extra libraries
In this case the environment variables will supersede the
configure script ones.
Example :
$ # for ksh, bash...
$ export MAKE=gmake
$ ./configure...
or
$ # for csh, tcsh...
$ setenv MAKE gmake
$ ./configure...
B/ Type "make". This will compile Xcoral.
C/ Type "make install" to install Xcoral binary and Smac files in
standard places. You'll need write permission on the installation
directories to do this. See the Makefile for information on what
directories were chosen; you can override these choices by modifying
the "prefix" variable in the Makefile.
Warning, in Smac directory, the word.h file must be the one
of your system (char,int and pointer alignment).
On SunOS, Solaris, Linux, FreeBSD, Hpux, Irix, and Aix
the file word.h is generated correctly by make.
In the other cases, try to build word.h (See target word.h in
Smac/Makefile).
If you have a 8 bits keys Keyboard (accentued char), use the
LANG environment variable (fr, de etc). Xcoral uses setlocale
function which looks at LANG variable.
We suggest to use 'focus under the mouse' as Focus Policy.
You can send bugs or suggestions to xcoral@free.fr
[Lionel, Bruno, Dominique]
