This is an old version of the file "porting.notes".  It contains
porting information that people submitted for Tcl releases numbered
7.3 and earlier.  You may find information in this file useful if
there is no information available for your machine in the current
version of "porting.notes".

I don't have personal access to any of these machines, so I make
no guarantees that the notes are correct, complete, or up-to-date.
If you see the word "I" in any explanations, it refers to the person
who contributed the information, not to me;  this means that I
probably can't answer any questions about any of this stuff.  In
some cases, a person has volunteered to act as a contact point for
questions about porting Tcl to a particular machine;  in these
cases the person's name and e-mail address are listed.

sccsid = @(#) porting.old 1.2 94/12/19 11:23:18

---------------------------------------------
Cray machines running UNICOS:
Contact: John Freeman (jlf@cray.com)
---------------------------------------------

1. There is an error in the strstr function in UNICOS such that if the
string to be searched is empty (""), the search will continue past the
end of the string.  Because of this, the history substitution loop
will sometimes run past the end of its target string and trash
malloc's free list, resulting in a core dump some time later.  (As you
can probably guess, this took a while to diagnose.)  I've submitted a
problem report to the C library maintainers, but in the meantime here
is a workaround.

-----------------------------------------------------------------
diff -c1 -r1.1 tclHistory.c
*** 1.1	1991/11/12 16:01:58
--- tclHistory.c	1991/11/12 16:14:22
***************
*** 23,24 ****
--- 23,29 ----
  #include "tclInt.h"
+ 
+ #ifdef _CRAY
+ /* There is a bug in strstr in UNICOS; this works around it. */
+ #define strstr(s1,s2) ((s1)?(*(s1)?strstr((s1),(s2)):0):0)
+ #endif _CRAY

---------------------------------------------
MIPS systems runing EP/IX:
---------------------------------------------

1. Need to add a line "#include <bsd/sys/time.h>" in tclUnix.h.

2. Need to add "-lbsd" into the line that makes tclTest:

	${CC} ${CFLAGS} tclTest.o libtcl.a -lbsd -o tclTest

---------------------------------------------
IBM RS/6000 systems running AIX:
---------------------------------------------

1. The system version of strtoul is buggy, at least under some
versions of AIX.  If the expression tests fail, try forcing Tcl
to use its own version of strtoul instead of the system version.
To do this, first copy strtoul.c from the compat subdirectory up
to the main Tcl directory.  Then modify the Makefile so that
the definition for COMPAT_OBJS includes "strtoul.o".  Note:  the
"config" script should now detect the buggy strtoul and substitute
Tcl's version automatically.

2. You may have to comment out the declaration of open in tclUnix.h.

3. You may need to add "-D_BSD -lbsd" to the CFLAGS definition.  This
causes the system include files to look like BSD include files and
causes C library routines to act like bsd library routines.  Without
this, the system may choke on "struct wait".

---------------------------------------------
AT&T 4.03 OS:
---------------------------------------------

Machine: i386/33Mhz i387 32k Cache 16MByte 
OS: AT&T SYSV Release 4 Version 3
X: X11R5 fixlevel 9
Xserver: X386 1.2

1. Change the Tk Makefile as follows:
XLIB            = -lX11
	should be changed to:
XLIB            = -lX11 -lsocket -lnsl

-------------------------------------------------------
Silicon Graphics systems:
-------------------------------------------------------

1. Change the CC variable in the Makefile to:

CC =		cc -xansi -D__STDC__ -signed

2. In  Irix releases 4.0.1 or earlier the C compiler has a buggy optimizer.
   If Tcl fails its test suite or generates inexplicable errors,
   compile tclVar.c with -O0 instead of -O.

3. For IRIX 5.1 or later, comments 1 and 2 are no longer relevant,
but you must add -D_BSD_SIGNALS to CFLAGS to get the proper signal
routines.

4. Add a "-lsun" switch in the targets for tclsh and tcltest,
just before ${MATH_LIBS}.

5. Rumor has it that you also need to add the "-lmalloc" library switch
in the targets for tclsh and tcltest.

6. In IRIX 5.2 you'll have to modify Makefile to fix the following problems:
    - The "-c" option is illegal with this version of install, but
      the "-F" switch is needed instead.  Change this in the "INSTALL ="
      definition line.
    - The order of file and directory have to be changed in all the
      invocations of INSTALL_DATA or INSTALL_PROGRAM.

---------------------------------------------
NeXT machines running NeXTStep 3.1:
---------------------------------------------

1. Run configure with predefined CPP:
	CPP='cc -E' ./configure
   (If your shell is [t]csh, do a "setenv CPP 'cc -E' ")
	
2. Edit Makefile: 
  -add tmpnam.o to COMPAT_OBJS:
	COMPAT_OBJS =		 getcwd.o waitpid.o strtod.o tmpnam.o
  -add the following to AC_FLAGS:
	-Dstrtod=tcl_strtod 

