* documentation update
 * minor changes to comments and method names