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]