IRAF Version 2.10

    This directory and its subdirectories contains the network version of the
full IRAF V2.10 distribution.

	README			This file
	COPYRIGHTS		Copyright information for this software
	ORDERFORM		IRAF order form (tapes, printed manuals etc.)
	REGISTER		IRAF site or user registration information
	bugs.log		Known bugs in this release (updated regularly)

	AIX3			IBM AIX distribution
	AUX3			Apple Macintosh A/UX distribution
	DOSF			DEC Alpha OSF/1			(New!)
	DSUX			Decstation Ultrix distribution
	HPUX			HP-Apollo distribution
	IRIX			SGI IRIX distribution
	S386			Sun-386i distribution
	SOS4			V2.10.4 SunOS/IRAF		(New!)
	SSOL			V2.10.4 Solaris/IRAF		(New!)
	VXUX			VAX Ultrix distribution
	VMS5			VAX/VMS-5 distribution

	LNUX			Linux/IRAF			(NEW!)
	DVMS			DEC Alpha OpenVMS		(planned)

	old/SOS4-v2102		V2.10.2 Sun/IRAF distribution

	PORT			Source-only distributions (all systems)

	pkgnotes.v210.Z		V2.10 package revisions notes
	sysnotes.v210.Z		V2.10 system revisons notes
	sysnotes.v2104.Z	V2.10.4 system revisons notes
	params.v2104.Z		V2.10.4 parameter change summary
	v210revs.ms.Z		V2.10 revisions summary, source version
	v210revs.ps.Z		V2.10 revisions summary, Postscript version
	v210revs.txt.Z		V2.10 revisions summary, text version

	zzutil			utilities used to maintain this distribution

There are two ways to build a distribution from the files contained in these
directories.


PREBUILT BINARY DISTRIBUTIONS

    The recommended way to create IRAF from the IRAF network archive is to
obtain and install a binary distribution.  This is identical to what one
would get on a mailed distribution tape, and includes full system sources
as well as prebuilt and tested system binaries.  Since this distribution
contains precompiled binaries it is large and takes longer to retrieve from
the archive, but once the distribution files have been obtained the
installation is simple and relatively safe from errors.

The binary distribution for each system is contained in a subdirectory such
as DSUX, S386, SOS4, VMS5, and so on.  All of the files needed to build IRAF
on the given system will be contained in this directory or in subdirectories.
Instructions for retrieving the files and performing the installation are
given in the README file in the root directory.


SOURCE-ONLY DISTRIBUTIONS

    The alternative to obtaining and installing a precompiled binary IRAF
distribution is to obtain the system sources and compile the system yourself.
This requires less material to be transferred over the network, but takes
longer, is more prone to error, and leaves some doubt as to how well tested
the resultant system will be (the executables you generate are not necessarily
identical to those we tested when the binary distribution was prepared).
IF A PREBUILT BINARY DISTRIBUTION IS AVAILABLE FOR YOUR SYSTEM YOU SHOULD
USE THAT.

All the files you need to build IRAF from a source-only distribution will
be found in the PORT subdirectory.  Instructions are given in the README
file in this directory.  In short, you will need the HS file for the
target system (the host system interface), and the IS.PORT.GEN and
NS.PORT.GEN distribution files (IRAF and NOAO package sources).  The
latter two archive files (they are compressed UNIX TAR files) consist of
some 7000 files, comprising the bulk of the IRAF distribution, and are
identical in all IRAF installations.  To build IRAF from the sources you
will need to install all three files, and do an IRAF sysgen to compile and
link the portable system.

A source-only distribution (actually this includes the host level HSI binaries
required for the IRAF sysgen) totals about 13 Mb, compared to 30-40 Mb for a
full distribution, including binaries as well as sources.


MAILED DISTRIBUTIONS

    An alternative to obtaining a network distribution of IRAF is ordering a
conventional mailed distribution from NOAO.  For sites with no network
connection or a poor network connection this may be the only way to go.
Sites that are getting IRAF for the first time and hence do not yet have
a manual set should probably order a mailed distribution in order to get
the (optional) manual set.  Beginning with IRAF V2.9 there is a nominal
fee for a mailed distribution to cover the cost of materials and handling.


REGISTERING YOUR SITE

    If you obtain IRAF from this archive or get a copy from a friend, and you
are a regular user, please register with us as an active site.  This helps us
monitor IRAF usage by the community, providing input for determining project
directions, and provides us with information needed to help obtain funding for
the IRAF project.  To register your site, you need only fill out the form in
the REGISTER file and send it back to us.  As a benefit of registering your
site, you will receive the IRAF Newsletter and if you wish, you can subscribe
to the IRAF mail (electronic bulletin board and news service).

		!! PLEASE REGISTER YOUR SITE IF YOU USE IRAF !!
		    (Just fill out and mail in the form)


AND THATS NOT ALL...

    IRAF is not all there is to IRAF.  You may also want to obtain some of
the "layered packages", or some of the contributed user programs available for
installation in IRAF.  Examples of layered packages are new IRAF packages still
undergoing user testing before being installed in the standard distribution,
and IRAF based software developed by outside groups, e.g., the STSDAS software
from STScI, or the PROS (XRAY) software from the ROSAT group at CFA (SAO).
Some of this software will be found elsewhere in this network archive.  The
file "ls-lR.Z" in the login directory of this network archive contains a
complete list of all the files in the archive, and is a good place to look to
see what is available.