Release Notes for 4.21
======================

*** DRAFT  *** DRAFT  *** DRAFT  *** DRAFT  *** DRAFT  *** DRAFT  *** DRAFT  *** DRAFT  

Bug Fixes
---------

Some errors in 0dbfs fixed which trashed the default sr/kr system.
Also correctipons in random opcpodes related to 0dbfs


Many calls to initerror replaced by perferror which shoudl give
clearly error recovery.  Also returns after initerror shpudl stop
consequential errors

0dbfs fixed in utilities

There was a bug in expanding the number of strset names remembered. 

various fixes in midi initialisatio and -o stdout use

Language Changes
----------------

Dynamic libraries loadable in Linux, using commant line to identify them.

A missing #include is now treated as a hard error

if then else structures incorporated

Opcode Fixes
------------

linevent correctly initialised

Argument to vco now "xxikppovo"

fog and fof now have an additional argument iskip which is non-zero
skips initialisation (allows legato use)


New Opcodes 
-----------

a(k) as interpolating type cast (Gabriel)

ink, outk, invalue, and outvalue opcodes

Instruments as opcodes

ftsave, ftsavek, ftload, ftloadk

New Gens
--------



Other Changes:
-------------

The limit of 20 lpc files removed -- now arbitrary

cvanal now available as stand-alone as well as internal utility

FreeBSD sources merged in

If message level is set with the 16 bit set then amplitudes are
printed in dB

A great deal of change related to moving towards the API.  Thsi si
incomplete but within a gnat's-wisker of complete


Known Bugs
==========

The following bugs are known but not yet fixed 9still!)

6: PVOC can glitch (mail of Mon, 19 Jun 2000 00:45:23 +0200)
8. Spaces in arguments to opcodes can be ignored, giving oddities
9. Mismatched closing bracket can give crash (mail of Fri, 19 Oct 2001
   19:00:56 +0100) 


Windows GUI Changes
-------------------


-----------------------------------------------------------------------
Saving and Loading Tables from file

ftsave "filename", iflag, ifn1 [,ifn2,...ifnX]
ftsavek "filename", ktrig, iflag, ifn1 [,ifn2,...ifnX]
ftload "filename", iflag, ifn1 [,ifn2,...,ifnX]
ftloadk "filename", ktrig, iflag, ifn1 [,ifn2,...,ifnX]

DESCRIPTION
Save and load a set of previously-allocated tables to/from a file.

INTIALIZATION
"filename" - quoted string containing the name of the file where
load/save the tables
iflag - type of the file to load/save: zero = binary file, nonzero = text 
fileifn1, ifn2,...ifnX - numbers of tables to load/save 

PERFORMANCE
ktrig - trigger signal. Save/load file each time it is nonzero.


ftsave and ftload allow to save and re-load a list of tables. Such
tables have to be already allocated. The format can be binary or text,
it is not compatible with wavefile, and is not endian-safe, at least
for now. 
fsavek and ftloadk are identical to ftsave and ftload. The only
difference is saving/loading operation can be repeated more time in
the same note, according to the trigger signal. 

------------------------------------------------------------------------