README file for Nyquist Version 2.2

INSTALLING NYQUIST
====================
Please see Section 1.1, Page 1, of the Nyquist Manual

IMPLEMENTATION STATUS
=====================
Version 2.1 provides:
	bug fixes
	documentation and code for user extensions
Version 2.0 provides:
	continuous time warps
	many more functions
	bug fixes

The distribution tar file contains most sources for Nyquist.  
A number of these files are machine generated, including:
-  many .c and .h files that implement signal processing functions.
	These are generated by translation system that converts
	.alg files to .c and .h files.  .alg files give high-level
	descriptions of DSP algorithms.  
- Makefile.* is generated by "makefile.lsp".

For this release, I have not done much testing on other machines.
The status is:

System                  Status

RS6K = RS6000, AIX      tested
NEXT = NeXT 3.0 (Cube)  tested
SGI = ???               untested - I integrated changes reported from ports
                                   of a previous version, so it should not be
                                   too far from working.
PMAX = Mach 2.5 on Dec workstation
                        untested - previous version of Nyquist DID work
SPARC = Sun Sparc ???   untested - previous version of Nyquist DID work

also included: Erik Dahl's Power Mac port, but this is not complete

SOUND FILE BYTE ORDERING
========================
There is at least one sound file here used for examples.  It has 16-bit 
samples with Motorola byte ordering (I think that's big-endian, i.e. 
high order byte first.)  To convert sound byte orderings on a unix machine:
	say 'dd conv=swab <input.snd >output.snd'

DIRECTORY STRUCTURE
===================
cmt - CMU MIDI Toolkit files, used by Nyquist for MIDI File I/O
demos - Nyquist demos go here
lib - .lsp files offering extensions to Nyquist
misc - various files and programs used to implement Nyquist
nyqsrc - general Nyquist source code (mostly in C)
runtime - the Nyquist and XLisp runtime code (mostly in XLisp)
sys - system specific files
test - test code (this is not maintained and may not be in the release)
todo - list of things to do (this may not be in the release)
tran - descriptor (.alg) files for machine-translated Nyquist code
xlisp - sources for Xlisp (these are linked into Nyquist)

