enhanced javaDocs