Functions and Header Comments

A function definition is always preceded by a function header comment. Here is an example; use the same format whenever you're asked to write a function.
/* maxOf3() -----------------------------------
 * returns max of i, j, k
 */
int maxOf3(int i, int j, int k){  
   // body of function goes here...
}

Reasoning (is but Reckoning):

Functions are like mini-programs. Programs begin with a program header comment. Therefore, functions are preceded by a function-header comment.

(Reckoning is an odd term today, but in the seventeenth century it meant computation, ...)