javadoc updates, pmd cleanup