Comments - different parameters

I have included some comments, and a function which is not yet called in
the main code.