Document the new behaviour.