	XWIP RELEASE NOTES
	==================

I. Please read the README file.

II. The version of this release may be determined by looking at the
   "version.pl" file.

III. The file CHANGES lists the changes between versions.

IV. The manual is available in the following forms:

	1. LaTeX source files in this distribution

	2. Postscript file in this distribution

	3. "XWIP Reference Manual, Version 0.4"
	   UCLA Computer Science Department Technical Report CSD-880079

	The technical report is available from:

  		UCLA Computer Science Department
        	Technical Reports
	        3413 Boelter Hall
	        Los Angeles, CA 90024-1596
		USA

	The last time I checked, the report costs $10, including
	shipping. ($12 to non USA addresses) They require prepayment.
	Personal checks are okay as long as they are in US funds drawn
	from a US bank. Make checks payable to
	"The Regents of the University of California".   

V. Installation Instructions

	0. Read all of these instructions before actually attempting
		installation. 

	1. place this distribution in a suitable directory

	2. determine which "build file" you will use:
		Quintus: use "qpx.pl"
		SICStus: use "spx.pl"
		others: you will have to make one up yourself

	2. adjust parameters
		Makefile: look at CFLAGS, XINCLUDE, XBIN and XETC
		Please check for a floating point option (both in
			explicit flags and environment variables) that
			will be compatible with your Prolog. If you
			use the default, you can probably ignore this
			comment. 
		"build file": look at the library list in the
			load_foreign_files directive

	3. make all 
	      or 
	   make programs - if you don't want to make the manual 

	4. start your prolog 
	   Make sure your environment matches your make environment. 
		Foreign function loading on the SUN may be influenced
		by the FLOAT_OPTION environment variable. Thus, your
		FLOAT_OPTION variable should be compatible with your
		make environment. If you don't set your FLOAT_OPTION
		variable, you can probably ignore this comment.

	5. consult your "build file",
	   follow the displayed instructions to dump the Prolog
	   and then exit Prolog.

	6. do a quick test:
	   set your DISPLAY environment variable appropriately,
	   start your Prolog dump,
	   consult "hw.pl",
	   prove the goal "helloWorld",
	   the "Hello World" window should appear,
	   resize it and move it around, it should be refreshed appropriately.

	7. make install
	      or
	   move the dump and manual where you want it
	
	8. to reformat the manual:
		latex xwip
		make document (to remake the index)
		latex xwip (to incorporate the remade index)

	   Note this process uses the makeindex program which is
	   available from Pehong Chen (phc@berkeley.edu). 
	   LaTeX is, of course, available almost anywhere.

VI. File List

CHANGES		- change log
Makefile	- make control file
NOTES		- this file
README		- copyright, credits and availability
cfconst		- program to generate cfont.pl
cfconst.c	- cfconst source
cfconst.o	- cfconst object
cfont.pl	- cursor names relation
cfont.tex	- cursor names table for manual 
cftable		- program to generate cfont.tex
cftable.c	- cftable source
cftable.o	- cftable object
ff.pl		- foreign function declarations
hw.pl		- hello world example
lint.c		- plint hack
pred.pl		- predicate definitions
qpx.pl		- Quintus build file
qpxi.pl		- loads interpreted Quintus version (for debugging)
spx.pl		- SICStus build file
spxi.pl		- loads interpreted SICStus version (for debugging)
table.pl	- various tables of constants
util.pl		- utility routines for prolog
version.pl	- prolog version
xwip.aux	- latex auxiliary file
xwip.dvi	- latex output
xwip.idx	- raw index
xwip.ilg	- makeindex auxiliary file
xwip.ind	- processed index
xwip.log	- latex log file
xwip.o		- C function object file
xwip.ps		- postscript version of manual
xwip.tex	- LaTeX source to manual
xwip.toc	- latex table of contents file
xwipd.pl	- debugging routines
	
other *.h, *.c	- C function sources
other *.o	- C function object files used to build xwip.o
	
VII. Questions

If have a questions, comments, bug reports, new features,
improvements, etc. please send e-mail to:

	xwip@cs.ucla.edu
	   or
	...!ucbvax!cs.ucla.edu!xwip	

Please mention the version of the system you are using. If including
code changes, please use context diffs. I will do my best to fix any
bugs and make improvements. But, of course, there are no warranties as
explained by the copyright and license. 

	Enjoy,

	Ted Kim

#
# eof
#
