clearified some javaDocs