document and tweak environmental variables