
TODO:
-----
	-Read this file (down to the end).
	-Try to build xcoral.
	-Print doc/xcoral-2.1.ps on your favorite printer.
	-And go to the coffee machine.

Content:
--------
	-Some informations about building xcoral.
	-Build xcoral.
	-Build xcoral for each of the following systems:
	 SunOS, Ultrix4.3, HP-UX, IRIX, AIX and Linux.
	-Future.

Preamble:
---------
	Xcoral has been developped on SunOS 4.1.x (BSD) with
	MIT X11 R[4|5] Window System. We have compiled it
	and tested it (a little) on other systems.

	To build xcoral, you need only one 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 as well as GNU gcc.
	
Warning:
--------
	The lex.yy.c files are built with 'flex -8' (part of GNU
	distribution),and gen.tab.[ch] with the standard
	'yacc -d'. These files are present in this distribution
	and are not produced by make.

Build:
------		
	A/ Set XC_LIBDIR (default /usr/local/lib/xcoral)
	in Imakefile if the command xmkmf is available,
	else in one of the other Makefile corresponding
	to your system or in Makefile_std. 
	This directory contains Smac files and manual.

	B/ In Smac directory, the word.h file must be the one
	of your system (char,int and pointer alignment).
	On SunOS4.1.x, HP-UX, IRIX, ULTRIX43, LINUX
	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/Imakefile).

	C/ If you don't run MIT X11 R[4|5], edit config.h
	to set fontnames and colornames for your X Window System.
	See also X_INCLUDE and X_LIBPATH.

	D/ At the top level type :
		xmkmf
		make All

		or make -f Makefile_SYSNAME
		
	E/ Install
		Copy xcoral in your local bin directory.
		Copy *.sc man.dtex and xcoralrc in XC_LIBDIR directory

		or as root make install

		then copy xcoralrc in your homedir as .xcoralrc
		
	F/ SEE ALSO :
		xcoral-goodies directory present a clever use
		of Smac user functions  (asynchronous make and 
		RCS interface, mouse and file header functions,
		comments generation etc)

Build on SunOS.4.1.X
--------------------
	Sun 3/4, SS2 SS10 with SunOS 4.1.x and MIT X11 R[4|5] or
		OpenWindows2/3.
	Compiler : Standard K&R cc, acc, gcc 2.4.5

	A/ With MIT X11 R[4|5]

		Set XC_LIBDIR in Imakefile
		xmkmf
		make All

		and make install

	B/ With OpenWindows 2/3 (don't use Sun xmkmf).
   
		Set XC_LIBDIR in Makefile_SUN_OPENWIN
		make -f Makefile_SUN_OPENWIN

		and make -f Makefile_SUN_OPENWIN install

Build on Ultrix4.3 
------------------
	Dec station 3100 with ULTRIX V4.3 and MIT X11 R[4|5].
	Dec station 5000 with ULTRIX V4.3 and Xws (Dec X11R4 server).
	Compiler : cc 

	Edit Makefile_Ultrix43 to set X_INCLUDE, X_LIBPATH and XC_LIBDIR.

	make -f Makefile_Ultrix43

	and make -f Makefile_Ultrix43 install

Build on HPUX
--------------
	HP 9000-720 with HP-UX 9.07 and HP X11R4 server.
	Compiler : cc

	Edit Makefile_HPUX to set X_INCLUDE, X_LIBPATH and XC_LIBDIR.

	make -f Makefile_HPUX

	and make -f Makefile_HPUX install

Build on IRIX
-------------
	Indigo-2  with IRIX Release 4.0.5H

	Edit Makefile_IRIX to set X_INCLUDE, X_LIBPATH and XC_LIBDIR.

	make -f Makefile_IRIX

	and make -f Makefile_IRIX install

Build on Linux
--------------
	386/486	Box, Compiler : gcc

	xmkmf
	make All

	and make install

	I've compiled xcoral-2.1 on a 0.99pl9 Linux box and I've played
	with it	half an hour. Apparently, it's OK, apparently.

	WARNING: 
		With the old filesystem (filename len <= 14),
		you must rename some Smac files (.sc).

Build on AIX 3.2: 
-----------------
	RS 6000.
	Edit Makefile_std to set X_INCLUDE, X_LIBPATH and XC_LIBDIR.

	make -f Makefile_std
	
	and make -f Makefile_std install

Future:
-------
	A new browser with more informations (templates,data etc).
	Colors managment for C/C++ mode (comments, function names,
	keywords, define, include etc).
	More Smac files (latex.sc, colors.sc etc).
	
	Humm may be.
	

You can send bugs or suggestions to lf@lri.lri.fr

	[Lionel, Bruno, Dominique]
