added comments with "Analyze Javadoc" tool