Doc environment variables 593

fixes #593 
fixes #460 
nit: remove the word "actual"