Completed javadoc comments, renamed variables to more understandable ones