update the AR enum docs to match the actual behavior. [ci skip]