RELEASE NOTES FOR THE CONTOUR LIBRARY
		    =====================================

		  Emilio Camahort - ecamahor@cs.utexas.edu

			       May 15, 1999

These notes refer to a new version of the contour library: libcontour.a dated
May 15, 1999. The new library incorporates the following changes:

New Functionality - a new data structure DatasetInfo has been added to the
interface. It allows obtaining relevant information about a given dataset.
The library function that allows accessing the information is:

	DatasetInfo     *getDatasetInfo(ConDataset *dataset);

For a complete list of the fields of DatasetInfo see the file: contour.h
One caveat: the fields dim, orig, and span are undefined for 2D and 3D un-
structured datasets.

Verbosity Level - a new global variable `verbose' of type int has been added
to control the level of verbosity of the library. It can be controled with
the library function:
	
	void            setVerboseLevel(int level);

By default the variable is set to 1, printing the usual diagnostics messages.
If set to 0, no messages are printed. If set to a value larger than 1, addi-
tional messages are printed.

Error Handling - Library errors are now handled by an error handler. The 
default error handler accepts a string and an integer toggle. The handler
prints the string plus an additional system error message, if available.
If the toggle is 0 the error handler returns control to the library. Other-
wise, it calls exit(0) to exit the program. The default error handler can 
be replaced by a user-defined handler using the library function:

	void            setErrorHandler(void (*handler)(char *, int));

Currently, only one error causes the library to exit, when no file can be
opened to load a dataset. Otherwise, all library routines return a NULL 
pointer if a non-fatal error occurs during their execution.

			-------------//------------