[misc] Make the javadoc explicit