This is a snapshot of CSOUND, currently running at MIT MediaLab on VAXes and
MicroVaxes (under 4.3 BSD Unix, and Ultrix) and on DEC-RISC machines (Ultrix).
Although under continuous development, CSOUND is used for all our software
synthesis and is quite robust. We have also run these sources on Sun3's under
SUN Unix, on HP Bobcat workstations running a version of Bell System 5,
and on Macintosh II's under MPW.  The system is currently being ported to
the MacII's THINK_C, and that should become stable soon.

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 lpc.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 three musical examples
by expert users JD, JN 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

PLEASE NOTE: the bulletin board is NOT for administrative requests.
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
								April, 1990