Fast Prolog Term I/O module
---------------------------

Author:		K.Y.Hui
		(modified from the "fastrw" module of SICStus Prolog)
Date:		11 May 1998
Version:	1.02

This is the fast term I/O module for both SICStus & Quintus Prolog
based on the fastrw module in SICStus Prolog release 3-2.


Files
-----

This release contains the following files:

README				-	this file
Makefile.sgi_sicstus		-	makefile for SGI/SICStus
Makefile.sparc_quintus		-	makefile for Sparc/Quintus
Makefile.sparc_sicstus		-	makefile for Sparc/SICStus
fastrw.h			-	C header file
fastrw.pl			-	Prolog source
machine_type.pl			-	machine name to platform mappings
sgi_sicstus_fastrw.c		-	C source for SGI/SICStus
sgi_sicstus_fastrw.pl		-	Prolog source for SGI/SICStus
sparc_quintus_fastrw.c		-	C source for Sparc/Quintus
sparc_quintus_fastrw.pl		-	Prolog source for Sparc/Quintus
sparc_sicstus_fastrw.c		-	C source for Sparc/SICStus
sparc_sicstus_fastrw.pl		-	Prolog source for Sparc/SICStus


Installation
------------

1.	Edit "Makefile.inc" to suit your local configuration.
	The major option will be the location of SICStus/Quintus Prolog.
	For example, if your SICStus Prolog is installed in the
	directory "/usr/local/sicstus", make the following change
	to the corresponding Makefile:

	SICSTUS_HOME=/usr/local/sicstus

2.	Type:

		make <platform>

	to make the corresponding *.o object file.
	For example:

		make sgi_sicstus

3.	Edit the machine mapping file "machine_map.pl".
	It contains mappings from the machine name to the platform type.
	For example, the machine "finch" is mapped to an SGI by
	the entry:

	host_map(finch,sgi)

	*** NOTE:	You will surely have to modify the
			"../machine_map.pl" file to tailor for
			your local environment.

4.	The automatic platform detecting feature uses the environment
	variable "HOST". If you use the shell "csh" (or tcsh), you
	can check your setting by the command:

		setenv | grep HOST

	If your environment is not properly set, you can do it
	by editing your shell resource file. For "csh" (or tcsh),
	you can edit the file "~/.cshrc" and add the following line:

		setenv HOST `hostname`

	and then type the following to refresh your environment:

		source ~/.cshrc

	*** Notice the single-quote is the inverted one!


Porting to other systems
------------------------

To port the library to another system requires porting the
C and Prolog source code. For example, if you are porting
it to HPUX, you may have to create the two files:

	hpux_sicstus_fastrw.pl
	hpux_sicstus_fastrw.o (from the C source)

Usually, the Prolog part depends on the Prolog system
that you are using and does not need any modification
(unless you are using something other than SICStus & Quintus).

For the C part, you may not have to modify the source code
but compiling the *.o for your platform is essential.

(NB:	The HPUX version is included in this release.)

 Name                    Last modified      Size  Description
 Makefile                1998-07-09 16:51  651   
 Makefile.hpux_sicstus   1998-07-09 16:51  191   
 Makefile.sgi_sicstus    1998-07-09 16:51  173   
 Makefile.sparc_quintus  1998-07-09 16:51  176   
 Makefile.sparc_sicstus  1998-07-09 16:51  194   
 README                  1998-07-09 16:51  2.8K  
 VERSION                 1998-07-09 16:51  235   
 fastrw.h                1998-07-09 16:51  3.7K  
 fastrw.pl               1998-07-09 16:51  644   
 hpux_sicstus_fastrw.c   1998-07-09 16:51   15K  
 hpux_sicstus_fastrw.pl  1998-07-09 16:51  1.9K  
 sgi_sicstus_fastrw.c    1998-07-09 16:51   15K  
 sgi_sicstus_fastrw.pl   1998-07-09 16:51  1.9K  
 so_locations            1998-07-10 15:15  1.0K  
 sparc_quintus_fastrw.c  1998-07-09 16:51   15K  
 sparc_quintus_fastrw.pl 1998-07-09 16:51  1.9K  
 sparc_sicstus_fastrw.c  1998-07-09 16:51   15K  
 sparc_sicstus_fastrw.pl 1998-07-09 16:51  1.9K