added some javaDocs