**************
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 (Universal)
*******************

cd saods9
ln -s make.darwintiger make.include
   or
ln -s make.darwinleopard make.include
   or
ln -s make.darwinsnowleopard make.include
   or
ln -s make.darwinlion make.include
make

*******************
For Aqua MacOSX (Universal)
*******************

cd saods9
ln -s make.macosxtiger make.include
   or
ln -s make.macosxleopard make.include
   or
ln -s make.macosxsnowleopard make.include
   or
ln -s make.macosxlion make.include
make
make ds9app

****************************
For Windows 7
****************************

# 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.x (minimum 3.4)
CXX = g++ 4.x (minimum 3.4)
YACC = bison 2.4
LEX = flex 2.5
X11 = R6

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

1. DS9 comes with Tcl/Tk8.5.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.
