AUXF77 -- A compiler package for A/UX.  This package includes the following:

	f77			Fortran compiler (uses f2c and gcc)
	f2c			AT&T Fortran to C translator
	gcc			GNU C compiler (V 2.2.1)
	gdb			GNU C debugger
	gas			GNU assembler

F77 is a real working Fortran compiler - I have used this to compile millions
of lines of code.  f77 is actually a shell script which calls f2c to translate
the Fortran source to an intermediate C file, then calls gcc to compile and
optionally link.  There is no manpage for f77 itself since it is just a simple
script, but full documentation for f2c and gcc is included.

	doc/f2c.ps.Z		f2c reference manual
	man/man1/f2c.1.Z	f2c manpage (nroffed, packed)
	man/man1/gcc.1.Z	gcc manpage
	man/man1/gdb.1.Z	gdb manpage
	info/gcc.info*		gcc info text
	info/gdb.info*		gdb info text

The "xinfo" utility in AUX3/auxbin can be used to view the info files under
X, although the manpages are adequate to use these utilities.

The F77 command is similar to that found on other UNIX systems, except that
being little more than a hack script, it only supports a limited number of
arguments.  The A/UX version of this script is based on a script provided
by AT&T with F2C.

F77 usage:	f77 [-O] [-o absfile] [-c] files [-l library]

	-o objfile	Override default executable name a.out.

	-c		Do not call linker, leave relocatables in *.o.

	-S		leave assembler output on file.s

	-l library	(passed to ld).

	-g 		compile for debugging

	-u		complain about undeclared variables

	-v		verbose

	-w		omit all warning messages

	-w66		omit Fortran 66 compatibility warning messages

	-z		link static

	files		FORTRAN source files ending in .f .
			C source files ending in .c .
			Assembly language files ending in .s .
			efl source files ending in .e .

	-D def		passed to C compiler (for .c files)

	-I includepath	passed to C compiler (for .c files)

	-Ntnnn		allow nnn entries in table t

GCC is version 2.2.1.  This is identical to the wuarchive version, except
that cpp (the C preprocessor, called internally by the compiler) had to be
modified slightly to support source code debugging of Fortran source files.
Be warned that if you try to install only f2c and f77 to use with a version
of gcc you may already have installed, you may lose this capability.


INSTALLATION

    This package includes only the runtime files required to use these
utilities.  No source is included.  The package is configured to be
installed in /usr/local; this is not an option, as the C source code for
various utilities such as GCC require that the path be specified at compile
time.  The files are self contained under /usr/local, i.e., nothing outside
/usr/local is affected when the package is installed.

Installation is very simple:

	% cd /usr/local
	% zcat <path>/auxf77.tar.Z | tar -xof -

where <path> is the directory where you placed the auxf77.tar.Z file when
you downloaded it from iraf.noao.edu.  It is not necessary to do the install
as root unless you need to do so to have write permission in /usr/local.
You may want to list the tar file before installing it, to see what will
be installed.


USAGE

    To use these utilities, just make sure that /usr/local/bin is included
in your path.


IRAF USAGE

    If you will be using the compilers with IRAF, include the following
statements (or some variation thereon) in your .login file.  If you don't
use the cshell, you will have to translate.

	setenv	iraf /usr/iraf/
	if (-e $iraf/unix/hlib/irafuser.csh) then
	    source $iraf/unix/hlib/irafuser.csh
	endif
	setenv	IRAFARCH f2c

If IRAF was installed somewhere other than in /usr/local, change the above
accordingly (or just make a symbolic link /usr/iraf pointing to where the
software is really installed).  See the IRAF distribution files for more
information on installing the IRAF software.


Doug Tody
IRAF project
National Optical Astronomy Observatories
May 1 1993