generated javadoc
refactoring and code editing