This file describes the installation procedure for ShellyLibV2.0

Please check the "bin" directory for executables for your
platform. You may want to skip section 1, if you found one.
Note, that there are no binaries for the "Shell Laboratory" at all!


1. Compiling
============

Prerequisites:

You will need an ANSI-C compliant C-compiler, gcc will be fine,
and a make program.
If you want to use the "Shell Laboratory" you will need an OpenGL
(Mesa will do!), Tcl/Tk (atleast V4.0 of Tk) and Togl as well.
Refer to the documentation located in the "doc" subdirectory
for information on where to get them (section "Addresses, Pointers ...").

Then:

- >cd src

- Edit the Makefile:

	-choose your C-compiler, change CFLAGS etc.
	-give the location of Tcl/Tk, OpenGL and Togl 

- Now compile:

   >make all
    if you want to build everything

   >make lib
    if you just want to build the library

   >make shelly
    if you want to build the example frontend ("shelly")

   >make lab
    if you want to build the "Shell Laboratory"

Compiling on platforms or with C-compilers that do not have a make
or are completely different in project management will require a bit
more work (serious tweaking of the Makefile, or creating a
totally new project) in order to compile.

This statements might ease this job:
- You do not have to build a library out of "shellyl.c", linking against
  the object ("shellyl.o") will do.
- "shelly" is built from "shellyl.c", "frontend.c" and "rdwrt.c". 
- The "Shell Laboratory" is built from "shellyl.c", "lab.c" and "rdwrt.c".
  But "lab.c" does include "frontend.h"!


2. Installing the binaries
==========================

You may want to copy several files to system directories.
As this distribution is targeted to many different machines/operating
systems no automatic installation is provided.

The executables "shelly", "lab", and the shellscript "slab" may 
be copied into any directories in the search-path. 
The shellscript "slab" needs an update afterwards.
Edit the last line "source "lab.tcl"" according to the information
in the docs (section "Using the Shell Laboratory" subsection "Starting up").




