comments and javadocs, part 1 complete