#	START NEW ARIX SCCS HEADER
#
#	@(#) README: version 25.1 created on 11/27/91 at 14:33:32
#
#	Copyright (c) 1990 by Arix Corporation
#	All Rights Reserved
#
#	@(#)README	25.1	11/27/91 Copyright (c) 1990 by Arix Corporation
#
#	END NEW ARIX SCCS HEADER
#

	Readme file for SPM EPROM, SPM DIAGIMAGE source tree.

	Products supported:

		1.  SPM EPROM 
		2.  SPM DIAG IMAGE
		3.  SPM DIAG IMAGE floppy version

	Makefiles:
		
		1.  spmfw.mk	- makefile for the EPROM make.
		2.  diag.mk	- Makefile for the diag image makes.

	Make command files:

		1.  mk_prom	- runs the 'normal' EPROM make.  This will
				  recreate the file date.c, thereby creating
				  a binary which will not match submissions.

		2.  mk_prom_sub	- runs the reproduce make required to create
				  a matching binary.  Uses the file date.sav_pr
				  to match date.o used for submission.  Prior to
				  submission, execute `mv date.o date.sav_pr`.

		3.  mk_image	- runs the 'normal' IMAGE make.  This will
				  recreate the file date.c, thereby creating a
				  binary which will not match submission.  The
				  IMAGE created is too large to be booted from 
				  a floppy.

		4.  mk_image_sub- runs the reproduce make required to create
				  a matching binary.  Uses the file date.sav_im
				  to match date.o used for submission.  Prior to
				  submission, execute `mv date.o date.sav_im`.

		5.  mk_image_f	- runs the 'floppy' IMAGE make.  This will
				  recreate the file date.c, thereby creating a
				  binary which will not match submission.  The
				  IMAGE created has a slightly reduced command
				  set to allow for an image size which may be
				  booted from a floppy device.

		6.  mk_image_fs	- runs the reproduce make required to create
				  a matching binary.  Uses the file date.sav_flp
				  to match date.o used for submission.  Prior to
				  submission, execute `mv date.o date.sav_flp`.

		7.  cl_prom	- Clobbers the EPROM objects and related files.

		8.  cl_image	- Clobbers the IMAGE objects and related files.

	Link editor maps:

		1.  ld.ffile	- Link editor map for EPROM using date.o.
		2.  ld.repffile - Link editor map for EPROM using date.sav_pr.
		3.  ld.rfile	- Link editor map for EPROM code to be linked
				  for RAM execution (0x01000000 base addr).
		4.  ldfile	- Link editor map for 'normal' IMAGE using
				  date.o.
		5.  ldrepfile	- Link editor map for 'normal' IMAGE using
				  date.sav_im.
		6.  ldflpfile	- Link editor map for 'floppy' IMAGE using
				  date.o.
		7.  ld_flp_rep	- Link editor map for 'floppy' IMAGE using
				  date.sav_flp.


	Command files:
		
		1.  mkboot	- creates bootimage file from the binary 'diag'.
		2.  mktape	- copies bootimage to /dev/rmt1 after rewinding.

	
	Submission Procedure:

		1.  Use 'mk_prom', 'mk_image', and 'mk_image_f' for normal 
		    development.  

		2.  When creating a release, run the desired make:

			spmfw	mk_prom
			diag	mk_image
			diag	mk_image_f	(floppy version)

		3.  Move the created binary to its submission name:

			spmfw	`mv spmfw spmfw_submit'
			diag	`mv diag diag_submit'
			diag	`mv diag fdiag_submit'		(floppy version)

		4.  Move date.o to proper date.sav_xxx:

			spmfw	`mv date.o date.sav_pr'
			diag	`mv date.o date.sav_im'
			diag	`mv date.o date.sav_flp'	(floppy version)

		5.  Perform the proper clobber:

			spmfw	cl_prom
			diag	cl_image
			diag	cl_image	(floppy version)

		6.  Check make by running the reproduce make:

			spmfw	mk_prom_sub
			diag	mk_image_sub
			diag	mk_image_fs	(floppy version)

		7.  Compare the binaries, differences are only allowed in date
		    written by the link editor in the file header.
		    (Bytes 5, 6, 7, and 8 when using cmp)

			spmfw	cmp -l spmfw spmfw_submit
			diag	cmp -l diag diag_submit
			diag	cmp -l diag fdiag_submit	(floppy version)

		8.  Perform the proper clobber:

			spmfw	cl_prom
			diag	cl_image
			diag	cl_image	(floppy version)

		9.  If more than one product is being submitted, go to step 2.

		10.  Write the source tree to tape using:
		
			cd SOURCE DIRECTORY 
			find . -print | cpio -oBv > /dev/rmt1

			(other devices may be substituted for /dev/rmt1)

		11. REMEMBER:  Always perform a clobber before changing
			       products.  Failure to do so will cause the
			       linking of conditionally compiled modules in
			       an improper manner.  In other words the make
			       WILL NOT WORK PROPERLY.

