* update documentation for new behavior