(IMHO) the code should be fixed to do what the documentation formerly claimed, and then revert this change.