updated the documentation in Java doc style