javadoc updated with new references