updated java doc comments