See: FILES for a shipping list of files in this archive.See: explain for a brief explaination of the diffs in perl.diffs.Here is a port of perl 4.0 Patchlevel 19 to the atariST series.:Whats new since atariST perl 4.010	- many minor problems fixed.	- configuration cleaned up.        - makefiles now have a uperl.a target, so that usub's can be          linked. (see usub/* to see how to make cursesperl)	- perl will now compile and run correctly with or without	the malloc that comes with perl.	- FILEs opened for write now correctly contain CR/LF unless	they are binmode'ed.	- complete support for gemdos/xbios/bios calls. see osbind.pl	and osexample.pl on how to use this facility.	- tracked perl to Patchlevel 19.known problems:	 - $! still does'nt contain the correct value when there is no error.	i still have'nt been able to track this down.-------------------------------------------------------------------------Here is a port of perl 4.0 Patchlevel 10 to the atariST series.What you'll need:	- a decent shell (i use gulam for obvious reasons), other	highly recommended ones are bash 1.08/1.10, gemini/mufpel, okami,	microCsh, init from apratt for MiNT. avoid neodesk. avoid the	desktop like the plague. The shell should be setup to use	atari/mwc conventions for command lines and environment setup	and passing. (in gulam be sure to `set env_style mw').	- a decent set of file utils (ls, rm, mv, etc etc) in your $PATH.	if you dont have these, look on atari.archive. the gnuFileutils	are available there.		- included here are echo and perlglob that you will need.	- setting UNIXMODE is recommended but not required. If you are	going to run the perl tests, then set UNIXMODE to atleast	"/.,LAd", else you will get a lot of unnecessary failures.	(alternately you will have to go in and edit long path names.	 get rid of things dealing with links, and rename paths	 beginning with "/dev/..." etc)	- if you are going to compile: you'll need gcc distribution,	(i used gcc-1.40 and libs at Patchlevel 73 initially. i          currently use gcc-2.1 and libs at Patchlevel 80). Also you will	need the port of gdbm (i used v1.5). you'll also need bison.	all these are available on atari.archive, in atari/gnustuff/tos	the diffs as enclosed in this kit assume you have gcc libs at        Patchlevel 80.	Compiling:	- get and install gnu gdbm (i used v1.5 -- see README.ST in	  the gdbm distribution on how to make the gdbm library).	- get the perl kit at Patchlevel 19        - copy  config.h usersub.c atarist.c echo.c wildmat.c  perlglob.c            makefile.sm makefile.smd makefile.st makefile.std makefile.stm	- apply the diffs in file `perl.diffs' using patch	- decide which makefile you want to use:	makefile.st	perl with gcc library malloc	makefile.sm	perl with malloc that comes with perl	- hit make -f <MAKEFILE>. (if you are not cross-compiling, 	   you'll have to adjust the makefile yourself -- watchout for	   perly.fixer).	   This will result in 3 executables, perl.ttp, perlglob.ttp	   and echo.ttp. Put all these executables in a sub-directory	   in your $PATH (and depending on your shell, issue a rehash).	(if you use makefile.std instead of makefile.st, the executable	 will be called perld.ttp. this is perl compiled with	 -DDEBUGGING)Compiling usubs:	see the files in usub/* and the makefile.st there.Testing:	- run perl from a decent shell. i use either gulam or bash	if you are going to be running from gulam, be sure to		set env_style mw	(this can be done automatically by including the above	 line in the gulam.g startup file). bash always uses	atari/mwc conventions so you dont have to do anything special.	(if you run perl from the desktop, you are asking for trouble!)	- you'll have to run the tests by hand. Almost all the tests	pass. You'll have to judge for yourself when a test fails	if it should have. I was able to explain all failures. If you	cant, ask me via mail. (one day i will cook up a script to	do this).	- It helps to have all the gnu fileutils in your PATH here.	especially echo.ttp and perlglob.ttp.	- Also a lot more tests will pass if you have UNIXMODE setup	i use "/.,LAd". If you dont use UNIXMODE, you'll have to hack	some of the tests.	- You may have to fix up a few Pathnames in the tests if you	are cd'ing to a particular test sub-directory to run the tests.	- Compare your tests with the results i got -- see file RESULTS.	General:	- setenv PERLLIB to point at the subdirectory containing lib/*	(if you want PERLLIB to contain more than one path, seperate	 them with commas)	- UNIXMODE is supported not required.	- Pipes are a little flakey sometimes, but mostly work fine.	Pipes, `prog`  etc are much more efficient if you have set	the environment var TEMP to point to a ramdisk. Note, when	you set TEMP, it should contain *no* tailing backslash (or slash).	- to force binary mode use "binmode FILE"	- browse thru config.h to see whats supported	- should MiNT'ize this much more.	- avoid using the backtick (`commands`). Use 'open(FOO, "command |")'	and use the filehandle FOO as appro.	- the command passed to system etc can contain	redirections of stdin/out, but system does not understand	fancy pipelines etc.	- syscall() to make gemdos/bios/xbios are fully supported now.	(note: we dont use ioctl like messy-dos to do this, as we can do	 real ioctl's on devices)	- i still need to cons up the lineA stuff.	  it should be just as easy to cons up aes/vdi outcalls too. imagine	  graphics from perl!.	- watch out for re-directions. TOS blows up if you try to	re-direct a re-directed handle. atari has greatly improved this	situation. hopefully, the next general release of TOS will contain	these fixes.	- in the perl libs (particularly perldb.pl) you will	need to s?/dev/tty?/dev/console?. perl -d works just fine.	for instance: (for this to work, UNIXMODE should include the	'd' option):*** /home/bammi/etc/src/perl/lib/perldb.pl	Tue Jun 11 17:40:17 1991--- perldb.pl	Mon Oct  7 21:46:28 1991****************** 49,56 ****  #   #  ! open(IN, "</dev/tty") || open(IN,  "<&STDIN");	# so we don't dingle stdin! open(OUT,">/dev/tty") || open(OUT, ">&STDOUT");	# so we don't dongle stdout  select(OUT);  $| = 1;				# for DB'OUT  select(STDOUT);--- 49,56 ----  #   #  ! open(IN, "</dev/console") || open(IN,  "<&STDIN");	# so we don't dingle stdin! open(OUT,">/dev/console") || open(OUT, ">&STDOUT");	# so we don't dongle stdout  select(OUT);  $| = 1;				# for DB'OUT  select(STDOUT);cheers,--bang:   uunet!cadence!bammi			jwahar r. bammidomain: bammi@cadence.comGEnie:	J.BammiCIS:    71515,155