added java doc to all methods