more comments for java doc