document new behavior
update info with registry & environment variables
Merge pull request #25 from spoonapps/dev/rafal/fix-clnt-3156

document new behavior