JAL-2438 Javadoc updates