ARexx Interface Library (Rxil)

			Linkable 'C' Library Release

			10-Nov-89  Version 1.0


	Copyright © 1989 by Donald T. Meyer, Stormgate Software
	All Rights Reserved



This is the first full release of the ARexx Interface Library (Rxil).

The library file is in Lattice format and was compiled for 32-bit
integers, standard parameter passing via the stack.

The demo.c file should compile under either Lattice or Aztec.
(Aztec might require some minor modifications)
(Don't you love it when people say that? :-)

The intent of this library is to help all programs which are being
written for the Amiga to implement a complete, robust ARexx interface if
they so desire.  ARexx is one of the strengths the Amiga has, and needs to
make full use of.  It allows things to be done on the Amiga that can be
done with great difficulty (if at all) on other machines.

Without naming any names, I have seen more than one supposed "ARexx
Interface" implemented that was incomplete, buggy, or just plain wrong!
I don't want to go so far as to say that what I have here is perfect, but I
believe that it can be very helpfull to those who want to implement a good
ARexx port with minimal effort.  It has been refined and tested over many
months, and is the product of experience implementing ARexx ports, function
hosts, and tools.

I would like to request that if you find any features lacking, and of
course any bugs, _please_ bring them to my attention.  My desire is to have
a standard library that can be used without modification by the vast
majority of programs.  To this end, it will probably become an Exec style
shared library at some point (hint, hint, Commodore).  Since some
developers don't want to burden the user with the effort involved in moving
a special library into the LIBS: directory, that is not the direction first
taken.  As ARexx becomes universal, and as this library hopefully becomes
widely used :-), a library will probably be offered.
Source code is being made available to allow those developers who don't
feel comfortable depending on "black boxes" to see just what is happening
and recompile as the will.  My hope is that changes to the source will not
be required.  Again, if you feel that they are, please let me know.  If
everyone who uses this library has to change the source to get it to do
what they want, making an Exec style shared library won't be very
practical, and I do want to pave the way for this possibility.




	==============   Usage Terms  ==============

These object modules be linked into any software product.
No portion of this source code is to be re-distributed for profit.
This library alone (i.e., not as part of an application, utility,
game, etc.) may not be re-distributed for profit.

If you use these routines in a commercial product, or in a shareware
program, I would request you send me a complimentary copy of the
product.

If you use these routines for your own "playing around", or in a PD
or freeware product, nothing is requested.

Please note that the above is indeed a request, not a requirement.
If you fail to comply, my lawyer won't call your lawyer or anything
like that.  I am counting on "honor amongst developers" or equivalent!

Distribution of this .zoo archive may be made via free telecommunications
services only.  Express exceptions to this are BIX, GEnie, and PeopleLink.




I would like to extend special thanks to Justin McCormick for his testing
efforts and suggestions, which have helped immensely.  Thanks also to Bill
Hawes for his patient answers to my questions, as well as for his thoughts
and suggestions.



Donald T. Meyer
Stormgate Software
P.O. Box 383
St. Peters, MO  63376

BIX:	donmeyer		(almost daily)
GEnie:	D.MEYER			(weekly)
PLINK:	Stormgate		(weekly)