XXL INSTALL and TEST File - Version XXL98.6  (AVI Version)
E. Lecolinet

==============================================================

FILES:

- xxl98.6.tar.gz : standard distribution with source code
- xxl-sunlibs98.6.tar.gz : Sun Solaris Libraries

==============================================================

0) REQUIREMENTS

The XXL package requires :

- Unix
  * prefered OS: SunOS5.x (= Solaris2)  with 5.x > 5.3 if possible

- X Window release X11R5 or more

- CDE or Motif 1.2.x (with x > 0 if possible)

- a "standard" window manager.
  * Prefered WM = mwm (Motif)
  * Tested WMs = dtwm (CDE), olwm, olvwm (OpenLook), fvwm
  * ! XXL does NOT work properly with certain versions of "ctwm" !

- Backing Store for the XXL builder (programs xlbuild and xlsketch)

Remarks:
  * XXL will probably NOT work under X11R4 (an obsolete version of X)
  * as the old "openwin" server on SunOS4 workstations is based on X11R4
    a more recent X server should probably be used

==============================================================

1) CREATE a new directory, for instance:  /usr/local/XXL
   From now, we will call it the "XXL directory"


==============================================================

2) UNCOMPRESS and UNTAR the proper distribution file in this new directory:

   For instance:
         gunzip xxl98.6.tar.gz
         tar xvf xxl98.6.tar

This will create the following directories :

config	: configuration files
include	: include files
lib	: libraries
src     : library source code
bin	: binary files (xlbuild, xlpad, xlsh)
sketch  : Sketch Builder (xlsketch)
examples: C examples
scripts	: XXL Script examples
html    : HTML AutoHelp (on-line manual)
iman	: compiled version of the Motif man pages (incremental man pages)


==============================================================

3) CONFIGURATION:

- go to directory XXL/config

- edit file "ConfMake" :

by defaut, file file starts with :

XDIR  = /usr/openwin
XMDIR = /usr/dt
XLDIR = /usr/local/XXL
CC = gcc
CCC = g++

You may have to modify these macros so that :

XDIR   will be the ACTUAL XWindow directory on YOUR system
XMDIR                     Motif
XLDIR                     XXL

CC must be an ANSI C (or C++) compiler (default: the "gcc" GNU compiler)
CCC must be a C++ compiler (default: the GNU g++ compiler)

Note: 
you can also install the XLDIR directory under your own home directory
if you don't have Root permissions to install it on /usr/local


==============================================================

4) COMPILATION

- return to the XXL directory

- type:  make

This should make the libraries and the binaries


==============================================================

5) TEST

- the programs to test are in directory 'bin':
   
   xlbuild  : the XXL Visual Builder
   xlsketch : the XXL Visual AND Sketch Builder
   xlsh     : the XXL shell
   xlpad    : an example that displays Sun rasterfiles and gif89 images

- note: 
  type:   xlpad -build  to start example xlpad AND the XXL Builder
  The same rule apply to any C program that uses the XXL library.

- several C programs examples are available in directory 'examples'

- several XXL Script examples are available in directory 'script'
  They can be executed:
  * by loading them from the XXL Builder (programs 'xlbuild' and 'xlsketch')
  * by using 'xlsh', the XXL Shell:
    type:    xlsh  scriptname    
    or:      xlsh -build scriptname
  * directly by typing their name
    (in which case they must be made executable and their first line must 
    refers to the actual location of the 'xlsh' program in the file system)

==============================================================

6) INSTALL

- you may optionally install:
  - the libraries in /usr/local/lib
  - the binaries in /usr/local/bin
  - the include files in /usr/local/include
by typing:

make install