egcs.1.1.2.3.README
Mar 22, 2001 

The EGCS C compiler (v1.1.2 port 2) for NEXTSTEP 3.x and 
OpenStep for Mach 4.x.  Includes C, Obj C, C++ and Fortran
compilers.

file:	egcs-i386.1.1.2.3.NI.b.tar.gz 
desc:	egcs for i386 output target
sum:	
md5sum:	

file:	egcs-m68k.1.1.2.3.NI.b.tar.gz 
desc:	egcs for m68k output target
sum:	
md5sum:	

file:	egcs-docs.1.1.2.2.NI.tar.gz 
desc:	egcs documentation and auxiliary utilities
sum:	08080  1043
md5sum:	f9f56b96f8181a8d75eb1863c2a8c913


(* 
   To be available at
   http://next-ftp.peak.org/next/apps/devtools/
   ftp://next-ftp.peak.org/pub/next/apps/devtools/
*)


INSTALLATION

Unpack to archive,
> gnutar xzvf /PathToArchive/egcs-i386.1.1.2.3.NI.b.tar.gz

Install resulting egcs-i386.pkg with /NextAdmin/Installer.app

Cross Compiling: If you would like the capability of cross-compiling,
(ie, build m68k binaries on an i386 system or vice-versa), install
the egcs package for the other target FAT.  For example, install
both Intel and NeXT binaries of egcs-m68k.pkg on an i386 system.

NEXTSTEP/OpenStep Developer Packages: you STILL need the nextstep 
developer packages  installed in order to use egcs, as it uses 
NeXT's supplied binutils, C libraries, and header files.


CROSS COMPILING (skip if you're not interested in cross-compiling)

Once you've got the other output target egcs package installed, 
here's how to actually do it.  There are two methods, and both
involve how to envoke the compiler.  I'll give the example of
compiling m68k binaries on an i386 system:

1.  Use the -b switch (preferred)
gcc -bm68k-next-nextstep3 foo.c
2.  Envoke cross-compiler directly
m68k-next-nextstep3-gcc foo.c



CHANGELOG

Mar 20, 2001	(1.1.2 port 3)
- The -read-only-relocs suppress flag left-over in 
  specs.nextstep3 file caused linker to fail on ns33.

June 29, 1999	(1.1.2 port 2)
- m68k output target (not very tested, however)
- Cross-compile capability
- Slightly-modified source available on request.

June 25, 1999	(1.1.2 port 1)
- c++ exceptions do not seem to work.  Running a program that uses
  exceptions crashes with the error: IOT Trap.  A bug report has
  been sent to egcs-bugs@egcs.cygnus.com
- Source available soon (required minor patching for openstep)
- m68k port available soon.
- Includes post_install script to handle differing linking
  issues between NEXTSTEP 3.x and OpenStep 4.x.

Jan 26, 1999	(1.1.1 port 1beta)
- Beta release.
- No source code (yet)


CREDITS

Cygnus Software, egcs source
http://egcs.cygnus.com/

Packager
Rex Dieter <rdieter@math.unl.edu>
Computer System Manager 
Universtity of Nebraska-Lincoln  
Department of Mathematics and Statistics 
http://www.math.unl.edu/~rdieter/