minor reworking of the javadaocs