completed and regenerated javadoc