Instructions for generating the Brown Workstation Environment from sources:

BWE is a package of tools that runs with X11 that is used at Brown as a basis
for a variety of software.  In turn, it makes use of a variety of software.
The most notable packages are a version of GNU make, a dynamic loader, and a
lightweight process package, THREADs.  All of these should be included on the
distribution tape in some form.  Note that if threads is not included, a dummy
substitute package is that is suitable for use with BWE, FIELD, and TANGO.
For more information, contact spr or twd @cs.brown.edu.

The script contained in the file INSTALL should set up all the dependent tools
and then build the BWE library and utilities.

For running with BWE (and building it), the following environment variables
can be set (this is not required any longer):

	PRO -- the directory containing bwe,dl,threads,etc
	ARCH -- the machine type (i.e. sun3, sun4, vax, ...)

In addition, ones path should include $PRO/cmd and $PRO/cmd/$ARCH.  All of this
is done, as an example, in the file INSTALL.  Finally, you have to be running
X11 at the time of the install.

The directory structure is set up to handle multple architectures with a
common source. The ARCH environment variable is used for this as are multiple
binary directorys, and other things.

The standard BWE distribution comes with a dummy (null) THREADs package. Doing
the install procedure will install this so that BWE is usable without threads.
If you are going to install threads, install $PRO/threads before installing
BWE.

BWE also comes with the Brown dynamic loading package, dynload.  This is
automatically installed as part of the installation script.

Two customizations are provided for in the INSTALL script.  The first is the
location of X11 librarys and include files and the second is whether to
optimize when building the system or not.  These are modified by changing the
variables X11info and OTHERinfo in the script accordingly.

ASH (a part of BWE) now includes a font family definition file that allows machine
independent access to fonts by family name, properties, and font size.	The files that
are distributed are based on the X11R3 MIT distribution.  If you have your own fonts
or some other distribution, you might want to create a file font.family.$(ARCH) in
/pro/bwe/ash/src and add it to the FAMILYS macro in the makefile before doing the
installation.

Example programs for BWE are found in several places.  The best examples are
FIELD, TANGO, and GARDEN, each large systems that make extensive use of the
BWE facilities.  Simpler examples are found in the $PRO/bwe/examples/src
directory.  The directory $PRO/bwe/ash/src contains numerous test programs
(test#.c), many of which can be used as examples.  Also, the various parts of
BWE are interdependent, so that examples of the use of the variuos packages can
also be found in other packages.
