NOTE ON THE MAKEFILES

	There are several versions of the makefile in this directory:

		Makefile.debug	makefile for debugging the executable
		Makefile.ibm	makefile for RS6000 machines
		Makefile.norm	normal makefile

	To compile the program, copy one of these to the file Makefile,
	and type

		% make depend
		% make

	(Note that the % is the prompt symbol; don't type it!) This will
	compile the program and place the executable s2ibis2 in the
	current directory.



NOTE ON COMPILING

	I've tried to make the code as portable as possible, and for the
	most part, it conforms to ANSI C.  Some compilers may have
	trouble with it, but it does compile using gcc.  See NOTE ON GNU
	SOFTWARE below.

	Note that the makefile calls flex and bison to generate the C
	code for the command file parser.  Some folks may not have
	these, so to make life easier, I've included the file s2iyacc.c,
	which is the code for the parser.  If you don't have flex and
	bison, comment out the following lines in the makefile (put a #
	in the first column of the line): 

			$(YACC) -d -v s2ibis.y
			mv s2ibis.tab.c s2iyacc.c

		s2ilex.c      : s2ibis.lex
			$(LEX) -i s2ibis.lex
			mv lex.yy.c s2ilex.c

	Then just type 

		% make depend
		% make

	to assemble the executable.
	


NOTE ON GNU SOFTWARE

	The makefile uses flex, bison and gcc to produce the executable.
	These are GNU versions of lex, yacc, and cc (respectively).  You
	can get all of these via anonymous ftp from the Free Software
	Foundation software archives, or other archives.  Below is some
	information on locations for finding the software. 


***** The following was taken from the Usenet g++ FAQ *****

   The Free Software Foundation is a nonprofit organization that
distributes software and manuals to raise funds for more GNU
development.  Getting your copy from the FSF contributes directly to
paying staff to develop GNU software.  CD-ROMs cost $400 if an
organization is buying, or $100 if an individual is buying.  Tapes cost
around $200 depending on media type.  I recommend asking for version 2,
not version 1, of g++.

   For more information about ordering from the FSF, contact
gnu@prep.ai.mit.edu, phone (617) 876-3296 or anonymous ftp file
`/pub/gnu/GNUinfo/ORDERS' from prep.ai.mit.edu or one of the sites
listed below.

   Here is a list of anonymous FTP archive sites for GNU software.

     ASIA: ftp.cs.titech.ac.jp, utsun.s.u-tokyo.ac.jp:/ftpsync/prep,
     cair.kaist.ac.kr:/pub/gnu, ftp.nectec.or.th:/pub/mirrors/gnu
     
     AUSTRALIA: archie.oz.au:/gnu (archie.oz or archie.oz.au for ACSnet)
     
     AFRICA: ftp.sun.ac.za:/pub/gnu
     
     MIDDLE-EAST: ftp.technion.ac.il:/pub/unsupported/gnu
     
     EUROPE: irisa.irisa.fr:/pub/gnu, ftp.univ-lyon1.fr:pub/gnu,
     ftp.mcc.ac.uk, unix.hensa.ac.uk:/pub/uunet/systems/gnu, ftp.denet.dk,
     src.doc.ic.ac.uk:/gnu, ftp.eunet.ch, nic.switch.ch:/mirror/gnu,
     ftp.informatik.rwth-aachen.de:/pub/gnu, ftp.informatik.tu-muenchen.de,
     ftp.win.tue.nl:/pub/gnu, ftp.funet.fi:/pub/gnu, ftp.stacken.kth.se,
     isy.liu.se, ftp.luth.se:/pub/unix/gnu, ftp.sunet.se:/pub/gnu,
     archive.eu.net
     
     SOUTH AMERICA: ftp.unicamp.br:/pub/gnu
     
     WESTERN CANADA: ftp.cs.ubc.ca:/mirror2/gnu
     
     USA: wuarchive.wustl.edu:/systems/gnu, labrea.stanford.edu,
     ftp.digex.net:/pub/gnu, ftp.kpc.com:/pub/mirror/gnu,
     f.ms.uky.edu:/pub3/gnu, jaguar.utah.edu:/gnustuff,
     ftp.hawaii.edu:/mirrors/gnu, vixen.cso.uiuc.edu:/gnu,
     mrcnext.cso.uiuc.edu:/pub/gnu, ftp.cs.columbia.edu:/archives/gnu/prep,
     col.hp.com:/mirrors/gnu, gatekeeper.dec.com:/pub/GNU,
     ftp.uu.net:/systems/gnu

   The "official site" is prep.ai.mit.edu, but your transfer will
probably go faster if you use one of the above machines.

   Most GNU utilities are compressed with "gzip", the GNU compression
utility.  All GNU archive sites should have a copy of this program,
which you will need to uncompress the distributions.

   UUNET customers can get GNU sources from UUNET via UUCP.  UUCP-only
sites can get GNU sources by "anonymous UUCP" from site "osu-cis" at
Ohio State University.  You pay for the long-distance call to OSU; the
price isn't too bad on weekends at 9600 bps.  Send mail to
uucp@cis.ohio-state.edu or osu-cis!uucp for more information.

   OSU lines are often busy.  If you're in the USA, and are willing to
spend more money, you can get sources via UUCP from UUNET using their
900 number: 1-900-GOT-SRCS (900 numbers don't work internationally).
You will be billed $0.50/minute by your phone company.

