Installation Details
------------ -------

This is file /usr/ftp/pub/Xinu.8086/install/README.  It contains
instructions for installing the Xinu software and recompiling
it.  These instructions instructions must be followed:
(a) after the distribution tape has been read in, or
(b) after the Xinu directory has been moved.

**************************************************************
***                     4.1bsd Users                       ***
*** NOTE: if you are still running 4.1bsd, you must remove ***
*** all .o files and libraries before doing anything else. ***
*** To do so, type the following:                          ***
***                                                        ***
***             cd /usr/ftp/pub/Xinu.8086/install                ***
***             ./Install 4.1                              ***
**************************************************************

Installation involves changing references to /usr/ftp/pub/Xinu.8086
in all source files and then recompiling them.

Step 1:	Execute shell script "Install" in this directory
	to climb around the tree and create final versions
	of the source files.

		cd /usr/ftp/pub/Xinu.8086/install
		./Install

Step 2:	Change to the source directory and execute the script
	that rebuilds binaries:

		cd /usr/ftp/pub/Xinu.8086/src
        	Makeall > make.out &

	If you have installed Xinu in other than /usr/Xinu,
	this program takes about one hour on a VAX 780
	(Hence, we suggest that you run it in background).
	Also be warned that there are numerous programs in
	the cross-development software that produce warning
	messages when recompiled.  You do not need to be
	superuser; only directories under /usr/ftp/pub/Xinu.8086
	are affected. 

Step 3:	Add /usr/ftp/pub/Xinu.8086/bin to your "path" so you can
	execute	commands that are found there:

	C-shell users type:

		set path=( $path /usr/ftp/pub/Xinu.8086/bin )

	Bourne shell users type:

		PATH=$PATH:/usr/ftp/pub/Xinu.8086/bin
		export PATH

	To make Xinu commands accessible after your next
	login, you must change the path assignment in your
	.profile or .cshrc files.


Step 4:	Try the command "odt" in /usr/ftp/pub/Xinu.8086/bin. It
	connects your keyboard to an LSI 11 console input
	and output from the LSI 11 to your terminal screen:

		odt

	To get the attention of the LSI, type backslash
	followed by null (CONTROL @).  The LSI will stop
	execution and print a prompt ("at" sign).  You
	are now talking to the LSI's "ODT" mode (consult
	the vendor's manual for additional information on
	ODT).  To terminate the odt command, kill the
	process with your normal interrupt character
	(usually CONTROL-C or DELETE).

Step 5: Change to the Xinu source directory and download
	the test program:

		cd /usr/ftp/pub/Xinu.8086/src/sys/sys
		download -a5
		odt

	It will print "hello world." and stop.  When all
	processes complete, type CONTROL-c to kill the odt
	command.


Step 6:	Pick one of your directories and make sure the
	cross-compiler works.

		cd directory-of-your-choice
		cp /usr/ftp/pub/Xinu.8086/src/sys/sys/test.c .
		cc11 -o test.out test.c
		download -a5 test.out
		odt

	This is the normal sequence for using Xinu.  Be
	sure it works before you change the operating
	system.


Step 7:	You are ready to experiment with Xinu itself.
	Change to the source directory and modify the
	configuration for your LSI 11.

		cd /usr/ftp/pub/Xinu.8086/src/sys/sys
		...edit file "Configuration"...
		make a.out
		download -a4
		odt

	Note that because recompiling the Xinu sources
	may take considerable time.  It is advisable to
	run make in the background with output (and error
	messages) directed to a file.

	Make will recompile the Xinu sources, rebuild
	file "xinu.o", and rebind library "libx.a".
	However, it leaves the new versions in source
	directory.  Make also compiles file "test.c"
	and binds it with the new library to form file
	"a.out".  When you are satisfied that the new
	version works, run "make intall" to copy the new
	version into /usr/ftp/pub/Xinu.8086/lib where command
	cc11 accesses it.

	Other arguments can be used with make.  For details
	see the file "Makefile".  Two that particularly
	useful ones are "everything" that runs several
	scripts designed to test source program formats,
	and "d" that runs "download -a4 ; odt" after remaking
	a.out.  Thus, you normally run "make d" after a
	change to recompile, download, and test the system.


Suggestions
-----------

   Suggestions and reports of problems are welcomed.
