document new behavior