javadoc for hints