update JavaDoc comments