added commentary and javadoc, removed debugging messages