

This is the directory where you configure, compile, and install Xcoral-3.2.
In the subdirectory Doc, you will find the complete User manual as a 
Postscript document xcoral-3.2.ps and also xcoral-card.ps. A Html version
is also provided in this distribution (Doc/HTML/xcoral.html) which is
produced from the xcoral-3.2.tex source document with the famous translator
LateX2html (thanks to Nikos Drakos).

Preamble:
---------

	Xcoral has been developped on SunOS 4.1.x (BSD) with MIT X11 R[4|5]
	Window System and GNU gcc compiler. Now we compile and test it on 
	Solaris-2.6/CDE and Linux system.
	We have compiled and tested Xcoral (a little) on other systems.
	To build Xcoral, you need only the X11 library (libX11.a). 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.

	Xcoral has been compiled on the following systems:
	Linux, Solaris, SunOS, Digital Unix, HPUX, IRIX and FreeBSD.

How To Compile And Install Xcoral:
----------------------------------

	Basically the following commands built and install xcoral:

		$ ./configure
		$ make
		$ make install

		$ cp SmacLib/xcoralrc.lf $HOME/.xcoralrc


	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).



	IMPORTANT:
	==========
	copy SmacLib/xcoralrc.lf in your homedir as .xcoralrc (if you have
	already a .xcoralrc, save it and use the new .xcoralrc).

	If you have a Keyboard with 8 bits keys (accentued char), use the
	LANG environment variable (fr, de etc). Xcoral uses setlocale
	function which looks at LANG variable.



You can send bugs or suggestions to xcoral@aar.alcatel-alsthom.fr


	[Lionel, Bruno, Dominique]
