README - BEAMS PLAY SO FAR

			Terry Barnaby  -  BEAM Ltd

				29/11/96

I have tried to get the whole of Usonix to compile, and link. This is the
results of this work to date. It is quite a hack but I hope it is of interest,
it should show what needs to be done. I have put it on the ftp site
in usonix_beam_1.tar.z

In order to do this I have emulated the RW include files, by working out
which classes and functions are required and used the poll() function as
produced by Joel.

I have included inline stub functions for the required RW members and some
other functions that are required.

The usonix Makefile is baddly hacked but works. No dependancies are included.
All compiler warnings have been turned off to aid getting the thing compiled.
All changes in the source code have been introduced with the -DBEAM
compiler option.

The template system has left me a bit cold (i'm not up on templates yet,
but am quickly learning !). I thought that the implemntations of the
template functions would need to be included not linked in later.
So I have "included" the template source files where necessary.

ProcessManager.cc causes fatal internal compiler errors, with the exception
bit of the code. Is this my exception.h or is there realy compiler problems ?
Anyway a lot of the code has been defined out.

The Shared librarys compile and link buts thats about as far as I have gone
with these.

The whole system builds and links on my system (Redhat 3.0.1 Picasso).
Just run "make" in the top directory.
I have'nt gone any further yet.

Directory layout
	README		- This README
	Makefile	- Master makefile to build all
	libbeam		- Library source to fix RW and Linux missing parts
	RAP		- The RAP part
	usonix		- The mercator sources
	include		- Include files from libbeam
	lib		- Library from libbeam

I Wonder if a way of tackling the port is to emulate the required
RW functions directly using g++ or other code ?
Anyway any comments would be interesting.

Terry

-- 
+----------------------------------------------------------------------------+
|  Dr Terry Barnaby                   |  BEAM Ltd                            |
|  Phone: +44 1454 324512             |  Northavon Business Center, Dean Rd  |
|  Fax:   +44 1454 313172             |  Yate, Bristol, BS17 5NH, UK         |
|  Email: terry@beam.demon.co.uk      |  Web: www.beam.demon.co.uk           |
|  BEAM for: Visualy Impaired X-Terminals, Parallel Processing, Software Dev |
|                          "Tandems are twice the fun !"                     |