improve the class javadoc
Merge branch 'gda-8.42' of ssh://dascgitolite@dasc-git.diamond.ac.uk/gda/gda-core.git into gda-8.42