This directory contains the master `Makefile' for ObjectProDSP.
ObjectProDSP is a trademark of Mountain Math Software.

For the user interface process to compile and link X-windows and
InterViews 3.1 librarys and header files must be installed on your
system. The search path for these librarys and header files are
specified in the `EXTRA_CFLAGS' and `EXTRA_LK_FLAGS' definitions in file:
$OPD_ROOT/src/gui/build/iv/Makefile_inc
You may need to edit this file.

To compile and link ObjectProDSP under X-windoes requires approximately
30 megabytes of total (physical + virtual) memory. 20 Megabytes should
be enough if you are not running X-windows.

ObjectProDSP will run in 16 megabytes of memory and probably somewhat
less. If you are tight for memory save the state frequently (you
can do this automatically from the `state' menu).  If memory is exhausted.
The program dies with a short error message in one of the log files
`dsp.messages' or `cgi.messages'. (There are two log files for the two
processes.) You can only recover back to the last point at which the state
was saved.

To generate the documentation you must have groff, LaTeX and dvips
installed.

The environmental variable `OPD_ROOT' must be set to the root
directory in which you have installed ObjectProDSP. Usually the
best way to do this is to add the following 2 lines to `.bashrc'
in your HOME directory: 
OPD_ROOT=(direcotry where ObjectProDSP is installed)
export OPD_ROOT
To cause this update to effect your current shell type:
. ~/.bashrc

You can set `OPD_ROOT' on a temporary basis by connecting to the
ObjectProDSP root directory and entering `set_root'.

The first line in `$OPD_ROOT/scripts/SYSTEM' gives the
operating system. Currently only `linux' is supported.

Enter `make' with no parameters for a list of what you can
build from this directory.

After you create ObjectProDSP You may want to create a soft link in some
standard directory on the executable search path with `$OPD_ROOT/bin/opd'.
For example as `root' type the following:

ln -s $OPD_ROOT/bin/opd /usr/local/bin/opd

It is not generally necessary to put other executables on the
search path.

If you create a new distribution the result will be placed in
directory `$OPD_ROOT/dist/ftp'.
This directory is structued to be suitable for placing
in an archive for retrieval with FTP. Its subdirectories
includes `README' files.

If you make any changes and create a new distribution
you must make it clear that what you are distributing is based
on ObjectProDSP but is not an official release from Mountain Math
Software. Keep in mind that ObjectProDSP is a trademark of Mountain
Math Software. You will nead to change the cover pages of any manuals
you have edited. You should edit at least the top level
README file to identify yourself or your company and
to explain the changes you have made. You should read and follow
the instructions in `$OPD_ROOT/scripts/user_copyright_text' for updating
that file and adding your copyright notice and indentification to any files
you have altered and files created from files you have altered.
