**************
Welcome to DS9
**************

Quick Instructions for those who hate to read instructions.
After installation, ds9 can be located in saods9/bin/ds9.
To build DS9, just cut and paste the following commands:

***********
For Solaris
***********

cd saods9
ln -s make.solaris make.include
make

***********
For Solaris64
***********

cd saods9

# There is an issue with ranlib and 64bit libs. This is a work around.
ln -s /usr/bin/touch ranlib

ln -s make.solaris64 make.include
make

*********
For Linux
*********

cd saods9
ln -s make.linux make.include
make

*********
For Linux64
*********

cd saods9
ln -s make.linux64 make.include
make

************
For LinuxPPC
************

cd saods9
ln -s make.linuxppc make.include
make

*********
For FreeBSD
*********

cd saods9
ln -s make.freebsd make.include
make

*********
For FreeBSD64
*********

cd saods9
ln -s make.freebsd64 make.include
make

*******************
For MacOSX (Darwin)
*******************

cd saods9
ln -s make.darwin make.include
make

****************************
For Windows NT/2000/XP
****************************

# Obtain/install Cygwin from http://www.cygwin.com
# edit /usr/include/sys/types.h 
# define FDSETSIZE 8192

cd saods9
ln -s make.windows make.include
make
# html will fail
make fixit
# more errors
make finish install

*******************
Building philosophy
*******************

First, I'd like to apologize for the state of the makefiles and the
build process.

DS9 is a Tcl/Tk standalone application. It requires no support files,
libraries, etc. To build DS9, you must also build Tcl, Tk, BLT,
MKTCLAPP, TkImg, TkHTML, TkTable, AST,and XPA, along with SAOtk. The makefiles
handle all this for you, however, it takes some time and appears very
messy.

The current makefiles are targeted for:

MAKE = gnu make 3.8
CC = gcc 4.0 (minimum 3.3)
CXX = g++ 4.0 (minimum 3.3)
X11 = R6

There are a number of issues to lead to the current set up.

1. DS9 comes with Tcl/Tk8.4.9. There are several modifications to the
Tcl/Tk source code to provide support for certain features within
DS9. Please use this version when building DS9.

2. The windows version is built with gcc under cygwin. Currently, the
following features are NOT supported under windows: printing directly
to a printer. However, postscript files may be saved.  FITS Bin Table
filtering is only available when run under cygwin
