**************
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
***********

# WARNING: saods9 uses gnu make
cd saods9
ln -s make.solaris 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 X11 MacOSX 10.4 Tiger (Universal)
*******************

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

*******************
For Aqua MacOSX 10.4 Tiger (Universal)
*******************

cd saods9
ln -s make.macosxtiger make.include
make
make ds9app

*******************
For X11 MacOSX 10.5 Leopard (Universal)
*******************

cd saods9
ln -s make.darwinleopard make.include
make
Note: this version consist of 2 files, the binary, ds9, 
      and a separate archive, ds9.zip. These files must be in the same
      directory.

*******************
For Aqua MacOSX 10.5 Leopard (Universal)
*******************

cd saods9
ln -s make.macosxleopard make.include
make
make ds9app

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

# Obtain/install Cygwin from http://www.cygwin.com
# Make sure you install the following programs (aside from gcc, make, etc.):
#   perl, cpio unzip
# Make sure you install the following libraries:
#   tcl/tk, libxml2, libxml2-devel, libxslt libxslt-devel
# Probably you also need to add saods9/bin and . to your path

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

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

DS9 is a Tcl/Tk standalone application. It requires no support files,
libraries, etc. To build DS9, you must also build Tcl, Tk, BLT, TkImg,
TkHTML, TkTable, zlib, zip, zvfs, 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.3 (minimum 3.4)
CXX = g++ 4.3 (minimum 3.4)
YACC = bison 2.3
LEX = flex 2.5.33
X11 = R6

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

1. DS9 comes with Tcl/Tk8.4.18. 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. FITS Bin Table
filtering is only available when run under cygwin
