HAL-2 updated javadoc