	This directory contains routines which implement fast, table driven
	math functions.	At the present time, the functions currently 
	implemented are SIN(), COS(), ATAN2(), and (on uVAX only) SQRT(). 
	All functions return type float.

	There are two flavours of table driven function. In the first
	case, the function uses lookup tables, and, in the case of
	VAX's, assembly code, to speed up the computation. The user
	includes "../h/fastmath.h" in his/her code, and then calls
	the functions exactly like their libm.a counterparts. 

	As a second option, the user can invoke the script 'inlinemath',
	which lives in this directory, to massage the function calls
	in the compiled application into inline code. This involves
	compiling with -S to get the assembly code, running the code
	through the 'inlinemath' script, and then proceeding with the
	assembly. This option is currently only implemented on a VAX,
	The SQRT() function is not available inline.

	EXAMPLE: 
			cc program.c -S
			../fastmath/inlinemath program.s program.s
			cc program.s -o program

	'inlinemath' takes two arguments: an input file, and an output
	file (they may have the same name, since intermediate values are
	buffered). All calls to the fastmath functions in program.s will
	be replaced with inline code.

	The tables which the functions use are created by the program
	maketable, using a specification contained in the file <FXN>.conf.
	The SQRT() function table is created using the program sqrt_tabgen.

	The files in this directory are:

	SIN.conf --	config file for the sin() lookup table, used as
			input by 'maketable'.

	mt_sin.c -- 	the sine table.

	sin.c --	Code for the routines SIN(), COS(), and SINCOS().
			The latter computes both sine and cosine values,
			which it is faster to do at the same time instead
			of separately.

	ATAN2.conf --	config file for the atan2() lookup table, used as
			input by 'maketable'.

	mt_atan2.c --	the atan2 table.

	atan2.c --	Code for the routine ATAN2().

	fastmath.h --	definition file to be included in programs using
			the fats math functions. This file is normally copied
			into the ../h/ directory.

	inlinemath --   shell script which applies performs inline code
			substituion on assembly output.

	maketable --	program to build a math table (as a large C 
			initialized C array) given a specification (such
			as TABLE.conf) on it's standard input.

	<fxn>_Cdefs.h -- C code definitions describing the parameters
			associated with the tables produced by 'maketable'.

	<fxn>_Adefs.h -- assembly level definitions describing the parameters
			associated with the tables produced by 'maketable'.

	<fxn>_Adefs.sed -- assembly level table definitions, also produced
			by 'maketable', in a format suitable for use by 'sed'.

	constants.sed -- a sed script containing various math constants used
			by the inline math routines.

	inlinemath.sed -- the sed script used by the inlinemath program to
			generate the inline code.

	atan2-test.c --	program to test and time the ATAN2() function.

	atan2-inline -- inline code version of atan2-test which tests and
			times the inline version of ATAN2().	

	sin-test.c --	program to test and time the SIN(), COS(), and 
			SINCOS() functions.

	sin-inline --   inline code version of sin-test which tests and
			times the inline versions of the sin/cos functions.

	sqrt-test.c --	program to test the SQRT() call.

	sqrt_tabgen.c -- special program to generate the lookup table for
			the SQRT function.

	sqrt.c --	Stub routine to provide SQRT(x) on non-VAX
			systems.
	sqrt-s.s --	VAX assembly implementation of table driven
			SQRT() routine.
