expanding javadoc