Apart from the Javadoc, it also needs to be added to the documentation to make sure that normal users know about this feature and also know how to use it.