3. Edit compat/tmpnam.c and replace "/usr/tmp" with "/tmp"

After this, tcl7.0 will be build fine on NeXT (ignore linker warning)
and run all the tests. There are some formatting problems in printf() or
scanf() which come from NeXT's lacking POSIX conformance. Ignore those
errors, they don't matter much.

4. Additional information that may apply to NeXTStep 3.2 only:

    The problem on NEXTSTEP 3.2 is that the configure script makes some
    bad assumptions about the uid_t and gid_t types.  Actually, the may
    have been valid for NEXTSTEP 3.0, or it may be NEXTSTEP's rudimentary
    attempt at POSIX support under 3.2, but no matter what the reason, the
    configure script sets up the Makefile with CFLAGS '-Duid_t=int' and
    '-Dgid_t=int', which are, unfortunately, incorrect, since they shoudl
    actually be (I think) unsigned shorts.  This causes problems when the
    'stat' structure is included, since it throws off the field offsets
    from what the 'fstat' function thinks they should be.
    
    Anyway, the quick fix is to run configure and then edit the Makefile
    to remove the uid_t and gid_t defines.  This will allow tcl and Tk to
    compile and run.  There are some other problems on NEXTSTEP,
    specifically with %g in the printf family of functions, but making the
    uid_t and gid_t change will get it up and running.

---------------------------------------------
NeXT machines running NeXTStep 3.2:
---------------------------------------------

1. Run configure with predefined CPP:
	CPP='cc -E' ./configure
   (If your shell is [t]csh, do a "setenv CPP 'cc -E' ")
	
2. Edit Makefile: 
  -add tmpnam.o to COMPAT_OBJS:
	COMPAT_OBJS =		 getcwd.o waitpid.o strtod.o tmpnam.o
  -add the following to AC_FLAGS:
	-Dstrtod=tcl_strtod
  -add '-m' to MATH_LIBS:
        MATH_LIBS = -m -lm
  -add '-O2 -arch m68k -arch i386' to CFLAGS:
	CFLAGS = -O2 -arch m68k -arch i386 

-------------------------------------------------
ISC 2.2 UNIX (using standard ATT SYSV compiler):
-------------------------------------------------

In Makefile, change

CFLAGS =      -g -I. -DTCL_LIBRARY=\"${TCL_LIBRARY}\"

to

CFLAGS =      -g -I. -DPOSIX_JC -DTCL_LIBRARY=\"${TCL_LIBRARY}\"

This brings in the typedef for pid_t, which is needed for
/usr/include/sys/wait.h in tclUnix.h.

---------------------------------------------
DEC Alphas:
---------------------------------------------

1. There appears to be a compiler/library bug that causes core-dumps
unless you compile tclVar.c without optimization (remove the -O compiler
switch).  The problem appears to have been fixed in the 1.3-4 version
of the compiler.

---------------------------------------------
CDC 4680MP, EP/IX 1.4.3:
---------------------------------------------

The installation was done in the System V environment (-systype sysv)
with the BSD extensions available (-I/usr/include/bsd and -lbsd).  It was
built with the 2.20 level C compiler.  The 2.11 level should not be used
because it has a problem with detecting NaN values in lines like:
	if (x != x) ...
which appear in the TCL code.

To make the configure script find the BSD extensions, I set environment
variable DEFS to "-I/usr/include/bsd" and LIBS to "-lbsd" before
running it.  I would have also set CC to "cc2.20", but that compiler
driver has a bug that loader errors (e.g. not finding a library routine,
which the script uses to tell what is available) do not cause an error
status to be returned to the shell (but see the comments about "-non_shared"
below in the 2.1.1 notes).

There is a bug in the <sys/wait.h> include file that mis-defines the
structure fields and causes WIFEXITED and WIFSIGNALED to return incorrect
values.  My solution was to create a subdirectory "sys" of the main TCL
source directory and put a corrected wait.h in it.  The "-I." already on
all the compile lines causes it to be used instead of the system version.
To fix this, compare the structure definition in /usr/include/bsd/sys/wait.h
with /bsd43/include/sys/wait.h (or mail to John Jackson, jrj@cc.purdue.edu,
and he'll send you a context diff).

After running configure, I made the following changes to Makefile:

	1)  In AC_FLAGS, change:
		-DNO_WAIT3=1
	to
		-DNO_WAIT3=0 -Dwait3=wait2
	EP/IX (in the System V environment) provides a wait2() system
	call with what TCL needs (the WNOHANG flag).  The extra parameter
	TCL passes to what it thinks is wait3() (the resources used by
	the child process) is always zero and will be safely ignored.

	2)  Change:
		CC=cc
	to
		CC=cc2.20
	because of the NaN problem mentioned earlier.  Skip this if the
	default compiler is already 2.20 (or later).

	3)  Add "-lbsd" to the commands that create tclsh and tcltest
	(look for "-o").

