javadoced the code