
WHAT IS THIS 
------------

This is release 1.0 of the SlingShot XView extensions.  

The SlingShot extensions are a set of XView objects that are
useful for implementing graphical objects in a canvas.  They
provide callbacks for double click and drag and  drop,  pro-
vide  layout  policies, and handle repainting.  These exten-
sions use the XView subclassing scheme so the standard XView
API (xv_create, xv_set, etc.) is applicable.



COMPILING
---------

You will need OpenWindows or XView version 2.0 or 3.0 to compile this.

There are four steps to compiling this software:

	1) cd to the top directory (the one that contains this README file)
	2) type "xmkmf"
	3) type "make Makefiles"
	4) type "make"

The include files, documentation, source, compiled library and examples
require a total of about 3.3 Megabytes of disk space (sparc
executables).

If you don't have OpenWindows, you will have to edit the Imakefiles in
root, lib, and examples to point to the XView include directories.
Alternately, you may use the ordinary Makefiles named "Makefile.mak"
in each directory. (If you are running OpenWindows 2.0, this will
probably be easier than using imake.)


INSTALLATION
------------

Installation is optional, to do this type:

	"make install DESTDIR=/somewhere"

Installation installs just the bare bones include files and library
archive that you need to write programs using the SlingShot
extensions.  The example programs and documentation files are not
copied.

The total disk space required for installation directories is about 
168 K (for sparc architectures).



DIRECTORIES
-----------

The directory structure that lies below this is as follows:

	./doc
		Programmer's documentation.  (Ascii text files.)

	./include/sspkg
		The include files.

	./lib
		Source for the libsspkg.a library and the library archive.

	./examples
		Source for demos and examples.  This is the first place
		(after building) to look if you want a quick feel of
		what this does.  These programs are intended to be
		programming examples, rather than of end-user programs.

	./examples/icons
		Icon files included by the examples.


RELEASE INFO
------------

This is the 1.0 release, there are no major functionality or interface
changes from the 1.0 beta release.  The following bugs have been 
identified and fixed:

	Fixed: core dumps on Sun 3.
		rect_bounding was passed a Rect * instead of a Rect 
		in canshell_eve.c
	Fixed: calling free() twice when selecting objects.
	Fixed: referencing free'd memory when destroying an array_tile
	Fixed: a server lock up when handling mouse events.
	Fixed: Makefile.mak is more forgiving of errors for install
		and clean targets.

1.0beta users should note that the include files <sspkg/rectobj_list.h>
and <sspkg/rectobj_sel.h> are no longer in the include directory.  The
contents of these files are now included <sspkg/rectobj.h> and are no
longer necessary.

1.0 is the first release that has been released over comp.sources.x.

The selection and drag and drop interfaces do not use XView 3.0's 
dnd and selection interface.  This will be fixed in a later release.


CAVEATS
-------

This software hasn't been compiled or tested on anything other than
sparc and sun 3.  We'd be interested in any problems with bringing 
it up on other architectures.

This software has been stable and in use for some time, but it has
received no official quality assurance or useability testing.  This is
unsupported software!  There are no guarantees, but an attempt to fix
reported bugs will be made.

This is NOT an official or supported product of Sun Microsystems, Inc.
This software has been developed to leverage other efforts, and it is
being released because it is hoped others can get benefits from it
too.  However, there ARE bugs in this software which may never be
fixed, and there is no guarantee of compatability between releases.

If you find it useful, or have questions, suggestions, or bugs, drop us
(the developers) a line at slingshot-packages@gazooch.Eng.Sun.COM.

