document new env behavior
Merge pull request #37 from spoonapps/dev/rafal/fix-clnt-3233

document new env behavior