some more comments and moved parameters in their sections