This is a snapshot of CSOUND, currently running at mit-ems on our VAX-750
under 4.3 BSD Unix.  Although still under development, CSOUND has entirely
replaced Music11 for all our software synthesis since January '86,
and appears quite robust.
We also run the same CSOUND on MicroVaxes under Ultrix, on a Sun3 under
SUN Unix, and on HP Bobcat workstations running a version of Bell System 5.

All system differences are controlled by the top-level Makefile.
By editing this Makefile you can request inclusion of X windows and other
high-resolution graphics;  you can opt for soundfiles with/without headers;
and you can enable reads/writes remotely across a net.
The Makefile can also control the speed of audio processing: electing
single precision floats will double your speed with no loss in fidelity;
even greater improvements will result from any hardware accelerators present.
Check your hardware and software options carefully while editing this Makefile.

The top Makefile requires you to specify the libraries which will receive your
executables on successful installation.  Once Makefile is suitably modified,
installation requires just five commands from within the top directory:
		make includes
		make
		make install
		make manpp
		make clean
The first will install two globally needed .h files for subsequent compiles. 
The next creates two executables (PERF and CSOUND) in the top directory,
then several others in subdirectories using their 'Makef' files.
Subdirectories in 'anal' contain audio analysis programs, such as LPC and
hetrodyne, encoding audio files as control files for reconstruction in Csound
orchestras.  Subdirectories in 'util' contain score manipulating programs,
such as SCOT, CSCORE, SCSORT and EXTRACT.

If the first two 'make' commands succeed, go on to the third;  a correctly
edited top-level Makefile should be the only Csound file you need worry about.
If subdirectory compilation gives problems on your system, be aware that
only PERF, CSOUND, and SCSORT are essential for running a basic Csound job.
You can bypass problematic routines by commenting out the offending lines
in the lower Makef files.   NO OTHER FILES SHOULD BE MODIFIED AT INSTALLATION.
Type 'make manpp' to install some helpful man pages.  Finally,
use 'make clean' to remove old intermediate files & conserve storage.

Sound is written to a file in a predefined Sound File Directory, declared by
setting an environment variable SFDIR (eg. 'setenv SFDIR /usr/sound/logname').
If your system permits rexec's across a net, SFDIR can be remote (see manual).
Soundfile formats are either 16-bit fixed-point samples or 32-bit floats.
If you install with SFIRCAM defined, soundfiles will have a 1024-byte header,
as used at IRCAM, Paris.  'util/others' includes three IRCAM directories
(sndinfo.dir, sndin.dir, sndout.dir) whose compilation require use of
UCSD/carl headers.  These are not part of the supported installation.
I have included neither a sounddisk driver nor a PLAY command, since these
are so hardware dependent.  If you have a VAX and Digital Sound Corp DAC's,
you should import the IRCAM sound-file system and their play command.
For other configurations you will need to develop your own.

I have made a small header optional on all control files (such as lpc),
so that srate, npoles, etc. can be automatic (see the lp.h file).
Csound will read the header, then step over it no matter how long it is.
This means you can document your lp files by expanding the text in the header.
There are some 'man' pages explaining this.

The directory 'manual' contains ditroff sources for a hardcopy manual.
Its Makefile should make all apparent.  This manual is very detailed, serving
as a Reference, not a Primer.  Its purpose is to give an accurate account
of the functionality of each facet of the score and orchestra languages.
If you received these sources via FTP and don't have a laser printer,
you should purchase a single hardcopy from us at the MIT Media Lab.

The directory 'testfiles' contains orchestras/scores of two musical examples
by expert users JD and RB.  They should run without problem for your
initial assurance.
The remaining orchestras/scores are tests I've made in passing.
Check these test orchestras against the manual for syntax and form;
the task of creating bigger orchestras and better scores is left to you.

This entire directory is now available through ftp:	ftp   ems.media.mit.edu
There is also a bulletin board for user communication: csound@ems.media.mit.edu
To have your name added to/removed from the list,
order hardcopy manuals, etc., send mail to:    csound-request@ems.media.mit.edu

								Barry Vercoe
								July, 1987
