/*---------------------------------------------------------------
 * <function_name> -- <summary>
 *
 *	NOTE -- this prologue might be incomplete.
 *
 * DESCRIPTION:
 * ------------
 *
 * VALUE RETURNED BY FUNCTION:
 * ---------------------------
 *
 * FUNCTION PARAMETERS:
 * --------------------
 *
 * EXTERNAL VARIABLES:  
 * -------------------
 *	This list might not be complete.  In particular, it might not
 *	contain all external variables referenced by the functions
 *	that this function calls.
 *
 *-------------------------------------------------------------------
 */
