//	Welcome to PFL.
//	---------------


The executable code for PFL is freely available for academic use.  At
present only code for Sun SparcStatsions is available, although this may
change in the near future.  We've tried to eliminate as many bugs as
possible, but inevitably you will come across one from time to time.
Whenever you do find a bug, please let us know and will attempt to fix it in
the next release.

This directory and its sub-directories contain (almost) everything that you
need to run PFL.  In particular, it contains :

	README			//	This file !
	DemoBasics		//	A gentle introduction to PFL
	DemoGraphics		//	A gentle introduction to PFLs graphics functions
	ReleaseExec		//	The script to send the PFL executable code
	ReleaseSource		//	The script to send the PFL source code
	Manual			//	The user manual for PFL - to print it try
				//	tbl Manual | eqn | troff -ms | dpost | lpr -Pname
	Xf			//	A resource file which allows access to the XLib 
				//	routines provided by PFL

	environ			//	A directory containing useful PFL functions
	data			//	A directory containing sample data
	source			//	A directory containing the PFL source code
	util			//	A directory containing the utilities PFL needs 

	pfl.sun4		//	Sun4 executable code
				//	Note: this file is only created after executing step (iii) below

To be able to run PFL you must :

(i)	set the following environment variables :
		setenv PFLDIR		your_unix_pathname/pfl
		setenv XAPPLRESDIR      your_unix_pathname/pfl
		setenv PFLOPT		"-fast +p -Bstatic"
	it's probably best to add these to your .cshrc file.

(ii)	change every occurrence of "/bbkcs/lib" in the file 
	your_unix_pathname/pfl/environ/std.env to "your_unix_pathname"

(iii)	make sure you have access to an AT&T C++ compiler

(iv)	go into the sub-directory source/parser and type
		make_all

(v)	the pfl executable code is now in the file pfl.sun4; before trying it
	out, however, read the user manual and browse through the "std.env",
	"common.env" and "example.env" scripts in the sub-directory "environ"
	

Note:  You will need some experience in the use of a lazy functional
programming language such as Miranda or Haskell to be able to use PFL.  Due
to limitations of time the user manual is incomplete and is laconic to say
the least.  A recommended introductory text is :

	R. Bird and P. Wadler
	Introduction to Functional Programming
	Prentice Hall International
	1988
	


If you have any installation problems contact :

E-mail:		carol@uk.ac.bbk.dcs

Snail mail:	Carol Small
		Department of Computer Science
		Birkbeck College
		Malet Street 
		London WC1E 7HX

Fax:		071-636-4971
Telephone:	071-631-6546
