added java doc comments