document new env behavior