//////////////////////////////////////////////////////////////// <Function Name>
// <Brief description of what the function does.>
//
// Parameters:
//   <List each parameter and give a brief description of its purpose.>
//
// Pre:       <List the preconditions; i.e., the things that must be true
//             before the function is called.  Usually these involve whether
//             and how parameters must be initialized before the call, etc.>
//
// Post:      <List the postconditions; i.e., the things that are guaranteed
//             to be true when the function finishes, assuming that the
//             listed preconditions are satisfied.>
//
// Returns:   Describe what value the function returns, if any.
//
// Called by: <List the name(s) of the function(s) that call this one.>
// Calls:     <List the name(s) of the function(s) that this one calls.>
//