cont reworking the javadaocs