added some javadocs and some checkstyle cleanup