4.4BSD/usr/src/contrib/perl-4.036/atarist/README.ST

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. bammi
domain: bammi@cadence.com
GEnie:	J.Bammi
CIS:    71515,155