update javadoc to be valid