improve $RepeatedMsgReduction doc

Thanks to David Lang for some of the text.