ISIS-973: improvements to javadoc only
ISIS-973: improvements to javadoc only