**************
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 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, tktable,
tkcon, xmlrpc, blt, zlib, tclxml, tkimg, tkmepg, tkhtml, xpa, iis,
checkdns, funtools, ast, wcssubs, rice, hcompress, plio, saotk, zip,
and zvfs.  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
CXX = g++ 4.x
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.
