more comments on javadoc generation for doc purposes