tidy javadoc and included missing @Test annotation