more docco tweaks, and added an env variable that should shut up one of the complaints in the logs