more JavaDoc work