Welcome to the Courseware Development System  Version 2.0

** What is CDS?

CDS is a hypertext tool designed to let non-programmers create their
own applications.  Unlike most hypertext tools, CDS does not have it's
own interpreter but rather relies on an independent backend.

What this means is that CDS can be used as a X11 graphical user interface
to virtually any mathematical package.

** Supported platforms for CDS

To compile CDS, you will need a c++ compiler and the MOTIF libraries.

CDS has been compiled and tested on the following platforms

Sun 4.1 using either AT&T C++ 2.1 or g++ 1.37
VaxStation 2000 and 3100 using either AT&T C++ 2.1 or g++ 1.37

Testing is now being done on the following platforms
DecStation 3100 using AT&T C++
IBM RT using AT&T C++

** Installing CDS

1. Edit the files Imake.cds and src.lib/expect/Makefile to conform to your system

2. Type:
  xmkmf
  make World

Set the environment variables
CDS_CONFIG_DIR - the absolute path of the CDS configuration direcotry
XENVIRONMENT - the location of the application defaults
XBMLANGPATH - The absolute path of the pixmaps directory in the form
   (/<absolute_path>/%B)

** Running cds

The file BUGS in the directory DOC contains reported problems with
installing CDS and their solutions

** CDS directory structure

Imake.cds - CDS site configuration parameters
Imakefile - The CDS main Imakefile
README - This file
applications - directory containing sample CDS files

config - directory containing configuration files

doc - directory containing documentation on CDS
doc/BUGS - the CDS big list
doc/HISTORY - history of CDS revisions
doc/NOTES.C++ - differences between AT&T C++ and g++
doc/TODO - ideas on enhancing CDS

pixmaps - directory containing pixmaps for CDS

src - directory containing source code for the CDS main program

src.cds - directory containing source code for the CDS library

src.lib - directory containing source code for the libraries used by CDS
src.lib/At - the Athena tools widget library
src.lib/Cm - the CDS widget library
src.lib/expect - the expect inter-process comunication library
                 anon ftp from durer.cme.nist
src.lib/regex - the GNU regex library, contained in the libg++ library
src.lib/vprintf - the vprintf library
                  anon ftp from uunet.uu.net
