reviewed problems with the javadoc