added shell javadoc, pmd tool refactoring