improved JavaDoc