Javadoc refactoring. Part 1

javadoc refactoring