added some JavaDoc