update javadoc and fix generation to link out