added comments for javadoc generation