added a new javadoc