commenting and unneeded loop

Added commenting to some of the functions that had none, reviewed and
clarified other commenting.

Removed a vestigial loop.  The loop initialized the int array to 0.
Unneeded because int arrays are initialized to 0 on creation, and
because it was fill directly after.