clarification about what the variables are.
additional readme cleanup and stuff.