This is the directory where you configure, compile, and install Xcoral-3.40.
In the subdirectory Doc, you will find the complete User manual as a 
Postscript document xcoral-3.40.ps and also xcoral-card.ps. 

Preamble:
---------

	Xcoral has been developped on Sun Solaris OS with MIT X11 R[4|5]
	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, Digital Unix, 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, Digital Unix, 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, Aix and
	   Digital Unix, 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]