------------------------------------------------------------------------------- **** IRAF Version 2.12 Release **** ------------------------------------------------------------------------------- Updated Jul 16 2002 - V2.12.1, HPUX released, SSOL and PCIX update Updated Jul 24 2002 - V2.12.1, DUNX released Updated Jul 28 2002 - V2.12.1, IRIX released Updated Feb 05 2004 - V2.12.2, SSOL and PCIX update (bugfix/platform support) ------------------------------------------------------------------------------- This directory and its subdirectories contains the network version of the full IRAF V2.12 distribution. May 8, 2002 - Initial V2.12 EXPORT release. (SSOL and PCIX only) Jul 16, 2002 - V2.12.1 EXPORT release. (patch and all-platform support) Feb 05, 2004 - V2.12.2 EXPORT patch release. (SSOL and PCIX only) README This file COPYRIGHTS Copyright information for this software SSOL Sun/IRAF distribution - both SunOS and Solaris PCIX PC-IRAF distribution - includes FreeBSD, Slackware, RedHat and SuSE Linux, Solaris x86, MacOSX, and Linux PPC (NEW in V2.12.2!) DUNX Digital Unix/IRAF distribution - Compaq Tru64 IRIX SGI/IRAF distribution - IRIX 6.5 and later HPUX HP/IRAF distribution - HP/UX 10.20 and later PORT Source-only distributions (all systems) sysnotes.v212 V2.12 system revisons notes v212revs.txt V2.12 revisions summary, text version v2122revs.txt V2.12.2 revisions summary, text version 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 CD-ROM, 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 SSOL, PCIX, DUNX, HPUX, 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 on a givel platform 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 60-70 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 CD-ROM distribution from NOAO. For sites with no network connection or a poor network connection this may be the only way to go. A CD-ROM for all supported systems may be ordered online at http://iraf.noao.edu/iraforder/ Beginning with IRAF V2.9 there is a nominal fee (typically $50US) 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 !! [--> Note you can register using the IRAF Web pages now <--] [--> Registrants will receive selected IRAF mailing lists <--] AND THATS NOT ALL... The main IRAF distribution 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 MSCRED package from NOAO. See /iraf/extern, /iraf/contrib, and /iraf/misc for layered software. Graphics software for use with IRAF, including xgterm and ximtool, will be found in /iraf/x11iraf.