javadoc enhancements about normalization