Bash 1.08
-rw-rw-r--  1 weiner     101024 Sep  8 11:28 108src-d2.zoo
-rw-r--r--  1 gray      1734722 Sep 25 15:15 bash-108.zoo

This file gives some cursory documentation for building and using Bash V1.08
for an Atari ST. 

This whole mess is distrubuted as :

	1. ReadMe.first  		- this file
        2. bash-d2.zoo			- support code and diffs

bash-d2.zoo contains :

        1. man/bash.1			- the standard bash man page 
	   man/Usage			- some cursory documentation on how
					  to use Bash.
	   man/bash_login		- a sample .bash_login file

	2. st-bash-src/src.diff 	- diffs to the FSF Bash Source
           st-bash-src/ReadMe		- a description of st-bash-src dir
           st-bash-src/endian.h		- defines for big endian machine
	   st-bash-src/pipesize.h	- defines for sizeof(pipe)
	   st-bash-src/sysdefs.h	- Atari system definitions
           st-bash-src/version.h        - defines version 1 of ST-Bash
	   st-bash-src/Makefile.cross	- a makefile for building ST-Bash 
					  in a cross development enviroment.
           st-bash-src/ReadMe		- descripion of the directory contents
	   st-bash-src/ChangeLog	- what has been done to Bash to 
					  make it work on the ST.
	3. lib+/*			- support routines neeeded on the ST.

	4. readline/read.diff		- diffs to the FSF Readline library
	   readline/Makefile.cross      - a makefile for building readline.olb
					  in a cross developement enviroment.
	   readline/ChangeLog           - what has been done to the readline
				          library to make it work on the ST. 

	5. gcclib/ioctl.h		- modified gcc include file
	   gcclib/fcntl.h		- ``			  ''
	   gcclib/close.c		- modified close.c for gnu RTL.
	   gcclib/open.c		- modified open.c  for gnu RTL.
	   gcclib/pipe.c       		- new addition to the gnu RTL.
	   gcclib/symdir.c		- modified symdir.c for gnu RTL.



To build this unpack the archive bash-d1.zoo with zoo x.// bash-d1.zoo
in a directory called st-bash-1.08, this will create the above mentioned
directories and files. In this directory create a directory called 
alloc-files/ and leave it empty for the time being.


||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
!!!!!!!!********README NOW********||||||||||||||||||||||||||||||||||||||||||
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
[ As  of PathLevel 72 of the gnu rtl from Jawhar Bammi, the routines 
  in gnulib/* are not yet incorporated into the GCC Run-Time-Library.
  What you need to do is copy libgcc/*.h into your gcc-include directory,
  copy gcclib/*.c into your lib-source/  directory (source for the RTL)
  add pipe.o to the list of unix files in "mincl", then build a new 
  gnu.olb library.
]



You need to get the original distribution of (Bashv1.08 + Patches) from 
prep.ai.mit.edu and unpack it somewhere. Apply the patches that you got
from prep.

----------------
(A) copy :
        alias.c	 	alias.h		bashline.c	braces.c	
	builtins.c	builtins.h	config.h	copy_cmd.c
	dispose_cmd.c	endian.h	execute_cmd.c	expr.c
	fc.c		flags.c		flags.h		general.c
	general.h	glob.c		hash.c		hash.h
	jobs.c		jobs.h		longest_sig.c	machines.h
	mailcheck.c	make_cmd.c	ndir.h		nojobs.c
	parse.y		posixstat.h	print_cmd.c	quit.h
	shell.c		shell.h		siglist.c	subst.c
	sysdefs.h	test.c		trap.c		trap.h
	ulimit.c	unwind_prot.c	variables.c	variables.h
	version.c	version.h
from the patched FSF distribution into : st-bash-108/st-bash-src/

cd st-bash-108/st-bash-src 
apply the diffs src.diff
----------------

(B) copy :
	readline/* 
from the patched FSF distribution into : st-bash-108/readline/

cd st-bash-108/readline
apply the diffs read.diff
----------------

(C) copy :
	alloc-files/*
from the patched FSF distribution into : st-bash-108/alloc-files/
----------------

!!! Now all the files are in place and patched for the Atari ST. !!!

All that is left is the compilation.

	(i)	cd st-bash-108/readline
		hit make
		copy readline.olb to your library directory.

	(ii)	cd st-bash-108/st-bash-src
		hit make
		This should give a bash.ttp file all ready to be fired up!
                If at this stage you get a message from the linker saying 
		flush_key_buff() or _del_symdir_cache() not found, you 
		need a new termcap.olb or gnu.olb!


-----------------------------------------------------------------------------