---------------------------------------------
CDC 4680MP, EP/IX 2.1.1:
---------------------------------------------

The installation was done in the System V environment (-systype sysv)
with the BSD extensions available (-I/usr/include/bsd and -lbsd).  It was
built with the 3.11 level C compiler.  The 2.11 level should not be used
because it has a problem with detecting NaN values in lines like:
	if (x != x) ...
which appear in the TCL code.  The 2.20 compiler does not have this
problem.

To make the configure script find the BSD extensions, I set environment
variable DEFS to:

	"-I/usr/include/bsd -D__STDC__=0 -non_shared"

and LIBS to:

	"-lbsd"

before running it.  The "-non_shared" is needed because with shared
libraries, the compiler (actually, the loader) does not report an
error for "missing" routines.  The configuration script depends on this
error to know what routines are available.  This is the real problem
I reported above for EP/IX 1.4.3 that I incorrectly attributed to a
compiler driver bug.  I don't have 1.4.3 available any more, but it's
possible using "-non_shared" on it would have solved the problem.

The same <sys/wait.h> bug exists at 2.1.1 (yes, I have reported it to
CDC), and the same fix as described in the 1.4.3 porting notes works.

In addition to the three Makefile changes described in the 1.4.3 notes,
you can remove the "-non_shared" flag from AC_FLAGS.  It is only needed
for the configuration step, not the build.

You will get duplicate definition compilation warnings of:

	DBL_MIN
	DBL_MAX
	FLT_MIN
	FLT_MAX

during tclExpr.c.  These can be ignored.

During expr.test, you will get a failure for one of the "fmod" tests
unless you have CDC patch CC40038311 installed.

---------------------------------------------
Convex systems, OS 10.1 and 10.2:
Contact: Lennart Sorth (ls@dmi.min.dk)
---------------------------------------------

1. tcl7.0b2 compiles on Convex systems (OS 10.1 and 10.2) by just running 
  configure, typing make, except tclUnixUtil.c needs to be compiled
  with option "-pcc" (portable cc, =!ANSI) due to:
  cc: Error on line 1111 of tclUnixUtil.c: 'waitpid' redeclared:
  incompatible types.

-------------------------------------------------
Pyramid, OSx 5.1a (UCB universe, GCC installed):
-------------------------------------------------

1. The procedures memcpy, strchr, fmod, and strrchr are all missing,
so you'll need to provide substitutes for them.  After you do that
everything should compile fine.  There will be one error in a scan
test, but it's an obscure one because of a non-ANSI implementation
of sscanf on the machine;  you can ignore it.

2. You may also have to add "tmpnam.o" to COMPAT_OBJS in Makefile:
the system version appears to be bad.

-------------------------------------------------
Encore 91, UMAX V 3.0.9.3:
-------------------------------------------------

1. Modify the CFLAGS assignment in file Makefile.in to include the 
-DENCORE flag in Makefile:

	CFLAGS = -O -DENCORE

2. "mkdir" does not by default create the parent directories.  The mkdir
directives should be modified to "midir -p".

-------------------------------------------------
Sequent machines running Dynix:
Contact: Andrew Swan (aswan@soda.berkeley.edu)
-------------------------------------------------

1. Use gcc instead of the cc distributed by Sequent

2. The distributed math library does not include the fmod
   function.  Source for fmod can be retrieved from a BSD
   source archive (such as ftp.uu.net) and included in the
   compat directory.  Add fmod.o to the COMPAT_OBJS variable
   in the Makefile.  You may need to comment out references
   to 'isnan' and 'finite' in fmod.c

3. If the linker complains that there are two copies of the
   'tanh' function, use the ar command to extract the objects
   from the math library and build a new one without tanh.o

4. The *scanf functions in the Sequent libraries are apparently
   broken, which will cause the scanning tests to fail.  The
   cases that fail are fairly obscure.  Using GNU libc apparently
   solves this problem.

-------------------------------------------------
Systems running Interactive 4.0:
-------------------------------------------------

1. Add "-posix -D_SYSV3" to CFLAGS in Makefile (or Makefile.in).

-------------------------------------------------
Systems running FreeBSD 1.1.5.1:
-------------------------------------------------

The following changes comprise the entire porting effort of tcl7.3 to
FreeBSD (i.e. these were the changes to tclTest.c) and should probably
be made part of the tcl distribution. The changes only effect the way that
floating point exceptions are reported. I've choosen to move the changes
out of tclTest.c and into tclBasic.c.

in tclBasic.c at top-of-file:

#ifdef BSD_NET2
#include <floatingpoint.h>
#endif

in tclBasic.c in Tcl_Init():

#ifdef BSD_NET2
    fpsetround(FP_RN);
    fpsetmask(0L);
#endif

