	----- S-Lang README file and installation instructions ------

   Copyright (C) 1993 John E. Davis (davis@amy.tch.harvard.edu)
   All rights reserved.

   This file is part of S-Lang.

   S-Lang is distributed in the hope that it will be useful, but WITHOUT
   ANY WARRANTY.  No author or distributor accepts responsibility to
   anyone for the consequences of using it or for whether it serves any
   particular purpose or works at all, unless he says so in writing.
   Refer to the S-Lang General Public License for full details.

   Everyone is granted permission to copy, modify and redistribute
   S-Lang, but only under the conditions described in the S-Lang General
   Public License.  A copy of this license is supposed to have been given
   to you along with S-Lang so you can know your rights and
   responsibilities.  It should be in a file named COPYING.  Among other
   things, the copyright notice and this notice must be preserved on all
   copies.

S-Lang is a library that enables a C program to embed a C-like language
interpreter.  S-Lang is distributed with the GNU General public license and
it is also available for commercial licensing.  For details, send email to
davis@amy.tch.harvard.edu or write:

    John E. Davis
    31 Harris St. #5
    Brookline, MA, 02146

---------------------------------------------------------------------
The files in this distribution include:

  README        This file.  Installation instructions.

Application specific files: (example is a programmable calculator)

  calc.c	main program for calculator
  calc.sl	sample S-Lang file loaded by calc.
  makefile.*	makefile for S-Lang library and calculator
  VMSmake.com   VMS 'makefile' 
  
Documentation:

  slang.txt     Description of S-Lang language
  slang.how     How to embed S-Lang into a C program
  
S-Lang library specific files.

  COPYING       license for S-Lang
  malloc.h	system dependent malloc definitions
  config.h      configuration file
  slang.c	main code for S-Lang interpreter
  slang.h       include file for all S-Lang applications
  _slang.h      include file for interpreter modules.
  slstd.c       standard S-Lang intrinsics module
  slmath.c	floating point math functions
  slfile.c      file i/o module
  slparse.c     Infix -> RPN parser
  slarray.c     Array operations
  slarray.h     include file

If you wish to be on the S-Lang mailing list, simply send me an email with
your email address.  I use the mailing list to announce new releases of
S-Lang and to report any bugs.  Send an email to:

davis@amy.tch.harvard.edu

------------------------------------------------------------------------------

Installation instructions.

Building the S-Lang library requires a C compiler that understands function
prototypes.  On SunOS, you will need gcc.

S-Lang has been successfully compiled and tested on many platforms and OSs
(Unix/VMS/PC-MSDOS).   There are at least 4 makefiles included in the
distribution:

     makefile.unx    Unix
     makefile.dos    MS-DOS (Borland BCC specific)
     makefile.djg    DJGPP (GO32) specific
     vmsmake.com     DCL command procedure 
     
As usual, look at the relavent makefile and edit it as required for your
system.  On VMS, just type `@vmsmake' or if you have gcc, type `@vmsmake gcc'.
For non-VMS systems, copy the appropriate makefile.xxx to `makefile'.  Then
after editing it, simply type `make'.

The library comes with a sample forgram called calc.  Once you have
successfully built the S-Lang library,  simply type `make calc' tobuild the
sample application.  This step is not necessary if you are running VMS.

Finally not that some Unix systems do not have `ranlib'.  If you see an
error indicating this fact, simply ignore it.

