tweak documentation to make consistent with new code.