# @(#)README	1.15 09 Sep 1994 (UKC)

See the file CHANGES for the status of this alpha release.


Here is how to build ups on Solaris 2.3, HP-UX and IRIX.

In addition to the ups distribution tar file you will need the followiong:

	- a vanilla copy of the gdb version 4.13 source distribution.

	- a reasonably recent version of perl installed somewhere in
          your path.

	- on HP machines only, the GNU C compiler gcc somewhere in
	  your path.

The build steps are the same on Solaris 2.3 and IRIX.  They are
slightly different on the HP as you need to build ups with gcc (this
is because the HP C compiler objects to some preprocessor chicanery in
ups - the ups source will be fixed in a future release).

1) Unpack a fresh copy of the gdb 4.13 distribution, and build gdb.
   (The ups build procedure does not modify the gdb source tree, so if
   you already have a built version of gdb-4.13 you can use that.)

   On Solaris 2.3 and IRIX:

	gzcat gdb-4.13.tar | tar xf -
	cd gdb-4.13
	./configure
	make

   You need to build gdb with gcc on the HP, where the last step above
   is replaced by:

	make CC=gcc


2) Unpack the ups distribution compressed tar file and cd to the top
   level ups directory:

	zcat ups-3.3.tar | tar xf -
	cd ups-3.3


3) Build the modified gdb tree:

	sh gdbconf/mkupsgdb -from path-to-gdb-4.13 .

   (the final `.' is a directory name - don't omit it).
   path-to-gdb-4.13 is the path to the top level directory of the gdb
   4.13 distribution.

   On the HP, you need to specify gcc:

	sh gdbconf/mkupsgdb -from path-to-gdb-4.13 -gcc .

   The mkupsgdb shell script runs various perl scripts to build a
   library `libgdb.a' based on modified versions of the gdb source
   (nearly all the modifications are the #ifdefing out of gdb
   functions not needed by ups).
   
   The result is a new directory below the top level ups directory
   containing a mixture of modified gdb source files and symbolic
   links back to the vanilla gdb source tree.  The directory name
   is formed by adding `.munged' to the last component of the vanilla
   gdb source path (thus it will normally be `gdb-4.13.munged').


4) Build ups.  The make command is currently different on each
   architecture:

     Solaris:  make CFLAGS="-g -xs -DSVR4"
        IRIX:  make SHELL=/bin/sh
       HP-UX:  make CC=gcc

   If all goes well this will build a binary called ups/ups-gdb.

The install support has not been tested yet - just copy the binary and
manual page.

Mark Russell
9th September 1994