#124: final javadoc and pmd fixes