javadoc and additional convenience method for JAL-716