added more java doc comments