---------- ---------- ---------- ---------- ---------- ---------- ----------
		  INSTRUCTIONS ON BUILDING `ss'
---------- ---------- ---------- ---------- ---------- ---------- ----------

  This first set of instructions will guide you in building 'ss' on
  a a single architecture.  To set up separate compilation trees for
  building on multiple architectures, see the next section.

---------- ---------- ---------- ---------- ---------- ---------- ----------
1) Edit and customize Makefile, as necessary.

2) Copy a config file (ie: config.sun) to config.h
   (If there is no suitable config.* file for your system, you'll have to
   build one, based on one of the others.  Please email me any new config
   files you develop)

3) make

   This will build everything, but will not install it.  This procedure
   will not affect any files outside of the current directory.

4) You can now install the pieces manually, or issue the "make install"
   command.  

   NOTE: I always install by hand, due to our multiple-architecture 
   environment.  (eg: we have one /usr/local/man serving many different
   architectures, so a hand installation is called for.)  THEREFORE,
   be carefull when using this option.

---------- ---------- ---------- ---------- ---------- ---------- ----------
BULDING `ss' IN A MULTI-ARCHITECTURE ENVIRONMENT:

1)  From this directory, run the Mklinks script once for each
    architecture.  eg:
	./Mklinks sun4

    This will create a directory sun4 (underneath the current directory)
    with symbolic links to all the source files in this directory.

2)  For each of the new directories, customize the Makefile (Note, that this
    is a *copy* of the Makefile, and not a link, so don't worry about editing
    it) inside it, and follow the procedure above to build ss.

3)  Now, when installing a bug fix, or just hacking around, you can 
    easily just remake the software in each directory.  In this way, only
    changed files need to be recompiled, and not everything.  
    
    Saves time, Consumes disk space --> your choice ;-)

---------- ---------- ---------- ---------- ---------- ---------- ----------
End
